集成 Jersey、Spring、Shiro

在上面的 Jersey web 项目的基础上，添加 Spring、Shiro 的支持，实现初级的权限安全框架。

增加 Spring、Shiro 的版本依赖

pom.xml 做如下修改:

<properties>中增加 Spring、Shiro 的版本

  1. <spring.version>4.1.4.RELEASE</spring.version>
  2. <shiro.version>1.2.3</shiro.version>

<dependencies>中增加 Spring、Shiro 的版本依赖

  1. <dependency>
  2.     <groupId>org.glassfish.jersey.ext</groupId>
  3.     <artifactId>jersey-spring3</artifactId>
  4.     <version>${jersey.version}</version>
  5.     <exclusions>
  7.         <exclusion>
  8.             <artifactId>jersey-server</artifactId>
  9.             <groupId>org.glassfish.jersey.core</groupId>
  10.         </exclusion>
  11.         <exclusion>
  12.             <artifactId>
  13.                 jersey-container-servlet-core
  14.             </artifactId>
  15.             <groupId>org.glassfish.jersey.containers</groupId>
  16.         </exclusion>
  17.         <exclusion>
  18.             <artifactId>hk2</artifactId>
  19.             <groupId>org.glassfish.hk2</groupId>
  20.         </exclusion>
  21.         <exclusion>
  22.             <groupId>org.springframework</groupId>
  23.             <artifactId>spring-core</artifactId>
  24.         </exclusion>
  25.         <exclusion>
  26.             <groupId>org.springframework</groupId>
  27.             <artifactId>spring-context</artifactId>
  28.         </exclusion>
  29.         <exclusion>
  30.             <groupId>org.springframework</groupId>
  31.             <artifactId>spring-web</artifactId>
  32.         </exclusion>
  33.         <exclusion>
  34.             <groupId>org.springframework</groupId>
  35.             <artifactId>spring-beans</artifactId>
  36.         </exclusion>
  37.         <exclusion>
  38.             <groupId>org.springframework</groupId>
  39.             <artifactId>spring-orm</artifactId>
  40.         </exclusion>
  41.         <exclusion>
  42.             <groupId>org.springframework</groupId>
  43.             <artifactId>spring-aop</artifactId>
  44.         </exclusion>
  45.         <exclusion>
  46.             <groupId>org.springframework</groupId>
  47.             <artifactId>spring-aspects</artifactId>
  48.         </exclusion>
  49.         <exclusion>
  50.             <groupId>org.springframework</groupId>
  51.             <artifactId>spring-test</artifactId>
  52.         </exclusion>
  54.     </exclusions>
  55. </dependency>
  56. <!-- jersey end -->
  57. <!-- spring start -->
  59. <dependency>
  60.     <groupId>org.springframework</groupId>
  61.     <artifactId>spring-core</artifactId>
  62.     <version>${spring.version}</version>
  63. </dependency>
  65. <dependency>
  66.     <groupId>org.springframework</groupId>
  67.     <artifactId>spring-context</artifactId>
  68.     <version>${spring.version}</version>
  69. </dependency>
  70. <dependency>
  71.     <groupId>org.springframework</groupId>
  72.     <artifactId>spring-orm</artifactId>
  73.     <version>${spring.version}</version>
  74. </dependency>
  75. <dependency>
  76.     <groupId>org.springframework</groupId>
  77.     <artifactId>spring-web</artifactId>
  78.     <version>${spring.version}</version>
  79. </dependency>
  80. <dependency>
  81.     <groupId>org.springframework</groupId>
  82.     <artifactId>spring-aop</artifactId>
  83.     <version>${spring.version}</version>
  84. </dependency>
  85. <dependency>
  86.     <groupId>org.springframework</groupId>
  87.     <artifactId>spring-beans</artifactId>
  88.     <version>${spring.version}</version>
  89. </dependency>
  90. <dependency>
  91.     <groupId>org.springframework</groupId>
  92.     <artifactId>spring-aspects</artifactId>
  93.     <version>${spring.version}</version>
  94. </dependency>
  95. <dependency>
  96.     <groupId>org.springframework</groupId>
  97.     <artifactId>spring-test</artifactId>
  98.     <version>${spring.version}</version>
  99.     <scope>test</scope>
  100. </dependency>
  101. <!-- spring end -->
  103. <!-- shiro start -->
  104. <dependency>
  105.     <groupId>org.apache.shiro</groupId>
  106.     <artifactId>shiro-core</artifactId>
  107.     <version>${shiro.version}</version>
  108. </dependency>
  109. <dependency>
  110.     <groupId>org.apache.shiro</groupId>
  111.     <artifactId>shiro-spring</artifactId>
  112.     <version>${shiro.version}</version>
  113. </dependency>
  114. <dependency>
  115.     <groupId>org.apache.shiro</groupId>
  116.     <artifactId>shiro-web</artifactId>
  117.     <version>${shiro.version}</version>
  118. </dependency>
  119. <!-- shiro end -->

