使用SpringSide 3.1.4.3开发Web项目的全过程(中)

来源:互联网 发布:国家统计局房价数据 编辑:程序博客网 时间:2024/05/21 17:40
第七步、编写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><href="article!input.action">添加文章</a></td></tr>
    <s:iterator value="page.result">
        <tr>
            <td>${subject}</td>
            <td><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一起工作,至于第九步,当然是把项目从单数据库环境更改到多数据库环境了。具体内容,且看下回分解!