Struts Web 框架简介

目录 建立 Struts 应用程序 开发 Struts 应用程序 在 JSP 页面中使用 Struts 自定义标记库 在 JSP 页面中使用 Struts 验证字段 使用 Struts 在 JSP 页面间导航 构建和运行 Struts 应用程序 向 Struts 应用程序添加更多功能 使用 Struts 添加 "Cancel" 功能 使用 Struts 添加 "Logout" 功能 使用 Struts 添加 "Reset" 功能 向 IDE 添加喜欢的 Struts 功能 更多信息

本教程所需要的软件

开始之前，需要在您的计算机上下载并安装以下软件：

• NetBeans IDE 6.0 Web & Java EE（下载）。
• Java Standard Development Kit（JDK）版本 5.0 或版本 6.0（下载）。
• Glassfish V2 或 Tomcat Web Server，两者都可在 NetBeans IDE 6.0 安装程序中选择安装。

在 JSP 页面中使用 Struts 自定义标记库

许多 Web 应用程序使用 JavaServer Pages ( JSP ) 在 MVC 范例中查看，所以 Struts 提供了自定义标记库来简化与 HTML 窗体的交互。在 IDE 中，这些都可以在 JSP 页面中非常轻松、顺利地设置并使用。

1. 右键单击 LoginPage 项目节点，选择 New > JSP 选项，然后调用新 JSP 页面 loginForm。单击 Finish 按钮。
2. 在 Source Editor 中，将 <H2> 标记的默认内容更改为 Login Form，并对 <TITLE> 标记的内容也作相同更改。
3. 将前面这两个 taglib 标记从 welcomeStruts.jsp 文件复制到新 loginForm.jsp 文件的顶部：

   <%@ taglib uri="http://jakarta.apache.org/struts/tags-bean" prefix="bean" %>
   <%@ taglib uri="http://jakarta.apache.org/struts/tags-html" prefix="html" %>

4. 在 loginForm.jsp中，中，在 <H2> 标记下面添加以下内容：

    

   <html:form action="login">
      <html:submit value="Login" />
   </html:form>

   注意，当您键入 Struts 标记时，IDE 建议用不同的方法完成代码键入，并提供 Struts Javadoc 给与近一步的帮助：

   

   在 Source Editor 中完成键入后，您可以在 Source Editor 中右键单击并选择 Format 选项（Alt-Shift-F）来整理代码：

5. 在 Source Editor 右边的 Component Palette（Ctrl-Shift-8）的 HTML 部分中，将 Table 项拖到 <html:submit value="Login" /> 行的正上方。将弹出 Insert Table 对话框。将 Rows 和 Columns 设置为 1，以便创建由单行和单列组成的表。单击 OK 按钮。

    

   loginForm.jsp 现在将如下所示：

    

   <html:form action="login">
       <table border="1">
           <thead>
               <tr>
                   <th></th>
               </tr>
           </thead>
           <tbody>
               <tr>
                   <td></td>
               </tr>
           </tbody>
       </table>
       <html:submit value="Login" />
   </html:form>

6. 在 <TH> 标记中间，键入以下内容：

   <bean:message key="login.name" />

   在 <TD> 标记中间，键入以下内容：

   <html:text property="name" />

   loginForm.jsp 的主体现在将如下所示：

   

7. 在 Projects 窗口中，展开 Source Packages 节点，展开 com.myapp.struts 节点，然后双击 ApplicationResource.propertiess 文件使其在 Source Editor 中打开。将 login.name 作为键添加在 ApplicationResource.properties 文件的任何地方，并添加一个有意义的消息。例如：

   login.name=Name

在页面中使用 Struts 验证字段

Struts "actionform bean" 类代表视图（在本例中，是 JSP 页面）和 Struts action 类之间共享的数据。actionform bean 类可用于填充视图并向 action 类提供输入内容。actioform bean 类还有一个 validate 方法，可允许验证从视图映射的输入内容。

1. 右键单击 LoginPage 项目节点并选择 New > Other 选项。在 Struts 类别中选择 Struts ActionForm Bean 并单击 Next 按钮。注意，actionform bean 类将称作 “NewStrutsActionForm”。在本教程中，保留默认名称。在真实应用程序中，将赋予 actionform bean 类一个有意义的新名称。在 Package 下拉列表中选择 com.myapp.struts 选项并单击 Finish 按钮。

    

   actionform bean 类将在 Source Editor 中打开。默认情况下，IDE 向它提供调用称作 name 的 String 以及调用称作number 的 int。两个字段也会获得为其定义的获取方法和设置方法。

2. 在 Source Editor 中打开 struts-config.xml 并注意其包含的内容，下面给出了其中的一部份内容：

    

   <form-beans>
       <form-bean name="NewStrutsActionForm" type="com.myapp.struts.NewStrutsActionForm"/>
   </form-beans>

   按住 Ctrl 键并将鼠标移动到 actionform bean 类的完全合格的类名：

    

   

   将出现一个超链接。单击该链接可以导航到 actionform bean 类。

