Activiti

Главная страница: http://activiti.org

Activiti — это легковесная система управления рабочими процессами и платформа управления бизнес-процессами (BPM), ориентированная на бизнес-пользователей, разработчиков и системных администраторов. Ядром системы является мощный и надёжный движок BPMN 2 для Java. Он открытый и распространяется под лицензией Apache. Activiti может работать в любом Java-приложении, на сервере, в кластере или в облаке. Она идеально интегрируется с Spring, она очень лёгкая и основана на простых концепциях.****ЗАМЕЧАНИЕ: Мы перенесли всё содержимое разработочной ветки в основную ветку master, чтобы проектировать и писать следующую значительную версию проекта. Если вы хотите внести свой вклад в версию 6.x, обратитесь к ветке 6.x.****Если вы хотите узнать больше о структуре наших репозиториев, прочитайте нашу GitBook.

Настройка IntelliJ

• Установите уровень языка 21, чтобы быстро выявлять ошибки при использовании возможностей доступных только в более новых версиях Java.

  • Откройте меню File, пункт меню Project Structure

  • Нажмите элемент списка Modules, для каждого модуля, перейдите на вкладку Sources, выпадающий список Language level должен автоматически установиться на 21

  • Избегайте того, чтобы изменения в некоторых ресурсах игнорировались при следующем запуске/отладке (и вы были вынуждены использовать mvn).

  • Откройте меню File, пункт меню Settings или меню IntelliJ IDEA, пункт меню Preferences... если используете Mac

  • Найдите элемент дерева Compiler, поле Resource patterns: измените на !?*.java (удалите остальной контент)

• Избегайте ошибки StackOverflowError при сборке.

  • Откройте меню File, пункт меню Settings или меню IntelliJ IDEA, пункт меню Preferences... если используете Mac
  • Найдите элемент дерева Compiler, элемент дерева Java Compiler, поле Additional command line parameters

• Добавьте -J-Xss1024k

• Рекомендованный стиль кода: используйте Google Java Style Guide с editorconfig - Скачайте xml-файл стиля кода IntelliJ с сайта: [https://google.github.io/styleguide/intellij-java-google-style.xml]

  • Откройте меню File, пункт меню Settings или меню IntelliJ IDEA, пункт меню Preferences... если используете Mac

  • Найдите элемент дерева Code Style, нажмите значок шестерёнки и выберите Import scheme, затем IntelliJ code style xml

  • Обзор места, где вы скачали xml-файл, и открытие его. Убедитесь, что активной является схема GoogleStyle.

    • Примечание: IntelliJ IDEA автоматически не форматирует ваш код. Вам нужно нажать сочетание клавиш Ctrl+Alt+L для активации автоформатирования после завершения написания кода.

  • Есть файл .editorconfig, который имеет определение для отступов, кодировки файла, концов строк.

  • Если вы отключите этот файл, вам потребуется установить кодировку файла и количество пробелов правильно вручную.

  • Xml-файл стиля кода Eclipse: [https://google.github.io/styleguide/eclipse-java-google-style.xml]

  • Для Eclipse требуется плагин editorconfig-eclipse для поддержки файлов EditorConfig.- Вручную установите правильную кодировку файла (UTF-8 за исключением файлов properties) и конец строки (unix):

  • Откройте меню Файл, пункт меню Параметры или меню IntelliJ IDEA, пункт меню Настройки... если используете Mac

  • Найдите элемент дерева Стиль кода, элемент дерева Основные

    • Выберите значение в выпадающем списке Разделитель строк (для новых файлов): Unix

  • Найдите элемент дерева Кодировки файлов

    • Выберите значение в выпадающем списке Глобальная кодировка: UTF-8
    • Выберите значение в выпадающем списке По умолчанию кодировка для файлов properties: ISO-8859-1
      • Примечание: обычные файлы i18n properties должны быть в ISO-8859-1, как указано в контракте Java ResourceBundle.

• Вручную установите правильное количество пробелов при нажатии Tab:

  • Откройте меню Файл, пункт меню Параметры или меню IntelliJ IDEA, пункт меню Настройки... если вы используете Mac
  • Найдите элемент дерева Стиль кода, элемент дерева Основные
  • Нажмите вкладку Java
    • Чекбокс Использовать символ табуляции: отключен
    • Поле ввода Размер табуляции: 4
    • Поле ввода Отступ: 4
    • Поле ввода Отступ продолжения: 8
  • Нажмите вкладку XML
    • Чекбокс Использовать символ табуляции: отключен
    • Поле ввода Размер табуляции: 2
    • Поле ввода Отступ: 2
    • Поле ввода Отступ продолжения: 4

• Установите правильные заголовки файлов (не включайте @author или бессмысленный Javadoc): - Откройте меню Файл, пункт меню Параметры или меню IntelliJ IDEA, пункт меню Предпочтения... , если вы используете Mac

  • Нажмите на элемент дерева Шаблоны файлов, вкладка Includes, элемент списка File Header
  • Удалите строку @author Ваше имя.
    • Мы не принимаем строки @author в исходных файлах, см. часто задаваемые вопросы ниже.
  • Удалите весь Javadoc, так как автоматически сгенерированные данные являются бессмысленными.- Установите правильный заголовок лицензии
  • Откройте меню Файл, пункт меню Настройки или меню IntelliJ IDEA, пункт меню Предпочтения... если вы используете Mac
  • Нажмите на элемент дерева Лицензия, элемент дерева Профили лицензий
    • Нажмите кнопку импорта для импорта профиля Профиль лицензии
    • Выберите файл: Alfresco_Software.xml
  • Нажмите на элемент дерева Лицензия
    • Выборник По умолчанию проект лицензия: Alfresco Software

Часто задаваемые вопросы

• Почему вы не принимаете строки @author в ваших исходных файлах?

  • Потому что метки автора в Java файлах становятся настоящей проблемой обслуживания

    • Большая часть этих меток неверна, неполна или неточна.
    • В большинстве случаев они содержат только оригинального автора. Многие файлы полностью переформированы другими авторами.
    • Git является точной системой отслеживания версий, это канонический источник для получения информации об авторах.

  • Потому что метки автора способствуют собственности на код, что плохо в долгосрочной перспективе. - Если люди работают над тем, что они считают собственностью другого человека, они склонны:

    • исправлять только то, что было им назначено, вместо того чтобы исправлять всё сломанное
    • отказываться от ответственности, если этот код работает некорректно
    • бояться наступить на ноги владельца.
    • Благодарность авторам предоставляется:
    • с помощью Open Hub, который также предоставляет статистику
    • в веб-интерфейсе GitHub.# Разработочные команды

Добавление заголовка лицензии

Для форматирования файлов с требуемой лицензией:

mvn license:format

Checkstyle

Проверьте соответствие вашего стиля кодирования всем правилам:

mvn checkstyle:check -DskipCheckstyle=false

Сайт

Для генерации сайта Maven:

mvn clean site site:stage

Сайт будет создан по адресу: target/staging/index.html

CI/CD

Запуск через GH Actions.

Чтобы проверять зависимости для PRs от Dependabot, метка "CI" должна быть добавлена к PR.

Необходимо установить следующие секреты: