Quando você escolhe o código base no qual executar uma revisão de código, o código
deve atender a determinados pré-requisitos; o mais importante, todos os arquivos no código base
devem ser compiláveis quando você executar a revisão.
Observe os seguintes pré-requisitos ao executar uma revisão de código e os problemas
que poderão ocorrer se não forem atendidos:
- O código deve ser compilável. A execução da revisão de código em código não compilável
pode causar resultados parciais, inconsistentes e, às vezes, errados.
- Não deve haver problemas de codificação. Se um projeto não for legível por apresentar
problemas de codificação e, portanto, não poder ser executado em seções não compiláveis,
a revisão de código não funcionará.
- As configurações de codificação devem estar corretas. Configurações de codificação erradas podem produzir
resultados semelhantes à execução da revisão de código em código não compilável.
Os pré-requisitos a seguir aplicam-se somente à revisão de código J2EE Best Practices
(Boas Práticas do J2EE):
- Os projetos dinâmicos da Web do J2EE devem ser compilados. Isso permite que todas as regras
na revisão de código J2EE Best Practices sejam ativadas.
- Se você migrar código de um espaço de trabalho WSAD (WebSphere Studio Application Developer),
será necessário definir manualmente o servidor. Clique com o botão direito do mouse no projeto
e, em seguida, clique em Properties (Propriedades) > Server (Servidor).
Advertências
Depois que você atender aos pré-requisitos e estiver pronto para executar uma revisão de código,
serão aplicadas algumas advertências em determinadas situações.
Executando uma revisão de código Structural Analysis (Análise Estrutural): Quando você
executa uma revisão de código Structural Analysis, é necessário executar a revisão no espaço de trabalho.
Isso assegura que o código em cada projeto seja revisto para completar a
análise estrutural.
Evitando vários arquivos com o mesmo caminho Java: Quando você executa determinadas
revisões de código no espaço de trabalho, a revisão não abrangerá vários arquivos com
o mesmo caminho Java mesmo que estejam em projetos diferentes. Esse comportamento
aplica-se a revisões de código ou regras que requerem processamento intenso do sistema:
- Revisão de código Structural Analysis (Análise Estrutural)
- Revisão de código J2EE Best Practices (Boas Práticas do J2EE)
- Revisão de código Complete (Completa)
- Regras do Architectural Control (Controle Arquitetural) que você cria
Conseqüentemente, é melhor evitar que vários arquivos tenham o mesmo caminho
Java.
Exemplo: Suponha que o espaço de trabalho contenha o projeto RED_Examples
e o projeto BLUE_Examples. Ambos contêm o pacote Color (Cor) que
inclui o arquivo bright.java. Quando você executa uma revisão de código no espaço de trabalho,
a revisão abrange somente um arquivo bright.java. Você poderá rever o código nos dois
arquivos renomeando-os e colocando-os em caminhos diferentes, por exemplo,
brightr.java e brightb.java.
Se o espaço de trabalho tiver vários arquivos com o mesmo caminho Java, você
poderá executar uma revisão de código que abranja os vários arquivos, configurando o espaço de trabalho
da seguinte maneira:
- Particione o espaço de trabalho para que não haja dois arquivos com o mesmo caminho
em um espaço de trabalho.
- Carregue um espaço de trabalho de cada vez.
- Execute uma revisão de código separada em cada espaço de trabalho.