Exercício 1.3: Definindo uma Regra de Controle de Arquitetura
Este exercício assume que você tenha concluído o Exercício 1.1: Importando os Recursos Obrigatórios. No Exercício 1.3, você lê primeiro um cenário do usuário. Em seguida, você assume a função de engenheiro de software, descrita no cenário do usuário, e utiliza o projeto importado no Exercício 1.1 para concluir o exercício.
Cenário do Usuário
Para evitar dependências externas, o engenheiro desejar colocar uma proteção para garantir que nada seja introduzido no aplicativo. Para fazer isso, ele cria uma regra a partir de um assistente fornecido. A regra é para alertá-lo se o pacote de utilitário tornar-se dependente do pacote de aplicativos.
Depois de criar a regra, o engenheiro executa uma revisão de código aplicando-a ao código base. As descobertas mostrarão quaisquer dependências externas no aplicativo.
Exercício
Neste exercício, execute as seguintes tarefas:
- Defina uma regra com base no assistente fornecido.
- Verifique se a regra definida pelo usuário está incluída na revisão de código de Análise Estrutural.
- Execute a revisão de código de Análise Estrutural.
- Visualize as descobertas da revisão de código que não aderiram aos critérios da sua regra.
Definindo uma Regra
Para definir uma regra de controle de arquitetura com base no assistente fornecido:
- Na barra de ferramentas, na visualização Revisão de Código, clique no ícone Gerenciar Regras,
.

- Na janela Preferências, clique em Nova Regra. O assistente Nova Regra de Revisão de Código é aberto.
O assistente Nova Regra de Revisão de Código, como mostrado na seguinte captura de tela, o orienta em algumas etapas para definir sua própria regra. Neste exercício, você irá projetar uma regra de controle de arquitetura para alertá-lo se uma dependência for introduzida entre os dois componentes.
- Na lista de regras Controle de Arquitetura, clique em Componente [dependência] introduzida. Note que ao selecionar essa opção, o texto abaixo da lista o orienta a utilizar esse gabarito para cancelar a permissão de uma dependência entre dois componentes.
Clique em Avançar.

- Em Propriedades Básicas, aceite os padrões que colocam a regra na categoria de análise estrutural, com um nível de gravidade de problema.

- Em Propriedades Específicas, especifique os componentes independente e dependentes para a regra:
- Componente Independente: workspace\StructuralAnalysis\src\com.ibm.r2a.rules.rsa.examples.architecturalcontrol\IndependentComponent.java
- Componente Dependente: workspace\StructuralAnalysis\src\com.ibm.r2a.rules.rsa.examples.architecturalcontrol\DependentComponent.java.
- Clique em Concluir.
Visualizando sua Regra Incluída em uma Revisão de Código
- Depois de definir uma regra, a janela Preferências é exibida. Na lista Selecionar Revisão de Código, clique em Concluir Revisão de Código se ela ainda não for a revisão de código selecionada. Isso mostra todas as categorias de revisão de código.
- Expanda a pasta Análise Estrutural para ver a regra que acabou de criar.
- Clique na regra para ver as propriedades definidas para ela, como mostrado na seguinte captura de tela:

Selecionando uma Revisão de Código que Aplique Apenas a sua Regra
Para executar uma revisão de código apenas para a sua regra, limpe todas as pastas na lista, exceto a pasta Análise Estrutural, conforme mostrado na captura de tela anterior. Clique em OK.
Selecionando um Código Base a Ser Revisado
Para selecionar o espaço de trabalho como o código base a ser revisado:
- Na barra de ferramentas, na visualização Revisão de Código, clique no ícone Revisar (
) > Revisar Espaço de Trabalho.
Executando a Revisão de Código
Depois de selecionar o código base a ser revisado, a revisão de código é executada. Você pode controlar o status verificando a barra de progresso no canto inferior direito da visualização.
Visualizando as Descobertas da Revisão de Código
Quando a revisão de código é concluída, as descobertas são mostradas na visualização Revisão de Código, conforme mostrado na seguinte captura de tela. Abaixo da guia, a linha de estatística resume a revisão.

- Expanda a pasta Análise Estrutural para ver as descobertas presentes.

- Clique duas vezes na terceira descoberta para ver o respectivo código fonte no editor, conforme mostrado na seguinte captura de tela:

Você concluiu o Exercício 1.3: Definindo uma regra de controle de arquitetura.
Alavancando o Poder das Regras Definidas pelo Usuário
Criando as suas próprias regras, você pode personalizar a proteção para monitorar a implementação do design. Você pode tomar as seguintes medidas:
- Especifique os critérios para uma regra.
- Designe um nível de gravidade para a regra: problema, aviso ou recomendação.
- Execute uma revisão de código apenas na(s) sua(s) regra(s).
Agrupando o Exercício 1.3
Você concluiu o Exercício 2: Definindo uma regra de controle de arquitetura. Nele você executou as seguintes tarefas:
- Definiu uma regra com base em um assistente fornecido.
- Verificou se a regra definida pelo usuário foi incluída na revisão de código de Análise Estrutural.
- Executou a revisão de código de Análise Estrutural.
- Visualizou as descobertas de revisão de código que não aderem aos critérios da sua regra.
Agora, você está pronto para começar o Exercício 1.4: Resolvendo um Problema Estrutural.