A classe do compilador de agrupamentos está localizada no plug-in JDT Core. O nome da classe é org.eclipse.jdt.compiler.batch.BatchCompiler. É incluída no pacote com
plugins/org.eclipse.jdt.core_<version>.jar. Desde o 3.2, está igualmente disponível como uma transferência individual. O nome do ficheiro é ecj.jar. A origem respectiva está igualmente disponível. Para obter o nome e a origem, aceda à página de transferências e
procure a secção JDT Core Batch Compiler. Este jar contém o compilador de agrupamento e o javac ant adapter.
Desde o 3.3, este jar contém também o suporte para jsr199 (Compilador API) e o suporte para jsr269 (Processamento de anotação). De forma a utilizar este suporte de processamento de anotação, é necessário um 1.6 VM.
Pode, assim, ser utilizado como uma aplicação autónoma, no interior de uma construção Ant fora do Eclipse.
java -jar org.eclipse.jdt.core_<versão>.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) da classe BatchCompiler.
org.eclipse.jdt.compiler.CompilationProgress progress = null; // instancie a sua subclasse org.eclipse.jdt.internal.compiler.batch.BatchCompiler.compile( "-classpath rt.jar A.java", new PrintWriter(System.out), new PrintWriter(System.err), progress);
Pode controlar a forma como o progresso é registado, ou como o compilador de lotes é cancelado, criando uma subclasse da classe org.eclipse.jdt.compiler.CompilationProgress.
As opções recomendadas têm um fundo cor de laranja.
Quando algumas opções estiverem a ser definidas várias vezes, o compilador de conjuntos consome-os da esquerda para a direita. Quando a opção de aviso (-warn:....) for utilizada sem '+' ou '-', isto substitui o conjunto de avisos previamente especificado. Por isso, o utilizar deverá certificar-se de que essa opção é incluída antes de qualquer outra utilização da opção -warn.
O mesmo se aplica à opção -err:.
| Nome | Utilização | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Opções de caminho de classes | |||||||||||||||
| -bootclasspath <dir 1>;<dir 2>;...;<dir P> | Esta é uma lista de directórios de ficheiros jar utilizados para dar instruções de arranque aos ficheiros de classe utilizados pelo compilador. Por predefinição, são utilizadas as bibliotecas de VM em execução. As entradas são separadas pelo separador de caminho de plataforma. Cada directório ou ficheiro pode especificar regras de acesso para tipos entre '[' e ']'. Se não for especificado nenhum caminho de classe de arranque, o compilador entenderá este a partir das seguintes propriedades do sistema: |
||||||||||||||
| -cp -classpath <dir 1>;<dir 2>;...;<dir P> |
Esta é uma lista de directórios de ficheiros jar utilizados para compilar os ficheiros de origem. A predefinição é o valor da propriedade "java.class.path". As entradas são separadas pelo separador de caminho de plataforma. Cada directório ou ficheiro pode especificar regras de acesso para tipos entre '[' e ']' (por exemplo [-X] para proibir o acesso ao tipo X, [~X] para desencorajar o acesso ao tipo X, [+p/X:-p/*] para proibir o acesso a todos os tipos no pacote p, mas para permitir o acesso ao p/X). O compilador segue as cláusulas Class-Path dos ficheiros manifest dos ficheiros jar de forma recursiva, e anexa cada ficheiro jar referenciado ao fim do caminho de classes, desde que ainda não esteja no caminho de
classes. |
||||||||||||||
| -extdirs <dir 1>;<dir 2>;...;<dir P> | Esta é uma lista de directórios utilizados para especificar a localização de ficheiros de extensão zip/jar. As entradas são separadas pelo separador de caminho de plataforma. | ||||||||||||||
| -endorseddirs <dir 1>;<dir 2>;...;<dir P> | Esta é uma lista de directórios utilizados para especificar a localização de ficheiros suportados zip/jar. As entradas são separadas pelo separador de caminho de plataforma. | ||||||||||||||
| -sourcepath <dir 1>;<dir 2>;...;<dir P> | Esta é uma lista de directórios utilizados para especificar os ficheiros de origem. As entradas são separadas pelo separador de caminho de plataforma. Cada directório pode especificar regras de acesso para tipos entre '[' e ']'. |
||||||||||||||
| -d <dir 1>|none | Isto é utilizado para especificar em que directório os
ficheiros .class gerados são copiados. Se for omitido, não é criada qualquer estrutura de directório de pacote. Se não pretender gerar nenhum .ficheiro de classe, utilize -d none. |
||||||||||||||
| -encoding <nome codificação> | Especifica a codificação predefinida de todos os ficheiros de origem. A codificação personalizada pode ser também especificada com base nos ficheiros inserindo um sufixo em cada ficheiro de origem de entrada/nome de ficheiro com o [<nome de codificação>]. Por exemplo, X.java[utf8] poderá especificar a codificação UTF-8 para a unidade de compilação X.java situada no directório do utilizador actual.
Se existirem várias codificações de ficheiro de origem especificadas, será utilizada a última. Por exemplo:
|
||||||||||||||
| Opções de compatibilidade | |||||||||||||||
| -destino 1.1 para 1.7 ou (5, 5.0, etc) | Especifica a definição de destino do ficheiro .class. Os valores possíveis são:
clcd1.1 pode ser utilizado para gerar o atributo StackMap. |
||||||||||||||
| -1.3 | Definir nível de compatibilidade para 1.3. -fonte 1.3 -destino 1.1. implícitos | ||||||||||||||
| -1.4 | Definir nível de compatibilidade para 1.4 (predefinição). -fonte 1.3 -destino 1.2. implícitos | ||||||||||||||
| -1.5 | Definir nível de compatibilidade para 1.5. -fonte 1.5 -destino 1.5. implícitos | ||||||||||||||
| -1.6 | Definir nível de compatibilidade para 1.6. -fonte 1.6 -destino 1.6. implícitos | ||||||||||||||
| -1.7 | Definir nível de compatibilidade para 1.7. -fonte 1.7 -destino 1.7 implícitos. | ||||||||||||||
| -fonte 1.1 para 1.7 ou (5, 5.0, etc) | É utilizado para especificar o nível de origem esperado pelo compilador. Os valores possíveis são:
|
||||||||||||||
| Opções de aviso | |||||||||||||||
| -?:warn -help:warn | Apresentar opções de aviso avançadas | ||||||||||||||
| -warn:... | Especificar o conjunto de avisos activados. e.g. -warn:unusedLocal,deprecation
|
||||||||||||||
| Predefinição | Nome do símbolo | Descrição | |||||||||||||
| +/- | allDeadCode | código inactivo incluindo verificação trivial if(DEBUG) | |||||||||||||
| +/- | allDeprecation | depreciação mesmo dentro de código obsoleto | |||||||||||||
| - | allJavadoc | javadoc inválido ou em falta | |||||||||||||
| - | allOver-ann | todas as anotações @Override em falta (super-classe e super-interfaces) | |||||||||||||
| - | all-static-method | todos os métodos podem ser declarados como aviso estáticos | |||||||||||||
| + | assertIdentifier | ocorrência de assert utilizada como identificador | |||||||||||||
| - | boxing | conversão autobox | |||||||||||||
| + | charConcat | quando uma tabela de caracteres é utilizada na concatenação de uma cadeia sem ser convertida explicitamente para uma cadeia | |||||||||||||
| + | compareIdentical | comparar expressões idênticas | |||||||||||||
| - | conditionAssign | possível atribuição acidental booleana | |||||||||||||
| + | constructorName | método com nome de construtor | |||||||||||||
| + | deadCode | código inactivo excluindo verificação trivial se (DEBUG) | |||||||||||||
| - | dep-ann | anotação @Deprecated em falta | |||||||||||||
| +/- | deprecation | utilização de tipo ou membro obsoleto fora de código obsoleto | |||||||||||||
| + | discouraged | utilização de tipos que correspondam a uma regra de acesso desencorajada | |||||||||||||
| - | emptyBlock | bloco vazio não documentado | |||||||||||||
| + | enumIdentifier | ocorrência de enum utilizada como identificador | |||||||||||||
| + | enumSwitch | comutação de enumeração incompleta | |||||||||||||
| - | enumSwitchPedantic | registar combinações de maiúsculas-minúsculas de troca de enumeração em falta mesmo na presença de combinação de maiúsculas-minúsculas predefinida | |||||||||||||
| - | fallthrough | possível caso de fall-through | |||||||||||||
| - | fieldHiding | campo a ocultar outra variável | |||||||||||||
| + | finalBound | parâmetro de tipo com limite final | |||||||||||||
| + | finally | bloco finally não que termina normalmente | |||||||||||||
| + | forbidden | utilização de tipos que correspondam a regras de acesso proibidas | |||||||||||||
| - | hashCode | método hashCode() ao substituir equals() | |||||||||||||
| +/- | hiding | macro para fieldHiding, localHiding, typeHiding e maskedCatchBlock | |||||||||||||
| - | includeAssertNull | elevar avisos nulos para variáveis que foram manchadas numa expressão assert | |||||||||||||
| - | indirectStatic | referência indirecta a membro estático | |||||||||||||
| + | intfAnnotation | tipo de anotação utilizado como superinterface | |||||||||||||
| + | intfNonInherited | compatibilidade de método não herdado de interface | |||||||||||||
| - | intfRedundant | localizar superinterfaces redundantes | |||||||||||||
| - | javadoc | javadoc inválido | |||||||||||||
| - | localHiding | variável local a ocultar outra variável | |||||||||||||
| + | maskedCatchBlock | bloco catch oculto | |||||||||||||
| - | nls | literais de cadeia não-nls (ausência de códigos //$NON-NLS-<n>) | |||||||||||||
| + | noEffectAssign | atribuição sem efeito | |||||||||||||
| +/- | null | potencialmente em falta ou verificação nula redundante | |||||||||||||
| - | nullAnnot | activar a análise de nulos baseada em anotações. Caso se pretenda, os tipos de anotações a interpretar pelo compilador podem ser especificados anexando (nullable|nonnull|nonnullbydefault), onde cada tipo de anotação é especificado utilizando o respectivo nome totalmente qualificado. Consulte também -nonNullByDefault em baixo. |
|||||||||||||
| - | nullDereference | falta verificação nula | |||||||||||||
| - | over-ann | anotação @Override em falta (apenas super-classe) | |||||||||||||
| - | paramAssign | atribuição a um parâmetro | |||||||||||||
| + | pkgDefaultMethod | tentativa de sobreposição de método de pacote predefinido | |||||||||||||
| + | raw | utilização de um tipo em bruto (em vez de um tipo parametrizado) | |||||||||||||
| +/- | resource | (potencialmente) utilização não segura do recurso do tipo Closeable | |||||||||||||
| - | semicolon | ponto e vírgula (;) desnecessário ou instrução vazia | |||||||||||||
| + | serial | serialVersionUID em falta | |||||||||||||
| - | specialParamHiding | parâmetro de construtor ou de formatador a ocultar outro campo | |||||||||||||
| +/- | static-access | macro para indirectStatic e staticReceiver | |||||||||||||
| - | static-method | um método de instância que pode ser um método estático | |||||||||||||
| + | staticReceiver | se for utilizado um receptor não estático para obter um campo estático ou chamar um método estático | |||||||||||||
| - | super | sobreposição de um método sem fazer uma invocação super | |||||||||||||
| + | suppress | activar @SuppressWarnings | |||||||||||||
| - | switchDefault | instrução switch à qual falta uma combinação de maiúsculas-minúsculas predefinida | |||||||||||||
| - | syncOverride | sincronizado em falta em substituição do método sincronizado | |||||||||||||
| - | syntheticAccess | ao efectuar acesso sintético para classe interna | |||||||||||||
| - | tasks | activar suporte para códigos de tarefas em código fonte | |||||||||||||
| + | typeHiding | parâmetro de tipo a ocultar outro tipo | |||||||||||||
| + | unavoidableGenericProblems | ignorar problemas de segurança de tipo inevitável devido a API de tipo raw | |||||||||||||
| + | não marcado | operação de tipo não verificada | |||||||||||||
| - | unnecessaryElse | cláusula else desnecessária | |||||||||||||
| - | unqualifiedField | referência não qualificada a um campo | |||||||||||||
| +/- | unused | macro para unusedAllocation, unusedArgument, unusedImport, unusedLabel, unusedLocal, unusedPrivate, unusedThrown e unusedTypeArgs | |||||||||||||
| - | unusedAllocation | atribuir um objecto que não é utilizado | |||||||||||||
| - | unusedArgument | argumento de método não utilizado | |||||||||||||
| + | unusedImport | referência de importação não utilizada | |||||||||||||
| + | unusedLabel | etiqueta não utilizada | |||||||||||||
| + | unusedLocal | variável local não utilizada | |||||||||||||
| + | unusedPrivate | instrução de membro privado não utilizado | |||||||||||||
| - | unusedThrown | excepção lançada declarada não utilizada | |||||||||||||
| + | unusedTypeArgs | argumentos de tipo não utilizado para método e construtor | |||||||||||||
| - | uselessTypeCheck | operação cast/instanceof desnecessária | |||||||||||||
| + | varargsCast | argumento de varargs requerer conversão explícita | |||||||||||||
| +/- | warningToken | símbolo de aviso não processado ou não utilizado em @SuppressWarnings | |||||||||||||
| -nowarn | Sem aviso (equivalente a -warn:none) | ||||||||||||||
| -err:... | Especificar o conjunto de avisos activados que são convertidos em erros. por ex., -err:unusedLocal,deprecation avisos unusedLocal e deprecation serão convertidos em erros. Todos os outros avisos continuam a ser registados como avisos.
|
||||||||||||||
| -deprecation | Equivalente a -warn:+deprecation. | ||||||||||||||
| -properties <ficheiro> | Defina a opção avisos/erros com base no conteúdo do ficheiro de propriedades. Esta opção pode ser utilizada com as opções -nowarn, -err:.. ou -warn:.. , mas a última na linha de comandos define as opções a serem utilizadas. O conteúdo do ficheiro de propriedades pode ser gerado através do estabelecer de definições específicas do projecto num projecto de java existente e utilizando o ficheiro no ficheiro ... 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] | Defina o nível de atributos de depuração
|
||||||||||||||
| -preserveAllLocals | Pedir explicitamente ao compilador para manter todas as variáveis locais (para efeitos de depuração). Quando omitidas, o compilador remove locais não utilizados. | ||||||||||||||
| Opções de processamento de anotação (requerem uma 1.6 VM ou superior e são utilizadas só se a compatibilidade for 1.6) | |||||||||||||||
| -Akey[=value] | Opções do processador de anotação que são passadas para processadores de anotação. key é formada por identificadores separados por pontos |
||||||||||||||
| -proc:[only|none] | Se for especificado -proc:only, os processadores de anotação serão executados, mas não é realizada nenhuma compilação. Se for especificado -proc:none, os processadores de anotação não serão descobertos ou executados; a compilação terá lugar como se não fossem encontrados nenhuns processadores de anotação. Por predefinição, o compilador tem de procurar o caminho de classe para os processadores de anotação. Portanto, a especificação de -proc:none poderá aumentar a velocidade da compilação se o processamento de anotação não for necessário. |
||||||||||||||
| -processor <class1[,class2,...]> | Os nomes de classe qualificados dos processadores a executar. Se especificados, o processo de descoberta do processador normal será ignorado. | ||||||||||||||
| -processorpath <dir 1>;<dir 2>;...;<dir P> | Uma lista dos directórios ou ficheiros jar que serão separados para processadores de anotação. As entradas são separadas pelo separador de caminho de plataforma. Se não forem especificadas, será, em seu lugar, procurado o caminho de classe. | ||||||||||||||
| -s <dir> | O directório em que os ficheiros de fonte gerados serão criados. | ||||||||||||||
| -XprintProcessorInfo | Informações de impressão sobre as anotações e elementos que serão pedidas a um processador para processar | ||||||||||||||
| -XprintRounds | Informações de impressão sobre circuitos do processamento de anotação | ||||||||||||||
| -classNames <class1[,class2,...]> | Nomes qualificados de tipos binários que precisam de ser processados | ||||||||||||||
| Opções ignoradas (para compatibilidade com as opções javac) | |||||||||||||||
| -J<option> | Transmitir opção à máquina virtual | ||||||||||||||
| -X<option> | Especificar opção não padrão. -Xemacs não é ignorado. | ||||||||||||||
| -X | Imprimir opções não padrão e sair | ||||||||||||||
| -O | Optimizar tempo de execução | ||||||||||||||
| Opções avançadas | |||||||||||||||
| @<file> | Ler argumentos de linha de comandos de ficheiro | ||||||||||||||
| -maxProblems <n> | Número máximo de problemas por unidade compilação (100 por predefinição) | ||||||||||||||
| -log <filename> | Especificar um ficheiro de registo no qual são efectuadas cópias de memória todas as saídas do compilador. Isto é particularmente útil se pretender depurar o compilador de agrupamentos ou obter o ficheiro que contém todos os erros e avisos de um construtor de agrupamento. Se a extensão for .xml, o ficheiro de registo gerado será um ficheiro xml. | ||||||||||||||
| -Xemacs | Utilizar estilo emacs para apresentar erros e localizações de aviso na consola e em registos de texto normais. Os registos XML não são afectados por esta opção. Com esta opção activada, a mensagem:2. WARNING in /workspace/X.javaé apresentada como: /workspace/X.java:8: warning: The method... |
||||||||||||||
| -proceedOnError[:Fatal] | Continua a compilar apesar dos erros, a efectuar cópia de memória de ficheiros de origem com métodos de problemas ou tipos de problemas. Isto é recomendado apenas se pretender executar a aplicação ainda que tenha erros remanescentes. Com ":Fatal", todos os erros opcionais são tratados como fatais e isso causa o cancelamento do código se for atingido um erro durante o tempo de execução. Sem ":Fatal", os erros opcionais não impede a geração adequada do código e os ficheiros .class produzidos podem ser executados sem problemas. |
||||||||||||||
| -verbose | Imprimir unidade de compilação acedidas/processadas na consola ou no ficheiro de registos, se especificado. | ||||||||||||||
| -referenceInfo | Calcular informações de referências. Isto só é útil se ligado ao construtor. De outra forma, as informações de referências são inúteis. | ||||||||||||||
| -progress | Mostra o progresso (apenas no modo -registo). | ||||||||||||||
| -time | Apresenta as informações sobre a velocidade. | ||||||||||||||
| -noExit | Não chamar System.exit(n) no fim da compilação (n=0 na ausência de erros). | ||||||||||||||
| -repeat <n> | Repetir processo de compilação <n> vezes (análise de rendimento) | ||||||||||||||
| -inlineJSR | Bytecode JSR incluído (implícito se destino >= 1.5). | ||||||||||||||
| -enableJavadoc | Considerar referências dentro de javadoc. | ||||||||||||||
| -missingNullDefault | Quando a análise de nulos baseada em anotações (utilizando "nullAnnot", em cima), esta opção irá emitir um aviso sempre que não existir uma anotação predefinida num pacote ou num tipo. | ||||||||||||||
| Opções de ajuda | |||||||||||||||
| -? -help | Apresenta mensagens de ajuda. | ||||||||||||||
| -v -version | Apresentar número de construção do compilador. Isto é particularmente útil para comunicar um defeito. | ||||||||||||||
| -showversion | Apresentar número de construção do compilador e continuar. Isto é particularmente útil para comunicar um defeito. | ||||||||||||||
d:\temp -classpath rt.jar -time -g -d d:/tmp |
Compila todos os ficheiros de origem d:\temp e respectivas subpastas. O caminho de classes é simplesmente rt.jar. Gera todos os atributos de depuração e todos os ficheiros .class gerados são largados em d:\tmp. A velocidade do compilador é apresentada assim que o processo de agrupamento é concluído. |
d:\temp\Test.java -classpath d:\temp;rt.jar -g:none |
Compila apenas Test.java e respectivos ficheiros dependentes, se existirem, recuperando os ficheiros dependentes a partir de d:\temp. O caminho de classe é d:\temp seguido de rt.jar, o que significa que todas as classes necessárias são pesquisadas em primeiro lugar em d:\temp e depois em rt.jar. Não gera quaisquer atributos de depuração e todos os ficheiros .class gerados são largados em d:\temp. |