Формат даты

Этот раздел перенесён из документации Camunda 7 и в дальнейшем будет доработан с учётом особенностей OpenBPM Engine

REST API использует формат даты по умолчанию yyyy-MM-dd’T’HH:mm:ss.SSSZ, который представляет дату с миллисекундами и информацией о часовом поясе, например, 2016-01-25T13:33:42.165+0100.

Если вы добавляете дату как параметр GET-запроса, помните о URL-кодировании, например 2016-01-25T13:33:42.165%2b0100.

Пользовательский формат даты

Пользовательский формат даты можно настроить в файле web.xml REST API. Для этого необходимо добавить ServletContextListener CustomJacksonDateFormatListener. Пользовательский формат даты можно задать с помощью параметра контекста io.openbpm.bpm.engine.rest.jackson.dateFormat.

Например, если формат даты не должен содержать миллисекунды и информацию о часовом поясе (yyyy-MM-dd’T’HH:mm:ss), можно использовать следующую конфигурацию.

Чтобы добиться этого, вы можете отредактировать файл WEB-INF/web.xml следующим образом:

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">

  <!-- ... -->

  <listener>
    <listener-class>
      io.openbpm.bpm.engine.rest.CustomJacksonDateFormatListener
    </listener-class>
  </listener>

  <context-param>
    <param-name>io.openbpm.bpm.engine.rest.jackson.dateFormat</param-name>
    <param-value>yyyy-MM-dd'T'HH:mm:ss</param-value>
  </context-param>

  <!-- ... -->
</web-app>

С такой конфигурацией REST API будет возвращать даты с точностью до миллисекунд и информацией о часовом поясе. Кроме того, новые даты с миллисекундами и информацией о часовом поясе можно передавать в REST API без потери этих сведений.

СОВМЕСТИМОСТЬ С WEBAPPS: Учтите, что для возможности использования OpenBPM Webapps формат даты должен соответствовать следующему:

yyyy-MM-dd['T’HH:mm[:ss[.SSS[Z]]]]

Лицензия и атрибуция

Эта документация была создана на базе материала "Camunda 7 Docs" от Camunda, находится под лицензией Creative Commons Attribution-ShareAlike 3.0 Unported License .

Оригинал документации: https://docs.camunda.org