Você pode executar revisões de código em um workbench "headless"
(sem interface com o usuário para o ambiente de desenvolvimento) a partir de uma
interface de linha de comandos. As regras de revisão de código que são executadas no
código fonte são as que foram utilizadas por último na interface com o usuário. Se uma revisão de código nunca foi executada, as configurações padrão na página Revisão de Código das Preferências Java (a revisão de código Quick) serão executadas no código. Por padrão, após a execução da revisão do código, dois relatórios serão gerados: um relatório HTML e um relatório JSML (JScrib Markup Language).
Eles serão localizados na pasta de metadados do
espaço de trabalho na pasta com.ibm.r2a.command.line.mode. Você pode especificar o tipo
de relatório que é gerado e o local no qual o relatório aparece depois que a revisão de
código é executada.
Nota: Você pode executar revisões de código no modo headless apenas no espaço de
trabalho. Se você deseja analisar um subconjunto do espaço de trabalho, como um ou mais
projetos específicos, crie um espaço de trabalho com esses projetos e execute o revisão
de código nesse espaço de trabalho.
Antes de executar as revisões de código no
modo headless:
- O espaço de trabalho deve conter pelo menos um projeto com arquivos de origem Java.
- Se você desejar especificar as regras que são executadas, deve configurar a revisão
de código na interface com o usuário.
O ambiente de desenvolvimento não precisa estar em execução.
Não é possível
executar várias execuções de revisão de código no modo headless ao mesmo tempo no mesmo espaço de trabalho; também não é possível utilizar o modo headless enquanto uma interface gráfica com o usuário Eclipse tiver bloqueado o espaço de trabalho.
Nota: Devido às limitações do sistema operacional Windows, o comprimento da cadeia
utilizada para executar o modo de linha de comandos (C:\path\java.exe …) deve ser o mais curto possível
ou os parâmetros ao final da cadeia devem ser cortados e perdidos pelo sistema. Usuários do Windows devem utilizar as boas práticas a seguir
para obter os melhores resultados:
- A variável PATH deve incluir o máximo de caminhos possível, como por exemplo o caminho
Java e o caminho
dos arquivos JAR.
- O caminho ao espaço de trabalho deve ser o mais curto possível, por exemplo,
C:\workspace.
- O caminho até o local em que os relatórios são gerados também deve ser o mais curto
possível, por exemplo, C:\report.
Para executar revisões de código em um workbench headless, ativa-se o aplicativo no modo linha de comandos utilizando o comando
<dir_do_eclipse>/jre/bin/java <opções da máquina virtual> -cp <dir_do_eclipse>/startup.jar
org.eclipse.core.launcher.Main <opções do modo da linha de comandos> <opções do
eclipse>, juntamente com sua configuração do produto. A sua configuração do produto pode ser
localizada em .
<opções da máquina
virtual> estão localizadas sob a propriedade
eclipse.vmargs.
As opções principais do Eclipse estão localizadas sob a propriedade
eclipse.commands,
onde você poderá incluir o caminho do espaço de trabalho utilizando o token
-data do Eclipse.
<opções do modo da linha de comandos> refere-se a opções do modo da linha de comandos.
Nota: Pode ser necessário anexar parâmetros adicionais aos comandos nas etapas a seguir, dependendo da configuração de seu sistemas operacional. Os parâmetros estão localizados nos detalhes da configuração do sistema sob "Propriedades do Sistema".