Mandato JSPBatchCompiler
El compilador por lotes valida la sintaxis de las páginas JSP (JavaServer Pages), convierte las páginas JSP en archivos de origen Java™ y compila los archivos de origen Java en archivos de clase de Java Servlet. El compilador por lotes también valida los archivos de distintivos y genera las clases de implementación Java. Utilice esta función para compilar por lotes los archivos JSP y, así, habilitar unas respuestas más rápidas a las solicitudes de cliente iniciales para los archivos JSP en el servidor web de producción.
El compilador por lotes se puede ejecutar en los archivos de archivador de empresa (EAR) y en los archivos de archivado de aplicación web (WAR) comprimidos o ampliados, así como en aplicaciones empresariales y módulos web que se han desplegado en WebSphere Application Server. Cuando el destino es una aplicación de empresa desplegada, el servidor no necesita estar en ejecución para poder ejecutar el compilador por lotes. Si el compilador por lotes se ejecuta cuando se está ejecutando el servidor de destino, el servidor no reconoce la existencia de un archivo de clase actualizado y no lo carga a menos que se reinicie la aplicación de empresa. Cuando el destino es un archivo EAR o WAR comprimido, el compilador por lotes debe expandirlo antes de ejecutarse.
Proceso de módulos web
El compilador por lotes funciona en un módulo web a la vez. Si el destino es un archivo EAR o una aplicación empresarial instalada que contiene más de un módulo web, el compilador por lotes funciona en cada módulo web de forma individual. Esto se realiza porque las páginas JSP se configuran por cada módulo web, a través del archivo de descriptor de despliegue web.xml del módulo web. Dentro de un módulo web, el compilador por lotes procesa un directorio a la vez. Valida y convierte cada página JSP de forma individual y, a continuación, invoca el compilador Java para el grupo completo de archivos de orígenes Java generados en ese directorio. Si una página JSP falla durante la fase de compilación Java, el compilador Java no creará los archivos de clase de la mayoría o de todas las páginas JSP compilados correctamente en ese directorio.
Extensiones de archivo JSP
- Las extensiones de archivo JSP estándar
- .jsp
- .jspx
- .jsw
- .jsv
- La propiedad url-pattern de los elementos jsp-property-group en el archivo del descriptor de despliegue en los módulos web Servlet 2.4
- El parámetro de configuración del motor JSP jsp.file.extensions (para módulos web anteriores a Servlet 2.4)
- El parámetro de configuración del compilador por lotes jsp.file.extensions
El compilador por lotes siempre utiliza las extensiones estándar. Si el módulo web contiene un descriptor de despliegue Servlet 2.4, el compilador por lotes también procesa los patrones url-patterns encontrados dentro del elemento jsp-config. Si el destino del compilador por lotes contiene el parámetro de configuración del motor JSP jsp.file.extensions, también se procesan esas extensiones. Si existe el parámetro de configuración del compilador por lotes jsp.file.extensions, las extensiones proporcionadas también se procesan y alteran temporalmente el parámetro de configuración del motor JSP jsp.file.extensions.
Se recomienda dar a los 'fragmentos' de JSP una extensión que no procese el compilador por lotes. Los fragmentos incluidos estáticamente que no sean autónomos generan errores de conversión y compilación si se procesan. La especificación JSP 2.0 recomienda utilizar la extensión .jspf para dichos archivos.
Mandato de compilador por lotes
En un archivo por lotes Windows, JspBatchCompiler.bat y un script de shell UNIX de JspBatchCompiler.sh para ejecutar el compilador por lotes desde la línea de mandatos se encuentran en el directorio {RAÍZ_WAS}/bin.
También hay disponible una tarea Ant para ejecutar el compilador por lotes utilizando Ant. Consulte el tema Tarea Ant del compilador por lotes para obtener información adicional.
El script JspBatchCompiler para ejecutar el compilador por lotes desde la línea de mandatos Qshell se encuentra en el directorio raíz_servidor_aplicaciones/bin.
También hay disponible una tarea Ant para ejecutar el compilador por lotes utilizando Ant. Consulte el tema Tarea Ant del compilador por lotes para obtener información adicional.
JspBatchCompiler -ear.path | -war.path | -enterpriseapp.name <nombre>
[-response.file <nombre_archivo>]
[-webmodule.name <nombre>]
[-filename <nombre jsp | nombre directorio>
[-recurse <true | false>]
[-config.root <vía acceso>]
[-cell.name <nombre>]
[-cluster.name <nombre>] [-node.name <nombre>]
[-server.name <nombre>]
[-profileName <nombre>]
[-extractToDir <vía de acceso>]
[-compileToDir <vía de acceso>]
[-compileToWebInf <true | false>]
[-compileToWebInf <true | false>]
[-compileAfterFailure <true | false>]
[-translate <true | false>]
[-compile <true | false>]
[-removeTempDir <true | false>]
[-forceCompilation <true | false>]
[-useFullPackageNames <true | false>]
[-trackDependencies <true | false>]
[-createDebugClassfiles <true | false>]
[-keepgenerated <true | false>]
[-keepGeneratedclassfiles <true | false>]
[-usePageTagPool <true | false>]
[-useThreadTagPool <true | false>]
[-classloader.parentFirst <true | false>]
[-classloader.singleWarClassloader <true | false>]
[-additional.classpath <vía de acceso de archivos JAR y clases adicionales>]
[-verbose <true | false>]
[-deprecation <true | false>]
[-javaEncoding <codificación>
[-jdkSourceLevel <13 | 14 | 15 | 16 | 17 | 18 >]
[-compilerOptions <lista separada por espacios de opciones del compilador java>]
[-useJikes <true | false>]
[-jsp.file.extensions <extensiones de archivo para procesar>]
[-log.level <SEVERE | WARNING | INFO | CONFIG | FINE | FINER | FINEST | OFF>]
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[z/OS]](../images/ngzos.gif)
*** Consulte batchcompiler.properties.default en WAS_ROOT/bin para obtener más información. ***
*** Consulte JspCBuild.xml en RAÍZ_WAS/bin para obtener más
información sobre el JspC de la tarea Ant pública de WebSphere. ***
![[IBM i]](../images/iseries.gif)
*** Consulte batchcompiler.properties.default en raíz_servidor_aplicaciones/bin para obtener más información. ***
*** Consulte JspCBuild.xml en raíz_servidor_aplicaciones/bin para obtener más información sobre el JSpC de la tarea Ant pública de WebSphere. ***
- Parámetros de configuración del motor JSP para un módulo web.
Consulte el tema Parámetros de configuración del motor JSP.
- Parámetros de configuración del archivo de respuestas del compilador por lotes.
Estos parámetros se encuentran en un archivo de respuestas del compilador por lotes. Consulte -response.file.
- Parámetros de configuración de línea de mandatos del compilador por lotes.
Estos parámetros se entran en la línea de mandatos al ejecutar el compilador por lotes.
- Si el parámetro está en la línea de mandatos, se utiliza su valor.
- Si el parámetro no está en la línea de mandatos, el compilador por lotes busca el parámetro en el archivo de respuestas especificado en la línea de mandatos.
- Si no se especifica ningún archivo de respuesta, o si el parámetro no se encuentra allí, el compilador por lotes buscar el parámetro en los parámetros de configuración del motor JSP del módulo web.
Si no se encuentra ningún parámetro de configuración entre estos tres grupos, se utiliza un valor predeterminado. Se proporcionan los valores predeterminados para los parámetros de configuración junto con la descripción de los mismos.
Salvo el parámetro -profileName, estos parámetros no distinguen entre mayúsculas y minúsculas; -profileName distingue entre mayúsculas y minúsculas. Si los valores especificados para estos argumentos se componen de dos o más palabras separadas por espacios, deberá indicar los valores entre comillas.
El compilador por lotes no crea ni establece los valores de los parámetros del motor JSP equivalente. Esto significa que si se modifica una página JSP de un módulo web desplegado y lo vuelve a compilar el motor JSP durante el tiempo de ejecución, los parámetros de configuración del motor JSP determinará el comportamiento del motor. Por ejemplo, si utiliza el compilador por lotes para compilar un módulo web y utiliza la opción -useFullPackageNames true, los archivos JSP se compilarán para soportar dicha opción. El parámetro del motor JSP useFullPackageNames también debe establecerse en true para que el tiempo de ejecución de JSP pueda cargar las páginas JSP compiladas. Si las páginas JSP se modifican en un módulo web desplegado, los parámetros del motor se deben definir en los mismos valores utilizados en la compilación por lotes.
Para utilizar un compilador por lotes de JSP, escriba uno de los mandatos siguientes en una sola línea en el indicador de mandatos del sistema operativo:
- ear.path | war.path | enterpriseapp.name Representa la vía de acceso completa de un único archivo de archivado de aplicación empresarial (EAR) o un archivo de archivado de aplicación web (WAR) comprimido o ampliado, o el nombre de la aplicación empresarial desplegada que desee compilar. Por ejemplo:
JspBatchCompiler -ear.path c:\myproject\sampleApp.ear
JspBatchCompiler -ear.path /myhfs/myprojects/sampleApp.ear
JspBatchCompiler -war.path c:\myWars\examples.war
JspBatchCompiler -enterpriseapp.name myEnterpriseApp -webmodule.name my.war -filename aDir/main.jsp
JspBatchCompiler -ear.path /home/wasuser/myproject/sampleApp.ear
JspBatchCompiler -war.path /home/wasuser/wars/examples.war
JspBatchCompiler -enterpriseapp.name myEnterpriseApp -webmodule.name my.war -filename mydirectory/main.jsp
- response.file
Especifica la vía de acceso de un archivo que contiene parámetros de configuración que utiliza el compilador por lotes. response.file sólo se utiliza si se proporciona en la línea de mandatos; si se proporciona en un archivo de respuestas, se ignora.
En una instalación predeterminada, el archivo de respuestas de plantilla, batchcompiler.properties.default, está situado en el directorio {RAÍZ_WAS}/bin. Copie esta plantilla para crear sus propios archivos de respuesta que contengan los valores predeterminados de los parámetros que le interesen. Todos los parámetros necesarios y opcionales (excepto response.file) se pueden configurar en un archivo de respuesta. Por ejemplo: JspBatchCompiler -response.file c:\myproject\batchc.props
El archivo de respuestas de plantilla, batchcompiler.properties.default, se encuentra en el directorio raíz_servidor_aplicaciones/properties. Copie esta plantilla para crear sus propios archivos de respuesta que contengan los valores predeterminados de los parámetros que le interesen. Puede configurar todos los parámetros necesarios y opcionales, excepto response.file, en un archivo de respuestas. Por ejemplo: JspBatchCompiler -response.file /home/wasuser/myproject/batchc.props
Valor predeterminado: null
- webmodule.name
Representa el nombre del módulo web específico que desee compilar por lotes. Si este argumento no está definido, se compilan todos los módulos web de la aplicación empresarial. Este parámetro sólo se utiliza cuando se proporciona ear.path o enterpriseapp.name. Este parámetro es útil cuando las páginas JSP de un módulo web específico dentro de una aplicación empresarial desplegada se deben volver a generar, porque se eligen todas las dependencias de biblioteca compartida.
Ejemplo: JspBatchCompiler -enterpriseApp.name sampleApp -webmodule.name myWebModule.war
Valor predeterminado: todos los módulos web de un archivo EAR o una aplicación empresarial se compilan, si este parámetro no se proporciona.
- filename
El nombre de un archivo JSP que desea compilar. Si este argumento no está definido, se compilan todos los archivos del módulo web. Alternativamente, si se establece el nombre_archivo en el nombre de un directorio, solamente se compilarán los archivos JSP de dicho directorio y los directorios hijo de ese directorio. El nombre es relativo a la raíz de contexto del módulo web.
Ejemplo 1: si desea compilar el archivo, myTest.jsp, y éste se encuentra en /subdir/myJSPs, debería especificar -filename /subdir/myJSPs/myTest.jsp.
Ejemplo 2: si desea compilar todos los archivos JSP en /subdir/myJSPs y sus directorios hijo, debería especificar -filename subdir/myJSPs.
Valor predeterminado: se compilan todos los archivos JSP del módulo web. Si se especifica -filename / equivale al valor predeterminado.
- recurse
Determina si se procesan los subdirectorios debajo del directorio de destino. Este parámetro sólo se utiliza cuando se proporciona filename. Establezca el valor como false si desea procesar sólo el directorio denominado por el parámetro filename y no los subdirectorios.
Ejemplo: JspBatchCompiler -enterpriseApp.name sampleApp -filename /subdir1 -recurse false.
Valor predeterminado: true; se procesan todos los directorios del directorio de destino.
- config.root
Especifica la ubicación del directorio de configuración de WebSphere Application Server. Este parámetro sólo se utiliza cuando se proporciona enterpriseapp.name.
Valor predeterminado: {RAÍZ_WAS}/profiles/profilename/config
Valor predeterminado: raíz_perfil/config
- cell.name
Especifica el nombre de la célula en la que se despliega la aplicación. Este parámetro sólo se utiliza cuando se proporciona enterpriseapp.name.
Valor por omisión: el valor por omisión se obtiene del script de perfil que se utiliza. El nombre simbólico de esta variable es WAS_CELL.
- nombre.clúster
Especifica el nombre del clúster en el que está desplegada la aplicación. Este parámetro proporciona el compilador por lotes con acceso a bibliotecas compartidas de ámbito de clúster y solamente se utiliza cuando se indica enterpriseapp.name.
Valor por omisión: el valor por omisión se obtiene del script de perfil que se utiliza. El nombre simbólico de esta variable es WAS_CLUSTER.
- node.name
Especifica el nombre del nodo en el que se despliega la aplicación. Este parámetro sólo se utiliza cuando se proporciona enterpriseapp.name.
Valor por omisión: el valor por omisión se obtiene del script de perfil que se utiliza. El nombre simbólico de esta variable es WAS_NODE.
- server.name
El nombre del servidor en el que se despliega la aplicación. Este parámetro sólo se utiliza cuando se proporciona enterpriseapp.name.
Valor predeterminado: server1
- profileName
Especifica el nombre del perfil que desea utilizar. Este parámetro sólo se utiliza cuando se proporciona enterprise.name o -ear.
Ejemplo: JspBatchCompiler -enterpriseApp.name sampleApp -profileName AppServer-3
Valor predeterminado: Se utiliza el perfil predeterminado. Se obtiene del script setupCmdLine del archivo en el directorio raíz_instalación_root/bin. El nombre simbólico es DEFAULT_PROFILE_SCRIPT.
Valor predeterminado: Se utiliza el perfil predeterminado. Se obtiene del script setupCmdLine del directorio raíz_servidor_aplicaciones/bin. El nombre simbólico es DEFAULT_PROFILE_SCRIPT.
- extractToDir
Especifica el directorio en el que se extraen los archivos de archivado empresarial (EAR) y los archivos de archivado de aplicación web (WAR) desplegados previamente antes de que el compilador por lotes opere en éstos. Este parámetro se ignora cuando se proporciona enterpriseapp.name. El parámetro extractToDir se utiliza como se describe en la tabla.
Ejemplo: JspBatchCompiler -ear.path c:\myproject\sampleApp.ear -extractToDir c:\myTempDir.
Ejemplo: JspBatchCompiler -ear.path c:\myproject\sampleApp.ear -extractToDir /home/wasuser/mytempdir.
Caso de uso: un archivo comprimido debe extraerse antes de compilarlo por lotes. También puede extraer un archivo ampliado a un nuevo directorio. En ambos casos, la extracción deja intacto el archivo original, que puede ser útil al llevar a cabo el desarrollo.
Tabla 1. extractToDir. Valores predeterminados Archivo expandido Archivo comprimido extractToDir proporcionado El compilador por lotes extrae el archivador en extractToDir antes de utilizarlo. Si ya existe un archivo o directorio con el mismo nombre que el indicado en extractToDir, el compilador por lotes elimina completamente el archivador antes de extraerlo. Si el compilador por lotes finaliza sin errores, éste comprime el archivador en el lugar indicado en extractToDir, aunque se haya expandido el archivo EAR o el archivo WAR original. Si se encuentran errores durante la compilación, el archivo EAR o el archivo WAR de deja en estado expandido, aunque el archivo EAR o el archivo WAR se deje en estado expandido. extractToDir no proporcionado El compilador por lotes opera en el archivo EAR o en el archivo WAR (no lo extraiga en otro directorio) y el archivador permanece expandido una vez que finaliza el compilador por lotes. El compilador por lotes extrae el archivador en el directorio que devuelve la propiedad JVM "java.io.tmpdir". El resto del comportamiento descrito, cuando se proporciona extractToDir, es el mismo en este caso. El valor predeterminado es server1.
- compileToDir
Especifica el directorio en el que se convierten las páginas JSP en archivos de origen Java y se compilan en archivos de clase. Este directorio puede estar en cualquier lugar del sistema de archivos, aunque el comportamiento predeterminado del compilador por lotes en general es adecuado. En la tabla se describe el comportamiento del compilador por lotes al compilar los archivos de clase
Ejemplo: JspBatchCompiler -enterpriseApp.name sampleApp -compileToDir c:\myTargetDir
Ejemplo: JspBatchCompiler -enterpriseApp.name sampleApp -compileToDir /home/wasuser/myTargetDir
Caso de uso: este parámetro permite generar los archivos Java y de clase en un directorio fuera del destino, lo que puede ser útil si desea comparar los archivos recién generados con sus versiones anteriores que permanecen intactos dentro del destino.
Tabla 2. compileToDir . Valores predeterminados ear.path o war.path proporcionado enterpriseApp.name proporcionado compileToDir no se proporciona; compileToWebInf no se proporciona o tiene el valor true Los archivos de clase se compilan en el directorio WEB-INF/classes del módulo web Los archivos de clase se compilan en el directorio WEB-INF/classes del módulo web. compileToDir no se proporciona; compileToWebInf tiene el valor false Los archivos de clase se compilan en el directorio WEB-INF/classes del módulo web. Los archivos de clase se compilan en el directorio temporal del producto (normalmente {WAS_ROOT}/temp). compileToDir se proporciona; compileToWebInf no se proporciona, o tiene el valor true o false Los archivos de clase se compilan en el directorio que indica compileToDir. Los archivos de clase se compilan en el directorio que indica compileToDir. Tabla 3. compileToDir . Valores predeterminados ear.path o war.path proporcionado enterpriseApp.name proporcionado compileToDir no se proporciona; compileToWebInf no se proporciona o tiene el valor true Los archivos de clase se compilan en el directorio WEB-INF/classes del módulo web Los archivos de clase se compilan en el directorio WEB-INF/classes del módulo web. compileToDir no se proporciona; compileToWebInf tiene el valor false Los archivos de clase se compilan en el directorio WEB-INF/classes del módulo web. Los archivos de clase se compilan en el directorio temporal del producto (normalmente raíz_perfil/temp). compileToDir se proporciona; compileToWebInf no se proporciona, o tiene el valor true o false Los archivos de clase se compilan en el directorio que indica compileToDir. Los archivos de clase se compilan en el directorio que indica compileToDir. - compileToWebInf
Especifica si el directorio de destino para los archivos de clase JSP compilados debe ser el directorio WEB-INF/classes del módulo web. Este parámetro sólo se utiliza cuando se proporciona enterpriseApp.name, y compileToDir lo altera temporalmente si se proporciona compileToDir.
El comportamiento predeterminado del compilador por lotes es compilar en el directorio WEB-INF/classes del módulo web. En la tabla se describe el comportamiento del compilador por lotes al compilar los archivos de clase.
Ejemplo: JspBatchCompiler -enterpriseApp.name sampleApp -compileToWebInf false.
Caso de uso: defina este parámetro en false cuando se proporcione enterpriseApp.name y desee que los archivos de clase se compilen en el directorio temporal (temp) de WebSphere Application Server, en lugar, del directorio WEB-INF/classes del módulo web. Recomendación: si este parámetro se establece en false, establezca forceCompilation en el valor true si hay algunos archivos de clase JSP en el directorio WEB-INF/classes.
Valor predeterminado: true; consulte la tabla.
- compileAfterFailure
Especifica si el compilador por lotes JDK JSP continúa compilando las otras páginas JSP (JavaServer Pages) del directorio actual si uno o más de los archivos JSP de dicho directorio no puede compilarse. Generalmente, cuando uno de los archivos no puede compilarse, el compilador por lotes de JSP omite todos los archivos JSP restantes del directorio y empieza a compilar los archivos del directorio siguiente.
Si establece este parámetro con el valor true, también debe especificar el parámetro useJDKCompiler y establecerlo con el valor true.
Ejemplo: JspBatchCompiler -enterpriseApp.name sampleApp -useJDKCompiler true –compileAfterFailure false.
Caso de uso: Establezca este parámetro en true si desea que el compilador por lotes de JSP compile los otros archivos JSP (JavaServer Pages) del directorio actual aún cuando uno o más archivos JSP de dicho directorio no puedan compilarse.
Valor predeterminado: false
- forceCompilation
Especifica si el compilador por lotes debe volver a compilar todos los recursos JSP independientemente de que si la página JSP está obsoleta o no.
Ejemplo: JspBatchCompiler -ear.path c:\myproject\sampleApp.ear -forceCompilation true.
Ejemplo: JspBatchCompiler -ear.path /home/wasuser/myproject/sampleApp.ear -forceCompilation true.
Caso de uso: especialmente útil al crear un archivador para su despliegue, para asegurarse de que todas las clases JSP están actualizadas.
Valor predeterminado: false
- useFullPackageNames
Especifica si el compilador por lotes genera nombres completos de paquete para las clases JSP. El valor predeterminado es generar todas las clases JSP en el mismo paquete. El cargador de clases del motor JSP sabe cómo cargar las clases JSP cuando están todas en el mismo paquete. El valor predeterminado tiene la ventaja de generar vías de acceso más pequeñas del sistema de . Los nombres completos de paquetes tienen la ventaja de habilitar la configuración de los archivos de clase JSP compilados previamente como servlets en el archivo web.xml sin el uso del atributo jsp-file, lo que genera que se utilice un solo cargador de clases (el cargador de clases de la aplicación web) para cargar todas estas clases JSP. De forma parecida, cuando los atributos de configuración useFullPackageNames y disableJspRuntimeCompilation del motor JSP tienen los dos el valor true, se utiliza un solo cargador de clases para cargar todas las clases JSP, aunque las páginas JSP no estén configuradas como servlets en el archivo web.xml.
Cuando useFullPackageNames está definido en true, el compilador de proceso por lotes genera un archivo llamado generated_web.xml en el directorio WEB-INF del módulo web. Este archivo contiene información de configuración de servlets para cada página JSP que se ha convertido y compilado satisfactoriamente. De forma opcional, la información se puede copiar en el archivo web.xml del módulo web, de forma que las páginas JSP se carguen como servlets por el contenedor web. Tenga en cuenta que si se configura de esta manera una página JSP como un servlet, no se realiza la recarga de la página JSP en el tiempo de ejecución si se modifica la página JSP. Esto se debe a que la página JSP se trata como un servlet normal y las solicitudes dirigidas a él no pasarán por el motor JSP.
Ejemplo: JspBatchCompiler –enterpriseApp.name sampleApp –useFullPackageNames true
Caso de uso: Permite que un solo cargador de clases cargue las clases JSP.
Valor predeterminado: false
- removeTempDir
Especifica si se elimina el directorio temporal del módulo web. El compilador por lotes genera de forma predeterminada los archivos de clase JSP en un directorio WEB-INF/classes del módulo web. Los archivos de clase JSP se generan en el directorio temp durante el tiempo de ejecución si se modifica una página JSP y está habilitada la recarga de JSP. Gracias a compilar por lotes todas las páginas JSP en un módulo web y eliminar también el directorio temp, los recursos de disco se conservan. Sólo puede utilizar el parámetro removeTempDir cuando se proporciona -enterpriseApp.name.
Ejemplo: JspBatchCompiler -enterpriseApp.name sampleApp -removeTempDir true.
Caso de uso: libere espacio en disco borrando el directorio temp de una aplicación web.
Valor predeterminado: false
- translate
Especifica si se convierten y se compilan las páginas JSP. Establezca la opción translate en el valor false si no desea que se conviertan y compilen las páginas JSP. Debe utilizar esta opción junto con -removeTempDir para indicar al compilador por lotes que elimine sólo el directorio temp y que no realice ningún proceso adicional.
Ejemplo: JspBatchCompiler -enterpriseApp.name sampleApp -translate false -removeTempDir true.
Caso de uso: libere espacio en disco borrando el directorio temp de una aplicación web, sin invocar el proceso JSP.
Valor por omisión: true
- compile
Especifica si las páginas JSP deben pasar la fase de compilación Java. Establezca la opción compile en el valor false si no desea que las páginas JSP pasen por la fase de compilación Java.
Ejemplo: JspBatchCompiler -enterpriseApp.name sampleApp -compile false
Caso de uso: si sólo desea que se compruebe la sintaxis de las páginas JSP, establezca -compile en el valor false. Puede establecer -keepgenerated en true si desea ver los archivos .java que se generan durante la fase de conversión.
Valor por omisión: true
- trackDependencies Especifica si el compilador por lotes recompila una página JSP cuando se modifica alguna de sus dependencias, aunque la página JSP no se haya modificado. El seguimiento de las dependencias supone una reducción grave del rendimiento en el tiempo de ejecución, porque el motor JSP comprueba el sistema de archivos en cada una de las solicitudes para una página JSP para ver si se ha modificado alguna de las dependencias. WebSphere Application Server hace un seguimiento de las siguientes dependencias:
- Archivos incluidos estáticamente en la página JSP
- Archivos de distintivos utilizados por la página JSP (excepto los archivos de distintivos que hay en los archivos JAR)
- Archivos TLD utilizados por la página JSP (excepto los archivos TLD que hay en los archivos JAR)
Ejemplo: JspBatchCompiler -ear.path c:\myproject\sampleApp.ear -trackDependencies true.
Ejemplo: JspBatchCompiler -ear.path /home/wasuser/myproject/sampleApp.ear -trackDependencies true.
Caso de uso: Es útil en un entorno de desarrollo.
Valor predeterminado: false
- createDebugClassfiles
Especifica si el compilador por lotes genera archivos de clase que contengan información SMAP, según la especificación JSR 45, Soporte de depuración para otros idiomas.
Ejemplo: JspBatchCompiler -enterpriseApp.name sampleApp -createDebugClassfiles true
Caso de uso: utilice este parámetro cuando desee poder depurar las páginas JSP del IDE que cumple con las especificaciones JSR 45.
Valor predeterminado: false
- keepgenerated
Especifica si el compilador por lotes guarda o borra los archivos de origen Java generados que se han creado durante la fase de conversión.
Si se establece en true, WebSphere Application Server guarda los archivos .java generados para la compilación en su servidor. De manera predeterminada, este argumento se establece en false y los archivos .java se borran una vez compilados los archivos de clase.
Ejemplo: JspBatchCompiler -ear.path c:\myproject\sampleApp.ear -keepgenerated true
Ejemplo: JspBatchCompiler -ear.path /home/wasuser/myproject/sampleApp.ear -keepgenerated true
Caso de uso: utilice este parámetro cuando desee poder revisar el código Java generado por el compilador por lotes.
Valor predeterminado: false
- keepGeneratedclassfiles
Especifica si el compilador por lotes guarda o borra los archivos de clase generados durante la compilación de los archivos de origen Java.
Ejemplo: JspBatchCompiler -ear.path c:\myproject\sampleApp.ear -keepGeneratedclassfiles false -keepgenerated false
Ejemplo: JspBatchCompiler -ear.path /home/wasuser/myproject/sampleApp.ear -keepGeneratedclassfiles false -keepgenerated false
Caso de uso: establezca este parámetro en el valor false sólo si desea ver si hay errores de conversión o compilación en las páginas JSP. Si se especifica junto -keepgenerated false, este parámetro hará que se eliminen todos los archivos generados antes de que finalice el compilador por lotes.
Valor por omisión: true
- usePageTagPool
Habilita o inhabilita la reutilización de los manejadores de distintivos personalizados de forma individual para cada página JSP.
Ejemplo: JspBatchCompiler -ear.path c:\myproject\sampleApp.ear -usePageTagPool true
Ejemplo: JspBatchCompiler -ear.path /home/wasuser/myproject/sampleApp.ear -usePageTagPool true
Caso de uso: utilice este parámetro para habilitar la reutilización basada en páginas web de los manejadores de distintivos.
Valor predeterminado: false
- useThreadTagPool
Habilita o inhabilita la reutilización de los manejadores de distintivos personalizados por hebra de solicitud por módulo web.
Ejemplo: JspBatchCompiler -ear.path c:\myproject\sampleApp.ear -useThreadTagPool true
Ejemplo: JspBatchCompiler -ear.path /home/wasuser/myproject/sampleApp.ear -useThreadTagPool true
Caso de uso: utilice este parámetro para habilitar la reutilización basada en módulo web de manejadores de distintivos.
Valor predeterminado: false
- classloader.parentFirst
Especifica el orden de búsqueda para la carga de clases indicando al compilador por lotes que busque al cargador de clases padre antes que al cargador de clases de aplicación. Este parámetro sólo se utiliza cuando se indica ear.path o enterpriseApp.name.
Ejemplo: JspBatchCompiler -ear.path c:\myproject\sampleApp.ear -classloader.parentFirst false
Ejemplo: JspBatchCompiler -ear.path /home/wasuser/myproject/sampleApp.ear -classloader.parentFirst false
Caso de uso: defina este parámetro en false cuando el módulo web contenga un archivo JAR que también se encuentra en el directorio lib del servidor y desea que el archivo JAR del módulo web se elija en primer lugar.
Valor por omisión: true
- classloader.singleWarClassloader
Especifica si se va a utilizar un cargador de clases por archivo EAR o un cargador de clases por archivo WAR. Sólo se utiliza cuando se proporciona ear.path o enterpriseApp.name.
Ejemplo: JspBatchCompiler -ear.path c:\myproject\sampleApp.ear -classloader.singleWarClassloader true
Ejemplo: JspBatchCompiler -ear.path /home/wasuser/myproject/sampleApp.ear -classloader.singleWarClassloader true
Caso de uso: defina este parámetro en true cuando un módulo web dependa de los archivos y las clases JAR de otro módulo web de la misma aplicación empresarial.
Valor predeterminado: false; se crea un cargador de clases por archivo WAR sin verse las clases de otros módulos web.
- additional.classpath
Especifica las entradas de vías de acceso de clases adicionales que se deben utilizar al analizar y compilar páginas JSP. Este parámetro sólo se utiliza cuando se proporciona war.path. Cuando war.path es el destino, el compilador por lotes no elige las bibliotecas compartidas de WebSphere. Por lo tanto, si por ejemplo el archivo WAR se basa en un archivo JAR configurado en WebSphere Application Server como una biblioteca compartida, utilice esta opción para señalar a este archivo JAR. Asimismo, si proporciona war.path y también utiliza el parámetro -extractToDir, todos los JAR que hay en la variable classpath de manifiesto del WAR no se añadirán a la variable classpath (puesto que ahora el archivo WAR se ha extraído automáticamente fuera del archivo EAR en el que reside). En este caso, utilice -additional.classpath para señalar a los archivos JAR necesarios. Añada la vía de acceso completa de los recursos necesarios, separados por el separador de vía de acceso correspondiente del sistema.
Ejemplo: JspBatchCompiler -war.path c:\myproject\examples.war -additional.classpath c:\myJars\someJar.jar;c:\myClasses
Ejemplo: JspBatchCompiler -war.path /home/wasuser/myproject/examples.war -additional.classpath /home/wasuser/myJars/someJar.jar:/home/wasuser/myClasses
Caso de uso: utilice este parámetro para añadirlo a los archivos y clases JAR de la classpath fuera del archivo WAR. En el tiempo de ejecución, estos mismos archivos y clases JAR tienen que estar disponibles a través de los mecanismos de configuración de WebSphere Application Server estándar.
Valor predeterminado: null
- verbose
Especifica si el compilador por lotes debe generar una salida en modalidad verbosa mientras compila los códigos de origen generados.
Ejemplo: JspBatchCompiler -war.path c:\myproject\examples.war -verbose true
Ejemplo: JspBatchCompiler -war.path /home/wasuser/myproject/examples.war -verbose true
Caso de uso: establezca este parámetro en el valor true si desea ver la carga de clases del compilador Java y otros mensajes.
Valor predeterminado: false
- deprecation
Indica que el compilador debe generar avisos de puesta en desuso cuando compila los códigos de origen generados.
Ejemplo: JspBatchCompiler -war.path c:\myproject\examples.war -deprecation true
Ejemplo: JspBatchCompiler -war.path /home/wasuser/myproject/examples.war -deprecation true
Caso de uso: establezca este parámetro en el valor true si desea ver los mensajes de puesta en desuso del compilador Java.
Valor predeterminado: false
- javaEncoding
Especifica la codificación que se utiliza cuando se genera el archivo .java y cuando lo compila el compilador Java. Cuando se establece -javaEncoding, se pasa esta codificación al compilador Java mediante el argumento -encoding. Recuerde que Jikes no da soporte a la codificación.
Ejemplo: JspBatchCompiler -war.path c:\myproject\examples.war -javaEncoding Shift-JIS
Ejemplo: JspBatchCompiler -war.path/home/wasuser/myproject/examples.war -javaEncoding Shift-JIS
Caso de uso: establezca este parámetro cuando la codificación de páginas de las páginas JSP no es compatible con UTF-8.
Valor por defecto: UTF-8.
- jdkSourceLevel
Este parámetro del motor JSP se ha introducido en WebSphere Application Server versión 6.1 para soportar JDK 5. Utilice este parámetro, en lugar del parámetro compileWithAssert, aunque WithAssert de compilación sigue funcionando en la versión 6.1.
El valor predeterminado de este parámetro es 17. Este parámetro requiere volver a generar el origen Java. Los siguientes son los valores del parámetro jdkSourceLevel:- El valor 13 inhabilita todas las características de idioma nuevas de JDK 1.4, JDK 5.0, JDK 6.0, JDK 7.0 y 8.0.
- El valor 14 habilita el uso del recurso de evaluación e inhabilita todas las nuevas características de idioma de JDK 5.0, JDK 6.0, JDK 7.0 y 8.0.
- El valor 15 habilita el uso del recurso de evaluación e inhabilita todas las nuevas características de idioma de JDK 6.0, JDK 7.0 y 8.0.
- El valor 16 habilita el uso del recurso de evaluación e inhabilita todas las nuevas características de idioma de JDK 7.0 y 8.0.
- El valor 17 habilita el uso del recurso de evaluación e inhabilita todas las nuevas características de idioma de JDK 8.0.
- El valor 18 habilita el uso de las nuevas características de JDK 8.0.
Ejemplo: JspBatchCompiler -war.path c:\myproject\examples.war -jdkSourceLevel 14
Caso de uso: defina este parámetro cuando desee habilitar o inhabilitar las características de idioma de JDK 1.4, JDK 5.0, JDK 6.0, JDK 7.0 y 8.0
Valor predeterminado: 17
- compilerOptions
Especifica una lista de series que se van a pasar en el mandato de compilador Java. Es una lista separada por espacios con el formato "arg1 arg2 argn".
Ejemplo: JspBatchCompiler -war.path c:\myproject\examples.war -compilerOptions "-bootclasspath <path>"
Ejemplo: JspBatchCompiler -war.path /home/wasuser/myproject/examples.war -compilerOptions "-bootclasspath <path>"
Caso de uso: utilice este parámetro si necesita argumentos del compilador Java distintos de verbose, deprecation y del soporte del recursos de aserción.
Valor predeterminado: null
- useJikes
Especifica si se debe utilizar Jikes para compilar los orígenes Java. NOTA: Jikes no se incluye con WebSphere Application Server.
Ejemplo: JspBatchCompiler -ear.path c:\myproject\sampleApp.ear -useJikes true
Ejemplo: JspBatchCompiler -ear.path /home/wasuser/myproject/sampleApp.ear -useJikes true
Caso de uso: establezca este parámetro en el valor true para que el compilador por lotes utilice Jikes como el compilador Java.
Valor por omisión: false
- jsp.file.extensions
Especifica las extensiones de archivo que va a procesar el compilador por lotes. Esta es una lista separada por signos de punto y coma o una lista separadas por signos de dos puntos con el formato *.ext1;*.ext2:*.extn. Tenga en cuenta que este parámetro no es necesario para las aplicaciones web de Servlet 2.4 porque la propiedad url-pattern de los elementos jsp-property-group del descriptor de despliegue se puede utilizar para identificar las extensiones que se deben tratar como páginas JSP.
Ejemplo: JspBatchCompiler -enterpriseApp.name sampleApp -jsp.file.extensions *jspz;*.jspt
Caso de uso: utilice este parámetro para añadir extensiones adicionales que el compilador por lotes va a procesar.
Valor por omisión: null. Consulte la sección, "Extensiones de archivos JSP", en este tema para obtener información adicional.
- log.level
Especifica el nivel de registro cronológico que se dirige a la consola durante la compilación por lotes. Los valores son SEVERE | WARNING | INFO | CONFIG | FINE | FINER | FINEST | OFF
Ejemplo: JspBatchCompiler -enterpriseApp.name sampleApp -log.level FINEST
Caso de uso: establezca este parámetro en un valor más alto o más bajo para controlar la salida del registro cronológico. FINEST genera la salida más útil para la depuración.
Valor por omisión: CONFIG