Activiti

Деятельность

Домашняя страница: http://activiti.org

Activiti — это упрощенный рабочий процесс и платформа управления бизнес-процессами (BPM), предназначенная для деловых людей, разработчиков и системных администраторов. Его ядром является сверхбыстрый и надежный механизм процессов BPMN 2 для Java. Он имеет открытый исходный код и распространяется по лицензии Apache. Activiti работает в любом приложении Java, на сервере, в кластере или в облаке. Он прекрасно интегрируется со Spring, чрезвычайно легок и основан на простых концепциях.

* *ПРИМЕЧАНИЕ. Мы переместили в главную ветку все содержимое ветки разработки, которое мы использовали для разработки и написания кода следующей основной версии проекта. Если вы хотите внести свой вклад в версию 6.x, просмотрите ветку 6.x.**

Если вы хотите узнать больше о структуре наших репозиториев, вы можете прочитать нашу GitBook.

Настройка IntelliJ

• Принудительно установить уровень языка 21 для быстрого отказа при (случайном) использовании функций, доступных только в более новых версиях Java.

  • Открыть меню Файл , пункт меню Структура проекта.
  • Щелкните элемент списка «Модули» , для каждого модуля, вкладку « Источники» , поле со списком. Уровень языка должен быть автоматически установлен на 21 ...

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

  • Откройте меню Файл , пункт меню Настройки или меню IntelliJ IDEA , пункт меню Настройки... если на Mac
  • Щелкните элемент дерева «Компилятор» , текстовое поле « Шаблоны ресурсов »: измените на !?*.java (удалить другое содержимое).

• Избегайте StackOverflowError при построении

  • Откройте меню Файл , пункт меню Настройки или меню IntelliJ IDEA , пункт меню Настройки... если на Mac
  • Щелкните элемент дерева «Компилятор» , элемент дерева «Компилятор Java» , текстовое поле «Дополнительные параметры командной строки».
  • Добавьте -J-Xss1024k

• Рекомендуемый стиль кода: используйте Руководство по стилю Google Java с editorconfig.

  • Загрузите XML-код стиля кода IntelliJ по адресу: [https://google.github.io/styleguide/intellij-java-google-style.xml]
  • Откройте меню Файл , пункт меню Настройки или меню IntelliJ IDEA , пункт меню Настройки... если на Mac
  • Щелкните элемент дерева «Стиль кода» , нажмите «шестеренка» и выберите «Импортировать схему» , затем «Стиль кода IntelliJ 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, за исключением файлов свойств) и символы конца строки (unix):

  • Откройте меню Файл , пункт меню Настройки или меню IntelliJ IDEA , пункт меню Настройки... если на Mac
  • Щелкните элемент дерева «Стиль кода» , элемент дерева «Общие».
    • Разделитель строк Combobox (для новых файлов) : Unix
  • Щелкните элемент дерева «Кодировки файлов».
    • Глобальная кодировка Combobox: UTF-8
    • Кодировка Combobox по умолчанию для файлов свойств : ISO-8859-1
      • Примечание. Обычные файлы свойств i18n должны быть в ISO-8859-1 как указано в контракте Java ResourceBundle .

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

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

• Установите правильные заголовки файлов (не включайте @author или бессмысленный javadoc):

  • Откройте меню Файл , пункт меню Настройки или меню IntelliJ IDEA , пункт меню Настройки... если на Mac
  • Щелкните элемент дерева «Шаблоны файлов» , вкладку « Включает» и элемент списка File Header .
  • Удалите строку @author Ваше имя .
    • Мы не принимаем строки @author в исходных файлах, см. FAQ ниже.
  • Удалите весь Javadoc, поскольку автоматически шаблонные данные бессмысленны.

• Установите правильный заголовок лицензии

  • Откройте меню Файл , пункт меню Настройки или меню IntelliJ IDEA , пункт меню Настройки... если на Mac
  • Щелкните элемент дерева Авторские права , элемент дерева Профили авторских прав
    • Нажмите кнопку импорта, чтобы импортировать профиль авторских прав.
    • Выберите файл: Alfresco_Software.xml.
  • Щелкните элемент дерева Авторские права
    • Combobox Авторские права проекта по умолчанию : Alfresco Software

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

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

  • Потому что теги автора в файлах Java — это кошмар для обслуживания.

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

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

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

  • Авторам отдается должное:

    • с Open Hub, который также имеет статистику
    • в веб-интерфейсе GitHub.

Команды разработки

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

Чтобы отформатировать файлы с необходимой лицензией:

mvn license:format

Чекстиль

Чтобы проверить, соответствует ли ваш стиль кода всем правилам:

mvn checkstyle:check -DskipCheckstyle=false

Сайт

Чтобы создать сайт maven:

mvn clean site site:stage

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

CI/CD

Запуск на GH Actions.

Чтобы запросы Dependabot были подтверждены CI, к PR необходимо добавить метку «CI».

Требуется установить следующие секреты:

Имя	Описание
BOT_GITHUB_TOKEN	Токен для запуска других сборок на GH
BOT_GITHUB_USERNAME	Имя пользователя для отправки PR на распространение
NEXUS_USERNAME	Имя пользователя внутреннего репозитория Maven
NEXUS_ПАРОЛЬ	Пароль внутреннего репозитория Maven
SLACK_NOTIFICATION_BOT_TOKEN	Токен для уведомления Slack о сбое