Struts1.x系列教程（1）：用MyEclipse开发第一个Struts程序(二)

配置连接池（用于连接数据库 struts ）

   < Resource  name ="jdbc/struts"  auth ="Container"
                type ="javax.sql.DataSource"
                driverClassName ="com.mysql.jdbc.Driver"
                url ="jdbc:mysql://localhost:3306/struts?characterEncoding=GBK"
                username ="root"
                password ="1234"               
                maxActive ="200"
                maxIdle ="50"
                maxWait ="3000" />

本例中提供了两个可以操作数据库的模型类：Product 和SearchProduct 。其中Product 用于验证由客户端提交的产品信息，并向t_products 表中写入这些信息。而SearchProduct 类用于对t_products 表的product_name 字段进行模糊查询，并返回查询到的产品信息（包括产品ID 、产品名称和产品价格）。

package  util;
import  java.sql.Connection;
public   class  Struts
{
    protected  javax.naming.Context ctx  =   new  javax.naming.InitialContext();
    protected  javax.sql.DataSource ds;
     protected  Connection conn;
     public  Struts()  throws  Exception
    {
        ds  =  (javax.sql.DataSource) ctx.lookup( " java:/comp/env/jdbc/struts " );
        conn  =  ds.getConnection();   //  从数据库连接池获得一个Connection
    }
}

   package  mystruts.model;
  
   import  java.sql. * ;
   import  mystruts.actionform. * ;
  
   public   class  Product  extends  util.Struts
  {
       private  ProductForm form;
  
       public  Product(ProductForm form)  throws  Exception
      {
           super ();
           this .form  =  form;
          validate();
      }
       //  验证客户端提交的数据
       public   void  validate()  throws  Exception
      {
           if  (form.getProductID().trim().equals( "" ))
               throw   new  Exception( " 产品ID不能为空! " );
           if (form.getProductID().length()  >   4 )
               throw   new  Exception( " 产品ID最长为4位! " );
           if  (form.getProductName().trim().equals( "" ))
               throw   new  Exception( " 产品名称不能为空 " );
           if  (Float.compare(form.getPrice(),  0 )  <=   0 )
               throw   new  Exception( " 产品价格必须大于0 " );
      }
       //  将客户端提交的产品信息保存到t_products中
       public   void  save()  throws  Exception
      {
           try
          {
              String productID  =  form.getProductID();
              String productName  =  form.getProductName();
               float  price  =  form.getPrice();
              String sql  =   " INSERT INTO t_products VALUES(' "   +  productID  +   " ', "
                       +   " ' "   +  productName  +   " ', "   +  String.valueOf(price)  +   " ) " ;
              PreparedStatement pstmt  =  conn.prepareStatement(sql);
              pstmt.executeUpdate();    //  执行INSERT语句
              pstmt.close();
              conn.close();
          }
           catch  (Exception e)
          {
               throw   new  Exception(e.getMessage());
          }
      }
  }

     在Product 类中使用了一个ProductForm 类，这个类是一个ActionForm 类，它的功能是保存客户端提交的数据。关于这个类将在下面详细介绍。Product 类通过构造方法的form 参数将客户端提交的数据传入Product 类的对象实例中，并在构造方法中验证这些数据，如果发现数据不合法，就会抛出一个异常。当客户端提交的数据合法后，成功建立了一个Product 类的对象实例，然后可以通过简单地调用save 方法将数据保存到t_products 表中。

   package  mystruts.model;
  
   import  java.sql. * ;
   import  java.util. * ;
   import  mystruts.actionform. * ;
  
   public   class  SearchProduct  extends  util.Struts
  {
       private  ProductForm form;
  
       public  SearchProduct(ProductForm form)  throws  Exception
      {
           super ();
           this .form  =  form;
      }    
       //  查询产品信息，并通过List返回查询结果
       public  List < String[] >  search()  throws  Exception
      {
          List < String[] >  result  =   new  LinkedList < String[] > ();
          String sql  =   " SELECT * FROM t_products WHERE product_name like '% "  
+  form.getProductName()  +   " %' " ;
          PreparedStatement pstmt  =   conn.prepareStatement(sql);
          ResultSet rs  =  pstmt.executeQuery();   //  开始执行SELECT语句
           while (rs.next())
          {
              String[] row  =   new  String[ 3 ];
              row[ 0 ]  =  rs.getString( 1 );
              row[ 1 ]  =  rs.getString( 2 );
              row[ 2 ]  =  rs.getString( 3 );
              result.add(row);
          }
          rs.close();
          conn.close();
           return  result;
      }
  }

   package  mystruts.actionform;
  
   import  org.apache.struts.action. * ;
  
   public   class  ProductForm  extends  ActionForm
  {
       private  String productID;   //  产品ID
       private  String productName;  //  产品名称
       private   float  price;   //  产品价格
       public  String getProductID()
      {
           return  productID;
      }
       public   void  setProductID(String productID)
      {
           this .productID  =  productID;
      }
       public  String getProductName()
      {
           return  productName;
      }
       public   void  setProductName(String productName)
      {
           this .productName  =  productName;
      }
       public   float  getPrice()
      {
           return  price;
      }
       public   void  setPrice( float  price)
      {
           this .price  =  price;
      }
  }

     从上面的代码可以看出，ActionForm 类一般从 org.apache.struts.action.ActionForm 类继承，而且在类中需要按着需要保存的数据表字段添加属性。如产品ID的属性是productName。在MyEclipse中可以只定义三个private变量，然后使用MyEclipse的 【Source 】  >  【Generate Getters and Setters... 】功能自动产生getter 和setter 方法。但在给这些属性取名时要注意，private 变量的名子和数据表的字段名没有直接的关系，但必须和JSP 页面中的<html> 标签的property 属性值一致，如<html:text property="productName" /> 表示输入产品名称的文本框，其中property 属性的值就是ProductForm 类中的productName 变量。如果不一致，将会抛出异常。其他和ProductForm 类的属性对应的<html> 标签可以查看上面的代码。
     光有ActionForm 类还不够，还需要在struts-config.xml 中的<struts-config> 节点中添加如下的内容：

