Configuración de parámetros del motor JSP

Información acerca de cómo añadir, cambiar o suprimir parámetros de configuración de motor JSP

Acerca de esta tarea

La siguiente nota se aplica a los archivos de referencias con una extensión .xmi en este tema:
Supported configurations Supported configurations: Para los archivos de enlace y extensión de IBM®, la extensión del nombre de archivo .xmi o .xml es diferente en función de si se utiliza una aplicación o módulo previo a Java EE 5 o una aplicación o módulo Java™ EE 5 o posterior. Un archivo de enlace o extensión de IBM se denomina ibm-*-ext.xmi o ibm-*-bnd.xmi donde * es el tipo de archivo de extensión o enlace como app, application, ejb-jar o web. Se aplican las condiciones siguientes:
  • En el caso de una aplicación o módulo que utilice una Java EE anterior a la versión 5, la extensión del archivo debe ser .xmi.
  • En el caso de una aplicación que utilice Java EE versión 5 o posterior, la extensión del archivo debe ser .xml. Si los archivos .xmi se incluyen con la aplicación o el módulo, el producto ignora los archivos .xmi.

No obstante, puede existir un módulo de Java EE 5 o posterior dentro de una aplicación que incluya archivos previos a Java EE 5 y que utilice la extensión de nombre de archivo .xmi.

Los archivos ibm-webservices-ext.xmi, ibm-webservices-bnd.xmi, ibm-webservicesclient-bnd.xmi, ibm-webservicesclient-ext.xmi, y ibm-portlet-ext.xmi siguen utilizando la extensión de archivo .xmi.

sptcfg
WebSphere Application Server no da soporte a la modificación de parámetros de extensión del descriptor de despliegue mediante la consola administrativa o los scripts de administración.
Best practice Best practice: Utilice una herramienta de ensamblaje como, por ejemplo, Rational Application Developer, para modificar los archivos de extensiones y enlace de IBM. Puede convertir archivos de extensiones y enlace en los módulos de XMI a XML utilizando la herramienta de conversión de enlaces y extensiones de IBM para multiplataformas.bprac

Para añadir, cambiar o suprimir parámetros de configuración del motor JSP, siga estos pasos:

Procedimiento

  1. Abra los archivos WEB-INF/ibm-web-ext.xmi o WEB-INF/ibm-web-ext.xml. [AIX Solaris HP-UX Linux Windows][z/OS]

    Los parámetros de configuración del motor JSP se almacenan en un directorio de configuración del módulo web o en un directorio de binarios de un módulo web en el archivo WEB-INF/ibm-web-ext.xmi o WEB-INF/ibm-web-ext.xml. Abra el archivo WEB-INF/ibm-web-ext.xmi o WEB-INF/ibm-web-ext.xml desde:

    [AIX Solaris HP-UX Linux Windows][z/OS]
    • El directorio de configuración, como en el ejemplo siguiente:
      {WAS_ROOT}/profiles/profilename/config/cells/cellname/applications/enterpriseappname/deployments/deployedname/webmodulename
    • El directorio de binarios si se ha desplegado una aplicación en WebSphere Application Server con el distintivo Utilizar configuración binaria establecido como true. Por ejemplo, un directorio de binarios sería:
      {RAÍZ_WAS}/profiles/nombreperfil/installedApps/nombrenodo/NombreAplicEmpresa/NombreMóduloWeb/ 
    [IBM i]

    Los parámetros de configuración del motor JSP se almacenan en un directorio de configuración del módulo web o en un directorio de binarios de un módulo web en el archivo WEB-INF/ibm-web-ext.xmi o WEB-INF/ibm-web-ext.xml. Abra el archivo WEB-INF/ibm-web-ext.xmi o WEB-INF/ibm-web-ext.xml desde:

    [IBM i]
    • El directorio de configuración, como en los ejemplos siguientes:
      raíz_perfil/config/cells/cellName/applications/enterpriseAppName/deployments/deployedName/webModuleName/WEB-INF/ibm-web-ext.xmi
      raíz_perfil/config/cells/cellName/applications/enterpriseAppName/deployments/deployedName/webModuleName/WEB-INF/ibm-web-ext.xml
    • El directorio de binarios si se ha desplegado una aplicación en WebSphere Application Server con el distintivo Utilizar configuración binaria establecido como true. Un ejemplo de directorio de binarios sería:
      raíz_perfil/installedApps/nombreNodo/nombreAplicación.ear/applicationName.war/WEB-INF/ibm-web-ext.xmi
      raíz_perfil/installedApps/nombreNodo/nombreAplicación.ear/applicationName.war/WEB-INF/ibm-web-ext.xml
  2. Edite los archivos WEB-INF/ibm-web-ext.xmi o WEB-INF/ibm-web-ext.xml.
    • Para añadir parámetros de configuración al archivo WEB-INF/ibm-web-ext.xmi, utilice el formato siguiente:
      xmi:id="JSPAttribute_6" name="parametername" value="parametervalue"/> 
    • Para añadir parámetros de configuración al archivo WEB-INF/ibm-web-ext.xml, utilice el formato siguiente:
      <jsp-attribute name="parametername" value="parametervalue"/>
    • Para suprimir parámetros de configuración, suprima la línea del archivo, o bien cierre la sentencia entre los distintivos <!-- -->.
  3. Guarde el archivo.
  4. Reinicie la aplicación de empresa. No es necesario reiniciar el servidor para que se apliquen los cambios en los parámetros. No obstante, algunos parámetros de configuración de motor de JSP afectan al código fuente Java que se genera para una JSP. Si se cambia este parámetro, debe volver a convertir los archivos JSP en el módulo web para volver a generar el origen Java. Puede utilizar el compilador de proceso por lotes para volver a convertir todos los archivos JSP de un módulo web. El compilador de proceso por lotes utiliza los parámetros de configuración de motor de JSP que haya establecido en el archivo ibm-web-ext.xmi o ibm-web-ext.xml, a menos que los altere temporalmente de forma específica. El tema Parámetros de configuración de motor de JSP identifica los parámetros que afectan al origen Java generado.

