Utilizando o Compilador de Lotes

Localizando o Compilador de Lotes

A classe do compilador de lotes está localizada no plug-in Núcleo JDT. O nome da classe é org.eclipse.jdt.compiler.batch.BatchCompiler. Ele é empacotado em plugins/org.eclipse.jdt.core_<version>.jar. Desde o 3.2, ele também está disponível como um download separado. O nome do arquivo é ecj.jar. Sua origem correspondente também está disponível. Para obtê-los, vá para a página de download e procure pela seção Compilador de Lotes de Núcleo do JDT. Esse jar contém o compilador de lotes e o adaptador ant javac.

Desde o 3.3, esse jar também contém o suporte para jsr199 (API do Compilador) e o suporte para jsr269 (Processamento de Anotação).Para utilizar o suporte de processamento de anotação, uma VM 1.6 é necessária.

Portanto, ele pode ser utilizado como um aplicativo independente e dentro de um build de Ant, fora do Eclipse.

Executando o Compilador de Lotes

Quais Opções Estão Disponíveis?

As opções recomendadas têm um plano de fundo laranja.

Quando algumas opções estiverem sendo configuradas várias vezes, o compilador de lotes as consumirá da esquerda para direita. Quando a opção de aviso (-warn:....) for usada sem '+' ou '-', ela substituirá o conjunto de avisos anteriormente especificado. Assim, o usuário deve certificar-se de que esse tipo de opção seja fornecida antes de qualquer outro uso da opção -warn.

O mesmo se aplica para a opção -err:.

Nome Uso
Opções de caminhos de classes
-bootclasspath <dir 1>;<dir 2>;...;<dir P> Esta é uma lista de diretórios ou arquivos jar utilizados para auto-inicialização dos arquivos de classe utilizados pelo compilador. Por padrão, as bibliotecas do VM em execução são utilizadas. As entradas são separadas pelo separador de caminhos da plataforma.
Cada diretório ou arquivo pode especificar regras de acesso para tipos entre '[' e ']'.

Se nenhum bootclasspath for especificado, o compilador irá pressupô-lo utilizando as seguintes propriedades do sistema sun.boot.class.path, vm.boot.class.path e org.apache.harmony.boot.class.path nessa ordem respectivamente.

