Utilizar o compilador de agrupamento

Encontrar o compilador de agrupamento

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.

Executar o compilador de agrupamento

Quais as opções disponíveis?

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: sun.boot.class.path, vm.boot.class.path ou org.apache.harmony.boot.class.path, por esta ordem.

-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:

  • ... -encoding UTF-8 X.java[Cp1252] Y.java[UTF-16] Z.java ....
    Todos os ficheiros de origem serão lidos utilizando a codificação UTF-8 (isto inclui Z.java). X.java será lido utilizando a codificação Cp1252 e Y.java será lido utilizando a codificação UTF-16.
  • ... -encoding UTF-8 -encoding UTF-16 ....
    Todos os ficheiros de origem são lidos utilizando 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 ficheiros de origem serão lidos utilizando a codificação Cp1252. X.java é o único ficheiro no directório /foo/bar a ser lido utilizando a codificação UTF-16. Todos os outros ficheiros nesse directório irão utilizar a codificação UTF-8.
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:
  • 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)
As predefiniçõ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 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:
  • 1.3
  • 1.4
  • 1.5, 5 ou 5.0
  • 1.6, 6 ou 6.0
  • 1.7, 7 ou 7.0
As predefiniçõ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 modo 1.4, assert é tratado como uma palavra-chave. Em 1.5 e 1.6, enum e assert são considerados palavras-chave.
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
-warn:none desactivar todos os avisos
símbolos de aviso -warn:< separados por ,> activar exactamente os avisos listados
símbolos de aviso -warn:+< separados por ,> activar avisos adicionais
símbolos de aviso -warn:-< separados por ,> desactivar avisos específicos
Na coluna Predefinição em baixo, uma marca "+/-" indica que uma opção abrange várias variantes de aviso muito exactas, algumas das quais estão activadas por predefinição, outras desactivadas. Isto significa que especificar a opção fornecida com "+" irá activar mais avisos do que a predefinição, e especificar "-" desactiva algumas opções que estão activadas por predefinição.
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.
símbolos de aviso -err:< separados por ,> converter exactamente os avisos listados para erros
símbolos de aviso -err:+< separados por ,> converter avisos adicionais para erros
símbolos de aviso -err:-< separados por ,> remover avisos específicos da conversão para erros
-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 .settings/org.eclipse.jdt.core.prefs como um ficheiro de propriedades, ou um ficheiro de texto simples que é definido em pares entrada/valor utilizando 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] Defina o nível de atributos de depuração
-g Todas as informações de depuração (equivalente a -g:lines,vars,source)
-g:none Sem informações de depuração
-g:[lines,vars,source] Informações de depuração selectivas
-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
(at line 8)...

é 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.

Exemplos

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.