Ejemplo

A continuación se proporciona un ejemplo del archivo WEB-INF/ibm-web-ext.xmi. Las líneas en negrita son parámetros de configuración del motor JSP.
<?xml version="1.0" encoding="UTF-8"?>
<webappext:WebAppExtension xmi:version="2.0" xmlns:xmi=http://www.omg.org/XMI
   xmlns:webappext="webappext.xmi" xmlns:webapplication="webapplication.xmi" xmi:id="WebAppExtension_1"   
   reloadInterval="9" reloadingEnabled="true" defaultErrorPage="error.jsp" additionalClassPath="" 
   fileServingEnabled="true" directoryBrowsingEnabled="false" serveServletsByClassnameEnabled="true" 
   autoRequestEncoding="true" autoResponseEncoding="false">
   <webApp href="WEB-INF/web.xml#WebApp_1"/>
   <jspAttributes xmi:id="JSPAttribute_1" name="useThreadTagPool" value="true"/>
   <jspAttributes xmi:id="JSPAttribute_2" name="verbose" value="false"/>
   <jspAttributes xmi:id="JSPAttribute_3" name="deprecation" value="false"/>
   <jspAttributes xmi:id="JSPAttribute_4" name="reloadEnabled" value="true"/>
   <jspAttributes xmi:id="JSPAttribute_5" name="reloadInterval" value="5"/>
   <jspAttributes xmi:id="JSPAttribute_6" name="keepgenerated" value="true"/>
   <!--<jspAttributes xmi:id="JSPAttribute_7" name="trackDependencies" value="true"/> -->
   
</webappext:WebAppExtension>
A continuación se muestra un ejemplo del archivo WEB-INF/ibm-web-ext.xml. Las líneas en negrita son parámetros de configuración del motor JSP.
<?xml version="1.0" encoding="UTF-8"?>
<web-ext
   xmlns="http://websphere.ibm.com/xml/ns/javaee"
   	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
   xsi:schemaLocation="http://websphere.ibm.com/xml/ns/javaee http://websphere.ibm.com/xml/ns/javaee/ibm-web-ext_1_0.xsd"
      version="1.0">

   <default-error-page uri="error.jsp"/>
   <jsp-attribute name="useThreadTagPool" value="true" />
   <jsp-attribute name="verbose" value="false" />
   <jsp-attribute name="deprecation" value="false" />
   <jsp-attribute name="reloadEnabled" value="true" />
   <jsp-attribute name="reloadInterval" value="5" />
   <jsp-attribute name="keepgenerated"  value="true" />
   <jsp-attribute name="trackDependencies" value="true" />
   <reload-interval value="9"/>
   <auto-encode-requests value="true"/>
   <auto-encode-responses value="false"/>
   <enable-directory-browsing value="false"/>
   <enable-file-serving value="false"/>
   <pre-compile-jsps value="false"/>
   <enable-reloading value="true"/>
   <enable-serving-servlets-by-class-name value="true"/>
</web-ext>
Atención: El entero n en JSPattribute_n tiene que ser exclusivo dentro del archivo.

Icon that indicates the type of topic Task topic



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