JBuilder 2005 Struts深度体验

用Action控制器 替换 switch.jsp

  在《 JBuilder 2005 Servlet高级开发》中我们介绍了用户登录模块的流程,其中switch.jsp充当一个业务处理和页面转发的中心处理器。由于JSP的设计初衷是实现页面展现逻辑,而这里我们居然"倒行逆施",将JSP用作业务处理和页面转发,显然是不恰当的。我们原来的switch.jsp身兼数职:接收login.jsp页面的 表单数据,查询数据库,转发页面,象一个事无巨细,有僭越之嫌的 "管家"总揽了所有的事情,程序没有分层,逻辑显得非常不清晰,象个大杂烩。

  其实Servlet本身倒是比较适合开发switch.jsp所完成的功能,但在《 JBuilder 2005 Servlet高级开发》专题中,我们并没有用Servlet斧正之,是因为我们希望在本专题中从更高的角度更完美地替换switch.jsp。

  可以通过Struts框架对switch.jsp功能进行分解,switch.jsp通过<jsp:useBean>获取登录页面表单数据可以通过ActionForm机制实现;switch.jsp查询T_USER数据表,判断用户是否是合法用户可以在Action的execute()中处理;当未通过验证转向fail.jsp页面,如果发生异常转向error.jsp页面,当用户通过验证后转向welcome.jsp页面,可以在Action中通过ActionForward实现多出口切换。

   新增一个图书管理模块

  现实的图书管理模块,应该包括对图书进行增、删、改、查的功能,由于篇幅所限,我们仅提供图书新增的功能。数据库中必须提供一张表用于保存图书的信息,这张表名为T_BOOK,其结构如图 4所示:


图 4 T_BOOK表结构

  我们完全用Struts框架实现图书新增的功能,JBuilder 提供了一个优秀的Struts可视化设计工具(Struts Config Editor),其中Action Designer能够非常形象地描述出一个业务功能操作流程,我们不妨就通过这个可视化设计器预览图书新增业务的程序结构,如图 5所示:


图 5 新增图书Struts流程

·bookAdd.jsp:图书 录入的界面,在这儿你将学习到Struts标签和资源文件的知识。

  ·bookActionForm:由BookActionForm类实现,保存bookAdd.jsp表单提交的数据。在这儿,你将学习到如何创建ActionForm,ActionForm如何对数据有效性进行自检的知识。

  ·/bookInsertAction:由BookInsertAction类实现,即业务控制器,负责将bookActionForm中的新增图书保存到数据库T_BOOK表中,并导向到insertSuccess.htm页面。

   事前准备

  通过File->New Project...创建一个名为bookStore的新工程,并在工程下创建名为webModule的Web模块,将原《JBuilder 2005 Servlet高级开发》专题的代码覆盖该新工程对应的内容。

  用SQL Plus运行下面的SQL 语句创建T_BOOK表:

  代码清单 5 创建T_BOOK表的SQL语句

1. create table T_BOOK (
2. BOOK_ID VARCHAR2(10) not null,
3. ISBN VARCHAR2(20) not null,
4. BOOK_NAME VARCHAR2(50) not null,
5. AUTHOR VARCHAR2(50),
6. CREATE_DATE CHAR(8),
7. constraint PK_T_BOOK primary key (BOOK_ID)
8. );


  从这个SQL中,我们可以看出BOOK_ID是表的主键,所以不允许重复,而ISBN和BOOK_NAME两字段不允许为空。它们决定了在图书添加时的数据检验规则。

  同样的,我们需要将必要的类添加到这个新工程的类库中。

用ActionForm截获登录表单数据

  原登录模块用bookstore.User描述login.jsp登录页面表单的数据,在switch.jsp程序中通过<jsp:useBean>标签获取login.jsp表单的数据。其实User类相当于Struts框架中的模型,我们将通过一个ActionForm更好地实现这个功能。

  ActionForm和Bean一样以属性名匹配的映射机制从HTTP请求中填充对象数据,但ActionForm比一般的Bean提供了更多的功能,Struts允许ActionForm通过validate()方法进行自校验,当数据不合法时自动转向到输出界面,此外还可以通过reset()方法,在数据填充前复位属性值。

  下面我们就来创建UserActionForm,替换User的功能,建立起Struts框架中的"数据模型"。

  1.指定ActionForm的Web模块及类信息

  File->New...->Web->在Web页中双击ActionForm图标,弹出如图 6所示的对话框:


