创建 Struts portlet JSP 文件

通常在创建其它 Struts 资源时,启动向导以在 Struts 项目中创建 JSP 文件的方法有两种:
  1. 如果使用 Web 图编辑器,则当实现已从 Web 部件选用板抽屉放到编辑器的自由格式面板上的 Web 页面节点时,将自动启动“新建 JSP 文件”向导。如果打算使用此方法,则需要在项目中有 Web 图(*.gph)文件。
  2. 还可以使用标准菜单选项来访问此向导以在 Web 图编辑器环境之外创建 JSP 文件。
建议您采用以下方法来创建新的 Struts portlet JSP 文件:使用 Web 图编辑器设计 Struts portlet 应用程序,然后实现 Web 页面节点来启动“新建 JSP 文件”向导。当实现节点时,已使用基于应用程序中节点的上下文的信息预先填写向导中的许多必需值。这将简化创建对 portlet 应用程序准确定义的 JSP 文件的过程。
使用“新建 JSP 文件”向导为 Struts portlet 项目创建的 JSP 文件适用于门户网站环境,并具有下列特征:
  • 它们不包含文档级标记,如 <head> 和 <body> 标记。此外,也不包括 DOCTYPE 声明。
  • Struts 标记在执行时会自动编写对 Web 页面、图像或 Struts 操作之类的资源的引用。使用 Struts 的资源引用的代码类似以下样本:<html:image src="icons/image.gif"/>
    注: 如果要将 HTML 标记用于资源引用,则必须使用 portlet API 对引用进行编码或译码。例如,<image src='<%= response.encodeURL("/icons/image.gif") %>'/>
  1. 通过在 Web 图(*.gph)文件中双击具有 .jsp 扩展名的 Web 页面节点来实现该 Web 页面或者从菜单栏中选择文件 > 新建 > JSP 文件来实现该 Web 页面。 “新建 JSP 文件”向导将打开。
  2. 为文件指定适当的文件夹。根据项目中的上下文或用来创建文件的方法,可能预先填写了此字段。
  3. 输入新 JSP 文件的名称。(可选)选择创建为 JSP 片段复选框来创建可以包括在其它 JSP 文件中的 JSP 片段。 将把适当的标记库条目添加至您创建的 JSP 片段。如果选择从页面模板创建选项,可为 portlet 页面定义风格一致的外观。
  4. 根据创建包含 JSP 文件的项目时如何定义标记和方式,应已预先选择了正确的标记语言值。同样,在模型字段中也应该预先选择了 Struts Portlet JSP
  5. (可选)选择配置高级选项复选框。如果不想配置其它选项,则单击完成以创建该文件。
  6. 单击下一步
  7. “标记库”页中应该已包括下列缺省 Struts portlet 标记库 URI:/WEB-INF/struts-html.tld/WEB-INF/struts-bean.tld/WEB-INF/tld/portlet.tld。对于 JSR 168 API portlet,还可以包括 /WEB-INF/tld/std-portlet.tld URI 以进行 portlet 初始化。项目中的这些 TLD 文件的位置基于项目配置。单击添加按钮以找出 TLD 文件或包含 TLD 文件的 JAR 文件以便可从各种源添加标记库。
    注: 如果您在向导的先前页面中选择了压缩 HTMLWML 1.3 作为标记语言,则您必须在向导的此页面中手工添加适当的 TLD 文件。Rational® Developer 当前支持这些标记,但您可以添加相关的标记库来使用指定标记(markup)可用的标记(tag)。
  8. 单击下一步
  9. 提供通常将对 JSP 文件提供的任何编码、内容类型和文档类型信息。已对 portlet 禁用样式表选项。您选择的文档类型值指定隐式文档类型,该文档类型在 JSP 文件中未指定 DOCTYPE 声明时用于内容辅助、“属性”视图和其它编辑上下文。单击下一步
  10. 通过选择适当的复选框,为 JSP 文件创建相应的 init() 和 destroy() 方法存根。将 JSP 文件注册为 Web 部署描述符中的 servlet 不适用于 portlet,因此,应禁用与添加至 web.xml 复选框相关的选项。如果已经启用它们,则清除该复选框以禁用它们。单击下一步
  11. 如果想要在新的 JSP 文件中包括表单,则完成表单字段选择页上的各字段:
    1. 如果应用程序包含多个模块,您想要指定缺省模块之外的模块,则在表单 bean 模块字段中输入模块的路径名。
    2. 表单 bean 条目字段中,输入条目的名称或从下拉列表中选择一个条目。 如果选择了现有表单 bean 条目并且它引用现有 ActionForm 子类,则将显示子类的名称。另外,ActionForm 子类中的所有字段将出现在“字段”框中。可以通过选择各个字段或选择“全部”或“无”按钮来选择想要在表单中包括哪些字段。
  12. 单击完成 将创建带有适当标记的 JSP 文件并自动在编辑窗格中打开它。
相关概念
创建 Struts portlet 和项目
Web 图和 Web 图编辑器
相关任务
创建架构良好的、使用 Struts 的 Web 应用程序
为新的应用程序创建 Web 图
相关参考
Struts 1.1 与 SPF 标记库类之间的差别
Web 工具选用板上的 Struts 抽屉
Struts 标记的属性

(C) Copyright IBM Corporation 2002, 2005. All Rights Reserved.