Utilizar el compilador por lotes

Localizar el compilador por lotes

El compilador por lotes se encuentra en el plug-in Núcleo de JDT. El nombre de la clase es org.eclipse.jdt.compiler.batch.BatchCompiler. Se empaqueta en plugins/org.eclipse.jdt.core_<versión>.jar. Desde 3.2, también está disponible como descarga aparte. El nombre del archivo es ecj.jar. El código fuente correspondiente también está disponible. Para obtenerlos, vaya a la página de descarga y busque la sección JDT Core Batch Compiler. Este jar contiene el compilador de proceso por lotes y el adaptador ant javac.

Desde 3.3, este jar también contiene el soporte de jsr199 (API de compilador) y el soporte de jsr269 (Proceso de anotaciones). Para utilizar el soporte de proceso de anotaciones, se necesita una VM 1.6.

De esta forma, puede utilizarse como aplicación autónoma y dentro de una construcción Ant fuera de Eclipse.

Ejecutar el compilador por lotes

Qué opciones están disponibles

Las opciones recomendadas tienen fondo naranja.

Cuando algunas opciones se establecen varias veces, el compilador de proceso por lotes las consume de izquierda a derecha. Cuando la opción de aviso (-warn:....) se utiliza sin '+' o '-', se altera temporalmente el conjunto de avisos especificados previamente. De este modo, el usuario debe asegurarse de que se proporciona una opción así antes de cualquier otra utilización de la opción -warn.

Los mismo vale para la opción -err:.

Nombre Utilización
Opciones de vía de acceso de clases
-bootclasspath <dir 1>;<dir 2>;...;<dir P> Lista de los directorios o archivos jar que sirven como rutina de carga de los archivos de clase utilizados por el compilador. Por omisión, se utilizan las bibliotecas de la VM en ejecución. Las entradas se separan con el separador de vías de acceso de la plataforma.
Cada directorio o archivo puede especificar reglas de acceso para tipos entre '[' y ']'.

Si no se especifica ninguna vía de acceso de clases de arranque, el compilador la deducirá mediante las propiedades del sistema siguientes sun.boot.class.path, vm.boot.class.path o org.apache.harmony.boot.class.path respectivamente y por este orden.

