Commande JSPBatchCompiler

Le compilateur par lots valide la syntaxe de JSP (JavaServer Pages), convertit les pages JSP en fichiers source Java™ et compile les fichiers source Java en fichiers classe Java Servlet. Le compilateur par lots valide également les fichiers de balises et génère les classes d'implémentation Java associées. Utilisez cette fonction pour compiler vos fichiers JSP par lots et accélérer les réponses aux requêtes initiales des clients portant sur les fichiers JSP qui résident sur votre serveur Web de production.

Vous pouvez exécuter le compilateur par lots sur des fichiers EAR (archive d'entreprise) et des fichiers WAR (archive d'application Web) comprimés ou développés ainsi que sur des applications d'entreprise et des modules Web qui ont été déployés dans WebSphere Application Server. Lorsque la cible est une application d'entreprise déployée, il n'est pas nécessaire que le serveur soit démarré pour l'exécution du compilateur par lots. Si le compilateur par lots est lancé alors que le serveur cible est en cours d'exécution, le serveur ne remarque pas les fichiers classe mis à jour et ne les charge pas tant que l'application d'entreprise n'est pas redémarrée. Si la cible est un fichier EAR ou WAR comprimé, le compilateur par lots doit développer le fichier avant son exécution.

Traitement des modules Web

Le compilateur par lots traite un module Web à la fois. Si la cible est un fichier EAR ou une application d'entreprise installée qui contient plusieurs modules Web, le compilateur par lots traite chaque module Web séparément. Ce processus est dû au fait que les pages JSP sont configurées en fonction d'un module Web, via le fichier de descripteur de déploiement web.xml du module Web. Dans un module Web, le compilateur par lots traite un répertoire à la fois. Il valide et convertit chaque page JSP séparément, puis appelle le compilateur Java pour la totalité du groupe de fichiers source Java générés dans ce répertoire. Si une page JSP génère des erreurs lors de la phase de compilation Java, il se peut que le compilateur Java ne crée pas les fichiers classe pour tout ou partie des pages JSP dont la compilation a abouti dans ce répertoire.

Extensions des fichiers JSP

Le compilateur par lots considère quatre éléments pour déterminer les extensions des fichiers à traiter :
  1. les extensions des fichiers JSP standard
    • .jsp
    • .jspx
    • .jsw
    • .jsv
  2. la propriété url-pattern des éléments jsp-property-group figurant dans le fichier du descripteur de déploiement des modules Web Servlet 2.4
  3. le paramètre de configuration du moteur JSP jsp.file.extensions (pour les modules Web antérieurs à la version Servlet 2.4)
  4. le paramètre de configuration du compilateur par lots jsp.file.extensions

Le compilateur par lots utilise toujours les extensions standard. Si le module Web contient un descripteur de déploiement Servlet 2.4, le compilateur par lots traite également les paramètres url-pattern trouvés dans l'élément jsp-config. Si la cible du compilateur par lots contient le paramètre de configuration du moteur JSP jsp.file.extensions, ces extensions sont également traitées. Si le paramètre de configuration du compilateur par lots, jsp.file.extensions, existe, les extensions données sont également traitées et remplacent le paramètre de configuration du moteur JSP jsp.file.extensions.

Il est judicieux d'associer une extension non traitée par le compilateur par lots aux 'fragments' JSP. Si traités, les fragments inclus statiquement et qui ne sont pas autonomes génèrent des erreurs de compilation et de conversion. La spécification JSP 2.0 recommande l'utilisation de l'extension .jspf pour de tels fichiers.

Commande du compilateur par lots

[AIX Solaris HP-UX Linux Windows][z/OS]Un fichier de commandes (batch) Windows, JspBatchCompiler.bat, et un script shell UNIX, JspBatchCompiler.sh, pour l'exécution du compilateur par lots à partir de la ligne de commande se trouvent dans le répertoire {WAS_ROOT}/bin. Une tâche Ant permet également d'exécuter le compilateur par lots à l'aide de Ant. Pour plus d'informations, consultez la rubrique Tâche Ant - Compilateur par lots.

[IBM i]Le script JspBatchCompiler pour l'exécution du compilateur par lots à partir de la commande Qshell se trouve dans le répertoire racine_serveur_app/bin. Une tâche Ant permet également d'exécuter le compilateur par lots à l'aide de Ant. Pour plus d'informations, consultez la rubrique Tâche Ant - Compilateur par lots.

La cible du compilateur par lots est le seul paramètre requis. La cible peut correspondre à -ear.path, -war.path ou -enterpriseapp.name.
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][z/OS]
			*** See batchcompiler.properties.default in WAS_ROOT/bin for more information. ***
  	*** See JspCBuild.xml in WAS_ROOT/bin for information about the public WebSphere Ant task JspC. ***
