Jersey+Spring+Hibernate集成学习记录

本文仅作为集成过程中的学习记录，会有部分个人的看法，所以文中的部分论述不保证正确，请谨慎参考。
破集成做了2天，发现这方面的资料不是太完善，好多资料都是前些年的，版本间的不兼容问题很少有文章涉及，所以走了不少弯路，这里记录下来加深一下记忆。
注：由于项目要求，所以项目的搭建过程非Maven环境。

• Jersey环境搭建及使用
  首先请去Jersey官网下载最新版的lib，这里不贴地址了，上次贴地址导致文章进审核。将jar包放到工程lib下，然后配置web.xml。

<display-name>Jersey Demo</display-name>

    <servlet>
        <servlet-name>jerseyServlet</servlet-name>
        <servlet-class>org.glassfish.jersey.servlet.ServletContainer</servlet-class>
       <init-param>
            <param-name>javax.ws.rs.Application</param-name>
            <param-value>com.JerseyResourceConfig</param-value>
        </init-param>
       <!--  <init-param>
        <param-name>jersey.config.server.provider.packages</param-name>
        <param-value>{packagename}</param-value>
        </init-param> -->
        <load-on-startup>1</load-on-startup>
        <async-supported>true</async-supported>  
    </servlet>
    <servlet-mapping>
        <servlet-name>jerseyServlet</servlet-name>
        <url-pattern>/ws/*</url-pattern>
    </servlet-mapping>

这里做一下说明，init-param有两种配置方式，被注释掉的是第二种，这种方式，Jersey会直接扫描你指定的{packagename}目录下文件作为API发布。由于后续要集成spring，这里选用了第一种。
然后我们继承ResourceConfig新建一个类作为Application。

public class JerseyResourceConfig extends ResourceConfig {

    public JerseyResourceConfig() {
        packages("com.test.api");

        register(RequestContextFilter.class);
    }
}

package指定了Jersey要扫描的包，而RequestContextFilter是集成Spring的关键，后面会谈到。
然后建立一个Demo

@Path("/Demo")
public class Demo{

    @Path("hello")
    @GET
    @Produces(MediaType.APPLICATION_JSON)
    public String hello(@QueryParam("name") String name) {
        return JSON.toJSONString(name);
    }

在浏览器输入http://localhost:8080/test/demo/hello?name=Jersey 即可测试。

• Spring环境搭建及使用
  首先导入Spring的相应Jar包，web.xml追加如下配置

<context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath:applicationContext.xml</param-value>
    </context-param>
    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>

这里就先不做Demo了，由于目前Servlet是Jersey提供，所以执行时是托管在Jersey上，在进行集成前，Spring是无法进行依赖注入的。

• Hibernate环境搭建及使用
  引入相关Jar包，在src下新建hibernate.cfg.xml

<!DOCTYPE hibernate-configuration PUBLIC
        "-//Hibernate/Hibernate Configuration DTD 3.0//EN"
        "http://www.hibernate.org/dtd/hibernate-configuration-3.0.dtd">

<hibernate-configuration>
    <session-factory>
        <property name="hibernate.connection.driver_class">com.mysql.jdbc.Driver</property>
        <property name="hibernate.connection.password">123456</property>
        <property name="hibernate.connection.url">jdbc:mysql://localhost:3306/test_database</property>
        <property name="hibernate.connection.username">root</property> 
        <property name="hibernate.dialect">org.hibernate.dialect.MySQLDialect</property>
        <mapping resource="com/test/entities/Demo.hbm.xml" />
    </session-factory>
</hibernate-configuration>

根据数据库表新建实体类，然后通过eclipse的jboss插件可以生成对应的hbm文件，hbm文件需要在hibernate.cfg.xml中通过<mapping resource="com/test/entities/Demo.hbm.xml" />注册。
这里就可以写Dao类来访问数据库了。由于目前没有集成，所以sessionfactory需要通过SessionFactory sf = new Configuration().configure().buildSessionFactory();来获取。

• Jersey集成Spring
  终于开始集成了，首先是Jersey集成Spring，这里要吐槽一下，Jersey分为1.x版本和2.x版本，1.x版本是由sun公司维护的，2.x版本是由glassfish维护，对，版本升级直接换了公司。。。 具体什么原因导致的这种状况不太了解，但是1.x与2.x的版本差异很大，所以集成方式也几乎完全不同，目前网上多数的集成都是早期的资料,基本都是基于1.x版本的。下面说一下2个版本的集成方式。
  -Jersey 1.x
  由于我用的是2.x版本，所以1.x的集成方式仅限于根据资料的总结，实际并没有尝试过是否可用。
  首先1.x版本的集成需要一个jersey-spring-1.x.jar（在mvnrepository上可以找到），这个jar包会提供一个Servlet，引入该Jar包后修改web.xml

<servlet-name>jerseyServlet</servlet-name>
<servlet-class>com.sun.jersey.spi.spring.container.servlet.SpringServlet</servlet-class>

然后就可以使用spring DI了。

-Jersey 2.x
2.x版本的Jersey由glassfish提供，在官网上可以直接下载。这个版本的集成需要在Application（上文的JerseyResourceConfig）中配置。

public class JerseyResourceConfig extends ResourceConfig {

    public JerseyResourceConfig() {
        packages("com.test.api");

        register(RequestContextFilter.class);
    }
}

我们在ResourceConfig中注册了RequestContextFilter，RequestContextFilter是 Spring的filter，提供了 JAX-RS （即Jersey）和 Spring 请求属性之间的桥梁。这里我们需要为项目追加一个spring-bridge-2.x.x.jar用来提供Jersey与Spring之间的桥接。注册后即可通过spring进行注入，这里提一下，Jersey集成Spring有一定的局限性，bean需要通过Spring注解注入，不能通过Spring XML直接注入。

• Spring集成Hibernate
  集成Hibernate理论上是为了session的注入，所以只需要在Spring的applicationContext.xml中添加session的bean。

<bean id="transactionManager" class="org.springframework.orm.hibernate4.HibernateTransactionManager">
    <property name="sessionFactory" ref="sessionFactory"></property>
</bean>

但由于我们是在hibernate.cfg,xml中进行Hibernate的配置，所以需要将该文件引入

<bean id="sessionFactory"  
    class="org.springframework.orm.hibernate4.LocalSessionFactoryBean">  
    <property name="configLocation" value="classpath:hibernate.cfg.xml" />  
</bean>

另外，我在集成完成后程序启动时遇到以下问题

Cannot unwrap to requested type [javax.sql.DataSource]

说明集成后，DataSource需要从Spring的配置中获取，所以移除hibernate.cfg.xml中相关的DataSource配置，并在applicationContext.xml追加

<bean id="dataSource" class="org.springframework.jdbc.datasource.DriverManagerDataSource">
    <property name="driverClassName" value="com.mysql.jdbc.Driver" />
    <property name="url" value="jdbc:mysql://localhost:3306/test_database" />
    <property name="username" value="root" />
    <property name="password" value="123456" />
</bean>

并修改

<bean id="sessionFactory"  
    class="org.springframework.orm.hibernate4.LocalSessionFactoryBean">  
    <property name="configLocation" value="classpath:hibernate.cfg.xml" />  
    <property name="dataSource" ref="dataSource" />
</bean>

Hibernate的简单集成目前已经完成了，由于考虑不希望开发中频繁的开关session，所以使用Spring做了事物管理并进行了AOP配置。具体配置如下

<bean id="transactionManager" class="org.springframework.orm.hibernate4.HibernateTransactionManager">
    <property name="sessionFactory" ref="sessionFactory"></property>
</bean>
<tx:annotation-driven transaction-manager="transactionManager"/>
<tx:advice id="txAdvice">
<tx:attributes>
<tx:method name="get*" read-only="true"/>
<tx:method name="save*" propagation="REQUIRED" read-only="false" />
<tx:method name="*" isolation="READ_COMMITTED" />
</tx:attributes>
</tx:advice>
<aop:config>
<aop:pointcut expression="execution(* com.test.service.*.*(..))" id="txPointcut"/>
<aop:advisor advice-ref="txAdvice" pointcut-ref="txPointcut"/>
</aop:config>

这样，我们就可以直接使用从注入的SessionFactory获取session直接使用了

this.getSessionFactory().getCurrentSession();