-cp
-classpath <dir 1>;<dir 2>;...;<dir P>
Lista de los directorios o archivos jar que sirven para compilar los archivos fuente. El valor predeterminado es el valor de la propiedad "java.class.path". Las entradas se separan con el separador de vías de acceso de la plataforma.
Cada directorio o archivo puede especificar reglas de acceso para tipos entre '[' y ']' (por ejemplo [-X] para prohibir el acceso al tipo X, [~X] para desaconsejar el acceso al tipo X, [+p/X:-p/*] para prohibir el acceso a todos los tipos en el paquete p pero permitir el acceso a p/X).
El compilador sigue las cláusulas Class-Path de los manifiestos de archivos jar de forma recursiva y añade cada archivo jar de referencia al final de la vía de acceso de clases, suponiendo que todavía no esté en la vía de acceso de clases.
-extdirs <dir 1>;<dir 2>;...;<dir P> Lista de los directorios que sirven para especificar la ubicación de los archivos zip/jar de las extensiones. Las entradas se separan con el separador de vías de acceso de la plataforma.
-endorseddirs <dir 1>;<dir 2>;...;<dir P> Lista de los directorios que sirven para especificar la ubicación de los archivos zip/jar endosados. Las entradas se separan con el separador de vías de acceso de la plataforma.
-sourcepath <dir 1>;<dir 2>;...;<dir P> Lista de los directorios que sirven para especificar los archivos fuente. Las entradas se separan con el separador de vías de acceso de la plataforma.
Cada directorio puede especificar reglas de acceso para tipos entre '[' y ']'.
-d <dir 1>|none Sirve para especificar en qué directorio hay que volcar los archivos .class generados. Si se omite, no se crea ninguna estructura de directorio de paquetes.
Si no desea generar ningún archivo .class, utilice -d none.
-encoding <nombre codificación> Especificar codificación predeterminada para todos los archivos fuente. También se puede especificar la codificación personalizada personalizada para cada archivo, añadiendo a cada nombre de archivo/carpeta fuente de entrada el sufijo [<nombre de codificación>]. Por ejemplo X.java[utf8] especificaría la codificación UTF-8 para la unidad de compilación X.java ubicada en el directorio del usuario actual.

Si se especifican varias codificaciones de archivo fuente predeterminadas, se utilizará la última.

Por ejemplo:

  • ... -encoding UTF-8 X.java[Cp1252] Y.java[UTF-16] Z.java ....
    Todos los archivos fuente se leerán mediante la codificación UTF-8 (esto incluye Z.java). X.java se leerá mediante la codificación Cp1252 y Y.java se leerá mediante la codificación UTF-16.
  • ... -encoding UTF-8 -encoding UTF-16 ....
    Todos los archivos fuente se leerán mediante la codificación UTF-16. La opción -encoding se ignora para UTF-8.
  • ... -encoding Cp1252 /foo/bar/X.java[UTF-16] /foo/bar[UTF-8] ....
    Todos los archivos fuente se leerán mediante la codificación Cp1252. X.java es el único archivo dentro del directorio /foo/bar que se debe leer utilizando la codificación UTF-16. El resto de archivos de ese directorio utilizarán codificación UTF-8.
Opciones de conformidad
-target 1.1 a 1.7 o (5, 5.0, etc) Especifica el valor del destino del archivo .class. Los valores posibles son:
  • 1.1 (versión principal: 45 secundaria: 3)
  • 1.2 (versión principal: 46 secundaria: 0)
  • 1.3 (versión principal: 47 secundaria: 0)
  • 1.4 (versión principal: 48 secundaria: 0)
  • 1.5, 5 o 5.0 (versión principal: 49 secundaria: 0)
  • 1.6, 6 o 6.0 (versión principal: 50 secundaria: 0)
  • 1.7, 7 o 7.0 (versión principal: 51 secundaria: 0)
Los valores predeterminados son:
  • 1.1 en la modalidad -1.3
  • 1.2 en la modalidad -1.4
  • 1.5 en la modalidad -1.5
  • 1.6 en la modalidad -1.6
  • 1.7 en la modalidad -1.7

clcd1.1 puede utilizarse para generar el atributo StackMap.

-1.3 Establecer que el nivel de conformidad sea 1.3. Implícito -source 1.3 -target 1.1.
-1.4 Establecer que el nivel de conformidad sea 1.4 (predeterminado). Implícito -source 1.3 -target 1.2.
-1.5 Establecer que el nivel de conformidad sea 1.5. Implícito -source 1.5 -target 1.5.
-1.6 Establecer que el nivel de conformidad sea 1.6. Implícito -source 1.6 -target 1.6.
-1.7 Establecer que el nivel de conformidad sea 1.7. Implícito -source 1.7 -target 1.7.
-source 1.1 a 1.7 o (5, 5.0, etc) Esto se utiliza para especificar el nivel del origen esperado por el compilador.
Los valores posibles son:
  • 1.3
  • 1.4
  • 1.5, 5 o 5.0
  • 1.6, 6 o 6.0
  • 1.7, 7 o 7.0
Los valores predeterminados son:
  • 1.3 en la modalidad -1.3
  • 1.3 en la modalidad -1.4
  • 1.5 en la modalidad -1.5
  • 1.6 en la modalidad -1.6
  • 1.7 en la modalidad -1.7
En 1.4, assert se trata como palabra clave. En 1.5 y 1.6, enum y assert se tratan como palabras clave.
Opciones de aviso
-?:warn -help:warn Visualizar opciones de aviso avanzadas
-warn:... Especificar el conjunto de avisos habilitados.
Por ejemplo, -warn:unusedLocal,deprecation
-warn:none inhabilitar todos los avisos
-warn:<símbolos de aviso separados por ,> habilitar exactamente los avisos de la lista
-warn:+<símbolos de aviso separados por ,> habilitar avisos adicionales
-warn:-<símbolos de aviso separados por ,> inhabilitar avisos específicos
En la columna Valor predeterminado siguiente, una marca "+/-" indica que una opción cubre varias variantes de aviso precisadas, algunas de las cuales están habilitadas de manera predeterminada y otras están inhabilitadas. Esto significa que al especificar la opción concreta con "+" se habilitarán más avisos que con el valor predeterminado y al especificar "-" se inhabilitarán algunos que están habilitados de manera predeterminada.
Valor predeterminado Nombre de símbolo Descripción
+/- allDeadCode código muerto incluyendo comprobación if(DEBUG) trivial
+/- allDeprecation en desuso incluso dentro de código en desuso
- allJavadoc javadoc no válido o que no se encuentra
- allOver-ann todas las anotaciones @Override faltantes (superclase y superinterfaces)
- all-static-method todos los métodos se pueden declarar como avisos estáticos
+ assertIdentifier aparición de assert usado como identificador
- boxing conversión de autoencaje
+ charConcat cuando una matriz de caracteres se emplea en una concatenación de series sin haber sido convertida explícitamente a una serie
+ compareIdentical comparando expresiones idénticas
- conditionAssign posible asignación booleana accidental
+ constructorName método con nombre de constructor
+ deadCode código muerto excluyendo comprobación if(DEBUG) trivial
- dep-ann anotación @Deprecated ausente
+/- deprecation uso de un tipo o miembro en desuso fuera del código en desuso
+ discouraged utilización de tipos que coinciden con una regla de acceso desaconsejada
- emptyBlock bloque vacío no documentado
+ enumIdentifier aparición de enum usado como identificador
+ enumSwitch conmutación de enumeración incompleta
- enumSwitchPedantic informar de casos switch de enumeración faltantes incluso en presencia de un caso default
- fallthrough recorrido de casos posible
- fieldHiding campo que oculta otra variable
+ finalBound parámetro de tipo con límite final
+ finally bloque finally que no se completa con normalidad
+ forbidden utilización de tipos que coinciden con una regla de acceso prohibida
- hashCode método hashCode() faltante al sobrescribir equals()
+/- hiding macro para fieldHiding, localHiding, typeHiding y maskedCatchBlock
- includeAssertNull generar avisos de nulos para las variables afectadas en una expresión assert
- indirectStatic referencia indirecta a miembro estático
+ intfAnnotation tipo de anotación utilizada como superinterfaz
+ intfNonInherited compatibilidad de método no heredada de interfaz
- intfRedundant buscar superinterfaces redundantes
- javadoc javadoc no válido
- localHiding variable local que oculta otra variable
+ maskedCatchBlock bloque catch oculto
- nls literales de tipo serie no nls (que no tienen códigos //$NON-NLS-<n>)
+ noEffectAssign asignación sin efecto
+/- null posible comprobación de nulo ausente o redundante
- nullAnnot habilita el análisis de nulos basado en anotaciones.
Si lo desea, los tipos de anotación que debe interpretar el compilador se pueden especificar añadiendo (nullable|nonnull|nonnullbydefault), donde cada tipo de anotación se especifica con su nombre totalmente calificado.
Consulte también -nonNullByDefault a continuación.
- nullDereference comprobación de nulo faltante
- over-ann anotación @Override faltante (sólo superclase)
- paramAssign asignación a un parámetro
+ pkgDefaultMethod intento de alterar temporalmente el método package-default
+ raw utilización de un tipo raw (en lugar de un tipo parametrizado)
+/- recurso uso (potencialmente) no seguro de un recurso del tipo Closeable
- semicolon punto y coma innecesario o sentencia vacía
+ serial serialVersionUID ausente
- specialParamHiding parámetro de constructor o de método set que oculta otro campo
+/- static-access macro para indirectStatic y staticReceiver
- static-method un método de instancia que podría ser como un método estático
+ staticReceiver si se utiliza un receptor no estático para obtener un campo estático o para llamar a un método estático
- super alterar temporalmente un método sin hacer una invocación de super
+ suppress habilitar @SuppressWarnings
- switchDefault sentencia switch sin caso default
- syncOverride falta sincronizado en sustitución de método sincronizado
- syntheticAccess cuando se lleva a cabo acceso sintético para clase interior
- tasks habilitar soporte para códigos de tareas en el código fuente
+ typeHiding parámetro de tipo que oculta otro tipo
+ unavoidableGenericProblems ignorar problemas inevitables de seguridad de tipos causados por API puras
+ unchecked operación de tipo no comprobada
- unnecessaryElse cláusula else innecesaria
- unqualifiedField referencia no calificada a campo
+/- unused macro para unusedAllocation, unusedArgument, unusedImport, unusedLabel, unusedLocal, unusedPrivate, unusedThrown y unusedTypeArgs
- unusedAllocation asignar un objeto que no se utiliza
- unusedArgument argumento de método no utilizado
+ unusedImport referencia a importación no utilizada
+ unusedLabel etiqueta no utilizada
+ unusedLocal variable local no utilizada
+ unusedPrivate declaración de miembro privado no utilizado
- unusedThrown excepción lanzada declarada, pero no utilizada
+ unusedTypeArgs argumentos de tipo no utilizado para el método y el constructor
- uselessTypeCheck operación cast/instanceof innecesaria
+ varargsCast argumento varargs necesita conversión de tipo explícita
+/- warningToken símbolo de aviso no manejado o no utilizado en @SuppressWarnings
-nowarn No hay ningún aviso (equivale a -warn:none)
-err:... Especificar el conjunto de avisos que se convierten en errores.
p. ej. -err:unusedLocal,deprecation
Los avisos unusedLocal y deprecation se convertirán en errores. El resto de avisos todavía se marcan como avisos.
-err:<símbolos de aviso separados por ,> convertir exactamente los avisos de la lista en errores
-err:+<símbolos de aviso separados por ,> convertir avisos adicionales en errores
-err:-<símbolos de aviso separados por ,> impedir que determinados avisos se conviertan en errores
-deprecation Equivale a -warn:+deprecation.
-properties <archivo> Establecer la opción de avisos/errores según el contenido del archivo de propiedades. Esta opción se puede utilizar con las opciones -nowarn, -err:.. o -warn:.., pero la última de ellas en la línea de mandatos establece las opciones a utilizar.

El contenido del archivo de propiedades se puede generar estableciendo valores específicos del proyecto en un proyecto java existente y utilizando el archivo de .settings/org.eclipse.jdt.core.prefs como archivo de propiedades o un archivo de texto simple definido como pares de entrada/valor mediante las constantes definidas en la clase 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
...
Opciones de depuración
-g[:none|:lines,vars,source] Establecer el nivel de atributos de depuración
-g Toda la información de depuración (equivale a -g:lines,vars,source)
-g:none No hay información de depuración
-g:[lines,vars,source] Información de depuración selectiva
-preserveAllLocals Pedir explícitamente al compilador que conserve todas las variables locales (a efectos de depuración). Si se omite, el compilador eliminará las variables locales que no se utilicen.
Opciones de proceso de anotaciones (necesitan una VM 1.6 o superior y se utilizan solamente si la conformidad es 1.6)
-Akey[=valor] Opciones de procesadores de anotaciones que se pasan a procesadores de anotaciones. key está hecho de identificadores separados por puntos
-proc:[only|none] Si se especifica -proc:only, los procesadores de anotaciones se ejecutarán pero no se realizará compilación alguna. Si se especifica -proc:none, los procesadores de anotaciones no se descubrirán ni se ejecutarán; la compilación continuará como si no se hubieran encontrado procesadores de anotaciones. De forma predeterminada, el compilador debe buscar procesadores de anotaciones en la vía de acceso de clases, de modo que especificar -proc:none puede acelerar la compilación si el proceso de anotaciones no es necesario.
-processor <clase1[,clase2,...]> Nombres de clase calificados de procesadores de anotaciones a ejecutar. Si se especifica, se saltará el proceso de descubrimiento de procesador normal.
-processorpath <dir 1>;<dir 2>;...;<dir P> Una lista de directorios o archivos jar en los que se buscarán procesadores de anotaciones. Las entradas se separan con el separador de vías de acceso de la plataforma. Si no se especifica, en su lugar se buscará en la vía de acceso de clases.
-s <dir> El directorio en el que se crearán los archivos fuente generados.
-XprintProcessorInfo Imprimir información acerca de qué anotaciones y qué elementos debe procesar un procesador
-XprintRounds Imprimir información acerca de rondas de proceso de anotaciones
-classNames <clase1[,clase2,...]> Nombres calificados de tipos binarios que necesitan procesarse
Opciones omitidas (para compatibilidad con opciones javac)
-J<opción> Pasar opción a la máquina virtual
-X<opción> Especificar opción no estándar. -Xemacs no se omite.
-X Imprimir opciones no estándar y salir
-O Optimizar tiempo de ejecución
Opciones avanzadas
@<archivo> Leer argumentos de línea de mandatos a partir del archivo
-maxProblems <n> Número máximo de problemas por unidad de compilación (el valor predeterminada es 100)
-log <nombre de archivo> Especifique un archivo de anotaciones en el que volcar todos los datos de salida del compilador. Es verdaderamente útil si se quiere depurar el compilador por lotes u obtener un archivo que contenga todos los errores y avisos de una construcción por lotes. Si la extensión es .xml, el archivo de anotaciones generado será xml.
-Xemacs Utilice el estilo emacs para presentar ubicaciones de errores y avisos en la consola y en las anotaciones de texto habituales. Las anotaciones XML no se ven afectadas por esta opción. Con esta opción activa, el mensaje
2. AVISO en /workspace/X.java
(en la línea 8)...

se presenta como
/workspace/X.java:8: aviso: El método...
-proceedOnError[:Fatal] Seguir compilando a pesar de los errores, volcar archivos de clase con métodos de problema o tipos de problema. Solo se lo recomendamos si desea poder ejecutar la aplicación aunque queden errores.
Con ":Fatal", todos los errores opcionales se tratan como muy graves, lo que implica la terminación anormal del código si se alcanza un error en tiempo de ejecución. Sin ":Fatal", los errores opcionales no impiden que se genere adecuadamente el código y los archivos .class generados se pueden ejecutar sin problema.
-verbose Imprimir unidades de compilación accedidas/procesadas en la consola o en el archivo de anotaciones, si se ha especificado.
-referenceInfo Calcular información de referencia. Solo es útil si se está conectado al constructor. De lo contrario, las informaciones de referencia son inútiles.
-progress Mostrar progreso (solo en modalidad -log).
-time Visualizar información de velocidad.
-noExit No llamar a System.exit(n) al final de la compilación (n=0 si no hay error).
-repeat <n> Repetir el proceso de compilación <n> veces (análisis de rendimiento)
-inlineJSR Incorporar bytecode JSR (implícito si destino >= 1.5).
-enableJavadoc Considerar referencias dentro de javadoc.
-missingNullDefault Cuando se habilita el análisis de nulos basado en anotaciones (utilizando "nullAnnot", como se indicaba anteriormente), esta opción emitirá un mensaje siempre que no haya ninguna notación predeterminada en un paquete o en un tipo.
Opciones de ayuda
-? -help Visualizar el mensaje de ayuda.
-v -version Visualizar el número de construcción del compilador. Es muy útil a la hora de notificar un error.
-showversion Visualizar el número de construcción del compilador y continuar. Es muy útil a la hora de notificar un error.

Ejemplos

d:\temp -classpath rt.jar -time -g -d d:/tmp Compila todos los archivos fuente que hay en d:\temp y en sus subcarpetas. La vía de acceso de clases es simplemente rt.jar. Genera todos los atributos de depuración, y todos los archivos .class generados se vuelcan en d:\tmp. La velocidad del compilador se visualizará cuando el proceso por lotes haya llegado al final.
d:\temp\Test.java -classpath d:\temp;rt.jar -g:none Solo compila Test.java y los posibles archivos dependientes que tenga y recupera archivos dependientes de d:\temp. La vía de acceso de clases es d:\temp seguido de rt.jar, lo que significa que todas las clases necesarias se buscan primero en d:\temp y, después, en rt.jar. No genera atributos de depuración, y los archivos .class generados se vuelcan en d:\temp.