Configurando Parâmetros do Mecanismo JSP

Aprenda como incluir, alterar ou excluir os parâmetros de configuração do mecanismo JSP.

Sobre Esta Tarefa

A seguinte nota aplica-se a referências de arquivos com uma extensão .xmi neste tópico:
Configurações suportadas Configurações suportadas: Para arquivos de extensão e de ligação IBM®, a extensão do nome do arquivo .xmi ou .xml é diferente dependendo de você estar utilizando um aplicativo pré-Java EE 5 ou um módulo ou um aplicativo ou módulo Java™ EE 5 ou posterior. Um arquivo de extensão ou de ligação IBM é denominado ibm-*-ext.xmi ou ibm-*-bnd.xmi em que * é o tipo de arquivo de extensão ou de ligação como app, aplicativo, ejb-jar ou web. As seguintes condições se aplicam:
  • Para um aplicativo ou módulo que usa um Java EE versão anterior à versão 5, a extensão do arquivo deverá ser .xmi.
  • Para um aplicativo ou módulo que usa Java EE 5 ou posterior, a extensão do arquivo deve ser .xml. Se os arquivos .xmi forem incluídos no aplicativo ou módulo, o produto ignorará os arquivos .xmi.

No entanto, um módulo Java EE 5 ou posterior pode existir dentro de um aplicativo que inclui arquivos pré-Java EE 5 e usa a extensão do nome do arquivo .xmi.

Os arquivos ibm-webservices-ext.xmi, ibm-webservices-bnd.xmi, ibm-webservicesclient-bnd.xmi, ibm-webservicesclient-ext.xmi, e ibm-portlet-ext.xmi continuam a usar as extensões de arquivo .xmi.

sptcfg
O WebSphere Application Server não suporta a modificação de parâmetros de extensão do descritor de implementação por meio do Console Administrativo ou de scripts administrativos.
Boas Práticas Boas Práticas: Use uma ferramenta de montagem, como o Rational Application Developer, para modificar os arquivos de extensão e ligação da IBM. É possível converter os arquivos de extensão e ligação nos módulos, de XMI para XML usando a IBM Bindings and Extensions Conversion Tool for Multi-Platforms.bprac

Para incluir, alterar ou excluir os parâmetros de configuração do mecanismo JSP, execute as etapas a seguir:

Procedimento

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

    Os parâmetros de configuração do mecanismo JSP são armazenados em um diretório de configuração do módulo da Web ou em um diretório de binários do módulo da Web no arquivo WEB-INF/ibm-web-ext.xmi ou WEB-INF/ibm-web-ext.xml. Abra o arquivo WEB-INF/ibm-web-ext.xmi ou WEB-INF/ibm-web-ext.xml a partir de:

    [AIX Solaris HP-UX Linux Windows][z/OS]
    • O diretório de configuração, como no exemplo a seguir:
      {WAS_ROOT}/profiles/profilename/config/cells/cellname/applications/enterpriseappname/deployments/deployedname/webmodulename
    • O diretório de binários, se um aplicativo foi implementado no WebSphere Application Server com o sinalizador Usar Configuração de Binário configurado como true. Um exemplo de diretório de binários é:
      {WAS_ROOT}/profiles/profilename/installedApps/nodename/EnterpriseAppName/WebModuleName/ 
    [IBM i]

    Os parâmetros de configuração do mecanismo JSP são armazenados em um diretório de configuração do módulo da Web ou em um diretório de binários do módulo da Web no arquivo WEB-INF/ibm-web-ext.xmi ou WEB-INF/ibm-web-ext.xml. Abra o arquivo WEB-INF/ibm-web-ext.xmi ou WEB-INF/ibm-web-ext.xml a partir de:

    [IBM i]
    • O diretório de configuração, como nos exemplos a seguir:
      profile_root/config/cells/cellName/applications/enterpriseAppName/deployments/deployedName/webModuleName/WEB-INF/ibm-web-ext.xmi
      profile_root/config/cells/cellName/applications/enterpriseAppName/deployments/deployedName/webModuleName/WEB-INF/ibm-web-ext.xml
    • O diretório de binários, se um aplicativo foi implementado no WebSphere Application Server com o sinalizador Usar Configuração de Binário configurado como true. Um exemplo de um diretório de binários é:
      profile_root/installedApps/nodeName/applicationName.ear/applicationName.war/WEB-INF/ibm-web-ext.xmi
      profile_root/installedApps/nodeName/applicationName.ear/applicationName.war/WEB-INF/ibm-web-ext.xml
  2. Edite o arquivo WEB-INF/ibm-web-ext.xmi ou WEB-INF/ibm-web-ext.xml.
    • Para incluir parâmetros de configuração no arquivo WEB-INF/ibm-web-ext.xmi, use o seguinte formato:
      xmi:id="JSPAttribute_6" name="parametername" value="parametervalue"/> 
    • Para incluir parâmetros de configuração no arquivo WEB-INF/ibm-web-ext.xml, use o seguinte formato:
      <jsp-attribute name="parametername" value="parametervalue"/>
    • Para excluir parâmetros de configuração, exclua a linha do arquivo ou coloque a instrução entre tags <!-- -->.
  3. Salve o arquivo.
  4. Reinicie o Aplicativo Corporativo. Não é necessário reiniciar o servidor para que as mudanças de parâmetros tenham efeito. No entanto, alguns parâmetros de configuração do mecanismo JSP afetam o código-fonte Java gerado para uma JSP. Se esses parâmetros forem alterados, você deverá converter novamente os arquivos JSP no módulo da Web para gerar novamente a fonte Java. É possível usar o compilador de lotes para converter novamente todos os arquivos JSP em um módulo da Web. O compilador de lotes usa os parâmetros de configuração do mecanismo JSP que foram configurados no arquivo ibm-web-ext.xmi ou ibm-web-ext.xml, a menos que você os substitua especificamente. O tópico Parâmetros de Configuração do Mecanismo JSP identifica os parâmetros que afetam a origem Java gerada.

Exemplo

A seguinte amostra é do arquivo WEB-INF/ibm-web-ext.xmi. As linhas com texto em negrito são parâmetros de configuração do mecanismo 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 seguir há uma amostra do arquivo WEB-INF/ibm-web-ext.xml. As linhas com texto em negrito são parâmetros de configuração do mecanismo 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>
Atenção: O inteiro n em JSPattribute_n deve ser exclusivo dentro do arquivo.

Ícone que indica o tipo de tópico Tópico de Tarefa



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tweb_jspengine
Nome do arquivo: tweb_jspengine.html