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.
java -jar org.eclipse.jdt.core_<version>.jar -classpath rt.jar A.java
ou:
java -jar ecj.jar -classpath rt.jar A.java
compile(String commandLine, PrintWriter
outWriter, PrintWriter errWriter, CompilationProgress progress)
estático da classe BatchCompiler.
org.eclipse.jdt.compiler.CompilationProgress progress = null; // instanciar sua subclasse org.eclipse.jdt.internal.compiler.batch.BatchCompiler.compile( "-classpath rt.jar A.java", new PrintWriter(System.out), new PrintWriter(System.err), progress);
É possível controlar como o progresso é relatado ou como o compilador de lotes é cancelado, através da subclassificação da classe org.eclipse.jdt.compiler.CompilationProgress.
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 |
||||||||||||||
| -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:
|
||||||||||||||
| 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 é:
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 é:
|
||||||||||||||
| 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
|
||||||||||||||
| 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.
|
||||||||||||||
| -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 ... 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
|
||||||||||||||
| -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é 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. | ||||||||||||||
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. |