图 6 创建UserActionForm

  ·Struts config:我们前面有提到Struts1.1支持多个配置文件,所以你在这儿可以选择使用哪个Struts配置文件。因为我们现在还没有定义多个Struts配置文件,所以只得使用struts-config.xml。在开发新增图书的功能时,我们将定义另一个配置文件。

  ·ActionForm:ActionForm的类名,这里我们填入UserActionForm。

  按Next到下一步。

  2.定义ActionForm属性


图 7 定义ActionForm属性

  通过 Add...按钮为UserActionForm增加4个属性,如图 7所示。特别的,如果这个ActionForm所对应的入口页面已经创建,你也可以直接通过Add from JSP...按钮,选择一个JSP页面, JBuilder会分析这个页面的表单,并将表单的数据组件名抽取为ActionForm的属性。

  按Next到下一步。

  3.一些附加功能的定义


图 8 附加功能定义

  在FormBeanName中为UserActionForm指定一个名字,一般接受JBuilder所提供的默认名即可。这个名字将在struts-config.xml文件用来命名UserActionForm。

  ActionForm比一般JavaBean强大的地方在于它可以进行数据检验,还可以进行数据复位。如果这个ActionForm最终要放到session中的,那么最好实现reset()方法,以复位ActionForm的数据,否则属性可能不会反映最新的值。这里, UserActionForm无需进行数据 有效性校验,但由于UserActionForm最终需要放到session中,所以我们需要实现reset()方法。故此我们勾选Create/replace reset() method body选项。

  直接按Finish创建UserActionForm,再将User类的代码拷贝过来,整改后的最终代码如下所示:

  代码清单 6 以ActionForm实现的User类