< form-beans >
     < form-bean  name ="saveProductForm"  type =" mystruts.actionform.ProductForm"   />
     < form-bean  name ="searchProductForm"  type ="mystruts.actionform.ProductForm"   />
</ form-beans >

   package  mystruts.action;
  
   import  javax.servlet.http. * ;
   import  org.apache.struts.action. * ;
   import  mystruts.actionform. * ;
   import  mystruts.model. * ;
  
   public   class  SaveProductAction  extends  Action
  {
       //  在客户端访问saveProduct动作时执行该方法
       public  ActionForward execute(ActionMapping mapping, ActionForm form,
              HttpServletRequest request, HttpServletResponse response)
      {
          ProductForm saveProductForm  =  (ProductForm) form;
           try
          {
              Product product  =   new  Product(saveProductForm);
              product.save();   //  保存产品信息
              request.setAttribute( " info " ,  " 保存成功! " );   
          }
           catch  (Exception e)
          {
              request.setAttribute( " info " , e.getMessage());
          }
           return  mapping.findForward( " save " );
      }
  }

< action  name ="saveProductForm"  path ="/saveProduct" scope ="request"  type =" mystruts.action.SaveProductAction" >
    < forward  name ="save"  path ="/mystruts/save.jsp"   />
</ action >

   < %@ page  pageEncoding ="GBK" % >
  ${requestScope.info}

     在IE 中输入如下的URL ：

    http://localhost:8080/samples/mystruts/newProduct.jsp

     在文本框中输入相应的信息后，点“保存”按钮，如果输入的数据是合法的，就会将数据保存在t_products 中，否则会显示出错的原因。    searchProduct动作的实现和saveProduct差不多，也会为三步：实现动作类（SearchProductAction）、在struts-config.xml中添加配置信息和实现用于显示查询结果的JSP文件。下面的代码分别显示了这三步所要编写的代码。

SearchProductAction.java

   package  mystruts.action;
  
   import  javax.servlet.http. * ;
   import  org.apache.struts.action. * ;
   import  mystruts.actionform. * ;
   import  mystruts.model. * ;
   import  java.util. * ;
  
   public   class  SearchProductAction  extends  Action
  {
  
       public  ActionForward execute(ActionMapping mapping, ActionForm form,
              HttpServletRequest request, HttpServletResponse response)
      {
          ProductForm searchProductForm  =  (ProductForm) form;
           try
          {
              SearchProduct searchProduct  =   new  SearchProduct(searchProductForm);
              List < String[] >  result  =  searchProduct.search();   //  查询产品信息
               if  (result.size()  >   0 )   //  有符合条件的产品信息
              {
                  request.setAttribute( " result " , result);
                  request.setAttribute( " info " ,  " 记录数： "   +  String.valueOf(result.size()));
              }
               else    //  没有查到任何产品信息
                  request.setAttribute( " info " ,  " 没有符合要求的记录! " );
          }
           catch  (Exception e)
          {
              request.setAttribute( " info " , e.getMessage());
          }
           return  mapping.findForward( " search " );
      }
  }

