一 开发环境
1、动态web工程
2、部分依赖
1. hibernate-release-4.1.0.Final.zip
2. hibernate-validator-4.2.0.Final.jar
3. spring-framework-3.1.1.RELEASE-with-docs.zip
4. proxool-0.9.1.jar
5. log4j 1.2.16
6. slf4j -1.6.1
7. mysql-connector-java-5.1.10.jar
8. hamcrest 1.3.0RC2
9. ehcache 2.4.3
hibernate-release-4.1.0.Final.zip
hibernate-validator-4.2.0.Final.jar
spring-framework-3.1.1.RELEASE-with-docs.zip
proxool-0.9.1.jar
log4j 1.2.16
slf4j -1.6.1
mysql-connector-java-5.1.10.jar
hamcrest 1.3.0RC2
ehcache 2.4.3
3、为了方便学习，暂没有使用maven构建工程
二 工程主要包括内容
1、springMVC + spring3.1.1 + hibernate4.1.0集成
2、通用DAO层 和 Service层
3、二级缓存 Ehcache
4、REST风格的表现层
5、通用分页（两个版本）
５.1、首页 上一页,下一页 尾页 跳转
５.2、上一页 1 2 3 4 5 下一页
6、数据库连接池采用proxool
7、spring集成测试
8、表现层的 java validator框架验证（采用hibernate-validator-4.2.0实现）
9、视图采用JSP，并进行组件化分离
三 TODO LIST 将本项目做成脚手架方便以后新项目查询
1、Service层进行AOP缓存（缓存使用Memcached实现）
2、单元测试（把常见的桩测试、伪实现、模拟对象演示一遍 区别集成测试）
3、监控功能
后台查询hibernate二级缓存 hit/miss率功能
后台查询当前服务器状态功能（如 线程信息、服务器相关信息）
4、spring RPC功能
5、spring集成 quartz 进行任务调度
6、spring集成 java mail进行邮件发送
7、DAO层将各种常用框架集成进来（方便查询）
8、把工作中经常用的东西 融合进去，作为脚手架，方便以后查询
四 集成重点及常见问题
1、spring-config.xml 配置文件：
1.1、该配置文件只加载除表现层之外的所有bean，因此需要如下配置：
1. <context:component-scan base-package="cn.javass">
2. "annotation" expression="org.springframework.stereotype.Controller"/>
3. </context:component-scan>
<context:component-scan base-package="cn.javass">
<context:exclude-filter type="annotation" expression="org.springframework.stereotype.Controller"/>
</context:component-scan>
通过exclude-filter 把所有 @Controller注解的表现层控制器组件排除
1.2、国际化消息文件配置
1. <!-- 国际化的消息资源文件 -->
2. "messageSource" class="org.springframework.context.support.ReloadableResourceBundleMessageSource">
3. "basenames">
4. <list>
5. <!-- 在web环境中一定要定位到classpath 否则默认到当前web应用下找 -->
6. <value>classpath:messages</value>
7. </list>
8. </property>
9. "defaultEncoding" value="UTF-8"/>
10. "cacheSeconds" value="60"/>
11. </bean>
<!-- 国际化的消息资源文件 -->
<bean id="messageSource" class="org.springframework.context.support.ReloadableResourceBundleMessageSource">
<property name="basenames">
<list>
<!-- 在web环境中一定要定位到classpath 否则默认到当前web应用下找 -->
<value>classpath:messages</value>
</list>
</property>
<property name="defaultEncoding" value="UTF-8"/>
<property name="cacheSeconds" value="60"/>
</bean>
此处basenames内一定是 classpath:messages ，如果你写出“messages”，将会到你的web应用的根下找 即你的messages.properties一定在 web应用/messages.propertis。
1.3、hibernate的sessionFactory配置 需要使用org.springframework.orm.hibernate4.LocalSessionFactoryBean，其他都是类似的，具体看源代码。
1．4、<aop:aspectj-autoproxy expose-proxy="true"/> 实现@AspectJ注解的，默认使用AnnotationAwareAspectJAutoProxyCreator进行AOP代理，它是BeanPostProcessor的子类，在容器启动时Bean初始化开始和结束时调用进行AOP代理的创建，因此只对当容器启动时有效，使用时注意此处。
1.5、声明式容器管理事务
建议使用声明式容器管理事务，而不建议使用注解容器管理事务（虽然简单），但太分布式了，采用声明式容器管理事务一般只对service层进行处理。
1. <tx:advice id="txAdvice" transaction-manager="txManager">
2. <tx:attributes>
3. "save*" propagation="REQUIRED"
4. "add*" propagation="REQUIRED"
5. "create*" propagation="REQUIRED"
6. "insert*" propagation="REQUIRED"
7. "update*" propagation="REQUIRED"
8. "merge*" propagation="REQUIRED"
9. "del*" propagation="REQUIRED"
10. "remove*" propagation="REQUIRED"
11. "put*" propagation="REQUIRED"
12. "use*" propagation="REQUIRED"/>
13. <!--hibernate4必须配置为开启事务 否则 getCurrentSession()获取不到-->
14. "get*" propagation="REQUIRED" read-only="true"
15. "count*" propagation="REQUIRED" read-only="true"
16. "find*" propagation="REQUIRED" read-only="true"
17. "list*" propagation="REQUIRED" read-only="true"
18. "*" read-only="true"
19. </tx:attributes>
20. </tx:advice>
21. <aop:config expose-proxy="true">
22. <!-- 只对业务逻辑层实施事务 -->
23. "txPointcut" expression="execution(* cn.javass..service..*.*(..))"
24. "txAdvice" pointcut-ref="txPointcut"/>
25. </aop:config>
<tx:advice id="txAdvice" transaction-manager="txManager">
<tx:attributes>
<tx:method name="save*" propagation="REQUIRED" />
<tx:method name="add*" propagation="REQUIRED" />
<tx:method name="create*" propagation="REQUIRED" />
<tx:method name="insert*" propagation="REQUIRED" />
<tx:method name="update*" propagation="REQUIRED" />
<tx:method name="merge*" propagation="REQUIRED" />
<tx:method name="del*" propagation="REQUIRED" />
<tx:method name="remove*" propagation="REQUIRED" />
<tx:method name="put*" propagation="REQUIRED" />
<tx:method name="use*" propagation="REQUIRED"/>
<!--hibernate4必须配置为开启事务 否则 getCurrentSession()获取不到-->
<tx:method name="get*" propagation="REQUIRED" read-only="true" />
<tx:method name="count*" propagation="REQUIRED" read-only="true" />
<tx:method name="find*" propagation="REQUIRED" read-only="true" />
<tx:method name="list*" propagation="REQUIRED" read-only="true" />
<tx:method name="*" read-only="true" />
</tx:attributes>
</tx:advice>
<aop:config expose-proxy="true">
<!-- 只对业务逻辑层实施事务 -->
<aop:pointcut id="txPointcut" expression="execution(* cn.javass..service..*.*(..))" />
<aop:advisor advice-ref="txAdvice" pointcut-ref="txPointcut"/>
</aop:config>
此处一定注意 使用 hibernate4，在不使用OpenSessionInView模式时，在使用getCurrentSession()时会有如下问题：
当有一个方法list 传播行为为Supports，当在另一个方法getPage()（无事务）调用list方法时会抛出org.hibernate.HibernateException: No Session found for current thread 异常。
这是因为getCurrentSession()在没有session的情况下不会自动创建一个，不知道这是不是Spring3.1实现的bug，欢迎大家讨论下。
因此最好的解决方案是使用REQUIRED的传播行为。请看最后的分析
二、spring-servlet.xml：
2.1、表现层配置文件，只应加装表现层Bean，否则可能引起问题。
1. <!-- 开启controller注解支持 -->
2. <!-- 注：如果base-package=cn.javass 则注解事务不起作用-->
3. <context:component-scan base-package="cn.javass.demo.web.controller">
4. "annotation" expression="org.springframework.stereotype.Controller"/>
5. </context:component-scan>
<!-- 开启controller注解支持 -->
<!-- 注：如果base-package=cn.javass 则注解事务不起作用-->
<context:component-scan base-package="cn.javass.demo.web.controller">
<context:include-filter type="annotation" expression="org.springframework.stereotype.Controller"/>
</context:component-scan>
此处只应该加载表现层组件，如果此处还加载dao层或service层的bean会将之前容器加载的替换掉，而且此处不会进行AOP织入，所以会造成AOP失效问题（如事务不起作用），再回头看我们的1.4讨论的。
2.2、<mvc:view-controller path="/" view-name="forward:/index"/> 表示当访问主页时自动转发到index控制器。
2.3、静态资源映射
1. <!-- 当在web.xml 中 DispatcherServlet使用 <url-pattern>/</url-pattern> 映射时，能映射静态资源 -->
2. <mvc:default-servlet-handler/>
3. <!-- 静态资源映射 -->
4. <mvc:resources mapping="/images/**" location="/WEB-INF/images/"
5. <mvc:resources mapping="/css/**" location="/WEB-INF/css/"
6. <mvc:resources mapping="/js/**" location="/WEB-INF/js/"
<!-- 当在web.xml 中 DispatcherServlet使用 <url-pattern>/</url-pattern> 映射时，能映射静态资源 -->
<mvc:default-servlet-handler/>
<!-- 静态资源映射 -->
<mvc:resources mapping="/images/**" location="/WEB-INF/images/" />
<mvc:resources mapping="/css/**" location="/WEB-INF/css/" />
<mvc:resources mapping="/js/**" location="/WEB-INF/js/" />
以上是配置文件部分，接下来来看具体代码。
三、通用DAO层Hibernate4实现
为了减少各模块实现的代码量，实际工作时都会有通用DAO层实现，以下是部分核心代码：
1. public abstract class BaseHibernateDao<M extends java.io.Serializable, PK extends java.io.Serializable> implements
2.
3. protected static final Logger LOGGER = LoggerFactory.getLogger(BaseHibernateDao.class);
4.
5. private final
6. private final
7. private final
8. private final
9. private final
10. private String pkName = null;
11.
12. @SuppressWarnings("unchecked")
13. public
14. this.entityClass = (Class<M>) ((ParameterizedType) getClass().getGenericSuperclass()).getActualTypeArguments()[0];
15. this.entityClass.getDeclaredFields();
16. for(Field f : fields) {
17. if(f.isAnnotationPresent(Id.class)) {
18. this.pkName = f.getName();
19. }
20. }
21.
22. Assert.notNull(pkName);
23. //TODO @Entity name not null
24. "from " + this.entityClass.getSimpleName() + " order by " + pkName + " desc";
25. "from " + this.entityClass.getSimpleName() + " where " + pkName + " > ? order by " + pkName + " asc";
26. "from " + this.entityClass.getSimpleName() + " where " + pkName + " < ? order by " + pkName + " desc";
27. " select count(*) from " + this.entityClass.getSimpleName();
28. }
29.
30. @Autowired
31. @Qualifier("sessionFactory")
32. private
33.
34. public
35. //事务必须是开启的，否则获取不到
36. return
37. }
38. ……
39. }
public abstract class BaseHibernateDao<M extends java.io.Serializable, PK extends java.io.Serializable> implements IBaseDao<M, PK> {
protected static final Logger LOGGER = LoggerFactory.getLogger(BaseHibernateDao.class);
private final Class<M> entityClass;
private final String HQL_LIST_ALL;
private final String HQL_COUNT_ALL;
private final String HQL_OPTIMIZE_PRE_LIST_ALL;
private final String HQL_OPTIMIZE_NEXT_LIST_ALL;
private String pkName = null;
@SuppressWarnings("unchecked")
public BaseHibernateDao() {
this.entityClass = (Class<M>) ((ParameterizedType) getClass().getGenericSuperclass()).getActualTypeArguments()[0];
Field[] fields = this.entityClass.getDeclaredFields();
for(Field f : fields) {
if(f.isAnnotationPresent(Id.class)) {
this.pkName = f.getName();
}
}
Assert.notNull(pkName);
//TODO @Entity name not null
HQL_LIST_ALL = "from " + this.entityClass.getSimpleName() + " order by " + pkName + " desc";
HQL_OPTIMIZE_PRE_LIST_ALL = "from " + this.entityClass.getSimpleName() + " where " + pkName + " > ? order by " + pkName + " asc";
HQL_OPTIMIZE_NEXT_LIST_ALL = "from " + this.entityClass.getSimpleName() + " where " + pkName + " < ? order by " + pkName + " desc";
HQL_COUNT_ALL = " select count(*) from " + this.entityClass.getSimpleName();
}
@Autowired
@Qualifier("sessionFactory")
private SessionFactory sessionFactory;
public Session getSession() {
//事务必须是开启的，否则获取不到
return sessionFactory.getCurrentSession();
}
……
}
Spring3.1集成Hibernate4不再需要HibernateDaoSupport和HibernateTemplate了，直接使用原生API即可。
四、通用Service层代码 此处省略，看源代码，有了通用代码后CURD就不用再写了。
1. @Service("UserService")
2. public class UserServiceImpl extends BaseService<UserModel, Integer> implements
3.
4. private static final Logger LOGGER = LoggerFactory.getLogger(UserServiceImpl.class);
5.
6. private
7.
8. @Autowired
9. @Qualifier("UserDao")
10. @Override
11. public void
12. this.baseDao = userDao;
13. this.userDao = (UserDao) userDao;
14. }
15.
16.
17.
18. @Override
19. public Page<UserModel> query(int pn, int
20. return
21. }
22. }
23.
@Service("UserService")
public class UserServiceImpl extends BaseService<UserModel, Integer> implements UserService {
private static final Logger LOGGER = LoggerFactory.getLogger(UserServiceImpl.class);
private UserDao userDao;
@Autowired
@Qualifier("UserDao")
@Override
public void setBaseDao(IBaseDao<UserModel, Integer> userDao) {
this.baseDao = userDao;
this.userDao = (UserDao) userDao;
}
@Override
public Page<UserModel> query(int pn, int pageSize, UserQueryModel command) {
return PageUtil.getPage(userDao.countQuery(command) ,pn, userDao.query(pn, pageSize, command), pageSize);
}
}
五、表现层 Controller实现
采用SpringMVC支持的REST风格实现，具体看代码，此处我们使用了java Validator框架 来进行 表现层数据验证
在Model实现上加验证注解
1. @Pattern(regexp = "[A-Za-z0-9]{5,20}", message = "{username.illegal}") //java validator验证（用户名字母数字组成，长度为5-10）
2. private
3.
4. @NotEmpty(message = "{email.illegal}")
5. @Email(message = "{email.illegal}") //错误消息会自动到MessageSource中查找
6. private
7.
8. @Pattern(regexp = "[A-Za-z0-9]{5,20}", message = "{password.illegal}")
9. private
10.
11. @DateFormat( message="{register.date.error}")//自定义的验证器
12. private
@Pattern(regexp = "[A-Za-z0-9]{5,20}", message = "{username.illegal}") //java validator验证（用户名字母数字组成，长度为5-10）
private String username;
@NotEmpty(message = "{email.illegal}")
@Email(message = "{email.illegal}") //错误消息会自动到MessageSource中查找
private String email;
@Pattern(regexp = "[A-Za-z0-9]{5,20}", message = "{password.illegal}")
private String password;
@DateFormat( message="{register.date.error}")//自定义的验证器
private Date registerDate;
在Controller中相应方法的需要验证的参数上加@Valid即可
1. @RequestMapping(value = "/user/add", method = {RequestMethod.POST})
2. public String add(Model model, @ModelAttribute("command") @Valid
@RequestMapping(value = "/user/add", method = {RequestMethod.POST})
public String add(Model model, @ModelAttribute("command") @Valid UserModel command, BindingResult result)
六、Spring集成测试
使用Spring集成测试能很方便的进行Bean的测试，而且使用@TransactionConfiguration(transactionManager = "txManager", defaultRollback = true)能自动回滚事务，清理测试前后状态。
1. @RunWith(SpringJUnit4ClassRunner.class)
2. @ContextConfiguration(locations = {"classpath:spring-config.xml"})
3. @Transactional
4. @TransactionConfiguration(transactionManager = "txManager", defaultRollback = true)
5. public class
6.
7. new
8.
9. @Autowired
10. private
11. ……
12. }
@RunWith(SpringJUnit4ClassRunner.class)
@ContextConfiguration(locations = {"classpath:spring-config.xml"})
@Transactional
@TransactionConfiguration(transactionManager = "txManager", defaultRollback = true)
public class UserServiceTest {
AtomicInteger counter = new AtomicInteger();
@Autowired
private UserService userService;
……
}
其他部分请直接看源码，欢迎大家讨论。
补充spring3.1.1源代码分析当 传播行为为 Support时报 org.hibernate.HibernateException: No Session found for current thread 异常：
spring3.1开始 不提供（没有这个东西了）Hibernate4的 DaoSupport和Template，，而是直接使用原生的Hibernate4 API
如在 Hibernate3中 HibernateTemplate中有如下代码
1. protected Session getSession() {
2. if (isAlwaysUseNewSession()) {
3. return SessionFactoryUtils.getNewSession(getSessionFactory(), getEntityInterceptor());
4. }
5. else if (isAllowCreate()) {//默认是true，也就是即使你的传播行为是Supports也一定会有session存在的
6. return SessionFactoryUtils.getSession(
7. getSessionFactory(), getEntityInterceptor(), getJdbcExceptionTranslator());
8. }
9. else if (SessionFactoryUtils.hasTransactionalSession(getSessionFactory())) {
10. return SessionFactoryUtils.getSession(getSessionFactory(), false);
11. }
12. else {
13. try {
14. return getSessionFactory().getCurrentSession();
15. }
16. catch (HibernateException ex) {
17. throw new DataAccessResourceFailureException("Could not obtain current Hibernate Session", ex);
18. }
19. }
20. }
但我们使用的是Hibernate4原生API，使用SpringSessionContext获取session，而这个isAllowCreate选项默认为false
1. /**
2. * Retrieve the Spring-managed Session for the current thread, if any.
3. */
4. public Session currentSession() throws HibernateException {
5. try {
6. return (org.hibernate.classic.Session) SessionFactoryUtils.doGetSession(this.sessionFactory, false);//最后的false即是
7. }
8. catch (IllegalStateException ex) {
9. throw new HibernateException(ex.getMessage());
10. }
11. }
SessionFactoryUtils类
1. public static Session doGetSession(SessionFactory sessionFactory, boolean allowCreate)
2. throws HibernateException, IllegalStateException {
3.
4. return doGetSession(sessionFactory, null, null, allowCreate);
5. }
可否认为这是集成Hibernate4的bug，或者采用OpenSessionInView模式解决或者传播行为最低为Required。