[IBM i]
			*** See batchcompiler.properties.default in racine_serveur_app/bin for more information. ***
   *** See JspCBuild.xml in racine_serveur_app/bin for information about the public WebSphere Ant task JspC. ***
Le compilateur Java reconnaît trois groupes de paramètres de configuration :
  1. Les paramètres de configuration du moteur JSP pour un module Web.

    Reportez-vous à la rubrique sur les paramètre de configuration du moteur JSP.

  2. Les paramètres de configuration du fichier de réponses du compilateur par lots.

    Il s'agit des paramètres figurant dans le fichier de réponse du compilateur par lots. Voir -response.file.

  3. Les paramètres de configuration de la ligne de commande du compilateur par lots.

    Il s'agit des paramètres entrés sur la ligne de commande lors de l'exécution du compilateur par lots.

Le compilateur par lots considère les trois groupes de paramètres de configuration pour déterminer les valeurs des paramètres utilisées lors de la compilation de pages JSP. Lors de la résolution d'une valeur pour un paramètre donné, l'ordre de priorité est le suivant :
  1. si le paramètre se trouve sur la ligne de commande, sa valeur est utilisée,
  2. si le paramètre ne se trouve pas sur la ligne de commande, le compilateur par lots recherche le paramètre dans un fichier de réponses mentionné sur la ligne de commande,
  3. si aucun fichier de réponse n'est indiqué ou si le paramètre ne se trouve pas dans le fichier de réponses, le compilateur par lots recherche le paramètre parmi les paramètres de configuration du moteur JSP du module Web.

Si un paramètre de configuration ne figure dans aucun des groupes, une valeur par défaut est utilisée. Les valeurs par défaut des paramètres de configuration sont indiquées ci-dessous avec la description des paramètres.

A l'exception de -profileName, ces paramètres ne sont pas sensibles à la casse. Si les valeurs spécifiées pour ces arguments se composent de plusieurs mots séparés par un espace, vous devez les placer entre guillemets.

Le compilateur par lots ne crée pas de paramètres de moteur JSP équivalents ni ne définit de valeurs pour ces paramètres. En d'autres termes, si une page JSP dans un module Web déployé est modifiée et recompilée par le moteur JSP pendant la phase d'exécution, les paramètres de configuration du moteur JSP déterminent le comportement du moteur. Par exemple, si vous utilisez le compilateur par lots pour compiler un module Web et que vous associez la valeur true à l'option -useFullPackageNames, les fichiers JSP sont compilés de sorte qu'ils prennent en charge cette option. Toutefois, le paramètre du moteur JSP useFullPackageNames doit également être associé à la valeur true pour que l'environnement d'exécution JSP puisse charger les pages JSP compilées. Si les pages JSP sont modifiées dans un module Web déployé, les paramètres du moteur doivent être associés aux mêmes valeurs que celles utilisées lors de la compilation par lots.

