在大多数的Web应用框架中,Action都是一个最基本的概念,也是可以与用户发出的HTTP请求相关联的最小的工作单元。
在Struts2中,Action可以以几种不同的方式来工作。
单个结果
Action最常用也是最基本的用法就是执行操作后返回单个结果。这种Action看上去就是这样的:
class MyAction {
public String execute() throws Exception {
return "success";
}
} 只需要更改 “struts.action.extension”这个属性的值。
这样简单的几行代码当然说明不了什么。但首先,这个Action类不需要继承其它类,也不需要实现其他接口。这样的类就是一个简单的POJO。
其次,在这个类中有一个名为“execute”的方法。这个方法名是依照惯例命名的,如果你想用其他名字的话,那么只需要在Action的配置文件中做出更改。无论方法名是什么,它们都被认为会返回一个String类型的值。Action的配置文件会将该Action的返回代码与要呈现给用户的结果进行匹配。另外,该方法还可以在需要的时候抛出异常。
下面是最简单的配置信息:
<action name="my" class="com.fdar.infoq.MyAction" >
<result>view.jsp</result>
</action>
“name”属性提供了执行Action所对应的URL地址,在这里就是“my.action”。“.action”的扩展名是在“struts.properties” 4文件中配置的。“class”属性指定了要执行的action所对应的类的全限定名。
多个结果
现在情况稍微复杂了一些,Action需要根据逻辑运算的结果,来生成多个结果。下面的代码和刚才那个类看上去很像:
class MyAction {
public String execute() throws Exception {
if( myLogicWorked() ) {
return "success";
} else {
return "error";
}
}
}
因为这里有两个结果,所以就为每一种不同的情况来配置要呈现给用户的结果。配置文件就变成了如下的样子:<action name="my" class="com.fdar.infoq.MyAction" >
<result>view.jsp</result>
<result name="error">error.jsp</result>
</action>
我们可以看到在result节点中多了“name”属性,实际上这个属性是一直都存在的,如果开发人员没有显式指定它的值,那么它的默认值就是“success”(第一个result的配置就是如此)。
前面我们已经看到了定义Action结果的最通用的方式。而实际上我们还有另外四种方式:
1. Action方法返回一个字符串——这个返回的字符串与“struts.xml”的一个action配置相匹配。例子中已经演示这一种方式。
2. 使用Code behind插件 ——当使用这个插件的时候,它会将Action的名字和Action返回的结果字符串进行连接来得到视图模板。比如说,如果URL是“/adduser.action”,而Action返回了“success”,那么要渲染的页面就是“/adduser-success.jsp” 。3. 使用 @Result注解—— action类可以用@Results 和@Result注解来标注多个不同的结果。Action所返回的字符串需要与所注解的结果之一相匹配。
4. 方法返回一个Result类的实例——Action不必一定要返回一个字符串,它可以返回一个Result类的实例,该实例应当是已经配置好可使用的。
结果类型
Action生成并返回给用户的结果可能会有多个值,而且也可能是不同的类型。“success”的结果可能会渲染一个JSP页面,而“error”的结果可能需要向浏览器发送一个HTTP头。
结果类型(本章中稍后会详细讨论)是通过result节点的“type”属性来定义的。和“name”属性一样,这个属性有一个默认值——“dispatcher”——用来渲染JSP。大多数情况下,你只需要使用默认的结果类型就可以了,但是你可以提供自定义的实现。
请求和表单类型核心组件 | 17 更多精彩内容:http://www.infoq.com/cn
5 Martin Fowler写过一篇文章,对依赖注入进行了完整的描述: http://www.martinfowler.com/articles/injection.html
Action为了执行操作,并为数据库持久化对象提供数据,就必须要访问请求字符串和表单中的数据。
Struts2采用了JavaBean的风格——要访问数据的话,就给字段提供一个getter和setter,要访问请求字符串和表单也是一样的道理。每一个请求字符串和表单的值都是一个简单的名/值对,所以要设定一个特定名称的值的话,就要为它提供一个setter。比如,如果一个JSP调用了“/home.action?framework=struts&version=2”这样一个请求,那么action就应该提供如下两个setter:“setFramework( String frameworkName )”和“setVersion( int version )”。
我们可以看到,例子中的setter并不是只接受String类型的参数。在默认情况下,Struts2可以把String类型的值转换成action所需要的类型,这条规则对于所有的primitive类型和基本对象类型的值都适用,当然你也可以对其进行配置,让它也适用于你所创建的类。Struts2还可以在更加复杂的对象图中进行定位后赋值,比如说如果一个表单元素的名字是“person.address.home.postcode”,其值为“2”,那么Struts2就会调用“getPerson().getAddress().getHome().setPostcode(2)”这个方法。
到现在为止,我们已经讨论了很多有关Action配置的问题,以及如何根据不同的结果代码来控制返回给用户的结果。这是Action的一个很重要的功能,但是,它必须要完成一些操作之后,才能返回结果。因此它们需要访问多种类型的对象——业务对象,数据访问对象或者其他资源。
Struts2使用了名为依赖注入5——又名控制反转——的技术来降低系统的耦合性。依赖注入可以通过构造器注入,接口注入和setter注入来实现。Struts2中用的是setter注入。这就是说,你只需要提供一个setter,对应的对象就可以被Action使用了。Struts2推荐的依赖注入框架是Spring框架,并通过插件对它进行配置。你还可以使用Plexus,或者是提供自定义的实现。还有些对象是不受Spring框架管理的,例如HttpServletRequest。这些对象是通过setter注入和接口注入混合处理的。对于每一个非业务的对象而言,都有一个对应的接口(也就是“aware”接口),需要action对其进行实现。
在最开始的时候,WebWork有它自己独有的依赖注入框架。但自从2.2版本以后,该框架就被Spring取代了。原先的那种组件框架是基于接口的,所以每一个组件都需要有一个接口和一个对应的实现类。
另外,每一个对象都有一个“Aware”接口,为组件提供了setter方法。对于UserDAO接口而言,对应的aware接口按照惯例就会被命名为“UserDAOAware”,其中有一个setter方法——“void setUserDAO( UserDAO dao );”。
当必需的接口和setter齐备以后,拦截器就会对对象的注入进行管理了。
从Action中访问数据
在有些情况下我们需要查看被Action修改过的对象。有好几种技术可以帮助我们做到这一点。
对于开发人员而言,最常用的方法就是把所需要访问的对象放到HttpServletRequest或者HttpSession里面。这可以通过实现“aware”接口(让依赖注入来工作),并设置为可以通过要求的名称来访问的方式来达到。
如果你打算使用内建的标签库或者是JSTL支持的话,访问数据就会更简单了。这两种方法都可以通过值栈来访问Action。开发人员唯一要另外做的就是在Action里面为所要访问的对象提供getter方法。
Hibernate 配置
Hibernate同时支持xml 格式的配置文件,以及传统的properties文件配置方式,不过这
里建议采用xml 型配置文件。xml配置文件提供了更易读的结构和更强的配置能力,可以直
接对映射文件加以配置,而在properties文件中则无法配置,必须通过代码中的Hard Coding
加载相应的映射文件。下面如果不作特别说明,都指的是基于xml 格式文件的配置方式。
配置文件名默认为“hibernate.cfg.xml”(或者hibernate.properties),Hibernate 初始化期
间会自动在CLASSPATH 中寻找这个文件,并读取其中的配置信息,为后期数据库操作做好
准备。
配置文件应部署在CLASSPATH 中,对于Web 应用而言,配置文件应放置在在
/WEB-INF/classes 目录下。
一个典型的hibernate.cfg.xml配置文件如下:
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE hibernate-configuration
PUBLIC "-//Hibernate/Hibernate Configuration DTD//EN"
"http://hibernate.sourceforge.net/hibernate-configuration-2.0.
dtd">
<hibernate-configuration>
<!—- SessionFactory 配置-->
<session-factory>
<!—- 数据库URL -->
<property name="hibernate.connection.url">
jdbc:mysql://localhost/sample
</property>
<!—- 数据库JDBC驱动-->
<property name="hibernate.connection.driver_class">
org.gjt.mm.mysql.Driver
</property>
<!—- 数据库用户名-->
<property name="hibernate.connection.username">
User
</property>
<!—- 数据库用户密码-->
<property name="hibernate.connection.password">
Mypass
</property>
<!--dialect ,每个数据库都有其对应的Dialet以匹配其平台特性-->
<property name="dialect">
net.sf.hibernate.dialect.MySQLDialect
</property>
<!—- 是否将运行期生成的SQL输出到日志以供调试-->
<property name="hibernate.show_sql">
True
</property>
<!—- 是否使用数据库外连接-->
<property name="hibernate.use_outer_join">
True
</property>
<!—- 事务管理类型,这里我们使用JDBC Transaction -->
<property name="hibernate.transaction.factory_class">
net.sf.hibernate.transaction.JDBCTransactionFactory
</property>
<!—映射文件配置,注意配置文件名必须包含其相对于根的全路径-->
<mapping resource="net/xiaxin/xdoclet/TUser.hbm.xml"/>
<mapping resource="net/xiaxin/xdoclet/TGroup.hbm.xml"/>
</session-factory>
</hibernate-configuration>
一个典型的hibernate.properties配置文件如下:
hibernate.dialect net.sf.hibernate.dialect.MySQLDialect
hibernate.connection.driver_class org.gjt.mm.mysql.Driver
hibernate.connection.driver_class com.mysql.jdbc.Driver
hibernate.connection.url jdbc:mysql:///sample
hibernate.connection.username user
hibernate.connection.password mypass
第一段代码
上面我们已经完成了Hiberante 的基础代码,现在先从一段最简单的代码入手,感受一
下Hibernate所提供的强大功能。
下面这段代码是一个JUnit TestCase,演示了TUser 对象的保存和读取。考虑到读者可
能没有JUnit的使用经验,代码中加入了一些JUnit相关注释。
public class HibernateTest extends TestCase {
Session session = null;
/**
* JUnit中setUp方法在TestCase初始化的时候会自动调用
* 一般用于初始化公用资源
*此例中,用于初始化Hibernate Session
*/
protected void setUp(){
try {
/**
*采用hibernate.properties配置文件的初始化代码:
* Configuration config = new Configuration();
* config.addClass(TUser.class);
*/
//采用hibernate.cfg.xml配置文件
//请注意初始化Configuration时的差异:
// 1.Configuration的初始化方式
// 2.xml文件中已经定义了Mapping文件,因此无需再Hard Coding导入
// POJO文件的定义
Configuration config = new Configuration().configure();
SessionFactory sessionFactory =
config.buildSessionFactory();
session = sessionFactory.openSession();
} catch (HibernateException e) {
e.printStackTrace();
}
}
/**
*与setUp方法相对应,JUnit TestCase执行完毕时,会自动调用tearDown方法
*一般用于资源释放
*此例中,用于关闭在setUp方法中打开的Hibernate Session
*/
protected void tearDown(){
try {
session.close();
} catch (HibernateException e) {
e.printStackTrace();
}
}
/**
* 对象持久化(Insert)测试方法
*
* JUnit中,以”test”作为前缀的方法为测试方法,将被JUnit自动添加
* 到测试计划中运行
*/
public void testInsert(){
try {
TUser user = new TUser();
user.setName("Emma");
session.save(user);
session.flush();
} catch (HibernateException e) {
e.printStackTrace();
Assert.fail(e.getMessage());
}
}
/**
* 对象读取(Select)测试
* 请保证运行之前数据库中已经存在name=’Erica’的记录
*/
public void testSelect(){
String hql=
" from TUser where name='Erica'";
try {
List userList = session.find(hql);
TUser user =(TUser)userList.get(0);
Assert.assertEquals(user.getName(),"Erica");
} catch (HibernateException e) {
e.printStackTrace();
Assert.fail(e.getMessage());
}
}
}
主流IDE,如Eclipse、Intellij IDEA 和JBuilder 中都内置了JUnit支持。下面是Eclipse
中运行该代码的结果(在Run菜单中选择Run as -> JUnit Test即可):
现在我们已经成功实现了一个简单的TUser 实例的保存和读取。可以看到,程序中通过
少量代码实现了Java 对象和数据库数据的同步,同时借助Hibernate的有力支持,轻松实现
了对象到关系型数据库的映射。
相对传统的JDBC数据访问模式,这样的实现无疑更符合面向对象的思想,同时也大大
提高了开发效率。