配置
Servlet 3.0以上
Resteasy会使用Servlet 3.0容器中ServletContainerInitializer的接口来自动扫描Resources和Providers,并初始化整个application。自动扫描机能依赖resteasy-servlet-initializer这个包。
推荐使用Maven:
<dependency>
<groupId>org.jboss.resteasy</groupId>
<artifactId>resteasy-jaxrs</artifactId>
<version>${resteasy.version}</version>
</dependency>
<dependency>
<groupId>org.jboss.resteasy</groupId>
<artifactId>resteasy-jaxb-provider</artifactId>
<version>${resteasy.version}</version>
</dependency>
Servlet 3.0以下
需要在WEB-INF/web.xml文件里面手动配置之后,然后在一个继承了Application的类中(例子里面是:ShoppingApplication这个自定义的类,它继承了Application)来指明Resources 和 Providers。
web.xml配置:
<web-app>
<display-name>Archetype Created Web Application</display-name>
<listener>
<listener-class>
<!-- ResteasyBootstrap这个类就是ServletContextListener -->
<!-- 这个类里配置了ResteasyProviderFactory和Registry的实例,然后就能从ServletContext里获得 -->
org.jboss.resteasy.plugins.server.servlet.ResteasyBootstrap
</listener-class>
</listener>
<!-- ** 此处书写自定义Listeners !!!! -->
<servlet>
<servlet-name>Resteasy</servlet-name>
<servlet-class>
org.jboss.resteasy.plugins.server.servlet.HttpServletDispatcher
</servlet-class>
<init-param>
<param-name>javax.ws.rs.Application</param-name>
<param-value>com.restfully.shop.services.ShoppingApplication</param-value>
</init-param>
</servlet>
<servlet-mapping>
<servlet-name>Resteasy</servlet-name>
<url-pattern>/*</url-pattern>
</servlet-mapping>
</web-app>
将Resteasy 部署为Filter
上面的将Resteasy作为Servlet运行的一个缺点,是不能使用静态资源比如:.html和.jpeg。
Filter方式可以弥补这个问题。
<web-app>
<filter>
<filter-name>Resteasy</filter-name>
<filter-class>
org.jboss.resteasy.plugins.server.servlet.FilterDispatcher
</filter-class>
<init-param>
<param-name>javax.ws.rs.Application</param-name>
<param-value>com.restfully.shop.services.ShoppingApplication</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>Resteasy</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
</web-app>
注1:servlet/filter/listener/interceptor区别与联系,请您看这里
注2:Servlet、Filter 和 Listener 调用顺序、生命周期的实验分析,请您看这里