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

El compilador por lotes determina qué extensiones de archivo debe procesar utilizando cuatro elementos:
  1. Las extensiones de archivo JSP estándar
    • .jsp
    • .jspx
    • .jsw
    • .jsv
  2. 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
  3. El parámetro de configuración del motor JSP jsp.file.extensions (para módulos web anteriores a Servlet 2.4)
  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

[AIX Solaris HP-UX Linux Windows][z/OS]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.

[IBM i]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.

El destino del compilador por lotes es el único parámetro obligatorio. El destino es -ear.path, -war.path o -enterpriseapp.name.
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][z/OS]
			*** 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]
			*** 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. ***
El compilador por lotes reconoce tres grupos de parámetros de configuración:
  1. Parámetros de configuración del motor JSP para un módulo web.

    Consulte el tema Parámetros de configuración del motor JSP.

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

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

El compilador por lotes examina los tres grupos de parámetros de configuración para determinar qué valor de un parámetro se utiliza al compilar páginas JSP. Cuando se resuelve el valor de un parámetro dado, la prioridad es:
  1. Si el parámetro está en la línea de mandatos, se utiliza su valor.
  2. 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.
  3. 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:
    • [AIX Solaris HP-UX Linux Windows]JspBatchCompiler -ear.path c:\myproject\sampleApp.ear
    • [z/OS]JspBatchCompiler -ear.path /myhfs/myprojects/sampleApp.ear
    • [AIX Solaris HP-UX Linux Windows][z/OS]JspBatchCompiler -war.path c:\myWars\examples.war
    • [AIX Solaris HP-UX Linux Windows][z/OS]JspBatchCompiler -enterpriseapp.name myEnterpriseApp -webmodule.name my.war -filename aDir/main.jsp
    • [IBM i]JspBatchCompiler -ear.path /home/wasuser/myproject/sampleApp.ear
    • [IBM i]JspBatchCompiler -war.path /home/wasuser/wars/examples.war
    • [IBM i]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.

    [AIX Solaris HP-UX Linux Windows][z/OS]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

    [IBM i]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.

    [AIX Solaris HP-UX Linux Windows][z/OS]Valor predeterminado: {RAÍZ_WAS}/profiles/profilename/config

    [IBM i]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

    [AIX Solaris HP-UX Linux Windows][z/OS]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.

    [IBM i]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.

    [AIX Solaris HP-UX Linux Windows][z/OS]Ejemplo: JspBatchCompiler -ear.path c:\myproject\sampleApp.ear -extractToDir c:\myTempDir.

    [IBM i]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

    [AIX Solaris HP-UX Linux Windows][z/OS]Ejemplo: JspBatchCompiler -enterpriseApp.name sampleApp -compileToDir c:\myTargetDir

    [IBM i]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.

    [AIX Solaris HP-UX Linux Windows][z/OS]
    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.
    [IBM i]
    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.

    [AIX Solaris HP-UX Linux Windows][z/OS]Ejemplo: JspBatchCompiler -ear.path c:\myproject\sampleApp.ear -forceCompilation true.

    [IBM i]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:
    1. Archivos incluidos estáticamente en la página JSP
    2. Archivos de distintivos utilizados por la página JSP (excepto los archivos de distintivos que hay en los archivos JAR)
    3. Archivos TLD utilizados por la página JSP (excepto los archivos TLD que hay en los archivos JAR)

    [AIX Solaris HP-UX Linux Windows][z/OS]Ejemplo: JspBatchCompiler -ear.path c:\myproject\sampleApp.ear -trackDependencies true.

    [IBM i]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.

    [AIX Solaris HP-UX Linux Windows][z/OS]Ejemplo: JspBatchCompiler -ear.path c:\myproject\sampleApp.ear -keepgenerated true

    [IBM i]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.

    [AIX Solaris HP-UX Linux Windows][z/OS]Ejemplo: JspBatchCompiler -ear.path c:\myproject\sampleApp.ear -keepGeneratedclassfiles false -keepgenerated false

    [IBM i]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.

    [AIX Solaris HP-UX Linux Windows][z/OS]Ejemplo: JspBatchCompiler -ear.path c:\myproject\sampleApp.ear -usePageTagPool true

    [IBM i]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.

    [AIX Solaris HP-UX Linux Windows][z/OS]Ejemplo: JspBatchCompiler -ear.path c:\myproject\sampleApp.ear -useThreadTagPool true

    [IBM i]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.

    [AIX Solaris HP-UX Linux Windows][z/OS]Ejemplo: JspBatchCompiler -ear.path c:\myproject\sampleApp.ear -classloader.parentFirst false

    [IBM i]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.

    [AIX Solaris HP-UX Linux Windows][z/OS]Ejemplo: JspBatchCompiler -ear.path c:\myproject\sampleApp.ear -classloader.singleWarClassloader true

    [IBM i]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.

    [AIX Solaris HP-UX Linux Windows][z/OS]Ejemplo: JspBatchCompiler -war.path c:\myproject\examples.war -additional.classpath c:\myJars\someJar.jar;c:\myClasses

    [IBM i]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.

    [AIX Solaris HP-UX Linux Windows][z/OS]Ejemplo: JspBatchCompiler -war.path c:\myproject\examples.war -verbose true

    [IBM i]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.

    [AIX Solaris HP-UX Linux Windows][z/OS]Ejemplo: JspBatchCompiler -war.path c:\myproject\examples.war -deprecation true

    [IBM i]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.

    [AIX Solaris HP-UX Linux Windows][z/OS]Ejemplo: JspBatchCompiler -war.path c:\myproject\examples.war -javaEncoding Shift-JIS

    [IBM i]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".

    [AIX Solaris HP-UX Linux Windows][z/OS]Ejemplo: JspBatchCompiler -war.path c:\myproject\examples.war -compilerOptions "-bootclasspath <path>"

    [IBM i]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.

    [AIX Solaris HP-UX Linux Windows][z/OS]Ejemplo: JspBatchCompiler -ear.path c:\myproject\sampleApp.ear -useJikes true

    [IBM i]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


Icon that indicates the type of topic Reference topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rweb_jspbchtl
File name: rweb_jspbchtl.html