第七章 WAS命令：JSPBatchCompiler+命令.docx

WAS命令：JSPBatchCompiler命令批处理编译器验证JavaServer Pages 的语法、将 JSP 页转换成 Java 源文件，并且将 Java 源文件编译为 Java Servlet类文件。批处理编译器也验证标记文件并生成它们的 Java 实现类。使用了该功能批量编译 JSP 文件，将能在产品 Web 服务器上更快响应客户机对 JSP 文件的初始请求。批处理编译器可以执行于压缩的或展开的企业归档（EAR）文件和 Web 应用程序归档（WAR）文件，以及已部署到WebSphere Application Server 的企业应用程序和 Web 模块。如果目标是已部署的企业应用程序，那么执行批处理编译器时不需要运行服务器。如果执行批处理编译器时目标服务器在运行，那么需要重新启动企业应用程序，否则服务器就不知道更新的类文件，也不能装入该类文件。如果目标是压缩的 EAR 文件或 WAR 文件，那么批处理编译器必须先展开它，然后再执行。Web 模块的处理批处理编译器一次在一个 Web 模块上运行。如果目标是 EAR 文件或已安装的包含多个 Web 模块的企业应用程序，批处理编译器在每个 Web 模块上单独运行。这是因为 JSP 页是通过 Web 模块的 web.xml 部署描述符文件在 Web 模块基础上配置的。在 Web 模块内，批处理编译器一次处理一个目录。它分别验证和转换每个 JSP 页，然后为该目录中生成的整个 Java 源文件组调用 Java 编译器。如果 Java 编译阶段中有一个 JSP 页编译失败，那么 Java 编译器不能为该目录中大多数（或全部）成功编译的 JSP 页创建类文件。JSP 文件扩展名批处理编译器使用四项来确定它应该处理的文件扩展名：标准 JSP 文件扩展名*.jsp *.jspx*.jsw *.jsv Servlet 2.4 Web 模块中部署描述符文件的 sp-property-group 元素的url-pattern 属性jsp.file.extensions JSP 引擎配置参数（适用于在Servlet 2.4 之前的 Web 模块）批处理编译器配置参数jsp.file.extensions批处理编译器始终使用标准扩展名。如果 Web 模块包含Servlet 2.4 部署描述符，那么批处理编译器还处理jsp-config元素中找到的任何url-pattern。如果批处理编译器目标包含 JSP 引擎配置参数jsp.file.extensions，那么也处理那些扩展名。如果存在批处理编译器配置参数jsp.file.extensions，也处理给定的扩展名并且将覆盖 JSP 引擎配置参数jsp.file.extensions。最好给 JSP“片段”一个批处理编译器不处理的扩展名。如果批处理编译器处理它，那么静态包含的片段不单独生成转换或编译错误。JSP 2.0 规范建议您为这样的文件使用扩展名.jspf。批处理编译器命令用于从命令行运行批处理编译器的 Windows 批处理文件JspBatchCompiler.bat和 UNIX shell 脚本JspBatchCompiler.sh都可以在{WAS_ROOT}/bin目录中找到。也可以使用 Ant 任务执行使用 Ant 的批处理编译器。请参阅主题“批处理编译器 Ant 任务”，以了解其他信息。批处理编译器目标是唯一的必需参数。目标是 -ear.path、-war.path或 -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][-node.name name][-server.name name][-profileName name][-extractToDir path][-compileToDir path][-compileToWebInf true | false][-translate true | false][-compile true | false][-removeTempDir true | false][-forceCompilation true | false][-useFullPackageNames true | false][-trackDependencies true | false][-cre