1. package bookstore;
2.
3. import java.sql.*;
4. import java.text.*;
5. import java.util.Date;
6. import javax.servlet.http.*;
7. import org.apache.struts.action.*;
8.
9. public class UserActionForm
10. extends ActionForm
11. {
12.  private String userId;
13.  private String password;
14.  private String userName;
15.  private String loginDatetime;
16.  public String getPassword() {
17.   return password;
18.  }
19.
20.  …
21.  //复位所有属性值
22.  public void reset(ActionMapping actionMapping,HttpServletRequest servletRequest) {
23.   this.userId = null;
24.   this.userName = null;
25.   this.password = null;
26.   this.loginDatetime = null;
27. }

  此外,JBuilder自动在struts-conf.xml文件中通过<form-bean>描述ActionForm。UserActionForm必须和一个Action相关联,因为HTTP请求通过Struts总控制器转发给Action,Struts控制器一旦发现Action有一个对应的ActionForm时,就用HTTP请求的数据填充这个ActionForm。
用Action代替switch.jsp的控制转换功能

  我们在前面已经数落用switch.jsp实现请求转换控制的缺点,Struts框架的Action是实现请求转换控制的最适合替代者。

  在这节里,我们就来创建一个名为LoginAction的Action,让其完美的接替switch.jsp的工作。

  File->New...->Web->在Web页中双击Action图标,启动创建Action的向导。

  1.指定Action名字及Web模块


图 9 指定Web模块及Action名字

  在Action中键入LoginAction作为Action的类名,其中Base class的下拉框中有许多Action基类可供选择,它们用于不同的场合,这些选项是:

  ·org.apache.struts.action.Action:标准的Action。

  ·org.apache.struts.actions.ForwardAction:相当于JSP的<jsp:forward>,方便Struts控制器进行预处理。此外,从学究的角度上来说,在JSP页面直接通过<jsp:forward>违反了MVC的分层原则,控制器无法干预。

  ·org.apache.struts.actions.IncludeAction:出于ForwardAction相似的原因,Struts推荐用IncludeAction代替JSP的<jsp:include>。

  ·org.apache.struts.actions.LookupDispatchAction:如果一个表单有多个提交按钮,不同的提交按钮执行不同的业务操作,用DispatchAction最为合适。

  ·org.apache.struts.actions.SwitchAction:用SwitchAction可在不同的Struts模块间转换。

  由于我们的Action需要完成用户密码验证的业务,并根据结果转换到不同的页面中,所以这个LoginAction是一个普通的Action,故我们选择org.apache.struts.action.Action。

  按Next到下一步。

  2.设置Action的配置信息


图 10 设置LoginAction的配置信息

  ·Action path:访问这个Action的URI,接受默认的/loginAction,这样我们将通过类似这样的URL:http://127.0.0.1:8080/webModule/loginAction.do来访问这个Action。

  ·FormBean name:下拉框中列出Web模块中所有的ActionForm,我们选择前一小节中所创建的userActionForm。这样客户端的HTTP请求访问LoginAction时,HTTP请求所带的数据就会被Struts总控制器自动填充到userActionForm中了。

  ·Scope:Action有两个选择:request和session。表示ActionForm在填充后将放在request对象中还是session对象中,由于我们需要在通过密码验证后,才使用户登录系统。这样就不能使userActionForm在数据填充时就放入session中,而应该在通过密码验证后,手工将其绑定到session中(UserActionForm一旦绑定到session中,其valueBound()方法就会被调用,记录用户登录日志),故此,我们选择request。

  ·input JSP:输入的JSP页面。在ActionForm需要进行数据有效性自校验的情况下,如果校验失败,Struts框架总控制器将请求返回到这个输入页面上。因为UserActionForm无需进行有效性校验(在3.1的第3步我们没有为UserActionForm实现自校验功能),所以无需指定输入的JSP。

  按Finish按钮直接创建LoginAction,JBuilder自动打开Struts Config Editor,生动形象地展现用户登录模块Struts框架下的处理流程,如图 11所示:


图 11 Struts Config Editor

  位于中心的/loginAction是访问LoginAction的URI,它是登录业务的控制器。Struts总控制器创建一个UserActionForm实例,并用HTTP请求的数据填充UserActionForm实例,然后将其传给LoginAction的execute()方法。

  3.定义访问入口

  现在我们需要调整login.jsp表单的提交地址,使用LoginAction来处理用户登录的请求,调整后的代码如所示:

  代码清单 7 login.jsp 使用LoginAction处理用户登录

1. <%@page contentType="text/html; charset=GBK" import="bookstore.UserList" %>
2. …
3. <form name="form1" method="post" action="/webModule/loginAction.do">用户名:
4.  <select name="userId">
5.   <option value="" selected>--登录用户--</option>
6.    <%=UserList.getUserListHTML()%>
7.  </select>
8.  密 码:
9.  <input name="password" type="password">
10.   <input type="submit" name="Submit" value="登录">
11. </form>
12. </body>
13. </html>

  如第3行所示,将原来action="switch.jsp"改为"/webModule/loginAction.do",由于我们需要将整个应用部署于/webModule的URI下,所以需要在Action访问的地址前加上/webModule。如果通过Struts的<html:form>标签来指定表单提交的地址,则无需添加/webModule,标签将自动进行转换,你将在本专题后续内容中学习到这种方法。

  注意:

  Struts框架总控制器Servlet通过路径匹配的方式截获HTTP请求,其匹配串是*.do,表示URL以.do结束的HTTP请求才会被Struts框架处理,否则Struts忽略之。所以在写链接地址时千万不要忘了调用地址后加一个.do的后缀。

  对login.jsp做调整后,重新切换到/loginAction的Struts Config Editor中,你将看到如图 12所示的流程图:


图 12 在JSP中指定调用Action后的流程图

  JBuilder将分析Web模块中所有JSP文件,如果发现引用了/loginAction就将其添加到该图中来,作为其访问入口。
4.为/loginAction定义两个出口

  一个Action一般只有一个入口,但往往会有多个出口,Action根据业务处理的不同结果转向相应的出口。图 12 /loginAction右边是一个带"forward"的浅色虚框,右键单击这个forward虚框,在弹出的菜单中点击Add Forward菜单项,在Strut Config Editor中将新增一个默认名为forward的出口项图标,左键单击这个forward新增的图标,对这个出口进行制定,如图 13所示:


图 13 为Action定义出口

  我们为这个出口地址取名为success,点击Path后的…按钮弹出Browser For Path对话框,列出当前Web模块所有可作为出口地址,如图 14所示:


图 14 可选出口地址

  我们选择welcome.jsp作为success的出口地址,按OK确定。

  按相同的方法再为/loginAction创建一个名为fail出口地址为fail.jsp以及名为error出口地址为error.jsp两出口,最后登录模块的流程如图 15所示:


图 15 登录模块的最终流程

  后面,我们将在LoginAction通过代码根据用户验证成功与否决定程序的出口,你将会发现我们通过出口的名字引用出口的地址。
完成以上配置后,切换到Source标签页,struts-config.xml文件中悉数记录下了这个配置信息:

  代码清单 8 登录模块对应struts-config.xml的配置信息

1. <struts-config>
2.  <form-beans>
3.   <form-bean name="userActionForm" type="bookstore.UserActionForm" />
4.  </form-beans>
5.  <action-mappings>
6.   <action name="userActionForm" path="/loginAction"
7.        scope="request" type="bookstore.LoginAction">
8.    <forward name="success" path="/welcome.jsp" />
9.    <forward name="fail" path="/fail.jsp" />
10.   <forward name="error" path="/error.jsp" />
11.   </action>

12.  </action-mappings>
13. </struts-config>

  其中第3行的配置信息声明了UserActionForm,为其指定了一个名字,在第6~10行是/loginAction的配置信息,它通过name属性声明这个Action对应的ActionForm为UserActionForm。

  在第8~10行,3个出口各对应一个<forward>配置项,在LoginAction中我们将通过<forward>的name属性引用出口的地址。

  下面,我们调整LoginAction类的execute()方法的代码,在其中验证用户密码,并根据验证结果转向不同的出口,其最终代码如下所示:

  代码清单 9 LoginAction.java

1. package bookstore;
2.
3. import org.apache.struts.action.ActionMapping;
4. import org.apache.struts.action.ActionForm;
5. import javax.servlet.http.HttpServletRequest;
6. import javax.servlet.http.HttpServletResponse;
7. import org.apache.struts.action.ActionForward;
8. import org.apache.struts.action.Action;
9.
10. import java.sql.*;
11.
12. public class LoginAction
13. extends Action {
14.  public ActionForward execute(ActionMapping actionMapping,
15.    ActionForm actionForm,
16.    HttpServletRequest servletRequest,
17.    HttpServletResponse servletResponse) {
18.     UserActionForm userActionForm = (UserActionForm) actionForm;
19.      Connection conn = null;
20.      try
21.     {
22.      conn = DBConnection.getConnection();
23.      PreparedStatement pStat = conn.prepareStatement(
24.        "select USER_NAME from T_USER where USER_ID=? and password = ?");
25.      pStat.setString(1, userActionForm.getUserId());
26.      pStat.setString(2, userActionForm.getPassword());
27.      ResultSet rs = pStat.executeQuery();
28.      if (rs.next())
29.      { //密码正确
30.       userActionForm.setUserName(rs.getString(1));
31.       servletRequest.getSession().setAttribute("ses_userBean", userActionForm);
32.       return actionMapping.findForward("success");//通过验证,转向welcome.jsp出口
33.      }
34.     }
35.     catch (SQLException se)
36.     {
37.      se.printStackTrace();
38.      return actionMapping.findForward("error");//程序发生异常,转向error.jsp出口
39.     }
40.     finally
41.     {
42.      try
43.      {
44.       if (conn != null)
45.       {
46.        conn.close();
47.       }
48.      }
49.      catch (SQLException ex)
50.      {
51.       ex.printStackTrace();
52.       return actionMapping.findForward("error");//程序发生异常,转向error.jsp出口
53.      }
54.     }
55.     return actionMapping.findForward("fail");//未通过验证,转向fail.jsp出口
56.    }
57. }

  在第18行通过强制类型转换获取UserActionForm实例,其后验证用户的代码其实就是switch.jsp验证用户的scriptlet的代码。我们根据用户验证的结果通过ActionMapping将请求转向不同的出口(如第32、38、52、55行所示),其中findForward(name)中的name即是struts-config.xml中对应Action配置项的<forward>中指出的出口项名字。这种通过名字引用出口的调用方式给我们带来了很大的灵活性,因为它将流程逻辑和具体实现隔离开来,假设你不希望用welcome.jsp作为登录成功所转向的页面,你只要在配置文件中对success的出口配置项进行调整就可以了,而无需更改程序。

  在通过用户验证后,我们将userActionForm手工放到session中(第31行),以ses_userBean为名放入session时userActionForm的valueBound()方法会被触发调用,记录用户登录日志。由于原success.jsp包含下面的代码:

<jsp:useBean id="ses_userBean" scope="session" class="bookstore.User"/>

  因为此时,我们已经用UserActionForm替换原User类,所以需要对这行代码作调整,否则在进行强制类型转换时将发生ClassCastException异常。调整后的代码为:

<jsp:useBean id="ses_userBean" scope="session" class="bookstore.UserActionForm"/>

  提示:

  一般情况下,Action只执行流程控制的功能,而不执行具体的业务处理。所以LoginAction的execute()中验证用户的业务最好抽取到一个具体的BO中(Business Object:商业处理对象)。

新增一个Struts配置文件

  考虑到图书模块是一个比较独立的模块,为了避免对Struts配置文件的资源争用导致团队工程的覆盖或冲突,我们为这个模块单独提供一个新的Struts配置文件,用这个配置文件配置图书模块所有Struts关联的信息。

  我们按照如下的方式为webModule模块添加一个名为book-struts-config.xml的配置文件。

  首先到<工程目录>/webModule/WEB-INF拷贝一个原有的struts-config.xml文件,更名为book-struts-config.xml放在struts-config.xml相同的目录下,删除原有配置的内容,将其调整成:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE struts-config PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 1.1//EN" "http://jakarta.apache.org/struts/dtds/struts-config_1_1.dtd">
<struts-config>
</struts-config>

  然后,在工程窗格的资源树中定位到webModule->Deployment descriptors-><Struts 1.1>节点上,右击<Struts 1.1>节点,在弹出的菜单中选择Properties...弹出Properties for ’<Struts 1.1>’对话框,如图 16所示:


图 16 Struts配置文件维护对话框

  点击Add...按钮,在弹出的Choose Struts config file对话框中选择book-struts-config.xml配置文件,按OK这个新的Struts配置文件将添加到Struts config file in web.xml列表中。

  新增配置文件成功后,在工程窗格资源树的<Struts 1.1>节点下,你将会发现这个新加入的Struts配置文件,如下图所示:


图 17 两个Struts配置文件

  这样,在创建新的FormBean或Action时,你就可以选择用哪个配置文件来保存Struts的配置信息了。

  图书Action Form

  下面我们着手创建用于接收新增图书页面表单数据的BookActionForm,使用book-struts-config.xml保存BookActionForm的配置信息。BookActionForm需要进行数据有效性自检,也就是说,要让BookActionForm实现validate()方法。

  创建BookActionForm和创建UserActionForm相似,但是在向导的第1步需要指定book-struts-config.xml记录BookActionForm配置信息,如图 18所示:


图 18 选择不同的配置文件

  我们在前一节为Web模块添加了一个配置文件,在Struts config下拉框中列出了Web模块所有配置文件,这里我们选择WEB-INF/book-struts-config.xml。

  在向导的第2步,我们为BookActionForm定义下列5个属性:

String bookId;//图书ID,对应T_BOOK表的BOOK_ID,是主键
String isbn;//isbn
String createDate;//创建日期
String bookName;//书名
String author;//作者

  在向导的第2步直接按Finish创建BookActionForm。由于bookId属性是主键,所以不能和T_BOOK中已有的记录重复,这可以通过BookActionForm的数据自检机制来完成,数据自检是通过定义validate()方法来实现的。向导已经为BookActionForm生成了validate()方法框架,我们只需要在validate()方法编写bookId的校验的代码就可以了,BookActionForm的最终代码如代码清单 10所示:

  代码清单 10 BookActionForm.java

1. package bookstore;
2.
3. import javax.servlet.http.HttpServletRequest;
4. import org.apache.struts.action.*;
5. import java.sql.*;
6.
7. public class BookActionForm
8.  extends ActionForm {
9.   …
10.   public ActionErrors validate(ActionMapping actionMapping,
11.   HttpServletRequest httpServletRequest) {
12.    ActionErrors errors = new ActionErrors();
13.    Connection conn = null;
14.    try {
15.     conn = DBConnection.getConnection();
16.     PreparedStatement pStat = conn.prepareStatement(
17.      "select count(*) count from T_BOOK where BOOK_ID=?");
18.     pStat.setString(1, this.bookId);
19.     ResultSet rs = pStat.executeQuery();
20.     if (rs.next()&& rs.getInt(1) > 0) {
21.      errors.add("bookId ",
22.      new ActionMessage("bookstore.duplicate.bookId",
23.      "图书ID和数据库中已经有的ID重复"));

24.     }
25.    }
26.    catch (SQLException se) {
27.     se.printStackTrace();
28.     errors.add("bookId",
29.     new ActionMessage("bookstore.dbaccess.error", "访问数据库时出错"));

30.    }
31.    finally {
32.     try {
33.      if (conn != null) {
34.       conn.close();
35.      }
36.     }
37.     catch (SQLException ex) {
38.      ex.printStackTrace();
39.      errors.add("bookId",
40.      new ActionMessage("bookstore.dbaccess.error",
41.        "访问数据库时出错"));

42.     }
43.    }
44.   return errors;
45.  }
46.
47.  public void reset(ActionMapping actionMapping,
48.   HttpServletRequest servletRequest) {
49.    this.createDate = getCurrDateStr();
50.   }
51.
52.  //获取当前时间字符
53.  private static String getCurrDateStr() {
54.   SimpleDateFormat sdf = new SimpleDateFormat("yyyyMMdd");
55.   return sdf.format(new Date());
56.  }
57. }

  当用户提交表单后,Struts框架自动把表单数据填充到ActionForm中,接着Struts框架自动调用ActionForm的validate()方法进行数据验证。如果validate()方法返回的ActionErrors为null或不包含任何ActionMessage对象,表示通过验证,Struts框架将ActionForm和HTTP请求一起传给Action的execute(),否则Struts框架将HTTP请求返回到输入的页面中,而输入页面即可通过<html:errors>显示对应request域中的ActionErrors错误信息显示出来。

  此外,我们在reset()方法中将createDate属性置为当前的日期,因为这个属性值不是通过页面表单提供的。

新增图书JSP页面

  1.通过向导创建bookAdd.jsp

  通过JSP向导创建bookAdd.jsp页面,在向导的第2步选择使用Struts1.1的struts-bean和struts-html标签,如图 19所示:


图 19 指定选用Struts标签

  2.使用JBuilder的Struts标签构建JSP页面

  你可以直接用拖拽的方法从JBuilder编辑器左边的标签库将Struts标签添加到JSP页面中,如图 20所示:


图 20 用拖拽的方式添加Struts标签

  Struts的html标签可以完成和标准的HTML元素相同的功能,Struts提倡使用Struts html标签库,因为这些标签可以和Struts框架的其他组件紧密地联系起来。而Strtus的bean标签库可以访问已经存在的JavaBean及其属性,有一些bean标签还可以访问HTTP请求头信息及Web资源文件的信息。

  我们希望用Struts的html标签库创建添加图书的表单,通过bean标签库访问Web资源文件作为表单组件前的标识文字。

  bookAdd.jsp的最终代码如代码清单 11所示:

  代码清单 11 bookAdd.jsp

1. <%@page contentType="text/html; charset=GBK" %>
2. <%@taglib uri="/WEB-INF/struts-bean.tld" prefix="bean"%>
3. <%@taglib uri="/WEB-INF/struts-html.tld" prefix="html"%>
4. <html>
5. <head>
6. <title>bookInsert</title>
7. <script language="JavaScript" >
8. function mySubmit(form)
9. {
10. if(form.isbn.value == null || form.isbn.value == "")
11. {
12.  alert("图书的ISBN不允许为空");
13.  return false;
14. }
15. if(form.bookName.value == null || form.bookName.value == "")
16. {
17.  alert("图书名不允许为空");
18.  return false;
19. }
20. }
21. </script>
22. </head>
23. <body bgcolor="#ffffff">
24. <html:errors/>
25.  <html:form action="/bookInsertAction.do" focus="bookId" method="post"
26.   οnsubmit="return mySubmit(this)" >
27.  <table width="100%%" border="0">
28.   <tr>
29.    <td>
30.     <bean:message bundle="bookstore" key="bookstore.bookId"/>
31.    </td>
32.    <td>
33.     <html:text name="bookActionForm" property="bookId"/>
34.    </td>
35.    <td>
36.     <bean:message bundle="bookstore" key="bookstore.isbn"/>
37.    </td>
38.    <td>
39.     <html:text name="bookActionForm" property="isbn"/>
40.    </td>
41.   </tr>
42.   <tr>
43.    <td>
44.     <bean:message bundle="bookstore" key="bookstore.bookName"/>
45.    </td>
46.    <td>
47.     <html:text name="bookActionForm" property="bookName"/>
48.    </td>
49.   <td>
50.   <bean:message bundle="bookstore" key="bookstore.author"/>
51.   </td>
52.   <td>
53.    <html:text name="bookActionForm" property="author"/>
54.   </td>
55.  </tr>
56.  <tr align="center">
57.   <td colspan="4">
58.    <html:submit value="保存"/>
59.    <html:reset value="取消"/>
60.   </td>
61.  </tr>
62.  </table>
63. </html:form>
64. </body>
65. </html>

  其中第25~63行是表单的定义代码,将<html:form>的action指定为"/bookInsertAction.do", 它是BookInsertAction的访问URI,将在下一节实现,通过<html:form>访问Action时,action只需保证和配置文件中指定的path一致就可以了,无需在前面添加上诸如/webModule的Web部署子目录。

  在第26行我们为<html:form>指定了一个onsubmit客户端校验函数,当isbn和bookName两组件中的任何一个为空时,拒绝提供表单。

  我们定义了4个<html:text>,它们对应标签HTML的<input type="text">输入框标签,其中name属性为对应的ActionForm名字,而property对应ActionForm的属性。图 21是bookAdd.jsp的设计期效果图:


图 21 bookAdd.jsp设计时的界面图

  当然,你可以直接在表单组件前写入具体的标识,如"图书ID",而非第30行的<bean:message>标签,但后者通过一个资源文件产生具体的标识,这样不但可直接通过资源文件控制标识还提供了国际化的特性。

  上面,我们只是简单地引用了名为bookstore的资源文件,下面我们需要创建这个资源文件并在Struts配置文件中描述它。

  到<工程目录>/src目录下,创建一个名为bookStoreResource_zh_CN.properties的资源文件,其内容如下所示:

bookstore.bookId=/u56fe/u4e66IDbookstore.isbn=ISBNbookstore.bookName=_
/u56fe/u4e66/u540dbookstore.author=/u4f5c/u8005bookstore.dbaccess.error=_
/u6570/u636e/u5e93/u8bbf/u95ee/u9519/u8befbookstore.duplicate.bookId=_
/u56fe/u4e66/u7f16/u53f7/u548c/u6570/u636e/u5e93/u4e2d/u5df2/u6709/u7684/u7f16/u53f7/u91cd/u590d

  这儿的中文必须采用Unicode编码格式,其对应的中文文件的内容为:

bookstore.bookId=图书IDbookstore.isbn=ISBNbookstore.bookName=图书名bookstore.author=作者bookstore.dbaccess.error=数据库访问错误bookstore.duplicate.bookId=图书编号和数据库中已有的编号重复

  在编译工程时,JBuilder会将位于<工程目录>/src下的资源文件拷贝到Web模块的WEB-INF/classes目录下。

  提示:

  JDK提供了一个将中文转换为Unicode编码格式的工具native2ascii.exe,它位于<JDK>/bin/目录下。在DOS命令窗口下,通过native2ascii -encoding GBK <源文件>

  <目标文件>即可以完成转换。

  注意:

  在前文中,我们曾提到了JBuilder 2005的一个Bug,即Web模块中的类或资源有时得不到同步,需要手工将类和资源拷贝到对应的目录。如果你发现资源文件没有同步到WEB-INF/classes目录时,bookStoreResource_zh_CN.properties需要在编译工程后手工拷贝到这个目录下,否则Struts就无法找到资源了。

  在工程窗格的资源树中找到book-struts-config.xml双击打开其对应的Struts Config Editor,切换到Message Resources标签页,如所示:


图 22 定义资源文件

  通过Add...按钮定义一个键名为bookstore的bookStoreResource资源文件。不同的语言环境的客户端将会访问不同的资源文件,如客户端为中文环境时,将访问bookStoreResource_ch_CN.properties,如果是英语的客户端将访问bookStoreResource_cn.properties资源文件,如果没有找到对应语言的资源文件,将访问默认的资源文件,这里,默认资源文件为bookStoreResource.properties。<bean:message>的boudle即为Parameter栏定义的名称。

  实战经验:

  笔者原来对Struts标签是比较排斥的,因为虽说它本意希望将页面展现逻辑和程序逻辑完美地分离开来。页面设计的工作由页面设计人员在Dreamweaver中完成,由于Dreamweaver不认识Struts的标签,那些像<html:text>,<html:submit>等表单组件的Struts标签在页面设计时看不到效果,所见即所得的理念被无情的剥夺了,界面设计人员对包含Struts标签的页面常常感到如堕五里雾中。

  许多Struts开发人员一直梦寐以求,希望能得到一个Dreamweaver的Struts标签扩展插件,让页面设计人员可以象标准的HTML组件标签一样设计页面。FWA公司的Visual Tags for Struts插件终于使我们梦想成真。通过这一插件,可以将Dreamweaver完美地和Struts结合起来,使用Struts标签的JSP页面可以在设计期得到使用标准HTML标签一样的可视化效果。你可以通过http://www.fwasi.com/downloads/下载Visual Tags for Struts的试用版。图 21的bookAdd.jsp效果界面,即是在Dreamweaver 2004中使用了Visual Tags for Struts插件后的效果页面。

  此外,有一点关于Struts标签的事情也必须提及:Sun开发出了JSF页面标签,这和Struts的标签在功能上是有重叠的,Struts 以后的版本将逐渐往JSF靠近,JSF的标签可能将最终取代Struts自己的标签,以实现天下大统。
创建BookInsertAction

  下面,我们来创建BookInsertAction,在该Action中将图书记录添加到T_BOOK表中。如果操作成功定向到insertSuccess.htm操作成功页面,如果在进行数据库操作时发现SQLException,则转向sqlFail.htm页面。我们需要事先创建这两个HTML页面,为了简单,仅在其中写入报告操作成功和失败的信息即可。

  按3.2相似的方式创建BookInsertAction,用book-struts-config.xml记录配置信息,在向导的第2步,将FormBean name指定为bookActionForm,Scope为request,将input JSP指定为/bookAdd.jsp,如图 23所示:


图 23 指出BookInsertAction的配置信息

  按Finish直接创建BookInsertAction,JBuilder将打开Struts Config Editor显示/bookInsertAction的流程,如图 24所示:


图 24 bookInsertAction流程

  添加1个出口,名为success,路径为/insertSuccess.htm。最终的/bookInsertAction的流程如图 5所示。

  代码清单 12是BookInsertAction的代码,它完成图书添加,出口控制的操作:

  代码清单 12 BookInsertAction.java

1. package bookstore;
2.
3. import javax.servlet.http.*;
4. import org.apache.struts.action.*;
5. import java.sql.*;
6.
7. public class BookInsertAction
8. extends Action {
9.  public ActionForward execute(ActionMapping actionMapping,
10.  ActionForm actionForm,
11.  HttpServletRequest servletRequest,
12.  HttpServletResponse servletResponse)
13.  throws Exception
14.  {
15.   BookActionForm bookActionForm = (BookActionForm) actionForm;
16.   Connection conn = null;
17.   conn = DBConnection.getConnection();
18.   PreparedStatement pStat = conn.prepareStatement(
19.    " insert into T_BOOK1(BOOK_ID,ISBN,BOOK_NAME,AUTHOR,"+
20.    "CREATE_DATE) values(?,?,?,?,?)");
21.   pStat.setString(1, bookActionForm.getBookId());
22.   pStat.setString(2, bookActionForm.getIsbn());
23.   pStat.setString(3, bookActionForm.getBookName());
24.   pStat.setString(4, bookActionForm.getAuthor());
25.   pStat.setString(5, bookActionForm.getCreateDate());
26.   pStat.executeUpdate();
27.   return actionMapping.findForward("success");
28.
29.  }
30. }

  BookInsertAction将bookActionForm的数据通过JDBC添加到T_BOOK表中,添加成功则转向insertSuccess.htm页面。有些观察细致的读者也许已经注意到BookInsertAction的execute()方法并未直接对SQLException进行处理,而是将异常抛出,如第13行所示。这里,我们要用到Struts1.1的新功能:通过配置方式处理异常。

  在工程窗格的webModule/Deployment descriptors/<Struts 1.1>下找到并双击book-struts-config.xml文件,调出的Struts Config Editor配置编辑器,切换到Global Exceptions标签页,如图 25所示:


图 25 异常处理配置

  点击Add...定义一个名为sqlexception的异常处理配置项,处理java.sql.SQLException异常,定义完这个配置项后,选中这个配置项,点击Edit...切换到这个配置项的详细设置页面,如图 26所示:


图 26 异常处理配置窗口

  在窗口下部切换到Source视图页中,这个异常配置项的配置信息如代码清单 13所示:

  代码清单 13 SQLException的异常处理配置项

1. …
2. <struts-config>
3.  …
4.  <global-exceptions>
5.   <exception key="sqlexception" type="java.sql.SQLException"
6.    path="/sqlFail.htm"/>

7.  </global-exceptions>
8.  …
9. </struts-config>

  第5~6行将/sqlFail.htm和java.sql.SQLException"挂接"起来,这样程序中任何Action的execute()方法抛出的SQLException异常都将由sqlexception配置项处理。

  在welcome.jsp页面中添加一个调用bookAdd.jsp的链接,登录系统后,通过这外链接调出bookAdd.jsp页面,如图 27所示:


图 27 添加图书页面

  填写图书记录,点击保存提交表单到/bookInsertAction的Action中,如果提供的图书ID和T_BOOK中已有的BOOK_ID重复,则Struts总控制器将直接返回到bookAdd.jsp页面中,由<html:errors/>报告错误信息。如果数据通过BookActionForm的自检并成功添加到数据库中,将最终转向insertSuccess.htm页面。

  提示:

  如果用Tomcat为Web服务器,如果图书记录会出现中文乱码的问题,可以使用我们上面介绍过的一个编码过滤器,你可以在web.xml中配置这个过滤器,乱码问题就可以解决了。

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值