3. 现在可以在 Source Editor 中浏览 actionform bean 类。查看 IDE 创建的 validate 的方法：

    

   public ActionErrors validate(ActionMapping mapping, HttpServletRequest request) {
           ActionErrors errors = new ActionErrors();
           if (getName() == null || getName().length() < 1) {
               errors.add("name", new ActionMessage("error.name.required"));
               // TODO: add 'error.name.required' key to your resources
           }
           return errors;
       }

   注意，在默认情况下验证调用 name 的字段。如果验证失败（JSP 页面中没有输入名称时会发生这种情况），则返回 error.name.required 识别的消息。

4. 按照 IDE 中的 validate 方法 TODO 说明，将 error.name.required 作为键添加到 ApplicationResource.properties 文件并添加一个有意义的消息。例如：

    

   error.name.required=Enter a name!

   要自定义错误消息的格式，在文件的顶端将前面四个键更改如下：

    

   errors.header=
   errors.prefix=<span style="color: red">
   errors.suffix=</span>
   errors.footer=

5. 将 loginForm.jsp 中的以下这行添加到 </html:form> 结束标记的上方，可指定要显示错误消息的位置：

    

   <html:errors />

使用 Struts 在 JSP 页面间导航

执行 Struts "action" 类来响应用户请求并通常通过业务委托与模型交互。action 类的职责是向相应的视图提供导航和前进控制。

1. 右键单击 LoginPage 项目节点并选择 New > Other 选项。在 Struts 类别中选择 Struts Action 选项并单击 Next 按钮。
2. 在 Name and Location 面板中，注意 action 类将被称为“NewStrutsAction”。在本教程中，保留默认名称。在真实程序中，将赋予 action 类一个有意义的新名称。
3. 在 Package 下拉式列表中选择 com.myapp.struts 选项。
4. 在 Action Path 中键入 login（因此，Action Path 的内容现在为 /login ）。单击 Next 按钮。
5. 在 ActionForm Bean、Parameter 中，注意 IDE 建议您将 action 类与上一步中创建的 actionform bean 类相关联。在 Input Resource 中，浏览到 loginForm.jsp 页面。单击 Finish 按钮。
6. 在 Source Editor 中打开 struts-config.xml 并注意其包含的内容，下面给出了其中的一些内容：

    

   <action-mappings>
      <action input="/loginForm.jsp"
               name="NewStrutsActionForm"
               path="/login"
              scope="session"
               type="com.myapp.struts.NewStrutsAction"/>
      <action path="/Welcome"
           forward="/welcomeStruts.jsp"/>
   </action-mappings>

   如果要 action 类对每个请求而不是每个会话做出响应，那么将鼠标放在 scope 属性上并按 Ctrl-Space 组合键：

    

   

   选择 Request 选项。

7. 按住 Ctrl 键并将鼠标移动到 action 类的完全合格的类名：

    

   

   将出现一个超链接。单击该链接可以导航到 action 类。

8. 浏览 action 类并查看 execute 方法：

    

   public ActionForward execute(ActionMapping mapping, ActionForm  form,
               HttpServletRequest request, HttpServletResponse response)
               throws Exception {
           return mapping.findForward(SUCCESS);
   }

   在 NewStrutsAction 的顶部，注意 SUCCESS 的定义：

    

   private final static String SUCCESS = "success";

   SUCCESS String 声明指定该 action 类映射到调用 success 的输出视图。

9. 您需要定义调用以上输出视图时将会显示的页面。所以，在与 loginForm.jsp 相同的位置创建另一个 JSP，并称它为 loginSuccessful。在 Source Editor 中，将新 JSP 文件中 <H2>标记的默认内容更改为 Login Successful!，并对 <TITLE> 标记的内容也作相同更改。
10. 在 Source Editor 中打开 struts-config.xml，右键单击 /login action 映射的任何区域，然后选择 Struts > Add Forward 选项。

     

    将会打开 Add Forward 对话框。

    在 Forward Name 中键入 success。在 Resource File 中，浏览到 loginSuccessful.jsp。对话框现在将如下所示：

     

    

    单击 Add 按钮。

    注意，struts-config.xml 现在将如下所示（新代码为黑体）：

     

    <action-mappings>
      <action input="/loginForm.jsp"
               name="NewStrutsActionForm"
               path="/login"
              scope="session"
               type="com.myapp.struts.NewStrutsAction">
           <forward name="success"
                    path="/loginSuccessful.jsp"/>
      </action>
      <action path="/Welcome"
           forward="/welcomeStruts.jsp"/>
    </action-mappings>

