Activiti

Atividades

Página inicial: http://activiti.org

Activiti é uma plataforma leve de fluxo de trabalho e gerenciamento de processos de negócios (BPM) voltada para empresários, desenvolvedores e administradores de sistema. Seu núcleo é um mecanismo de processo BPMN 2 super-rápido e sólido para Java. É de código aberto e distribuído sob a licença Apache. O Activiti é executado em qualquer aplicação Java, em um servidor, em um cluster ou na nuvem. Integra-se perfeitamente com Spring, é extremamente leve e baseado em conceitos simples.

* *NOTA: Movemos para o branch master todo o conteúdo do branch de desenvolvimento que estávamos usando para projetar e codificar a próxima versão principal do projeto. Se você quiser contribuir com a versão 6.x, consulte o branch 6.x.**

Se você quiser ler mais sobre nossa estrutura de Repositórios você pode ler nosso GitBook.

Configurando o IntelliJ

• Forçar o nível 21 da linguagem a falhar rapidamente ao usar (acidentalmente) recursos disponíveis apenas em versões mais recentes do Java.

  • Abra o menu Arquivo , item de menu Estrutura do Projeto
  • Clique no item da lista Módulos , para cada módulo, guia Fontes , caixa de combinação O nível do idioma deve ser definido automaticamente como 21 ...

• Evite que alterações em alguns recursos sejam ignoradas na próxima execução/depuração (e você seja forçado a usar mvn)

  • Abra o menu Arquivo , item de menu Configurações ou menu IntelliJ IDEA , item de menu Preferências... se estiver em um Mac
  • Clique no item da árvore Compilador , campo de texto Padrões de recursos : mude para !?*.java (remova outro conteúdo)

• Evite um StackOverflowError ao construir

  • Abra o menu Arquivo , item de menu Configurações ou menu IntelliJ IDEA , item de menu Preferências... se estiver em um Mac
  • Clique no item da árvore Compilador , item da árvore Compilador Java , campo de texto Parâmetros adicionais da linha de comando
  • Adicionar -J-Xss1024k

