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.
java -jar org.eclipse.jdt.core_<version>.jar -classpath rt.jar A.java
o bien:
java -jar ecj.jar -classpath rt.jar A.java
compile(String commandLine, PrintWriter outWriter, PrintWriter errWriter, CompilationProgress progress) de la clase BatchCompiler.
org.eclipse.jdt.compiler.CompilationProgress progress = null; // crear una instancia de la subclase org.eclipse.jdt.internal.compiler.batch.BatchCompiler.compile( "-classpath rt.jar A.java", new PrintWriter(System.out), new PrintWriter(System.err), progress);
Puede controlar la información de progreso o cómo se cancela el compilador de proceso por lotes creando una subclase de la clase org.eclipse.jdt.compiler.CompilationProgress.
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 |
||||||||||||||
| -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:
|
||||||||||||||
| 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:
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:
|
||||||||||||||
| Opciones de aviso | |||||||||||||||
| -?:warn -help:warn | Visualizar opciones de aviso avanzadas | ||||||||||||||
| -warn:... | Especificar el conjunto de avisos habilitados. Por ejemplo, -warn:unusedLocal,deprecation
|
||||||||||||||
| 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.
|
||||||||||||||
| -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 ... 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
|
||||||||||||||
| -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 mensaje2. AVISO en /workspace/X.javase 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. | ||||||||||||||
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. |