使用 Struts 添加 "Cancel" 功能

在本部分，添加 Struts 处理过的 Cancel 功能。

1. 在 loginForm.jsp 的 <html:submit> 行下面添加以下内容创建 Cancel 按钮：

   <html:cancel />

2. 将这些行添加到 org.myapp.struts.NewStrutsAction 的 execute 方法中：

   if (isCancelled(request)){
     return mapping.findForward(CANCEL);
   }

   在 isCancelled 方法中按住 Ctrl-Space 键，然后阅读 Javadoc 以理解该方法：

    

   

   在 NewStrutsAction 类顶端、SUCCESS 定义的下方声明 CANCEL 的定义:

   private final static String CANCEL = "cancel";

3. 您需要定义调用 CANCEL 时将会显示的页面。所以，在与 loginForm.jsp 相同的位置创建另一个 JSP，并称它为 loginCancel。在 Source Editor 中，将新 JSP 文件中 <H2> 标记的默认内容更改为 Login Cancelled! 并对 <TITLE> 标记的内容也作相同更改。
4. 在 Source Editor 中打开 struts-config.xml，右键单击 /login action 映射的任何区域，然后选择 Struts > Add Forward 选项。将会打开 Add Forward 对话框。
5. 在 Forward Name 中键入 cancel。在 Resource File 中，浏览到 loginCancel.jsp。对话框现在将如下所示：

    

   

   单击 Add 按钮。

   注意，struts-config.xml 现在将如下所示（新代码为黑体）：

    

   <action-mappings>
     <action input="/loginForm.jsp"
              name="NewStrutsActionForm"
              path="/login"
             scope="session"
              type="com.myapp.struts.NewStrutsAction">
          <forward name="success"
   		path="/loginSuccessful.jsp"/>
          <forward name="cancel"
                   path="/loginCancel.jsp"/>
     </action>
     <action path="/Welcome"
          forward="/welcomeStruts.jsp"/>
   </action-mappings>

6. 注意，在In Struts 1.2.9 和 1.3 中，在删除功能中存在一些变化，相关描述请点击 此处。因此，您需要添加下面用黑体显示的那一行。

    

   <action-mappings>
     <action input="/loginForm.jsp"
              name="NewStrutsActionForm"
              path="/login"
             scope="session"
              type="com.myapp.struts.NewStrutsAction">
          <forward name="success"
   		path="/loginSuccessful.jsp"/>
          <forward name="cancel"
                   path="/loginCancel.jsp"/>
          <set-property property="cancellable" value="true"/>
     </action>
     <action path="/Welcome"
          forward="/welcomeStruts.jsp"/>
   </action-mappings>

7. 再次运行应用程序并注意新 Cancel 按钮：

    

   

   单击该按钮并注意浏览器中是否打开了新 loginCancel.jsp 页面。

使用 Struts 添加 "Logout" 功能

1. 在 loginForm.jsp 中的 <H2> 标记下面添加以下内容创建 Logout 链接：

   <html:link action="/logout">Logout</html:link>

2. 您需要定义单击 Logout 链接时将会显示的页面。所以，在与 loginForm.jsp 相同的位置创建另一个 JSP，并称它为 loginOut。在 Source Editor 中，将新 JSP 文件中 <H2> 标记的默认内容更改为 Have a Nice Day!，并对 <TITLE> 标记的内容也做相同更改。
3. 在 Source Editor 中打开 struts-config.xml，右键单击任意位置并选择 Struts > Add Forward/Include Action。将会打开 Add Forward/Include Action 对话框。
4. 在 Action Path 中键入 logout。在 Resource File 中，浏览到 loginOut.jsp。对话框现在将如下所示：

    

   

   单击 Add 按钮。

   注意，struts-config.xml 现在将如下所示（新代码为黑体）：

    

   <action-mappings>
     <action input="/loginForm.jsp"
              name="NewStrutsActionForm"
              path="/login"
             scope="session"
              type="com.myapp.struts.NewStrutsAction">
          <forward name="success"
   		path="/loginSuccessful.jsp"/>
          <forward name="cancel"
                   path="/loginCancel.jsp"/>
     </action>
     <action forward="/loginOut.jsp"
          path="/logout"/>
     <action path="/Welcome"
          forward="/welcomeStruts.jsp"/>
   </action-mappings>

5. 再次运行应用程序并注意新 Logout 链接：

    

   

   单击该链接并注意浏览器中是否打开了新 loginOut.jsp 页面。

使用 Struts 添加 "Reset" 功能

1. 在 loginForm.jsp 中，在 Submit 和 Cancel 按钮之间添加以下内容创建 Reset 按钮：

   <html:reset />

2. 再次运行应用程序并注意新 Reset 按钮：

    

   

   在 Name 行中键入一些内容，单击 Reset 按钮，并注意 Struts 是否清空表格。