• Estilo de código recomendado: use o Guia de estilo Java do Google com editorconfig

  • Baixe o xml de estilo de código do IntelliJ em: [https://google.github.io/styleguide/intellij-java-google-style.xml]
  • Abra o menu Arquivo , item de menu Configurações ou menu IntelliJ IDEA , item de menu Preferências... se estiver em um Mac
  • Clique no item da árvore Code Style , clique na roda dentada e selecione Importesquema e, em seguida, IntelliJ code style xml
  • Navegue onde você baixou o xml e abra-o. Verifique se GoogleStyle é o esquema ativo.
    • Observação: o IntelliJ IDEA não formata seu código automaticamente. Você deve pressionar a combinação de teclado Ctrl+Alt+L para acionar a formatação automática quando a codificação for concluída.
  • Existe um .editorconfig que tem definição para recuos, codificação de arquivos e finais de linha.
  • Se você desativá-lo, será necessário definir a codificação do arquivo e o número de espaços corretamente manualmente.
  • XML de estilo de código Eclipse: [https://google.github.io/styleguide/eclipse-java-google-style.xml]
  • O Eclipse precisa do plugin editorconfig-eclipse para suportar arquivos EditorConfig.

• Defina manualmente a codificação correta do arquivo (UTF-8, exceto para arquivos de propriedades) e caracteres de fim de linha (unix):

  • Abra o menu Arquivo , item de menu Configurações ou menu IntelliJ IDEA , item de menu Preferências... se estiver em um Mac
  • Clique no item da árvore Estilo de código , item da árvore Geral
    • Combobox Separador de linha (para novos arquivos) : Unix
  • Clique no item da árvore Codificações de arquivo
    • Codificação global da caixa de combinação: UTF-8
    • Codificação padrão do Combobox para arquivos de propriedades : ISO-8859-1
      • Nota: os arquivos de propriedades normais do i18n devem estar em ISO-8859-1 conforme especificado pelo contrato java ResourceBundle .

• Defina manualmente o número correto de espaços ao pressionar tab:

  • Abra o menu Arquivo , item de menu Configurações ou menu IntelliJ IDEA , item de menu Preferências... se estiver em um Mac
  • Clique no item da árvore Estilo de código , item da árvore Geral
  • Clique na aba Java
    • Caixa de seleção Usar caractere de tabulação : off
    • Tamanho da guia do campo de texto: 4
    • Recuo do campo de texto: 4
    • Recuo de continuação do campo de texto: 8
  • Abrir guia XML
    • Caixa de seleção Usar caractere de tabulação : off
    • Tamanho da guia do campo de texto: 2
    • Recuo do campo de texto: 2
    • Recuo de continuação do campo de texto: 4

• Defina os cabeçalhos de arquivo corretos (não inclua @author ou um javadoc sem sentido):

  • Abra o menu Arquivo , item de menu Configurações ou menu IntelliJ IDEA , item de menu Preferências... se estiver em um Mac
  • Clique no item da árvore Modelos de arquivo , guia Inclui , item da lista File Header
  • Remova a linha @author Seu Nome .
    • Não aceitamos linhas @author em arquivos fonte, veja as perguntas frequentes abaixo.
  • Remova todo o javadoc, pois os dados modelados automaticamente não fazem sentido.

• Defina o cabeçalho de licença correto

  • Abra o menu Arquivo , item de menu Configurações ou menu IntelliJ IDEA , item de menu Preferências... se estiver em um Mac
  • Clique no item da árvore Copyright , item da árvore Perfis de direitos autorais
    • Clique no botão importar para importar o perfil de direitos autorais
    • Selecione o arquivo: Alfresco_Software.xml
  • Clique no item da árvore Direitos autorais
    • Direitos autorais do projeto padrão do Combobox: Alfresco Software

Perguntas frequentes

• Por que você não aceita linhas @author em seu código-fonte?

  • Porque as tags do autor nos arquivos java são um pesadelo de manutenção

    • Uma grande percentagem está errada, incompleta ou imprecisa.
    • Na maioria das vezes, contém apenas o autor original. Muitos arquivos são completamente refatorados/expandidos por outros autores.
    • Git é preciso, essa é a fonte canônica para encontrar o autor correto.

  • Porque as tags do autor promovem a propriedade do código , o que é ruim no longo prazo.

    • Se as pessoas trabalham em uma peça que consideram propriedade de outra pessoa, elas tendem a:
      • consertar apenas o que eles foram designados para consertar, em vez de tudo que está quebrado
      • descarte a responsabilidade se esse código não funcionar corretamente
      • tenha medo de pisar nos pés do dono.

  • Os créditos aos autores são dados:

    • com Open Hub que também possui estatísticas
    • na interface da web do GitHub.

Comandos de desenvolvimento

Adicionar cabeçalho de licença

Para formatar arquivos com a licença necessária:

mvn license:format

Estilo de verificação

Para verificar se o seu estilo de código respeita todas as regras:

mvn checkstyle:check -DskipCheckstyle=false

Site

Para gerar o site maven:

mvn clean site site:stage

o site será gerado em: target/staging/index.html

CI/CD

Executando em ações GH.

Para que os PRs do Dependabot sejam validados pelo CI, o rótulo "CI" deve ser adicionado ao PR.

Requer que os seguintes segredos sejam definidos:

Nome	Descrição
BOT_GITHUB_TOKEN	Token para lançar outras compilações no GH
BOT_GITHUB_USERNAME	Nome de usuário para emitir PRs de propagação
NEXUS_USERNAME	Nome de usuário do repositório interno Maven
NEXUS_SENHA	Senha do repositório interno do Maven
SLACK_NOTIFICATION_BOT_TOKEN	Token para notificar folga em caso de falha