由于 Jersey 官方 只有 jersey-spring3 库是用 来对 Spring 进行集成支持的，所以我们在用 Spring 4.x 的依赖时，要将 jersey-spring3 中的 Spring 3 依赖剔除。

配置 Spring

在 resource 目录下 增加一个 applicationContext.xml,这个就不详述了，搞过 Spring　的都知道，而后在　web.xml 中添加如下：

  1. <!-- spring start -->
  2. <context-param>
  3.     <param-name>contextConfigLocation</param-name>
  4.     <param-value>classpath:applicationContext.xml</param-value>
  5. </context-param>
  7. <listener>
  8.     <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
  9. </listener>
  10. <filter>
  11.     <description>处理编码的过滤器</description>
  12.     <filter-name>encodingFilter</filter-name>
  13.     <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
  14.     <init-param>
  15.         <param-name>encoding</param-name>
  16.         <param-value>UTF-8</param-value>
  17.     </init-param>
  18.     <init-param>
  19.         <param-name>forceEncoding</param-name>
  20.         <param-value>true</param-value>
  21.     </init-param>
  22. </filter>
  24. <filter-mapping>
  25.     <filter-name>encodingFilter</filter-name>
  26.     <url-pattern>/*</url-pattern>
  27. </filter-mapping>
  28. <!-- spring end -->

解释：classpath:applicationContext.xml,就是 Spring 配置文件的所在位置。encodingFilter 用来处理 编码的，这里是 UTF-8 来支持中文。

没错 ，Spring 的配置就是这么简单。

问题

web.xml 可能会出现下面的问题：

  1. The content of element type "web-app" must match "(icon?,display-
  2.  name?,description?,distributable?,context-param*,filter*,filter-mapping*,listener*,servlet*,servlet-
  3.  mapping*,session-config?,mime-mapping*,welcome-file-list?,error-page*,taglib*,resource-env-
  4.  ref*,resource-ref*,security-constraint*,login-config?,security-role*,env-entry*,ejb-ref*,ejb-local-ref*)".

意思是 这个 web.xml 的解析文档太旧了，解决方法是 将原来的

  1. <!DOCTYPE web-app PUBLIC
  2.  "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
  3.  "http://java.sun.com/dtd/web-app_2_3.dtd" >
  5. <web-app>

改为：

  1. <?xml version="1.0" encoding="UTF-8"?>
  3. <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  4.     xmlns="http://xmlns.jcp.org/xml/ns/javaee"
  5.     xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
  6.     id="WebApp_ID" version="3.1">

Shiro 在 Spring 的集成

为了方便管理，我们将 Shiro 的配置和 Spring 的常用配置分来处理。在相同路径下，复制一份 applicationContext.xml 更名为 applicationContext-shiro.xml。

修改 applicationContext.xml ，引用 Shiro 的配置

  2.       <!-- 引用各模块的spring配置文件 -->  
  3.      <import resource="applicationContext-shiro.xml"></import>

修改 applicationContext-spring.xml：

在 web.xml 中定义下面的过滤器及过滤器映射：

  1. <!-- filter-name对应applicationContext.xml中定义的名字为“shiroFilter”的bean -->
  2. <filter>
  3.     <filter-name>shiroFilter</filter-name>
  4.     <filter-class>org.springframework.web.filter.DelegatingFilterProxy</filter-class>
  5.     <init-param>
  6.         <param-name>targetFilterLifecycle</param-name>
  7.         <param-value>true</param-value>
  8.     </init-param>
  9. </filter>
  11. <!-- 使用“/*”匹配所有请求，保证所有的可控请求都经过Shiro的过滤。通常这个filter-mapping
  12. 放置到最前面(其他filter-mapping前面)，保证它是过滤器链中第一个起作用的 -->
  13. <filter-mapping>
  14.     <filter-name>shiroFilter</filter-name>
  15.     <url-pattern>/*</url-pattern>
  16. </filter-mapping>