在 struts-config.xml 中配置 searchProduct 动作

< action  name ="searchProductForm"  path ="/searchProduct"  scope ="request"  type ="mystruts.action.SearchProductAction" >
    < forward  name ="search"  path ="/mystruts/search.jsp"   />
</ action >

search.jsp

   <% @ page pageEncoding = " GBK " %>
   <% @ taglib uri = " http://struts.apache.org/tags-logic "  prefix = " logic " %>
   <% @ taglib uri = " http://java.sun.com/jsp/jstl/core "  prefix = " c " %>
   < html >
       < body >
<% --  从request的result中取出查询结果  -- %>
           < c:set  var ="result"  value ="${requestScope.result}"   />
           < table  width ="100%" >
               < tr  align ="center" >
                   < td >
                      ${requestScope.info}
                   </ td >
               </ tr >
               < tr  align ="center" >
                   < td >
                       < logic:present  name ="result" >
                           < table  border ="1" >
                               < tr  align ="center" >
                                   < td >  产品ID  </ td >
                                   < td >  产品名称  </ td >
                                   < td >  价格  </ td >
                               </ tr >
                               < logic:iterate  id ="row"  name ="result" >
                                   < tr >   < td >  ${row[0]}  </ td >
                                       < td >  ${row[1]}  </ td >
                                       < td >  ${row[2]}  </ td >
                                   </ tr >
                               </ logic:iterate >
                           </ table >
                       </ logic:present >
                   </ td >
               </ tr >
           </ table >
       </ body >
   </ html >

     在IE 中输入如下的URL ：

    http://localhost:8080/samples/%20mystruts/searchProduct.jsp

     在“产品名称”文本框中输入产品名称的一部分，程序就会查询出所有包含输入的产品名称的产品信息，并将结果显示出来。

七、解决 ActionForm 的乱码问题

 

     到现在为止，程序的功能部分已经全部实现完了。但还存在一个问题。当我们在产品名称中输入中文时，虽然将客户端提交的数据成功保存到数据库中，但是在t_products 表中的product_name 字段显示的都是乱码。产生这个问题的原因只有一个，就是客户端提交的数据的编码格式和数据库的编码格式不一致造成的。当然，解决这个问题的方法有很多，但笔者认为最容易的就是使用过滤器。所谓过滤器，就是在客户端提交数据后，在交由服务端处理之前所执行的一段服务端代码（一般为Java 代码）。一个过滤器是一个实现javax.servlet.Filter 接口的类。在本例中要使用的过滤器类叫EncodingFilter ，实现代码如下：

EncodingFilter.java

   package  filter;
   import  java.io.IOException;
   import  javax.servlet. * ;
   public   class  EncodingFilter  implements  Filter
  {
       public   void  destroy() {  }
       public   void  doFilter(ServletRequest request, ServletResponse response,
              FilterChain chain)  throws  IOException, ServletException
      {
          request.setCharacterEncoding( " GBK " );   //  将客户端提交的数据设为GBK编码格式
          //  继续处理客户端提交的数据，如果不写这条语句，Servlet引擎将不会处理所过滤的页面
          chain.doFilter(request, response);      
      }
       public   void  init(FilterConfig filterConfig)  throws  ServletException {   }  
  }

    Filter 接口的doFilter 方法是过滤器的核心方法。其中FilterChain 类的doFilter 方法允许继续处理客户端提交的数据。我们还可以使用这个方法来临时关闭Web 站点的某个或全部的页面（根据过滤器的设置而定）。由于本书的数据库使用的是GBK 编码格式，因此，需要使用ServletRequest 的setCharacterEncoding 方法将客户端提交的数据也设为GBK 编码格式。

     除了实现过滤器类，我们还需要在web.xml 中的<web-app> 节点加入如下的配置信息才能使过滤器生效：

在 web.xml 中配置过滤器

< filter >
    < filter-name > EncodingFilter </ filter-name >
    < filter-class >
        filter.EncodingFilter
    </ filter-class >
</ filter >
< filter-mapping >
    < filter-name > EncodingFilter </ filter-name >
    < url-pattern > /* </ url-pattern >
</ filter-mapping >