-cp
-classpath <dir 1>;<dir 2>;...;<dir P>
Esta é uma lista de diretórios ou arquivos jar utilizados para compilar os arquivos de origem. O valor padrão é o valor da propriedade "java.class.path". As entradas são separadas pelo separador de caminhos da plataforma.
Cada diretório ou arquivo pode especificar regras de acesso para tipos entre '[' e ']' (por ex., [-X] para proibir acesso ao tipo X, [~X] para desestimular acesso ao tipo X, [+p/X:-p/*] para proibir acesso a todos os tipos no pacote p, mas permitir acesso a p/X).
O compilador segue a cláusula Class-Path de manifestos de arquivos jar recursivamente e anexa cada arquivo jar referenciado no final do caminho da classe, desde que ele ainda não esteja no caminho da classe.
-extdirs <dir 1>;<dir 2>;...;<dir P> Esta é uma lista de diretórios utilizados para especificar o local de arquivos de extensão zip/jar. As entradas são separadas pelo separador de caminhos da plataforma.
-endorseddirs <dir 1>;<dir 2>;...;<dir P> Esta é uma lista de diretórios utilizados para especificar o local de arquivos endossados zip/jar. As entradas são separadas pelo separador de caminhos da plataforma.
-sourcepath <dir 1>;<dir 2>;...;<dir P> Esta é uma lista de diretórios utilizados para especificar os arquivos de origem. As entradas são separadas pelo separador de caminhos da plataforma.
Cada diretório pode especificar regras de acesso para tipos entre '[' e ']'.
-d <dir 1>|none Isso é utilizado para especificar em qual diretório os arquivos .class gerados devem ser despejados. Se ele for omitido, nenhuma estrutura de diretório do pacote será criada.
Se você não desejar gerar nenhum arquivo .class, utilize -d none.
-encoding <nome da codificação> Especifique a codificação padrão de todos os arquivos de origem. A codificação customizada também pode ser especificada em uma base por arquivo incluindo em cada nome de arquivo/pasta de origem de entrada um sufixo com [<nome da codificação>]). Por exemplo, X.java[utf8] especificará a codificação UTF-8 para a unidade de compilação X.java, localizada no diretório de usuário atual.

Se várias codificações padrão de arquivo de origem forem especificadas, a última será usada.

Exemplo:

  • ... -encoding UTF-8 X.java[Cp1252] Y.java[UTF-16] Z.java ....
    Todos os arquivos de origem serão lidos usando a codificação UTF-8 (isso inclui Z.java). X.java será lido usando a codificação Cp1252 e Y.java será lido usando a codificação UTF-16.
  • ... -encoding UTF-8 -encoding UTF-16 ....
    Todos os arquivos de origem serão lidos usando a codificação UTF-16. A opção -encoding para UTF-8 é ignorada.
  • ... -encoding Cp1252 /foo/bar/X.java[UTF-16] /foo/bar[UTF-8] ....
    Todos os arquivos de origem serão lidos usando a codificação Cp1252. X.java é o único arquivo dentro do diretório /foo/bar que será lido usando a codificação UTF-16. Todos os outros arquivos nesse diretório usarão a codificação UTF-8.
Opções de Conformidade
-target 1.1 a 1.7 ou (5, 5.0, etc) Isso especifica a configuração de destino do arquivo .class. O valor possível é:
  • 1.1 (versão principal: 45 secundária: 3)
  • 1.2 (versão principal: 46 secundária: 0)
  • 1.3 (versão principal: 47 secundária: 0)
  • 1.4 (versão principal: 48 secundária: 0)
  • 1.5, 5 ou 5.0 (versão principal: 49 secundária: 0)
  • 1.6, 6 ou 6.0 (versão principal: 50 secundária: 0)
  • 1.7, 7 ou 7.0 (versão principal: 51 secundária: 0)
Os padrões são:
  • 1.1 no modo -1.3
  • 1.2 no modo -1.4
  • 1.5 no modo -1.5
  • 1.6 no modo -1.6
  • 1.7 no modo -1.7

clcd1.1 pode ser usado para gerar o atributo StackMap.

-1.3 Configure o nível de conformidade como 1.3. -origem 1.3 -destino 1.1 implícitos.
-1.4 Configure o nível de conformidade 1.4 (padrão). -origem 1.3 -destino 1.2 implícitos.
-1.5 Configure o nível de conformidade como 1.5. -origem 1.5 -target 1.5 implícitos.
-1.6 Configure o nível de conformidade como 1.6. Implícito -source 1.6 -target 1.6.
-1.7 Defina o nível de conformidade como 1.7. Implícito -source 1.7 -target 1.7.
-source 1.1 a 1.7 ou (5, 5.0, etc) Utilizado para especificar o nível de origem esperado pelo compilador.
O valor possível é:
  • 1.3
  • 1.4
  • 1.5, 5 ou 5.0
  • 1.6, 6 ou 6.0
  • 1.7, 7 ou 7.0
Os padrões são:
  • 1.3 no modo -1.3
  • 1.3 no modo -1.4
  • 1.5 no modo -1.5
  • 1.6 no modo -1.6
  • 1.7 no modo -1.7
No 1.4, assert é tratado como uma palavra-chave. No 1.5 e 1.6, enum e assert são tratados como palavras-chave.
Opções de Aviso
-?:warn -help:warn Exibe opções de aviso avançadas
-warn:... Especifique o conjunto de avisos ativados.
Por exemplo, -warn:unusedLocal,deprecation
-warn:none desativa todos os avisos
-warn:<warning tokens separated by ,> ativa exatamente os avisos listados
-warn:+<warning tokens separated by ,> ativa avisos adicionais
-warn:-<warning tokens separated by ,> desativa avisos específicos
Na coluna Padrão abaixo, um sinal "+/-" indica que uma opção cobre diversas variantes de aviso de baixa granularidade, sendo que, alguns são ativados e outros desativados, por padrão. Isso significa que a especificação da opção fornecida com "+" ativará mais avisos do que o padrão e a especificação com "-" desativará alguns que são ativados por padrão.
Padrão Nome do Token Descrição
+/- allDeadCode código inativo, incluindo a verificação trivial if(DEBUG)
+/- allDeprecation substituição mesmo dentro do código substituído
- allJavadoc javadoc inválido ou ausente
- allOver-ann todas as anotações @Override ausentes (superclasse e superinterfaces)
- all-static-method o método todo pode ser declarado como avisos estáticos
+ assertIdentifier ocorrência de assert utilizada como identificador
- boxing conversão do autoboxing
+ charConcat quando uma matriz de caracteres é utilizada em uma concatenação de cadeia sem estar convertida explicitamente para uma cadeia
+ compareIdentical comparando expressões idênticas
- conditionAssign possível designação do booleano acidental
+ constructorName método com nome de construtor
+ deadCode código inativo, excluindo a verificação trivial if(DEBUG)
- dep-ann anotação do @Deprecated ausente
+/- deprecation o uso de tipo ou membro substituído fora do código substituído
+ discouraged o uso de tipos correspondentes a uma regra de acesso desestimulada
- emptyBlock bloco vazio não documentado
+ enumIdentifier ocorrência de enum usada como identificador
+ enumSwitch comutador enum incompleto
- enumSwitchPedantic casos de comutação numérica ausente no relatório mesmo na presença de um caso padrão
- fallthrough possível caso de fall-through
- fieldHiding campo ocultando outra variável
+ finalBound parâmetro type com limite final
+ finally bloco finally não é concluído de modo normal
+ forbidden o uso de tipos correspondentes a uma regra de acesso proibida
- hashCode método hashCode() ausente ao substituir equals()
+/- hiding macro para fieldHiding, localHiding, typeHiding e maskedCatchBlock
- includeAssertNull aumenta os avisos de nulo para variáveis que ficaram contaminadas em uma expressão de asserção
- indirectStatic referência indireta para membro estático
+ intfAnnotation tipo de anotação utilizada como super interface
+ intfNonInherited compatibilidade de método não-herdado da interface
- intfRedundant localizar superinterfaces redundantes
- javadoc javadoc inválido
- localHiding variável local ocultando outra variável
+ maskedCatchBlock bloco catch oculto
- nls literais de cadeia não-nls (falta de tags //$NON-NLS-<n>)
+ noEffectAssign designação sem efeito
+/- null verificação nula possivelmente ausente ou redundante
- nullAnnot ativar análise de nulo baseada em anotação.
Se desejado, os tipos de anotação a serem interpretados pelo compilador podem ser especificados ao anexar (nullable|nonnull|nonnullbydefault), sendo que cada tipo de anotação é especificado usando esse nome completo.
Consulte também -nonNullByDefault abaixo.
- nullDereference verificação nula ausente
- over-ann anotação @Override ausente (apenas superclasse)
- paramAssign designação a um parâmetro
+ pkgDefaultMethod tentativa de substituir método de pacote padrão
+ raw uso de um tipo não formatado (em vez de um tipo parametrizado)
+/- recurso (potencialmente) uso não seguro de recurso do tipo Fechável
- semicolon semicolon desnecessário ou instrução vazia
+ serial serialVersionUID ausente
- specialParamHiding parâmetro construtor ou definidor ocultando outro campo
+/- static-access macro para indirectStatic e staticReceiver
- static-method um método de instância que poderia ser como um método estático
+ staticReceiver se um receptor não estático for utilizado para obter um campo estático ou chamar um método estático
- super substituindo um método sem fazer uma superchamada
+ suppress ativar @SuppressWarnings
- switchDefault instrução de comutação que necessita de um caso padrão
- syncOverride sincronizado ausente na substituição do método sincronizado
- syntheticAccess quando executar acesso sintético para innerclass
- tasks ative suporte para tags de tarefas no código fonte
+ typeHiding parâmetro type ocultando outro tipo
+ unavoidableGenericProblems ignorar problemas de segurança de tipo inevitável devido a APIs brutas
+ unchecked operação de tipo desmarcada
- unnecessaryElse desnecessária cláusula else
- unqualifiedField referência não qualificada para campo
+/- unused macro para unusedAllocation, unusedArgument, unusedImport, unusedLabel, unusedLocal, unusedPrivate, unusedThrown e unusedTypeArgs
- unusedAllocation alocação de um objeto que não é usado
- unusedArgument argumento de método não utilizado
+ unusedImport referência de importação não utilizada
+ unusedLabel rótulo não utilizado
+ unusedLocal variável local não utilizada
+ unusedPrivate declaração de membro privado não utilizada
- unusedThrown exceção emitida declarada não utilizada
+ unusedTypeArgs argumentos de tipo não usados para método e construtor
- uselessTypeCheck operação de coerção/instância desnecessária
+ varargsCast argumento varargs precisa de coerção explícita
+/- warningToken token de aviso não manipulado ou não usado em @SuppressWarnings
-nowarn Nenhum aviso (equivalente a -warn:none)
-err:... Especifique o conjunto de avisos ativados que são convertidos em erros.
ex. -err:unusedLocal,deprecation
os avisos unusedLocal e deprecation serão convertidos em erros. Todos os outros avisos ainda serão relatados como avisos.
-err:<warning tokens separated by ,> converte exatamente os avisos listados em erros
-err:+<warning tokens separated by ,> converte avisos adicionais em erros
-err:-<warning tokens separated by ,> remove avisos específicos da conversão em erros
-deprecation Equivalente a -warn:+deprecation.
-properties <arquivo> Configura a opção avisos/erros com base no conteúdo do arquivo de propriedades. Essa opção pode ser usada com as opções -nowarn, -err:.. ou -warn:.. mas a última na linha de comandos configura as opções a serem usadas.

O conteúdo do arquivo de propriedades pode ser gerado ao definir configurações específicas do projeto em um projeto java existente e ao usar o arquivo no arquivo .settings/org.eclipse.jdt.core.prefs, como um arquivo de propriedades, ou um arquivo de texto simples definido por pares de entrada/valor usando as constantes definidas na classe org.eclipse.jdt.core.JavaCore.

... org.eclipse.jdt.core.compiler.problem.annotationSuperInterface=warning
org.eclipse.jdt.core.compiler.problem.assertIdentifier=warning org.eclipse.jdt.core.compiler.problem.autoboxing=ignore ...
Opções de Depuração
-g[:none|:lines,vars,source] Configure o nível de atributos de depuração
-g Todas as informações sobre depuração (equivalente a -g:lines,vars,source)
-g:none Nenhuma informação sobre depuração
-g:[lines,vars,source] informações de depuração seletiva
-preserveAllLocals Explicitamente peça ao compilador para preservar todas as variáveis locais (para fins de depuração). Se omitido, o compilador removerá os locais não utilizados.
Opções de Processamento de Anotação (exigem uma VM 1.6 ou acima e serão utilizadas apenas se a conformidade for 1.6)
-Akey[=value] Opções de processadores de anotação que são transmitidas aos processadores de anotação. key é composto de identificadores separados por pontos
-proc:[only|none] Se -proc:only for especificado, os processadores de anotação serão executados, mas nenhuma compilação será efetuada. Se -proc:none for especificado, os processadores de anotação não serão descobertos ou executados; a compilação prosseguirá como se nenhum processador de anotação fosse encontrado. Por padrão, o compilador deve procurar o caminho de classe para processadores de anotação; assim, a especificação de -proc:none talvez acelere a compilação se o processamento de anotação não for necessário.
-processor <class1[,class2,...]> Nomes de classe qualificados de processadores de anotação a serem executados. Se especificados, o processo de descoberta do processador normal será ignorado.
-processorpath <dir 1>;<dir 2>;...;<dir P> Uma lista de diretórios ou arquivos jar nos quais serão procurados processadores de anotação. As entradas são separadas pelo separador de caminhos da plataforma. Se não especificadas, o caminho de classe será procurado em seu lugar.
-s <dir> O diretório onde os arquivos de origem gerados serão criados.
-XprintProcessorInfo Imprimir informações sobre quais anotações e elementos um processador é solicitado a processar
-XprintRounds Imprimir informações sobre sucessões de processamentos de anotação
-classNames <class1[,class2,...]> Nomes qualificados de tipos de binário que precisam ser processados
Opções Ignoradas (para Compatibilidade com Opções javac)
-J<opção> Transmitir a opção à máquina virtual
-X<opção> Especifique opção não padrão. -Xemacs não é ignorado.
-X Imprimir opções não padrão e sair
-O Otimizar para tempo de execução
Opções Avançadas
@<arquivo> Mostre os argumentos da linha de comandos a partir do arquivo
-maxProblems <n> Número máximo de problemas por unidade de compilação (100 por padrão)
-log <nome do arquivo> Especifique um arquivo de registros no qual todas as saídas do compilador serão despejadas. Isso será realmente útil se você desejar depurar o compilador de lotes ou obter um arquivo que contenha todos os erros e avisos de uma construção em lote. Se a extensão for .xml, o log gerado será um arquivo xml.
-Xemacs Utilize o estilo emacs para apresentar locais de erros e avisos nos registros de texto comum e do console. Os registros XML não são afetados por essa opção. Com essa opção ativa, a mensagem:
2. AVISO em /workspace/X.java
(na linha 8)...

é apresentada como:
/workspace/X.java:8: aviso: O método...
-proceedOnError[:Fatal] Manter a compilação apesar dos erros, efetuando dump de arquivos de classe com métodos de problemas ou tipos de problemas. Será recomendável apenas se você puder executar o aplicativo mesmo se tiver erros restantes.
Com ":Fatal", se um erro for obtido no tempo de execução, todos os erros opcionais serão tratados como fatais e isso levará à interrupção do código. Sem ":Fatal", erros opcionais não impedirão a geração do código correto e os arquivos .class produzidos poderão ser executados sem um problema.
-verbose Imprima unidades de compilação acessadas/processadas no console ou no arquivo de registros, se especificado.
-referenceInfo Compute informações sobre referência. Isso será útil apenas se estiver conectado com o construtor. Caso contrário, as informações sobre referência serão inúteis.
-progress Mostrar progresso (apenas no modo -log).
-time Exibir informações de velocidade.
-noExit Não chamar System.exit(n) no final da compilação (n=0 se não houver nenhum erro).
-repeat <n> Repita as vezes do processo de compilação do <n> (análise de desempenho).
-inlineJSR Bytecode JSR seqüencial (implícito se o destino >= 1.5).
-enableJavadoc Considerar referências no javadoc.
-missingNullDefault Quando a análise de nulo baseada em anotação estiver ativada (usando "nullAnnot", acima), essa opção criará um aviso sempre que não houver uma anotação padrão em um pacote ou um tipo.
Opções de Ajuda
-? -help Exibe a mensagem de ajuda.
-v -version Exiba o número da compilação do compilador. Isso é muito útil para relatar um erro.
-showversion Exiba o número da compilação do compilador e continue. Isso é muito útil para relatar um erro.

Exemplos

d:\temp -classpath rt.jar -time -g -d d:/tmp Ele compila todos os arquivos de origem no d:\temp e suas subpastas. O caminho de classe é simplesmente rt.jar. Ele gera todos os atributos de depuração e todos os arquivos .class são despejados em d:\tmp. A velocidade do compilador será exibida quando o processo de batch for concluído.
d:\temp\Test.java -classpath d:\temp;rt.jar -g:none Ele compila apenas o Test.java e seus arquivos dependentes, se houver algum, recuperando os arquivos dependentes do d:\temp. O caminho de classe é d:\temp seguido por rt.jar, o que significa que todas as classes necessárias são procuradas primeiramente no d:\temp e, depois, no rt.jar. Não gera atributos de depuração e efetua dump de todos os arquivos .class gerados em d:\temp.