Интеграция движка с CDI

В Quarkus есть встроенная реализация CDI (Contexts and Dependency Injection) под названием ArC. Она основана на стандарте Jakarta CDI 4.0, но реализует только его часть.

OpenBPM Engine поддерживает CDI 4 через модуль openbpm-engine-cdi. Этот модуль встроен прямо в расширение Quarkus. Его возможности и модель программирования описаны в разделе Интеграция с CDI и Jakarta EE.

Ограничения

Quarkus ArC не стремится полностью реализовать CDI 4.0, поэтому часть возможностей модуля openbpm-engine-cdi недоступна. Некоторые функции из раздела Интеграция с CDI и Jakarta EE не поддерживаются или работают с ограничениями. Подробности приведены ниже.

Здесь перечислены только те ограничения Quarkus ArC, которые влияют на работу модуля openbpm-engine-cdi. У ArC есть и другие ограничения. При разработке приложения обязательно изучите ограничения и поддерживаемые возможности вашей версии Quarkus.

Ограниченная поддержка разрешения выражений JUEL

Модуль openbpm-engine-cdi позволяет ссылаться на CDI-бины и вызывать их методы в выражениях модели (например, camunda:expression, camunda:delegateExpression и т. д.). Quarkus ArC пока не поддерживает метод CDI API jakarta.enterprise.inject.spi.BeanManager#getELResolver, с помощью которого движок разрешает вызовы методов CDI-бинов. Поэтому сейчас поддерживаются только ссылки на CDI-бины.

Примеры:

  • поддерживаемое выражение: ${myService}

  • неподдерживаемое выражение: ${myService.checkCondition('foo')}

Ограниченная поддержка областей видимости в контекстной модели программирования

Модуль openbpm-engine-cdi позволяет связать экземпляр процесса с областью видимости Conversation Scope или Request Scope. Quarkus ArC поддерживает только Request Scope.

Настройка Quarkus для задания переменных при вызове метода с аннотацией @StartProcess

Модуль openbpm-engine-cdi позволяет задавать переменные процесса через поля класса с аннотацией @ProcessVariableTyped или @ProcessVariable: достаточно присвоить полю значение внутри метода с аннотацией @StartProcess, как в следующем примере:

@Dependent
public class ProcessController {

  @ProcessVariable
  String myProcessVariable;

  @StartProcess("keyOfTheProcess")
  public void startProcessByKey() {
    myProcessVariable = "my-value";
  }

}

Quarkus пытается автоматически внедрять бины в поля класса, помеченные аннотациями-квалификаторами (@Qualifier), поэтому без дополнительной настройки такой код не работает: Quarkus выбрасывает исключение.

Автоматическое внедрение можно отключить, если вы понимаете последствия и можете обойтись без него. Подробнее об этом в справочнике по конфигурации ArC.

Другой вариант: задать переменные внутри метода с аннотацией @StartProcess программно:

@Dependent
public class ProcessController {

  @Inject
  BusinessProcess process;

  String myProcessVariable;

  @StartProcess("keyOfTheProcess")
  public void startProcessByKey() {
    myProcessVariable = "my-value";
    process.setVariable("myProcessVariable", myProcessVariable);
  }

}

Бины @BusinessProcessScoped

Модуль openbpm-engine-cdi хранит бины @BusinessProcessScoped как переменные текущего экземпляра процесса.

Пассивация не поддерживается

Quarkus не поддерживает пассивацию и пассивирующие области видимости. Поэтому при запуске приложения Quarkus не проверяет, что бины @BusinessProcessScoped сериализуемы и поддерживают пассивацию (passivation capable).

Если бины @BusinessProcessScoped или объекты, на которые они ссылаются, не реализуют интерфейс java.io.Serializable, движок выбросит исключение во время выполнения, когда попытается сохранить бины как переменные процесса.

Уничтожение экземпляров бинов не поддерживается

Программно уничтожить экземпляр бина @BusinessProcessScoped сейчас нельзя.

Следующие методы API выбрасывают UnsupportedOperationException:

  • jakarta.enterprise.inject.Instance#destroy

  • io.quarkus.arc.InjectableContext#getState

  • io.quarkus.arc.InjectableContext#destroy

  • io.quarkus.arc.InjectableContext#destroy(Contextual<?> contextual)

Бины форм задач

Quarkus ArC пока не поддерживает привязку бинов к области видимости Conversation Scope. Кроме того, Quarkus не позволяет задать другую область видимости по умолчанию для бинов, которые расширение не контролирует. Поэтому следующие бины с областью видимости Conversation Scope по умолчанию недоступны в приложении Quarkus:

  • io.openbpm.bpm.engine.cdi.jsf.TaskForm

  • io.openbpm.bpm.engine.cdi.compat.FoxTaskForm

  • io.openbpm.bpm.engine.cdi.compat.OperatonTaskForm

Чтобы получить эту функциональность в приложении Quarkus, напишите собственные бины с нужными областями видимости и поведением. Доступные бины и модель программирования описаны в разделе Интеграция с CDI и Jakarta EE.

Документация создана на основе Camunda 7 Docs (Camunda, docs.camunda.org) и распространяется по лицензии Creative Commons Attribution-ShareAlike 3.0 Unported.