使用SpringSide 3.1.4.3开发Web项目的全过程（中）

第七步、编写Action和JSP。在SpringSide 3.1.4.3中，使用的是Struts 2及其Convention插件，已经不是前面使用的CodeBehind插件了，关于Convention插件，这里要再说几句，该插件的大部分功能和CodeBehind相同，唯一让人有点迷惑的就是该插件到哪里寻找Action类的问题，它会根据struts.convention.package.locators属性的值来决定，在该项目中，其值为“web”，之需要查阅一下struts.xml文件即可知。这说明，Convention会寻找所有包含“web”这个单词的包，并在该包及其子包中寻找Action类。这也正是Action层的包名为personal.youxia.web的原因。

关于SpringSide 3种的Struts的探讨，大家可以看看我之前写的一篇文章 SpringSide 3 中的 Struts 2

ArticleAction的实现思路如下，修改index.jsp，使其重定向到article.action，该Action默认调用其list方法显示所有文章，并返回article.jsp作为其视图。在该视图上，有添加文章的连接，点击该连接则访问article!input.action，这时会调用ArticleAction的input方法，并返回article-input.jsp作为其视图，在该视图中输入文章的内容，点击保存，调用article!save.action，这时会调用ArticleAction的save方法以保存数据，如果要删除文章，则调用article!delete.action，这时会调用ArticleAction的delete方法。在调用以上方法的过程中，会自动调用prepare系列的方法。

因此，该步骤涉及到三个JSP文件和一个Action类，它们分别是
index.jsp
article.jsp
article-input.jsp
ArticleAction.java

index.jsp的修改很简单，只是让项目一启动后就去访问ArticleAction，而不是默认的UserAction。index.jsp的代码如下：

<%  response.sendRedirect("article.action");  %>

这时，重点进入到ArticleAction中，创建该Action，其代码的框架如下：

package  personal.youxia.web;

import  personal.youxia.entity.entities.Article;

public   class  ArticleAction  extends  CrudActionSupport < Article >   {

    @Override
    public String delete() throws Exception {
        // TODO Auto-generated method stub
        return null;
    }

    @Override
    public String list() throws Exception {
        // TODO Auto-generated method stub
        return null;
    }

    @Override
    protected void prepareModel() throws Exception {
        // TODO Auto-generated method stub

    }

    @Override
    public String save() throws Exception {
        // TODO Auto-generated method stub
        return null;
    }

    public Article getModel() {
        // TODO Auto-generated method stub
        return null;
    }

}

可以看到，该Action从CrudActionSupport类继承，而CrudActionSupport又继承自ActionSupport，并实现了ModelDriven和Preparable接口，这样Struts 2的ModelDriven拦截器和Preparable拦截器就会对我们自己的Action发生作用。CrudActionSupport中的excute方法默认的实现是调用list方法，所以访问article.action就等于访问ArticleAction的list方法，该方法的目的是为了列出所有的文章，所以在该方法中使用了ArticleDao的分页查询，查询结果放在一个page对象中。在Struts 2中，已经没有了ActionForm的概念，可以直接把Action对象传递到视图中，为了能够在视图中访问page对象，只需要把page对象作为ArticleAction的一个属性即可。先在ArticleAction.java中加入几行代码：

    @Autowired
     private  ArticleManager articleManager;

     public   void  setArticleManager(ArticleManager articleManager) {
         this .articleManager  =  articleManager;
    }
    
     private  Page < Article >  page  =   new  Page < Article > ( 10 );
    
     public  Page < Article >  getPage() {
         return  page;
    }

可以看到该代码的作用是为了注入ArticleManager和初始化Page对象，此时list方法的代码就非常简单，如下：

@Override
     public  String list()  throws  Exception {
        page  =  articleManager.getAll(page);
         return  SUCCESS;
    }

由于该方法只是简单获取一个页面的Acticle，所以代码很简单，使用articleManager.getAll方法即可。如果要实现复杂的条件查询，就需要创建一个包含PropertyFilter对象的列表，然后使用articleManager.search方法进行查询，为了简化PropertyFilter对象列表的创建，白衣提供了HibernateWebUtils.buildPropertyFilters()静态方法供大家使用。

list方法返回的是SUCCESS，因此返回给用户的视图页面为article.jsp，该页面应该存放在WEB-INF目录的content目录中，这也是Convention插件的一个特性，这样用户就没有办法直接访问到视图页面了。在该页面中，可以通过访问page对象来显示数据，如下：

<% @ page language = " java "  contentType = " text/html; charset=UTF-8 "
    pageEncoding = " UTF-8 " %>
