Comando JSPBatchCompiler
O compilador de lotes valida a sintaxe de JavaServer Pages, converte as páginas JSP em arquivos de origem Java™ e compila os arquivos de origem Java em arquivos de classe Servlet Java. O compilador de lotes também valida arquivos de tag e gera suas classes de implementação Java. Use essa função para compilar em lote seus arquivos JSP e, assim, permitir respostas mais rápidas às solicitações de cliente iniciais para os arquivos JSP no seu servidor da Web de produção.
O compilador de lotes pode ser executado com relação aos arquivos Enterprise Archive (EAR) e arquivos Web Application Archive (WAR) compactados ou expandidos, bem como com relação a aplicativos corporativos e módulos da web que foram implementados no WebSphere Application Server. Quando o destino é um aplicativo corporativo implementado, o servidor não precisa estar em execução para executar o compilador de batch. Se o compilador de batch for executado enquanto o servidor de destino está em execução, o servidor não estará ciente de um arquivo de classe atualizado e não carregará o arquivo de classe, a menos que o aplicativo corporativo seja reiniciado. Quando o destino é um arquivo EAR ou um arquivo WAR compactado, o compilador de batch deve expandi-lo antes da execução.
Processamento de Módulos da Web
O compilador de lotes opera em um módulo da Web por vez. Se o destino for um arquivo EAR ou um aplicativo corporativo instalado que contenha mais de um módulo da Web, o compilador de lotes operará em cada módulo da Web individualmente. Isso é feito porque as páginas JSP são configuradas em uma base de módulo da Web, por meio do arquivo descritor de implementação web.xml do módulo da web. Em um módulo da Web, o compilador de lotes processa um diretório por vez. Ele valida e converte cada página JSP individualmente e, em seguida, chama o compilador Java para o grupo inteiro de arquivos de origem Java gerados nesse diretório. Se uma página JSP falhar durante a fase de compilação Java, o compilador Java poderá não criar arquivos de classe para a maioria ou para todas as páginas JSP que foram compiladas com êxito nesse diretório.
Extensões de Arquivos JSP
- Extensões de arquivos JSP padrão
- .jsp
- .jspx
- .jsw
- .jsv
- A propriedade padrão de URL dos elementos jsp-property-group no arquivo descritor de implementação nos módulos da Web Servlet 2.4
- O parâmetro de configuração de mecanismo JSP jsp.file.extensions (para módulos da Web pré-Servlet 2.4)
- O parâmetro de configuração do compilador de batch jsp.file.extensions
As extensões padrão são sempre utilizadas pelo compilador de batch. Se o módulo da Web contiver um descritor de implementação Servlet 2.4, o compilador de lotes também processará quaisquer padrões de URL localizados no elemento jsp-config. Se o destino do compilador de batch contiver o parâmetro de configuração do mecanismo JSP jsp.file.extensions, essas extensões também serão processadas. Se o parâmetro de configuração do compilador de lotes jsp.file.extensions estiver presente, as extensões fornecidas também serão processadas e substituirão o parâmetro de configuração do mecanismo JSP jsp.file.extensions.
É uma boa ideia fornecer uma extensão a 'fragmentos' JSP que não é processada pelo compilador de batch. Fragmentos incluídos estaticamente que não são independentes geram erros de conversão ou de compilação se processados. A Especificação JSP 2.0 sugere que você utilize a extensão .jspf para tais arquivos.
Comando do Compilador de Batch
Um
arquivo em lote do Windows,
JspBatchCompiler.bat e um script de shell do UNIX, JspBatchCompiler.sh, foram
localizados no diretório {WAS_ROOT}/bin para executar o compilador de lotes a partir da linha de comandos. Uma tarefa Ant também está disponível para a execução do
compilador em lote utilizando Ant. Consulte o tópico Tarefa ant do compilador de lotes para obter informações
adicionais.
O script JspBatchCompiler para execução do compilador em
lote a partir da linha de comandos do Qshell localiza-se no diretório
app_server_root/bin. Uma tarefa Ant também está disponível para a execução do
compilador em lote utilizando Ant. Consulte o tópico Tarefa ant do compilador de lotes para obter informações
adicionais.
JspBatchCompiler -ear.path | -war.path | -enterpriseapp.name <name>
[-response.file <filename>]
[-webmodule.name <name>]
[-filename <jsp name | directory name>
[-recurse <true | false>]
[-config.root <path>]
[-cell.name <name>]
[-cluster.name <name>] [-node.name <name>]
[-server.name <name>]
[-profileName <name>]
[-extractToDir <path>]
[-compileToDir <path>]
[-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 <classpath to additional JAR files and classes>]
[-verbose <true | false>]
[-deprecation <true | false>]
[-javaEncoding <encoding>
[-jdkSourceLevel <13 | 14 | 15 | 16 | 17 | 18 >]
[-compilerOptions <space-separated list of java compiler options>]
[-useJikes <true | false>]
[-jsp.file.extensions <file extensions to process>]
[-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 em
WAS_ROOT/bin para obter mais informações. ***
*** Consulte JspCBuild.xml em WAS_ROOT/bin para obter informações sobre a tarefa Ant JspC pública do WebSphere. ***
![[IBM i]](../images/iseries.gif)
*** Consulte batchcompiler.properties.default em app_server_root/bin para obter mais informações. ***
*** Consulte JspCBuild.xml em app_server_root/bin para obter informações sobre o WebSphere Ant task JspC público. ***
- Parâmetros de configuração do mecanismo JSP para um módulo da Web.
Consulte o tópico Parâmetros de Configuração do Mecanismo JSP.
- Parâmetros de configuração do arquivo de resposta do compilador de batch.
Esses são os parâmetros encontrados em um arquivo de resposta do compilador de batch. Consulte -response.file.
- Parâmetros de configuração de linha de comandos do compilador de batch.
Esses são os parâmetros informados na linha de comandos ao executar o compilador de batch.
- Se o parâmetro for encontrado na linha de comandos, seu valor é utilizado.
- Se o parâmetro não for encontrado na linha de comandos, o compilador de batch procurará o parâmetro em um arquivo de resposta citado na linha de comandos.
- Se nenhum arquivo de reposta for denominado, ou se o parâmetro não for ali localizado, o compilador de lotes procurará pelo parâmetro nos parâmetros de configuração do mecanismo JSP do módulo da Web.
Se um parâmetro de configuração não for encontrado entre esses três grupos, um valor padrão será utilizado. Os valores padrão dos parâmetros de configuração são fornecidos junto com a descrição dos parâmetros.
Com uma exceção, esses parâmetros não fazem distinção entre maiúsculas e minúsculas; -profileName faz distinção entre maiúsculas e minúsculas. Se os valores especificados para estes argumentos forem compostos de duas ou mais palavras separadas por espaços, será necessário colocar os valores entre aspas.
O compilador de batch não cria parâmetros de mecanismo JSP equivalentes, nem define os valores deles. Isso significa que se uma página JSP em um módulo da Web implementado for modificada e recompilada pelo mecanismo JSP no tempo de execução, os parâmetros de configuração do mecanismo JSP irão determinar o comportamento do mecanismo. Por exemplo, se você usar o compilador de lotes para compilar um módulo da Web e você usar a opção -useFullPackageNames true, os arquivos JSP serão compilados para suportar essa opção. Mas o parâmetro do mecanismo JSP useFullPackageNames também deve ser configurado como true para que o Tempo de Execução JSP possa carregar as páginas JSP compiladas. Se as páginas JSP forem modificadas em um módulo da Web implementado, os parâmetros do mecanismo deverão ser configurados para os mesmos valores na compilação de lotes.
Para usar o compilador de lotes JSP, digite um dos seguintes comandos em uma única linha em um prompt de comandos do sistema operacional:
- ear.path | war.path | enterpriseapp.name
Representa o caminho completo para um arquivo archive corporativo (EAR) ou um arquivo Web Application Archive (WAR) compactado ou expandido ou o nome do aplicativo corporativo implementado que deseja compilar. Exemplo
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 o caminho para um arquivo que contém parâmetros de configuração utilizados pelo compilador de batch. O response.file é utilizado apenas se for fornecido na linha de comandos; ele será ignorado se estiver presente em um arquivo de resposta.
Numa instalação padrão, o arquivo de respostas do modelo batchcompiler.properties.default está localizado no diretório {WAS_ROOT}/bin. Copie esse gabarito para criar seus próprios arquivos de resposta que contêm padrões para os parâmetros nos quais está interessado. Todos os parâmetros obrigatórios e opcionais (exceto response.file) podem ser configurados em um arquivo de resposta. Por exemplo: JspBatchCompiler -response.file c:\myproject\batchc.props
O arquivo de respostas do modelo, batchcompiler.properties.default, está localizado no diretório app_server_root/properties. Copie esse gabarito para criar seus próprios arquivos de resposta que contêm padrões para os parâmetros nos quais está interessado. É possível configurar todos os parâmetros obrigatórios e opcionais, exceto o response.file em um exemplo file.For de resposta: JspBatchCompiler -response.file /home/wasuser/myproject/batchc.props
Padrão : nulo
- webmodule.name
Representa o nome do módulo da Web específico que deseja compilar em lote. Se esse argumento não for configurado, todos os módulos da Web no aplicativo corporativo serão compilados. Esse parâmetro é utilizado somente quando ear.path ou enterpriseapp.name é fornecido. Esse parâmetro é útil quando as páginas JSP em um módulo da Web específico em um aplicativo corporativo implementado precisarem ser geradas novamente, porque todas as dependências da biblioteca compartilhada estão selecionadas.
Exemplo: JspBatchCompiler -enterpriseApp.name sampleApp -webmodule.name myWebModule.war
Padrão: Todos os módulos da web em um arquivo EAR ou aplicativo corporativo são compilados se este parâmetro não for dado.
- filename
Representa o nome de um único arquivo JSP que você deseja compilar. Se esse argumento não for configurado, todos os arquivos no módulo da Web serão compilados. Como alternativa, se filename for definido para o nome de um diretório, apenas os arquivos JSP desse diretório e dos diretórios filhos do diretório serão compilados. O nome é relativo à raiz de contexto do módulo da Web.
Exemplo 1: Se desejar compilar o arquivo, myTest.jsp, e ele estiver localizado em /subdir/myJSPs, você inseriria -filename /subdir/myJSPs/myTest.jsp.
Exemplo 2: Se desejar compilar todos os arquivos JSP em /subdir/myJSPs e seus diretórios filho, você inseriria -filename subdir/myJSPs.
Padrão: Todos os arquivos JSP no módulo da web são compilados. Digitar -filename / é equivalente ao padrão.
- recurse
Determina se os subdiretórios abaixo do diretório de destino são processados. Esse parâmetro é utilizado apenas quando o parâmetro filename é fornecido. Defina o valor para false para processar apenas o parâmetro filename do diretório denominado e não seus subdiretórios.
Exemplo: JspBatchCompiler -enterpriseApp.name sampleApp -filename /subdir1 -recurse false.
Padrão: true; All directories beneath the target directory are processed.
- config.root
Especifica o local do diretório de configuração do WebSphere Application Server. Esse parâmetro é utilizado apenas quando enterpriseapp.name é fornecido.
Padrão: {WAS_ROOT}/profiles/profilename/config
Padrão: profile_root/config
- cell.name
Especifica o nome da célula na qual o aplicativo é implementado. Esse parâmetro é utilizado apenas quando enterpriseapp.name é fornecido.
Padrão: O padrão é obtido de um script de perfil que é usado. O nome simbólico dessa variável é WAS_CELL.
- cluster.name
Especifica o nome do cluster no qual o aplicativo é implementado. Este parâmetro fornece o compilador de lotes com acesso às bibliotecas compartilhadas com escopo definido em cluster e é usado somente quando enterpriseapp.name é fornecido.
Padrão: O padrão é obtido de um script de perfil que é usado. O nome simbólico desta variável é WAS_CLUSTER.
- node.name
Especifica o nome do nó no qual o aplicativo é implementado. Esse parâmetro é utilizado apenas quando enterpriseapp.name é fornecido.
Padrão: O padrão é obtido de um script de perfil que é usado. O nome simbólico dessa variável é WAS_NODE.
- server.name
Representa o nome do servidor no qual o aplicativo é implementado. Esse parâmetro é utilizado apenas quando enterpriseapp.name é fornecido.
Padrão: server1
- profileName
Especifica o nome do perfil que você deseja utilizar. Esse parâmetro é usado somente quando o caminho de enterpriseapp.name ou -ear é fornecido.
Exemplo: JspBatchCompiler -enterpriseApp.name sampleApp -profileName AppServer-3
Padrão: O perfil padrão é usado. Isto é obtido do script setupCmdLine do arquivo no diretório install_root/bin. O nome simbólico é DEFAULT_PROFILE_SCRIPT.
Padrão: O perfil padrão é usado. É obtido a partir do script setupCmdLine no diretório app_server_root/bin. O nome simbólico é DEFAULT_PROFILE_SCRIPT.
- extractToDir
Especifica o diretório no qual os arquivos archive corporativo (EAR) pré-implementados e os arquivos web application archive (WAR) são extraídos antes que o compilador de lotes opere neles. Esse parâmetro é ignorado quando enterpriseapp.name é fornecido. O parâmetro extractToDir é usado da maneira descrita na tabela.
Exemplo: JspBatchCompiler -ear.path c:\myproject\sampleApp.ear -extractToDir c:\myTempDir.
Exemplo: JspBatchCompiler -ear.path c:\myproject\sampleApp.ear -extractToDir /home/wasuser/mytempdir.
Caso de uso: você deve extrair o arquivo compactado antes de ele ser compilado em lote. Você também pode extrair um archive expandido para um novo diretório. Em ambos os casos, a extração deixa o archive original intacto, o que pode ser útil enquanto o desenvolvimento está em andamento.
Tabela 1. extractToDir. Valores padrão Archive Expandido Archive Compactado extractToDir fornecido O compilador de batch extrai o archive para extractToDir antes de operar nele. Se um arquivo ou diretório com o mesmo nome do archive já existir no extractToDir, o compilador de batch removerá o archive completamente antes de extrair esse archive. Se o compilador de batch existir sem erros, ele compactará o archive no local no extractToDir, mesmo que o arquivo EAR ou arquivo WAR original esteja expandido. Se forem encontrados erros durante a compilação, o arquivo EAR ou o arquivo WAR será deixado no estado expandido mesmo que o arquivo EAR ou o arquivo WAR original esteja compactado. extractToDir não fornecido O compilador de batch opera no arquivo EAR ou no arquivo WAR localmente (não o extrai para outro diretório) e o archive permanece expandido após o compilador de batch ser concluído. O compilador de lotes extrai o archive para o diretório retornado pela propriedade JVM "java.io.tmpdir". O restante do comportamento descrito, quando extractToDir é fornecido, é o mesmo nesse caso. O padrão é server1.
- compileToDir
Especifica o diretório em que as páginas JSP são convertidas em arquivos de origem Java e compiladas em arquivos de classe. Esse diretório pode estar em qualquer local do sistema de arquivos, mas o comportamento padrão do compilador de lotes é geralmente adequado. O comportamento do compilador de lotes durante a compilação de arquivos de classe é descrito na tabela
Exemplo: JspBatchCompiler -enterpriseApp.name sampleApp -compileToDir c:\myTargetDir
Exemplo: JspBatchCompiler -enterpriseApp.name sampleApp -compileToDir /home/wasuser/myTargetDir
Caso de uso: Esse parâmetro permite gerar o Java e os arquivos de classe em um diretório fora do destino, o que poderá ser útil se você desejar comparar os arquivos recém-gerados com as suas versões anteriores que permanecem intocadas no destino.
Tabela 2. compileToDir . Valores padrão ear.path ou war.path fornecido enterpriseApp.name fornecido compileToDir não fornecido; compileToWebInf não fornecido, ou é true Os arquivos de classe são compilados no diretório WEB-INF/classes do módulo da Web. Os arquivos de classe são compilados no diretório WEB-INF/classes do módulo da Web. compileToDir não fornecido; compileToWebInf é false Os arquivos de classe são compilados no diretório WEB-INF/classes do módulo da Web. Os arquivos de classe são compilados no diretório temporário do produto (geralmente {WAS_ROOT}/temp). compileToDir é fornecido; compileToWebInf não é fornecido, ou é true ou false Os arquivos de classe são compilados no diretório indicado por compileToDir. Os arquivos de classe são compilados no diretório indicado por compileToDir. Tabela 3. compileToDir . Valores padrão ear.path ou war.path fornecido enterpriseApp.name fornecido compileToDir não fornecido; compileToWebInf não fornecido, ou é true Os arquivos de classe são compilados no diretório WEB-INF/classes do módulo da Web. Os arquivos de classe são compilados no diretório WEB-INF/classes do módulo da Web. compileToDir não fornecido; compileToWebInf é false Os arquivos de classe são compilados no diretório WEB-INF/classes do módulo da Web. Os arquivos de classes são compilados no diretório temporário do produto (geralmente profile_root/temp). compileToDir é fornecido; compileToWebInf não é fornecido, ou é true ou false Os arquivos de classe são compilados no diretório indicado por compileToDir. Os arquivos de classe são compilados no diretório indicado por compileToDir. - compileToWebInf
Especifica se o diretório de destino para os arquivos de classe JSP compilados deve ser o diretório WEB-INF/classes do módulo da web. Esse parâmetro é utilizado somente quando enterpriseApp.name é fornecido e é substituído por compileToDir se compileToDir for fornecido.
O comportamento padrão do compilador de lotes é compilar para o diretório WEB-INF/classes do módulo da Web. O comportamento do compilador de lotes durante a compilação de arquivos de classe é descrito na tabela.
Exemplo: JspBatchCompiler -enterpriseApp.name sampleApp -compileToWebInf false.
Caso de uso: configure esse parâmetro para false quando o enterpriseApp.name for fornecido e você desejar que os arquivos de classe sejam compilados para o diretório temporário do WebSphere Application Server em vez do diretório WEB-INF/classes do módulo da web. Recomendação: se esse parâmetro for definido para false, defina forceCompilation como true se não houver arquivos de classe JSP no diretório WEB-INF/classes.
Padrão: true; consulte a tabela.
- compileAfterFailure
Especifica se o compilador de lotes JDK JSP continuará compilando os outros arquivos JavaServer Pages (JSP) no diretório atual se um ou mais dos arquivos JavaServer Pages (JSP) nesse diretório não puderem ser compilados. Normalmente, quando um dos arquivos não puderem ser compilados, o compilador de lotes JSP ignorará todos os JSPs restantes neste diretório e iniciará a compilação dos arquivos no próximo diretório.
Se você configurar esse parâmetro para true, será necessário especificar também o parâmetro useJDKCompiler e defini-lo para true.
Exemplo: JspBatchCompiler -enterpriseApp.name sampleApp -useJDKCompiler true –compileAfterFailure false.
Caso de uso: configure este parâmetro para true se deseja que o compilador de lotes JSP compile os outros arquivos JavaServer Pages (JSP) no diretório atual mesmo se um ou mais dos arquivos JSP neste diretório não puderem ser compilados.
Padrão: false
- forceCompilation
Especifica se o compilador de batch é forçado a recompilar todos os recursos JSP independente da página JSP estar desatualizada ou não.
Exemplo: JspBatchCompiler -ear.path c:\myproject\sampleApp.ear -forceCompilation true.
Exemplo: JspBatchCompiler -ear.path /home/wasuser/myproject/sampleApp.ear -forceCompilation true.
Caso de uso: é especialmente útil ao criar um archive para implementação, para certificar-se de que todas as classesJSP estão atualizadas.
Padrão: false
- useFullPackageNames
Especifica se o compilador de batch gera nomes de pacotes completos para classes JSP. O padrão é gerar todas as classes JSP no mesmo pacote. O carregador de classes do mecanismo JSP sabe como carregar as classes JSP quando estão todas no mesmo pacote. O padrão tem o benefício de gerar caminhos menores do sistema de arquivo. Os nomes de pacotes completos possuem o benefício de ativar a configuração de arquivos de classe JSP pré-compilados como servlets no arquivo web.xml sem o uso do atributo jsp-file, o que resulta em um carregador de classe único (o carregador de classe do aplicativo da Web) ser usado para carregar tais classes JSP. De modo semelhante, quando os atributos useFullPackageNames e disableJspRuntimeCompilation da configuração do mecanismo JSP forem ambos true, um único carregador de classes será utilizado para carregar todas as classes JSP, mesmo se as páginas JSP não estiverem configuradas como servlets no arquivo web.xml.
Quando o useFullPackageNames é configurado para true, o compilador de lotes gera um arquivo chamado generated_web.xml no diretório WEB-INF do módulo da web. Esse arquivo contém as informações de configuração do servlet para cada página JSP que for convertida e compilada com êxito. As informações podem opcionalmente ser copiadas para o arquivo web.xml do módulo da Web para que as páginas JSP sejam carregadas como servlets pelo contêiner da Web. Observe que se uma página JSP for configurada como um servlet dessa forma, nenhum recarregamento da página JSP será feito no tempo de execução se a página JSP for modificada. Isso ocorre porque a página JSP é tratada como um servlet regular e os pedidos para ela não são transmitidos pelo mecanismo JSP.
Exemplo: JspBatchCompiler –enterpriseApp.name sampleApp –useFullPackageNames true
Caso de uso: permite que classes JSP sejam carregadas por um carregadore de classes único.
Padrão: false
- removeTempDir
Especifica se o diretório temporário do módulo da Web foi removido. O compilador em lote por padrão gera arquivos de classe JSP em um diretório WEB-INF/classes do módulo da Web. Os arquivos de classe JSP são gerados no diretório temp no tempo de execução se uma página JSP for modificada e o recarregamento de JSP for ativado. Ao compilar em lote todas as páginas JSP em um módulo da Web e também remover o diretório temp, os recursos de disco serão preservados. Você pode usar o parâmetro removeTempDir apenas quando -enterpriseApp.name for informado.
Exemplo: JspBatchCompiler -enterpriseApp.name sampleApp -removeTempDir true.
Caso de uso: libere espaco em disco limpando um diretório temp do aplicativo da web.
Padrão: false
- translate
Especifica se páginas JSP são convertidas e compiladas. Defina translate para false se não quiser que páginas JSP sejam convertidas e compiladas. Você deve usar esta opção em conjunto com -removeTempDir para dizer ao compilador de lotes para remover apenas o diretório temp e para não fazer nenhum outro processamento.
Exemplo: JspBatchCompiler -enterpriseApp.name sampleApp -translate false -removeTempDir true.
Caso de uso: libere espaço em disco limpando um diretório temp do aplicativo da web sem chamar o processamento JSP.
Padrão: true
- compile
Especifica se as páginas JSP passarão pela fase de compilação Java. Configure compile como false se não quiser que as páginas JSP passem pela fase de compilação Java.
Exemplo: JspBatchCompiler -enterpriseApp.name sampleApp -compile false
Caso de uso: se desejar que apenas págias JSP tenham a sintaxe verificada, configure -compile para false. Você pode definir -keepgenerated para true se quiser ver os arquivos .java que foram gerados durante a fase de conversão.
Padrão: true
- trackDependencies
Especifica se o compilador de batch recompila uma página JSP quando qualquer uma de suas dependências tiver sido alterada, mesmo que a própria página JSP não tenha sido alterada. O rastreamento de dependências compromete de maneira significativa o desempenho do tempo de execução, pois o Mecanismo JSP verifica o sistema de arquivo a cada pedido para uma página JSP para verificar se uma de suas dependências foi alterada. As dependências controladas pelo WebSphere Application Server são:
- Arquivos incluídos estaticamente na página JSP
- Arquivos de tag utilizados pela página JSP (excluindo os arquivos de tag que estão em arquivos JAR)
- Arquivos TLD utilizados pela página JSP (excluindo arquivos TLD que estão nos arquivos JAR)
Exemplo: JspBatchCompiler -ear.path c:\myproject\sampleApp.ear -trackDependencies true.
Exemplo: JspBatchCompiler -ear.path /home/wasuser/myproject/sampleApp.ear -trackDependencies true.
Caso de uso: útil em um ambiente de desenvolvimento.
Padrão: false
- createDebugClassfiles
Especifica se o compilador de lotes gera arquivos de classe que contenham informações SMAP, como por JSR 45, Suporte de depuração para Outros Idiomas.
Exemplo: JspBatchCompiler -enterpriseApp.name sampleApp -createDebugClassfiles true
Caso de uso: use este parâmetro quando você deseja ser capaz de depurar páginas JSP em seu IDE compatível com JSR 45.
Padrão: false
- keepgenerated
Especifica se o compilador de lotes salvará ou apagará os arquivos de origem Java gerados criados durante a fase de conversão.
Se configurado como true, o WebSphere Application Server salva os arquivos .java gerados usados para compilação no servidor. Por padrão, esse argumento é definido como false e os arquivos .java são apagados depois dos arquivos de classe serem compilados.
Exemplo: JspBatchCompiler -ear.path c:\myproject\sampleApp.ear -keepgenerated true
Exemplo: JspBatchCompiler -ear.path /home/wasuser/myproject/sampleApp.ear -keepgenerated true
Caso de uso: use este parâmetro quando desejar revisar o código de Java gerado pelo compilador de lotes.
Padrão: false
- keepGeneratedclassfiles
Especifica se o compilador de lotes salvará ou apagará os arquivos de classe gerados durante a compilação dos arquivos de origem Java.
Exemplo: JspBatchCompiler -ear.path c:\myproject\sampleApp.ear -keepGeneratedclassfiles false -keepgenerated false
Exemplo: JspBatchCompiler -ear.path /home/wasuser/myproject/sampleApp.ear -keepGeneratedclassfiles false -keepgenerated false
Caso de uso: configure este parâmetro para falso se desejar apenas ver se há algum erro de conversão ou compilação em suas páginas JSP. Se esse parâmetro for combinado com -keepgenerated false, o resultado é que todos os arquivos gerados serão removidos antes do compilador de batch ser concluído.
Padrão: true
- usePageTagPool
Ativa ou desativa a reutilização de rotinas de tratamento de tags customizadas em uma base de página JSP individual.
Exemplo: JspBatchCompiler -ear.path c:\myproject\sampleApp.ear -usePageTagPool true
Exemplo: JspBatchCompiler -ear.path /home/wasuser/myproject/sampleApp.ear -usePageTagPool true
Caso de uso: use este parâmetro para ativar a reutilização baseada em página JSP dos manipuladores de tag.
Padrão: false
- useThreadTagPool
Ativa ou desativa a reutilização dos manipuladores de tag customizados basicamente por encadeamento de solicitação por módulo da Web.
Exemplo: JspBatchCompiler -ear.path c:\myproject\sampleApp.ear -useThreadTagPool true
Exemplo: JspBatchCompiler -ear.path /home/wasuser/myproject/sampleApp.ear -useThreadTagPool true
Caso de uso: use este parâmetro para ativar a reutilização baseada em módulo da web dos manipuladores de tag.
Padrão: false
- classloader.parentFirst
Especifica a ordem de procura para carregamento de classes por meio da instrução do compilador de batch para procurar o carregador de classes-pai antes do carregador de classes do aplicativo. Esse parâmetro é utilizado apenas quando ear.path ou enterpriseApp.name é informado.
Exemplo: JspBatchCompiler -ear.path c:\myproject\sampleApp.ear -classloader.parentFirst false
Exemplo: JspBatchCompiler -ear.path /home/wasuser/myproject/sampleApp.ear -classloader.parentFirst false
Caso de uso: configure este parâmetro para false quando seu módulo da web contiver um arquivo JAR que também está localizado no diretório lib do servidor, e você desejar que o arquivo JAR módulo da web seja escolhido primeiro.
Padrão: true
- classloader.singleWarClassloader
Especifica se irá usar um carregador de classe por arquivo archive corporativo (EAR) ou se um carregador de classe por arquivo web application archive (WAR). Para uso somente quando ear.path ou enterpriseApp.name for fornecido.
Exemplo: JspBatchCompiler -ear.path c:\myproject\sampleApp.ear -classloader.singleWarClassloader true
Exemplo: JspBatchCompiler -ear.path /home/wasuser/myproject/sampleApp.ear -classloader.singleWarClassloader true
Caso de uso: configure este parâmetro para true quando um módulo da web depender de arquivos e classes JAR em outro módulo da web no mesmo aplicativo corporativo.
Padrão: false; um carregador de classes é criado por arquivo WAR sem nenhuma visibilidade de classes em outros módulos da web.
- additional.classpath
Especifica entradas de caminho de classe adicionais para serem utilizadas na análise e compilação de páginas JSP. Esse parâmetro é utilizado apenas quando war.path é fornecido. Quando war.path é o destino, as Bibliotecas Compartilhadas do WebSphere não são assimiladas pelo compilador de lotes. Portanto, se seu arquivo WAR depender, por exemplo, de um arquivo JAR que esteja configurado no WebSphere Application Server como uma biblioteca compartilhada, utilize essa opção para apontar para esse arquivo JAR. Além disso, se você fornecer o war.path e também usar o parâmetro -extractToDir, qualquer arquivo JAR que estiver no caminho de classe de manifesto do arquivo WAR não será incluído no caminho de classe (já que o arquivo WAR agora foi extraído por ele mesmo fora do arquivo WAR em que reside). Utilize -additional.classpath nesse caso para apontar para os arquivos JAR necessários. Inclua o caminho completo nos recursos necessários, separados pelo separador de caminho dependente do sistema.
Exemplo: JspBatchCompiler -war.path c:\myproject\examples.war -additional.classpath c:\myJars\someJar.jar;c:\myClasses
Exemplo: JspBatchCompiler -war.path /home/wasuser/myproject/examples.war -additional.classpath /home/wasuser/myJars/someJar.jar:/home/wasuser/myClasses
Caso de uso: use este parâmetro para incluir os arquivos e classes JAR do caminho fora de seu arquivo WAR. No tempo de execução, esses mesmos arquivos e classes JAR precisam ser disponibilizados por meio dos mecanismos de configuração padrão do WebSphere Application Server.
Padrão : nulo
- verbose
Especifica se o compilador de batch deve gerar saída de verbose enquanto compila as origens geradas.
Exemplo: JspBatchCompiler -war.path c:\myproject\examples.war -verbose true
Exemplo: JspBatchCompiler -war.path /home/wasuser/myproject/examples.war -verbose true
Caso de uso: configure este parâmetro para true quando desejar ver a classe do compiladorJava carregando e outras mensagens.
Padrão: false
- deprecation
Indica que o compilador deve gerar avisos de reprovação ao compilar as origens geradas.
Exemplo: JspBatchCompiler -war.path c:\myproject\examples.war -deprecation true
Exemplo: JspBatchCompiler -war.path /home/wasuser/myproject/examples.war -deprecation true
Caso de uso: configure este parâmetro para true quando desejar ver mensagens de descondinuação do compiladorJava.
Padrão: false
- javaEncoding
Especifica a codificação existente quando o arquivo .java for gerado e quando for compilado pelo compilador Java. Quando -javaEncoding for configurado, essa codificação será passada para o compilador java usando o argumento -encoding. Observe que a codificação não é suportada por Jikes.
Exemplo: JspBatchCompiler -war.path c:\myproject\examples.war -javaEncoding Shift-JIS
Exemplo: JspBatchCompiler -war.path/home/wasuser/myproject/examples.war -javaEncoding Shift-JIS
Caso de uso: configure este parâmetro quando a codificação de página de suas páginas JSP não forem compatíveis com UTF-8.
Valor padrão: UTF-8.
- jdkSourceLevel
Esse parâmetro de mecanismo JSP foi introduzido no WebSphere Application Server versão 6.1 para suportar o JDK 5. Use esse parâmetro no lugar do parâmetro compileWithAssert, embora a compilação WithAssert ainda funcione na versão 6.1.
O valor padrão para esse parâmetro é 17. Esse parâmetro requer a regeneração da origem Java. Veja a seguir os valores de parâmetro jdkSourceLevel:- O valor 13 desativa todos os novos recursos de idioma de JDK 1.4, JDK 5.0, JDK 6.0, JDK 7.0 e 8.0.
- O valor 14 permite o uso do recurso de asserção e desativa todos os novos recursos de idioma de JDK 5.0, JDK 6.0, JDK 7.0 e 8.0.
- O valor 15 permite o uso do recurso de asserção e desativa todos os novos recursos de idioma de JDK 6.0, JDK 7.0 e 8.0.
- O valor 16 permite o uso do recurso de asserção e desativa todos os novos recursos de JDK 7.0. e 8.0.
- O valor 17 permite o uso do recurso de asserção e desativa todos os novos recursos de JDK 8.0.
- O valor 18 permite o uso dos novos recursos de JDK 8.0.
Exemplo: JspBatchCompiler -war.path c:\myproject\examples.war -jdkSourceLevel 14
Caso de uso: Configure esse parâmetro quando desejar ativar ou desativar os recursos de idioma de JDK 1.4 , JDK 5.0, JDK 6.0, JDK 7.0 e JDK 8.0
Valor padrão: 17
- compilerOptions
Especifica uma lista de cadeias a serem transmitidas no comando do compilador Java. Esta é uma lista separada por espaços no formato "arg1 arg2 argn".
Exemplo: JspBatchCompiler -war.path c:\myproject\examples.war -compilerOptions "-bootclasspath <path>"
Exemplo: JspBatchCompiler -war.path /home/wasuser/myproject/examples.war -compilerOptions "-bootclasspath <path>"
Caso de uso: use este parâmetro se precisar de argumentos do compilador Java diferentes de detalhado, descontinuação e suporte de recurso de Asserção.
Padrão : nulo
- useJikes
Especifica se Jikes deve ser utilizado para compilação de origens Java. NOTA: Jikes não é enviado com o WebSphere Application Server.
Exemplo: JspBatchCompiler -ear.path c:\myproject\sampleApp.ear -useJikes true
Exemplo: JspBatchCompiler -ear.path /home/wasuser/myproject/sampleApp.ear -useJikes true
Caso de uso: configure este parâmetro para true para que o compilador de lotes use Jikes como o compilador Java.
Valor padrão: false
- jsp.file.extensions
Especifica as extensões de arquivos a serem processadas pelo compilador de batch. Esta é uma lista separada por ponto e vírgula ou dois pontos no formato *.ext1;*.ext2:*.extn. Note que esse parâmetro não é necessário para o os aplicativos da Web do Servlet 2.4 porque a propriedade de padrão de URL dos elementos jsp-property-group no descritor de implementação podem ser usados para identificar extensões que devem ser tratadas como páginas JSP.
Exemplo: JspBatchCompiler -enterpriseApp.name sampleApp -jsp.file.extensions *jspz;*.jspt
Caso de uso: use este parâmetro para incluir extensões adicionais a serem processados pelo compilador de lotes.
Padrão: nulo. Consulte a seção "Extensões do arquivo JSP" neste tópico para obter informações adicionais.
- log.level
Especifica o nível do log direcionado ao console durante a compilação em batch. Os valores são SEVERE | WARNING | INFO | CONFIG | FINE | FINER | FINEST | OFF
Exemplo: JspBatchCompiler -enterpriseApp.name sampleApp -log.level FINEST
Caso de uso: configure este parâmetro superior ou inferior para controlar a saída de criação de log. EXCELENTE gera a maior quantidade de saída útil para a depuração.
Padrão: CONFIG