创建 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 页面节点来实现它或者从菜单栏中选择文件 > 新建 > JSP 文件 “新建 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。项目中的这些 TLD 文件的位置基于项目配置。单击添加按钮以找出 TLD 文件或包含 TLD 文件的 JAR 文件以便可从各种源添加标记库。
    注: 如果您在向导的先前页面中选择了压缩 HTMLWML 1.3 作为标记语言,则您必须在向导的此页面中手工添加适当的 TLD 文件。Rational® Developer 当前支持这些标记,但您可以手工添加相关的标记库来使用可用于指定标记的标记。
  8. 单击下一步
  9. 提供通常将对 JSP 文件提供的任何编码、内容类型和文档类型信息。已对 portlet 禁用样式表选项。您选择的文档类型值指定隐式文档类型,该文档类型在 JSP 文件中未指定 DOCTYPE 声明时用于内容辅助、“属性”视图和其它编辑上下文。单击下一步
  10. 通过选择适用的适当复选框,为 JSP 文件创建 init() 和 destroy() 方法存根。将 JSP 文件注册为 Web 部署描述符中的 servlet 不适用于 portlet,因此,与添加至 web.xml 复选框相关的选项不可用。如果已经启用它们,则清除该复选框以禁用它们。单击下一步
  11. 单击完成 将创建带有适当标记的 JSP 文件并自动在编辑窗格中打开它。
相关概念
创建 Struts portlet 和项目
Web 图和 Web 图编辑器
相关任务
创建结构严谨的使用 Struts 的 Web 应用程序
为新的应用程序创建 Web 图
相关参考
Struts 1.1 与 SPF 标记库类之间的差别
Web 工具选用板上的 Struts 抽屉
Struts 标记的属性
使用条款 | 反馈
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.