<% @ include file = " /common/taglibs.jsp " %>
<! DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd" >
< html >
< head >
< meta  http-equiv ="Content-Type"  content ="text/html; charset=UTF-8" >
< title > Insert title here </ title >
</ head >
< body >
< table >
     < tr >< td >< a  href ="article!input.action" > 添加文章 </ a ></ td ></ tr >
     < s:iterator  value ="page.result" >
         < tr >
             < td > ${subject} </ td >
             < td >< a  href ="article!delete.action?id=${id}" > 删除 </ a ></ td >
         </ tr >
         < tr >
             < td > ${content} </ td >
         </ tr >
     </ s:iterator >
</ table >
</ body >
</ html >

如果数据库中有初始数据的话，该项目运行效果如下图：


到目前为止，还没有涉及到getModel()、prepareModel()、以及prepare系列的方法，但是，一旦需要添加或者删除文章，这一系列的方法就有作用了。在Struts 2中，由于没有了ActionForm的概念，所有的页面传入参数都会被注入到Action中，如果不想在Action中搞太多的getter和setter，最有效的方法就是提供一个Model对象，这时候拦截器会把页面参数注入到Model中，而在目前的项目中，没有比Entity类更适合做Model对象的了。通过观察CrudActionSupport基类，可以发现只有在执行save和input方法之前，才会执行prepareModel方法，该方法可以保证getModel方法返回的对象不是一个空指针，而调用delete方法之前Model对象没有初始化，但是delete方法只需要一个id作为参数，因此，可以在Action中增加一个id属性来满足要求。这时候，有改动的几行代码如下：

     private  Long id;
     private  Article article;

     public   void  setId(Long id) {
         this .id  =  id;
    }

    @Override
     protected   void  prepareModel()  throws  Exception {
         if  (id  !=   null ) {
            article  =  articleManager.get(id);
        }  else  {
            article  =   new  Article();
        }
    }
     public  Article getModel() {
         return  article;
    }

    @Override
     public  String delete()  throws  Exception {
        articleManager.delete(id);
         return  RELOAD;
    }

这里需要特别关注的是delete方法返回的值，为RELOAD，这是一个在基类中定义好了的字符串。返回该字符串的目的，是为了在delete方法执行完之后，不返回任何视图页面，而是以redirect的方式再次调用article.action，以便显示删除文章后的结果。因此，需要在ArticleAction中使用@Result注解，如下：

@Results( { @Result(name  =  CrudActionSupport.RELOAD, location  =   " article.action " , type  =   " redirect " ) })

经过如上修改，这时候再运行应用，就发现能够删除文章了。

再来实现添加文章的功能，从上面的article.jsp中可以看出，添加文章的链接为article!input.action，此时，会运行ArticleAction的input方法，该方法只是简单返回article-input.jsp视图文件作为用户输入文章的接口，article-input.jsp的代码如下：

<% @ page language = " java "  contentType = " text/html; charset=UTF-8 "
    pageEncoding = " UTF-8 " %>
<! DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd" >
< html >
< head >
< meta  http-equiv ="Content-Type"  content ="text/html; charset=UTF-8" >
< title > Insert title here </ title >
</ head >
< body >
< form  id ="inputForm"  action ="article!save.action"  method ="post" >
< table  class ="inputView" >
     < tr >
         < td > 主题: </ td >
         < td >< input  type ="text"  name ="subject"  size ="40"  id ="subject"   /></ td >
     </ tr >
     < tr >
         < td > 内容: </ td >
         < td >< textarea  name ="content"  id ="subject" ></ textarea ></ td >
     </ tr >
     < tr >
         < td  colspan ="2" >
             < input  type ="submit"  value ="提交"   /> &nbsp;  
             < input  type ="button"  value ="取消"  onclick ="history.back()" />
         </ td >
     </ tr >
</ table >
</ form >
</ body >
</ html >

而ArticleAction中只需要修改如下几行，由于ModelDriven拦截器已经把网页中传入的数据注入到了article对象中，所以save方法中只需要执行简单的保存操作即可：

    @Override
     public  String input()  throws  Exception {
         return  INPUT;
    }
    
    @Override
     public  String save()  throws  Exception {
        articleManager.save(article);
         return  RELOAD;
    }

至于实现文章的修改功能，那也是通过input方法和save方法实现的，只不过此时网页参数中会包含一个有效的id，而prepare系列的方法会根据该id先从数据库中提取数据，然后显示在article-input.jsp中，用户修改后，再调用save方法保存到数据库中。为减少本博文长度，该功能此处不做示范。

通过上面的步骤可以发现， 使用SpringSide 3中推荐的CRUD一体的模式，可以有效减少Action的数量和JSP文件的数量，每实现一个增删查改功能，只需要一个Action和两个JSP，但是，程序员一定要对其中的数据流向有充足的认识，才能理清它们之间的关系，不至于晕头转向。

到这里大家会发现，ArticleAction谁都可以访问，一点都不安全，所以第八步我会探讨如何让ArticleAction和SpringSecurity一起工作，至于第九步，当然是把项目从单数据库环境更改到多数据库环境了。具体内容，且看下回分解！