Pour utiliser le compilateur par lots, entrez l'une des commandes suivantes sur la même ligne à l'invite de commande du système d'exploitation :

  • ear.path | war.path | enterpriseapp.name
    Représente le chemin d'accès complet à un fichier EAR (enterprise application archive) ou WAR (Web application archive) comprimé ou développé ou au nom d'une application d'entreprise déployée à compiler. Par exemple :
    • [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

    Indique le chemin d'accès à un fichier contenant les paramètres de configuration utilisés par le compilateur par lots. Le paramètre response.file est utilisé uniquement s'il est spécifié sur la ligne de commande ; il est ignoré s'il figure dans un fichier de réponses.

    [AIX Solaris HP-UX Linux Windows][z/OS]Dans une installation par défaut, un modèle de fichier de réponses, batchcompiler.properties.default, se trouve dans le répertoire {WAS_ROOT}/bin. Copiez-le pour créer vos propres fichiers de réponses contenant les valeurs par défaut pour les paramètres qui vous intéressent. Vous pouvez configurer tous les paramètres, requis et facultatifs, (sauf response.file), dans un fichier de réponses. Par exemple : JspBatchCompiler -response.file c:\myproject\batchc.props

    [IBM i]Le modèle de fichier de réponses batchcompiler.properties.default se trouve dans le répertoire racine_serveur_app/properties. Copiez-le pour créer vos propres fichiers de réponses contenant les valeurs par défaut pour les paramètres qui vous intéressent. Vous pouvez configurer tous les paramètres, obligatoires et facultatifs (sauf response.file), dans un fichier de réponses. Exemple : JspBatchCompiler -response.file /home/wasuser/myproject/batchc.props

    Valeur par défaut : null

  • webmodule.name

    Représente le nom du module Web spécifique à compiler par lots. Si cet argument n'est pas défini, tous les modules Web de l'application d'entreprise sont compilés. Ce paramètre est utilisé uniquement lorsque le paramètre ear.path ou enterpriseapp.name est indiqué. Ce paramètre est utile lorsque des pages JSP d'un module Web précis dans une application d'entreprise déployée doivent être régénérées, car toutes les dépendances de bibliothèques partagées sont prises en compte.

    Exemple : JspBatchCompiler -enterpriseApp.name sampleApp -webmodule.name myWebModule.war

    Valeur par défaut : Tous les modules Web d'un fichier EAR ou d'une application d'entreprise sont compilés si ce paramètre n'est pas indiqué.

  • filename

    Représente le nom d'un fichier JSP particulier à compiler. Si cet argument n'est pas défini, tous les fichiers du module Web sont compilés. Si filename correspond au nom d'un répertoire, seuls les fichiers JSP figurant dans ce répertoire et les répertoires enfant de ce répertoire sont compilés. Le nom est relatif à la racine du contexte du module Web.

    Exemple 1 : Pour compiler le fichier, myTest.jsp, qui se trouve dans /subdir/myJSPs, entrez -filename /subdir/myJSPs/myTest.jsp.

    Exemple 2 : Pour compiler tous les fichiers JSP dans /subdir/myJSPs et ses répertoires enfant, entrez -filename subdir/myJSPs.

    Valeur par défaut : Tous les fichiers JSP du module Web sont compilés. La valeur -filename / est équivalente à la valeur par défaut.

  • recurse

    Détermine si les sous-répertoires du répertoire cible sont traités. Ce paramètre est utilisé uniquement lorsque le paramètre filename est indiqué. Associez-lui la valeur false pour traiter uniquement le répertoire spécifié par le paramètre filename et ignorer ses sous-répertoires.

    Exemple : JspBatchCompiler -enterpriseApp.name sampleApp -filename /subdir1 -recurse false.

    Valeur par défaut : true. Tous les répertoires situés sous le répertoire cible sont traités.

  • config.root

    Indique l'emplacement du répertoire de configuration WebSphere Application Server. Ce paramètre est utilisé uniquement lorsque le paramètre enterpriseapp.name est spécifié.

    [AIX Solaris HP-UX Linux Windows][z/OS]Valeur par défaut : {WAS_ROOT}/profiles/profilename/config

    [IBM i]Valeur par défaut : racine_profil/config

  • cell.name

    Indique le nom de la cellule dans laquelle l'application est déployée. Ce paramètre est utilisé uniquement lorsque le paramètre enterpriseapp.name est spécifié.

    Valeur par défaut : La valeur par défaut provient du script de profil utilisé. Le nom symbolique de cette variable est WAS_CELL.

  • cluster.name

    Indique le nom du cluster dans lequel l'application est déployée. Ce paramètre fournit le compilateur par lots avec un accès aux bibliothèques partagées de portée de cluster et est utilisé uniquement lorsqu'enterpriseapp.name est indiqué.

    Valeur par défaut : La valeur par défaut provient du script de profil utilisé. Le nom symbolique de cette variable est WAS_CLUSTER.

  • node.name

    Indique le nom du noeud sur lequel l'application est déployée. Ce paramètre est utilisé uniquement lorsque le paramètre enterpriseapp.name est spécifié.

    Valeur par défaut : La valeur par défaut provient du script de profil utilisé. Le nom symbolique de cette variable est WAS_NODE.

  • server.name

    Représente le nom du serveur dans lequel l'application est déployée. Ce paramètre est utilisé uniquement lorsque le paramètre enterpriseapp.name est spécifié.

    Valeur par défaut : server1

  • profileName

    Indique le nom du profil à utiliser. Ce paramètre est utilisé uniquement lorsque le chemin enterpriseapp.name ou -ear est spécifié.

    Exemple : JspBatchCompiler -enterpriseApp.name sampleApp -profileName AppServer-3

    [AIX Solaris HP-UX Linux Windows][z/OS]Valeur par défaut : Le profil par défaut est utilisé. Il provient du script du fichier setupCmdLine qui se trouve dans le répertoire racine_install/bin. Le nom symbolique est DEFAULT_PROFILE_SCRIPT.

    [IBM i]Valeur par défaut : Le profil par défaut est utilisé. Il provient du script setupCmdLine qui se trouve dans le répertoire racine_serveur_app/bin. Le nom symbolique est DEFAULT_PROFILE_SCRIPT.

  • extractToDir

    Indique le répertoire dans lequel les fichiers EAR (archive d'entreprise) et WAR (archive d'application Web) prédéployés sont extraits avant que le compilateur par lots ne les traite. Ce paramètre est ignoré lorsque le paramètre enterpriseapp.name est spécifié. Le paramètre extractToDir est utilisé conformément aux indications figurant dans le tableau.

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

    [IBM i]Exemple : JspBatchCompiler -ear.path c:\myproject\sampleApp.ear -extractToDir /home/wasuser/mytempdir.

    Scénario d'utilisation : Les archives comprimées doivent être extraites pour pouvoir être compilées par lots. Vous pouvez aussi extraire une archive développée dans un nouveau répertoire. Dans les deux cas, l'extraction n'a pas d'impact sur l'archive d'origine, qui peut être utile lors de la phase de développement.

    Tableau 1. extractToDir. Valeurs par défaut
      Archive développée Archive compressée
    extractToDir indiqué Le compilateur par lots extrait l'archive dans le répertoire spécifié par extractToDir avant de la traiter. Si un fichier ou un répertoire du même nom que l'archive existe déjà dans le répertoire extractToDir, le compilateur par lots supprime complètement l'archive existante avant d'extraire la nouvelle archive. Si le compilateur par lots se termine sans erreur, il comprime l'archive qui se trouve dans le répertoire extractToDir, même si le fichier EAR ou WAR d'origine était développé. Si des erreurs surviennent lors de la compilation, le fichier EAR ou WAR n'est pas comprimé même s'il l'était à l'origine.
    extractToDir non indiqué Le compilateur par lots traite le fichier EAR ou WAR là où il se trouve (il ne l'extrait pas dans un autre répertoire) et l'archive n'est pas comprimée une fois l'exécution du compilateur par lots terminée. Le compilateur par lots extrait l'archive dans le répertoire renvoyé par la propriété JVM "java.io.tmpdir". Le comportement pour les étapes suivantes est le même que lorsque le paramètre extractToDir est indiqué.

    Par défaut, il s'agit de server1.

  • compileToDir

    Indique le répertoire dans lequel les pages JSP sont converties en fichiers source Java et compilées en fichiers classe. Ce répertoire peut se trouver n'importe où sur le système de fichiers, mais le comportement par défaut du compilateur par lots est généralement adéquat. Il est décrit dans le tableau pour la compilation des fichiers classe.

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

    [IBM i]Exemple : JspBatchCompiler -enterpriseApp.name sampleApp -compileToDir /home/wasuser/myTargetDir

    Scénario d'utilisation : Ce paramètre permet de générer les fichiers classe et Java dans un répertoire qui se trouve en-dehors de la cible ; cela s'avère utile si vous voulez comparer les fichiers nouvellement générés avec leurs versions antérieures qui ne sont pas modifiées sur la cible.

    [AIX Solaris HP-UX Linux Windows][z/OS]
    Tableau 2. compileToDir . Valeurs par défaut
      ear.path ou war.path indiqué enterpriseApp.name indiqué
    compileToDir non indiqué ; compileToWebInf non indiqué ou true Les fichiers classe sont compilés dans le répertoire WEB-INF/classes du module Web Les fichiers classe sont compilés dans le répertoire WEB-INF/classes du module Web
    compileToDir non indiqué ; compileToWebInf false Les fichiers classe sont compilés dans le répertoire WEB-INF/classes du module Web Les fichiers classe sont compilés dans le répertoire temp du produit (en général, {WAS_ROOT}/temp).
    compileToDir indiqué ; compileToWebInf non indiqué ou true ou false Les fichiers classe sont compilés dans le répertoire indiqué par compileToDir Les fichiers classe sont compilés dans le répertoire indiqué par compileToDir
    [IBM i]
    Tableau 3. compileToDir . Valeurs par défaut
      ear.path ou war.path indiqué enterpriseApp.name indiqué
    compileToDir non indiqué ; compileToWebInf non indiqué ou true Les fichiers classe sont compilés dans le répertoire WEB-INF/classes du module Web Les fichiers classe sont compilés dans le répertoire WEB-INF/classes du module Web
    compileToDir non indiqué ; compileToWebInf false Les fichiers classe sont compilés dans le répertoire WEB-INF/classes du module Web Les fichiers classe sont compilés dans le répertoire temp du produit (en général, racine_profil/temp).
    compileToDir indiqué ; compileToWebInf non indiqué ou true ou false Les fichiers classe sont compilés dans le répertoire indiqué par compileToDir Les fichiers classe sont compilés dans le répertoire indiqué par compileToDir
  • compileToWebInf

    Indique si le répertoire cible des fichiers classe JSP compilés doit correspondre au répertoire WEB-INF/classes du module Web. Ce paramètre est utilisé uniquement lorsque enterpriseApp.name est spécifié et est remplacé par compileToDir si compileToDir est indiqué.

    Par défaut, le compilateur par lots effectue la compilation dans le répertoire WEB-INF/classes. Le comportement du compilateur par lots lors de la compilation de fichiers classe est décrit dans le tableau.

    Exemple : JspBatchCompiler -enterpriseApp.name sampleApp -compileToWebInf false.

    Scénario d'utilisation : Associez la valeur false à ce paramètre lorsque enterpriseApp.name est indiqué et que vous voulez que les fichiers classe soient compilés dans le répertoire temp de WebSphere Application Server au lieu du répertoire WEB-INF/classes du module Web. Conseil : si ce paramètre est associé à la valeur false, associez la valeur true à forceCompilation si des fichiers classe JSP se trouvent dans le répertoire WEB-INF/classes.

    Valeur par défaut : true ; voir tableau.

  • compileAfterFailure

    Indique si le compilateur par lots de JSP du JDK continue de compiler les autres fichiers JSP contenus dans le répertoire courant si un ou plusieurs des fichiers JSP de ce répertoire ne sont pas compilables. Habituellement, quand l'un des fichiers d'un répertoire ne peut pas être compilé, le compilateur par lots JSP ignore les autres fichiers JSP contenus dans le même répertoire et commence à compiler les fichiers du répertoire suivant.

    Si vous associez la valeur "true" à ce paramètre, vous devez également spécifier le paramètre useJDKCompiler et lui affecter aussi la valeur"true".

    Exemple : JspBatchCompiler -enterpriseApp.name sampleApp -useJDKCompiler true –compileAfterFailure false.

    Scénario d'utilisation : Affectez la valeur "true" à ce paramètre pour que le compilateur par lots de JSP compile les autres fichiers JSP du répertoire courant même si un ou plusieurs des fichiers JSP contenus dans ce répertoire ne sont pas compilables.

    Valeur par défaut : false

  • forceCompilation

    Indique si le compilateur par lots est obligé de recompiler toutes les ressources JSP, que la page JSP soit à jour ou non.

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

    [IBM i]Exemple : JspBatchCompiler -ear.path /home/wasuser/myproject/sampleApp.ear -forceCompilation true.

    Scénario d'utilisation : Particulièrement utile lors de la création d'une archive pour le déploiement, afin de garantir que toutes les classes JSP sont à jour.

    Valeur par défaut : false

  • useFullPackageNames

    Indique si le compilateur par lots génère des noms de package complets pour les classes JSP. Par défaut, toutes les classes JSP sont générées dans le même package. Le chargeur de classe du moteur JSP sait comment charger les classes JSP lorsqu'elles se trouvent toutes dans le même package. L'avantage du comportement par défaut est qu'il génère des chemins système pour les fichiers plus courts. Les noms de package complet permettent de configurer les fichiers classe JSP précompilés sous la forme de servlets dans le fichier web.xml sans utiliser l'attribut jsp-file ; ainsi, un chargeur de classe unique (le chargeur de classe de l'application Web) est utilisé pour le chargement de toutes les classes JSP de ce type. De même, lorsque les attributs de configuration du moteur JSP useFullPackageNames et disableJspRuntimeCompilation sont associés à la valeur true, un chargeur de classe unique est utilisé pour le chargement de toutes les classes JSP, même si les pages JSP ne sont pas configurées sous la forme de servlets dans le fichier web.xml.

    Lorsque l'attribut useFullPackageNames est paramétré sur true, le compilateur par lots génère un fichier appelé generated_web.xml dans le répertoire WEB-INF du module Web. Il contient des informations de configuration de servlet pour chaque page JSP dont la conversion et la compilation a abouti. Au besoin, les informations peuvent être copiées dans le fichier web.xml du module Web afin que les pages JSP soient chargées comme des servlets par le conteneur Web. Si une page JSP est configurée sous la forme d'un servlet de cette façon, elle n'est pas rechargée lors de l'exécution même si elle a été modifiée. En effet, la page JSP est traitée comme un servlet normal et les requêtes qui lui sont destinées ne sont pas transmises via le moteur JSP.

    Exemple : JspBatchCompiler –enterpriseApp.name sampleApp –useFullPackageNames true

    Scénario d'utilisation : Permet le chargement des classes JSP par un chargeur de classe unique.

    Valeur par défaut : false

  • removeTempDir

    Indique si le répertoire temp du module Web est supprimé. Par défaut, le compilateur par lots génère les fichiers de classe JSP dans le répertoire WEB-INF/classes d'un module Web. Les fichiers classe JSP sont générés dans le répertoire temp lors de l'exécution si une page JSP est modifiée et que le rechargement JSP est activé. La compilation par lots de toutes les pages JSP dans un module Web et la suppression du répertoire temp permet d'économiser de l'espace disque. Vous pouvez uniquement utiliser le paramètre removeTempDir lorsque -enterpriseApp.name est spécifié.

    Exemple : JspBatchCompiler -enterpriseApp.name sampleApp -removeTempDir true.

    Scénario d'utilisation : Libérez de l'espace disque en effaçant les données figurant dans le répertoire temp de l'application Web.

    Valeur par défaut : false

  • translate

    Indique si les pages JSP sont converties et compilées. Associez la valeur false à l'attribut translate pour ne pas convertir ni compiler les pages JSP. Vous devez utiliser cette option conjointement avec -removeTempDir pour indiquer au compilateur par lots qu'il doit supprimer le répertoire temp uniquement et arrêter le traitement.

    Exemple : JspBatchCompiler -enterpriseApp.name sampleApp -translate false -removeTempDir true.

    Scénario d'utilisation : Libérez de l'espace disque en effaçant les données figurant dans le répertoire temp de l'application Web, sans appeler le traitement JSP.

    Valeur par défaut : true

  • compile

    Indique si les pages JSP passent par la phase de compilation Java. Paramétrez compile sur false pour que les pages JSP ne passent pas par la phase de compilation Java.

    Exemple : JspBatchCompiler -enterpriseApp.name sampleApp -compile false

    Scénario d'utilisation : Pour que seule la syntaxe des pages JSP soit vérifiée, associez la valeur false à -compile. Vous pouvez associer la valeur true à -keepgenerated pour voir les fichiers .java générés lors de la phase de conversion.

    Valeur par défaut : true

  • trackDependencies
    Indique si le compilateur par lots recompile une page JSP si l'une de ses dépendances a changé, même si la page JSP elle-même n'est pas modifiée. Le suivi des dépendances entraîne une baisse significative des performances d'exécution car le moteur JSP consulte le système de fichiers pour chaque requête destinée à une page JSP pour vérifier que ses dépendances n'ont pas changé. Les dépendances suivies par WebSphere Application Server sont les suivantes :
    1. les fichiers inclus statiquement dans la page JSP,
    2. les fichiers de balises utilisés par la page JSP (à l'exception des fichiers de balises qui se trouvent dans les fichiers JAR),
    3. les fichiers TLD utilisés par la page JSP (à l'exception des fichiers TLD qui se trouvent dans les fichiers JAR)

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

    [IBM i]Exemple : JspBatchCompiler -ear.path /home/wasuser/myproject/sampleApp.ear -trackDependencies true.

    Scénario d'utilisation : Utile dans un environnement de développement.

    Valeur par défaut : false

  • createDebugClassfiles

    Indique si le compilateur par lots génère des fichiers classe contenant des informations SMAP, conformément à JSR 45, section relative à la prise en charge du débogage pour d'autres langues.

    Exemple : JspBatchCompiler -enterpriseApp.name sampleApp -createDebugClassfiles true

    Scénario d'utilisation : Utilisez ce paramètre pour pouvoir déboguer des pages JSP dans un environnement IDE compatible avec JSR 45.

    Valeur par défaut : false

  • keepgenerated

    Indique si le compilateur par lots sauvegarde ou efface les fichiers source Java générés lors de la phase de conversion.

    Si le paramètre a pour valeur true, WebSphere Application Server sauvegarde les fichiers .java générés utilisés pour la compilation sur le serveur. Par défaut, cet argument a pour valeur false et les fichiers .java sont effacés une fois les fichiers classe compilés.

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

    [IBM i]Exemple : JspBatchCompiler -ear.path /home/wasuser/myproject/sampleApp.ear -keepgenerated true

    Scénario d'utilisation : Utilisez ce paramètre pour consulter le code Java généré par le compilateur par lots.

    Valeur par défaut : false

  • keepGeneratedclassfiles

    Indique si le compilateur par lots sauvegarde ou efface les fichiers classe générés lors de la compilation des fichiers source Java.

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

    [IBM i]Exemple : JspBatchCompiler -ear.path /home/wasuser/myproject/sampleApp.ear -keepGeneratedclassfiles false -keepgenerated false

    Scénario d'utilisation : Associez la valeur false à ce paramètre si vous ne voulez voir que les erreurs de compilation ou de conversion pour vos pages JSP. Si vous associez cet attribut avec -keepgenerated false, tous les fichiers générés sont supprimés avant la fin de l'exécution du compilateur par lots.

    Valeur par défaut : true

  • usePageTagPool

    Active ou désactive la réutilisation des gestionnaires de balises personnalisées pour chaque fichier JSP séparément.

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

    [IBM i]Exemple : JspBatchCompiler -ear.path /home/wasuser/myproject/sampleApp.ear -usePageTagPool true

    Scénario d'utilisation : Utilisez ce paramètre pour activer la réutilisation des gestionnaires de balises personnalisées pour chaque page JSP.

    Valeur par défaut : false

  • useThreadTagPool

    Active ou désactive la réutilisation des gestionnaires de balises personnalisées pour chaque unité d'exécution de requête par module Web.

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

    [IBM i]Exemple : JspBatchCompiler -ear.path /home/wasuser/myproject/sampleApp.ear -useThreadTagPool true

    Scénario d'utilisation : Utilisez ce paramètre pour activer la réutilisation des gestionnaires de balises en fonction du module Web.

    Valeur par défaut : false

  • classloader.parentFirst

    Spécifie l'ordre de recherche pour le chargement des classes en indiquant au compilateur par lots de rechercher le chargeur de classe parent avant le chargeur de classe de l'application. Ce paramètre est utilisé uniquement lorsque le paramètre ear.path ou enterpriseApp.name est spécifié.

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

    [IBM i]Exemple : JspBatchCompiler -ear.path /home/wasuser/myproject/sampleApp.ear -classloader.parentFirst false

    Scénario d'utilisation : Associez la valeur false à ce paramètre lorsque votre module Web contient un fichier JAR qui se trouve également dans le répertoire lib du serveur et que vous voulez que le fichier JAR de votre module Web soit pris en compte en premier.

    Valeur par défaut : true

  • classloader.singleWarClassloader

    Indique si un chargeur de classe par fichier EAR (archive d'entreprise) ou un chargeur de classe par fichier WAR (archive d'application Web) doit être utilisé. Doit être utilisé uniquement avec ear.path ou enterpriseApp.name.

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

    [IBM i]Exemple : JspBatchCompiler -ear.path /home/wasuser/myproject/sampleApp.ear -classloader.singleWarClassloader true

    Scénario d'utilisation : Associez la valeur true à ce paramètre lorsqu'un module Web dépend des fichiers JAR et des classes d'un autre module Web figurant dans la même application d'entreprise.

    Valeur par défaut : false ; un chargeur de classe, qui ne considère par les classes figurant dans d'autres modules Web, est créé par fichier WAR.

  • additional.classpath

    Indique des entrées de chemins d'accès aux classes supplémentaires à utiliser lors de l'analyse et de la compilation de pages JSP. Ce paramètre est utilisé uniquement lorsque le paramètre war.path est spécifié. Lorsque war.path est la cible, les bibliothèques partagées, WebSphere ne sont pas prises en compte par le compilateur par lots. Par conséquent, si votre fichier WAR repose par exemple sur un fichier JAR configuré dans WebSphere Application Server en tant que bibliothèque partagée, utilisez cette option pour référencer ce fichier JAR. De plus, si vous indiquez war.path et utilisez le paramètre -extractToDir, les fichiers JAR qui se trouvent dans le chemin d'accès aux classes du manifeste du fichier WAR ne sont pas ajoutés au chemin d'accès aux classes (car le fichier WAR a été extrait hors du fichier EAR dans lequel il se trouve). Dans ce cas, utilisez -additional.classpath pour référencer les fichiers JAR nécessaires. Ajoutez le chemin d'accès complet aux ressources requises, séparées par le séparateur des chemins du système.

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

    [IBM i]Exemple : JspBatchCompiler -war.path /home/wasuser/myproject/examples.war -additional.classpath /home/wasuser/myJars/someJar.jar:/home/wasuser/myClasses

    Scénario d'utilisation : Utilisez ce paramètre pour ajouter au chemin d'accès aux classes les classes et fichiers JAR se trouvant hors de votre fichier WAR. Lors de l'exécution, ces mêmes classes et fichiers JAR doivent être disponibles via les mécanismes de configuration standard de WebSphere Application Server.

    Valeur par défaut : null

  • verbose

    Indique si le compilateur par lots doit générer une sortie détaillée lors de la compilation des sources générées.

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

    [IBM i]Exemple : JspBatchCompiler -war.path /home/wasuser/myproject/examples.war -verbose true

    Scénario d'utilisation : Définissez ce paramètre sur true pour afficher les messages relatifs au chargement des classes du compilateur Java et d'autres messages.

    Valeur par défaut : false

  • deprecation

    Indique que le compilateur doit générer des avertissements d'obsolescence pendant qu'il compile les sources générées.

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

    [IBM i]Exemple : JspBatchCompiler -war.path /home/wasuser/myproject/examples.war -deprecation true

    Scénario d'utilisation : Affectez à ce paramètre la valeur true pour afficher les messages d'obsolescence du compilateur Java.

    Valeur par défaut : false

  • javaEncoding

    Indique l'encodage utilisé lors de la génération du fichier .java et lors de la compilation par le compilateur Java. Lorsque le paramètre -javaEncoding est défini, cet encodage est transmis au compilateur Java via l'argument -encoding. Remarque : Jikes ne prend pas en charge cet encodage.

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

    [IBM i]Exemple : JspBatchCompiler -war.path/home/wasuser/myproject/examples.war -javaEncoding Shift-JIS

    Scénario d'utilisation : Définissez ce paramètre lorsque l'encodage de vos pages JSP n'est pas compatible avec UTF-8.

    Valeur par défaut : UTF-8.

  • jdkSourceLevel

    Ce paramètre du moteur JSP a été introduit dans WebSphere Application Server version 6.1 afin de prendre en charge JDK 5. Utilisez-le à la place de compileWithAssert, même si ce dernier fonctionne encore avec version 6.1.

    La valeur par défaut de ce paramètre est 17. Ce paramètre requiert la régénération du source Java. Les valeurs valides pour le paramètre jdkSourceLevel sont les suivantes :
    • La valeur 13 désactive toutes les nouvelles fonctionnalités de langage de JDK 1.4, JDK 5.0, JDK 6.0, JDK 7.0 et JDK 8.0.
    • La valeur 14 active l'utilisation de la fonctionnalité d'assertion et désactive toutes les nouvelles fonctionnalités de langage de JDK 5.0, JDK 6.0, JDK 7.0 et JDK 8.0.
    • La valeur 15 active l'utilisation de la fonctionnalité d'assertion et désactive toutes les nouvelles fonctionnalités de langage de JDK 6.0, JDK 7.0 et JDK 8.0.
    • La valeur 16 active l'utilisation de la fonctionnalité d'assertion et désactive toutes les nouvelles fonctionnalités de langage de JDK 7.0 et JDK 8.0.
    • La valeur 17 active l'utilisation de la fonctionnalité d'assertion et désactive toutes les nouvelles fonctionnalités de langage de JDK 8.0.
    • La valeur 18 active l'utilisation des nouvelles fonctionnalités de JDK 8.0.

    Exemple : JspBatchCompiler -war.path c:\myproject\examples.war -jdkSourceLevel 14

    Scénario d'utilisation : Définissez ce paramètre pour activer ou désactiver les fonctionnalités de langage de JDK 1.4, JDK 5.0, JDK 6.0 et JDK 7.0 et JDK 8.0.

    Valeur par défaut : 17

  • compilerOptions

    Indique la liste des chaînes à transmettre dans la commande du compilateur Java. Il s'agit d'une liste dont les éléments sont séparés par un espace et dont le format est "arg1 arg2 argn".

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

    [IBM i]Exemple : JspBatchCompiler -war.path /home/wasuser/myproject/examples.war -compilerOptions "-bootclasspath <path>"

    Scénario d'utilisation : Utilisez ce paramètre si vous avez besoin d'arguments de compilateur Java autres que les arguments de prise en charge des modes verbose, deprecation et assert.

    Valeur par défaut : null

  • useJikes

    Indique si Jikes doit être utilisé pour la compilation des sources Java. REMARQUE : Jikes n'est pas fourni avec WebSphere Application Server.

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

    [IBM i]Exemple : JspBatchCompiler -ear.path /home/wasuser/myproject/sampleApp.ear -useJikes true

    Scénario d'utilisation : Définissez ce paramètre sur true pour que le compilateur par lots utilise Jikes comme compilateur Java.

    Valeur par défaut : false

  • jsp.file.extensions

    Indique les extensions des fichiers que le compilateur par lots doit traiter. Il s'agit d'une liste dont les éléments sont séparés par un point-virgule ou un deux-points et dont le format est *.ext1;*.ext2:*.extn. Ce paramètre n'est pas requis par les applications Web Servlet 2.4 car la propriété url-pattern des éléments jsp-property-group figurant dans le descripteur de déploiement peut être utilisée pour l'identification des extensions devant être traitées comme des pages JSP.

    Exemple : JspBatchCompiler -enterpriseApp.name sampleApp -jsp.file.extensions *jspz;*.jspt

    Scénario d'utilisation : Utilisez ce paramètre pour ajouter les extensions supplémentaires que le compilateur par lots doit traiter.

    Valeur par défaut : null. Pour plus d'informations, voir la section "Extensions des fichiers JSP" de cette rubrique.

  • log.level

    Indique le niveau de journalisation affiché dans la console lors de la compilation par lots. Les valeurs sont SEVERE | WARNING | INFO | CONFIG | FINE | FINER | FINEST | OFF

    Exemple : JspBatchCompiler -enterpriseApp.name sampleApp -log.level FINEST

    Scénario d'utilisation : Associez une valeur plus élevée ou plus faible à ce paramètre pour contrôler la sortie de consignation. La valeur FINEST génère la sortie la plus utile pour le débogage.

    Valeur par défaut : CONFIG


Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rweb_jspbchtl
Nom du fichier : rweb_jspbchtl.html