SpringMVC 3.1集成Spring Security 3.1

这篇算是一个入门文章，昨天看见有网友提问，spring mvc集成spring security 的时候出错，揣测了一下问题木有解决。我就帮忙给搭建了一个集成框架他说可以，他告诉我这样的文章网上少。今天我就分享在这里供入门学习。spring mvc我木有用过，所以我们这里重点讲解如何集成spring security ，spring security是一个非常好的开源权限框架(具体了解自己google,或者到spring 官网，这里我给一个DOC3.1:http://static.springsource.org/spring-security/site/docs/3.1.x/reference/springsecurity.html)。可以说不仅仅包含了权限，里面有一套完整的授权认证系统包括：权限、防止session攻击、支持信道安全、支持LDAP认证、支持OpenID、同时支持CAS集成单点登录等等，个人用过spring security 2.0基本大致一样，当时中文资源那个少啊，尤其集成SSH+spring security 更是少的可怜，最后还是硬着头皮上，最后拿下了这个框架，最起码了解了。当时就写了一个SSH+spring security的文章，还被某网站引用。好了废话不扯，我们今天在来集成一个springmvc3.1+spring security3.1.我们step by step go。

step1：搭建SpringMVC。

如果你会搭建或者搭建好了spring MVC那这一步可以略过了。首先下载spring mvc3.1 jar这个到官网下载或者google，需要的jar如图：

然后创建一个包新建一个spring mvc 的class、我的如下：

@Controller
public class RestConstroller { 

    public RestConstroller() {} 

    @RequestMapping(value = "/welcome", method = RequestMethod.GET)
    public String registPost() {
        return "/hello";
    } 

}

上面采用spring 注解方式实例化class,这个我不多讲，spring mvc也没用过不敢乱点。官网有例子你自己照着做。http://static.springsource.org/spring/docs/3.1.x/spring-framework-reference/html/validation.html#format-configuring-FormattingConversionService

接着新建了一个view试图放了一个hello.jsp

然后新建一个spring-servlet.xml 这个是spring mvc的一个配置文件。

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
    xmlns:context="http://www.springframework.org/schema/context"
    xmlns:p="http://www.springframework.org/schema/p"
    xmlns:mvc="http://www.springframework.org/schema/mvc"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="
        http://www.springframework.org/schema/beans
        http://www.springframework.org/schema/beans/spring-beans.xsd
        http://www.springframework.org/schema/mvc
        http://www.springframework.org/schema/mvc/spring-mvc.xsd
        http://www.springframework.org/schema/context
        http://www.springframework.org/schema/context/spring-context.xsd">         

     <!-- 启动注解驱动的Spring MVC功能，注册请求url和注解POJO类方法的映射-->
     <mvc:annotation-driven />
     <!-- 启动包扫描功能，以便注册带有@Controller、@Service、@repository、@Component等注解的类成为spring的bean -->
     <context:component-scan base-package="com.mvc.test" />  <!--这个包根据自己的项目来配置，我的是com.mvc.test-->
     <!-- 对模型视图名称的解析，在请求时模型视图名称添加前后缀 -->
     <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver" p:prefix="/WEB-INF/view/" p:suffix=".jsp" />
</beans> 

然后配置web.xml:

     <context-param>
        <param-name>contextConfigLocation</param-name>
        <!-- 应用上下文配置文件 -->
        <param-value>/WEB-INF/spring-servlet.xml</param-value>
    </context-param>
    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener> 

　　<!-- 配置spring核心servlet -->
　　<servlet>
    　　<servlet-name>spring</servlet-name>
    　　<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    　　<load-on-startup>1</load-on-startup>
　　</servlet>
　　<!-- url-pattern配置为/ 拦截 -->
　　<servlet-mapping>
    　　<servlet-name>spring</servlet-name>
    　　<url-pattern>/</url-pattern>
　　</servlet-mapping>  

项目具体结构：

好了现在可以启动了，我这里启动的时候很不幸报错了，一看，缺少logger的jar,添加commons-logging-1.1.jar，ok启动访问http://localhost:8080/SpringMVC/welcome成功、

到这里spring mvc配置完成。下面我们的重点集成spring security 3.1

step 2 spring mvc3.1集成spring security 3.1

首先要讲一点大版本集成要注意一点，大版本号要保持一直，第一位的往往都是大版本号，小版本号影响不大。为什么要这样讲，当时我在集成SSH 的时候spring 用的是spring 2.X,然后去下载了一个spring security 3.X的死活不成功。后来在一片老外的文章中发现了，具体地址我忘记了，spring 2.X +spring security 2.X才能集成功，spring 3.X +spring security 3.X才能集成成功。现在想想真够二的、哈哈，好了小插曲过后，我们继续。

首先下载spring security 3.1jar，地址：http://www.springsource.org/spring-community-download。我这里有曾今下载的，就不用了、jar结构如下：

红色的呢，是源码包，我们不用加入，蓝色圈中的是两个例子、你可以部署学习一下。其他的就是我们需要的jar,可以根据包名称发现各个包都是一个spring security 的特性，一般来说我们把jar都加进去，随着项目需要都会用到的。

接下来我们需要新建一个applicationContext-security.xml文件，这个是spring security 配置必须的一个文件。内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<b:beans xmlns="http://www.springframework.org/schema/security"
    xmlns:b="http://www.springframework.org/schema/beans"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://www.springframework.org/schema/beans
                        http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
                        http://www.springframework.org/schema/security
                        http://www.springframework.org/schema/security/spring-security-3.1.xsd">
       <!-- 开启默认的拦截器 -->
     　<http auto-config='true'>
         <!-- 允许访问的uri -->
        <intercept-url pattern="/**" access="ROLE_USER" />
       </http> 

       <!-- 权限管理者 -->
       <authentication-manager>
           <!-- 权限提供者 -->
        <authentication-provider>
          <!-- 可提供登陆访问的用户 -->
          <user-service>
            <user name="haha" password="haha" authorities="ROLE_USER, ROLE_ADMIN" />
            <user name="xixi" password="xixi" authorities="ROLE_USER" />
          </user-service>
        </authentication-provider>
      </authentication-manager> 

</b:beans>

里面大概解释了一下，其中http节点里面默认的开启的几个必须的拦截器，下面的user-service 就是可以登陆访问的用户列表，我们这里没有用数据库所以就这样配置了，如果使用数据库 配置一个dataSource即可，包括后面的authorities都是通过数据库管理用户权限的，这里我们暂时入门不做深入讲解。

然后我们需要一个spring security 的过滤器配置、web.xml完整配置。

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.5"
    xmlns="http://java.sun.com/xml/ns/javaee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
    http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">

    <context-param>
        <param-name>contextConfigLocation</param-name>
        <!-- 应用上下文配置文件 -->
        <param-value>/WEB-INF/spring-servlet.xml,/WEB-INF/applicationContext-security.xml</param-value>
    </context-param> 

    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener> 

    <!-- spring securit start -->
    <filter>
      <filter-name>springSecurityFilterChain</filter-name>
      <filter-class>org.springframework.web.filter.DelegatingFilterProxy</filter-class>
    </filter>
    <filter-mapping>
      <filter-name>springSecurityFilterChain</filter-name>
      <url-pattern>/*</url-pattern>
    </filter-mapping>
    <!-- spring securit start --> 

    <!-- 配置spring核心servlet -->
    <servlet>
        <servlet-name>spring</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <!-- url-pattern配置为/，不带文件后缀，会造成其它静态文件(js，css等)不能访问。如配为*.do，则不影响静态文件的访问 -->
    <servlet-mapping>
        <servlet-name>spring</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping> 

    <welcome-file-list>
    　　<welcome-file>index.jsp</welcome-file>
  　</welcome-file-list>
</web-app>

其中springSecurityFilterChain  过滤器必须放在最前面，因为spring security的安全机制是保护在web最外层的安全框架，所以你的任何访问都要经过spring security 投票机制授权才可以访问的，否则不允许访问。只有登陆用户才可以访问。

contextConfigLocation配置就是扫描我们的spring mvc和spring security配置文件。

具体完整的目录结构如下：

下面我们启动web看看会发生什么神奇的事情。下面我们访问http://localhost:8080/SpringMVC/welcome

奇迹发生了，我们并没有创建登陆页面，那这个登陆页面哪里来的呢？哈哈，不要着急，慢慢来讲，看看url spring_security_login ，还记得我们前面配置的spring security 的配置文件的<http>这个配置默认会开启几个过滤器，其中有一个就是拦截发现我们没登陆然后查找登陆页面，但为什么自动出来呢？其是它为我们默认了一个登陆页面，登陆页面我们可以指定一个，前面我们没指定所以检查发现没有它就默认了一个登陆页面给我们，下面我们登陆看看会发生什么情况。（什么你不知道账号密码？其实就是我们spring security配置的那个账号密码）。

输入账号密码结果：

跳转到了我们刚刚要访问的uri了，中间还会检查我们的账号是否有权，有权才会访问成功，无权则会转到无权访问页面。好了，到这里spring mvc+spring security 集成就完成了，剩下的工作就是一步一步的慢慢学习spring security 来使用更多的完善的功能。简单吧，就这点东西。

到这里我们再试试如果登录一个不存在的账号会发生什么情况、我输入了一个admin、结果出现如下图：

spring security已经帮我们检查了，账号不存在，他会把我们继续重定向到登录页面，知道登录成功，否则你永远都面对的是这个登录页面。

好了今天主要分享的就这点，师傅引进门修行靠个人。不过我想了想，还是再分享一点有用的、有的人会想如果我的登录页面需要自定义怎么办？下面我们就讲讲。

首先自定义登陆，我们需要修改applicationContext-security.xml 配置文件，修改如下：

　　　　<!-- 开启默认的拦截器 -->
     　<http auto-config='true'>
       　　<!-- 允许访问的uri -->
       　　<intercept-url pattern="/**" access="ROLE_USER" />
       　　<!-- 登陆页面配置 -->
        　 <form-login login-page="/login.jsp" default-target-url="/index.jsp" authentication-failure-url="/login.jsp?error=true"/>
       </http> 

       <!-- 权限管理者 -->
       <authentication-manager>
           <!-- 权限提供者 -->
        <authentication-provider>
          <!-- 可提供登陆访问的用户 -->
          <user-service>
            <user name="haha" password="haha" authorities="ROLE_USER, ROLE_ADMIN" />
            <user name="xixi" password="xixi" authorities="ROLE_USER" />
          </user-service>
        </authentication-provider>
      </authentication-manager>

其中就多加 了一个form 配置节点，从命名可以看出login-page就是你的登陆页面，default-target-url是默认的登陆成功后的页面，authentication-failure-url就是当你输入非法账号或者密码自动重定向到login.jsp.

接下来创建我们自定义的登陆页面，我的就是login.jsp，有人到这里会想，form接下来该如何写呢？怎么写才能被拦截呢？如下：

    <h1>user login</h1>
    <form action="j_spring_security_check" method="post">
        用户名<input type="text" name="j_username"/><br/>
        密码<input type="password" name="j_password"/><br/>
        <input type="submit" value="submit"/>
    </form>

action="j_spring_security_check"必须这样写，否则拦截器拦截不到。登陆的字段j_username j_password必须这样写，否则你的登陆拦截器获取不到value。当然你也可以自定义，但前提是你必须继承UsernamePasswordAuthenticationFilter 过滤器去重写一下，这里我们就不麻烦了，而且一般情况下我们不需要重写，就用它提供的即可。好了，到这里我们可以启动服务器了。我们再次访问：http://localhost:8080/SpringMVC/welcome看看会发生神马变化。如图：

咦？这是什么情况？url变了，是我们要访问的登陆地址。可是页面的登陆form呢？不要着急，这种情况我当时见多了，第一反应login.jsp没有被放行，拦截下来了、受保护的资源。前面我们不是讲过spring  security 是保护在web最外层的，访问任何资源需要投票，授权才能访问的，这个也不例外。

好了，知道什么情况了，我们修改吧！修改如下部分片段即可：

　　　　 <!-- 开启默认的拦截器 -->
    　　<http auto-config='true'>
       　　<!--对login.jsp放行，不用保护-->
       　　<intercept-url pattern="/login.jsp" filters="none" />
       　　<!-- 允许访问的uri -->
       　　<intercept-url pattern="/**" access="ROLE_USER" />
       　　<!-- 登陆页面配置 -->
       　　<form-login login-page="/login.jsp" default-target-url="/index.jsp" authentication-failure-url="/login.jsp?error=true"/>
       </http> 

然后我们启动服务器再次访问http://localhost:8080/SpringMVC/welcome

不幸的事情又发生了，控制台报错，服务器启动失败!如下图：

其实大概的意思是讲下面的这个配置作废了。

<!--对login.jsp放行，不用保护-->
<intercept-url pattern="/login.jsp" filters="none" />这个配置是spring security 2.X中的，3.X以后作废了，使用新的方式了。不过错误告诉我们怎么使用新的标签了，就是新建一个节点标签，属性security="none" 来放行，好了，我们修改一下。修改部分配置如下：

     　　<!-- spring securit 3.X新的资源放行配置方式，不受保护的资源 -->
     　　<http pattern="/login.jsp" security="none"/>              

    　　 <!-- 开启默认的拦截器 -->
     　　<http auto-config='true'>
        　　<!-- 允许访问的uri -->
        　　<intercept-url pattern="/**" access="ROLE_USER" />
        　　<!-- 登陆页面配置 -->
        　　<form-login login-page="/login.jsp" default-target-url="/index.jsp" authentication-failure-url="/login.jsp?error=true"/>
        </http>

在http节点上面再加一个节点，然后配置不需要拦截的。pattern属性的意思就是通过正则表达式来匹配的。security="none"就是不安全的，意思就是不受spring security保护的资源，这里还要提一点，就是.jpg、.gif、.swf、.css、.js/等等资源文件都会被拦截下来，即使他是包含在一个已经放行的jsp页面或者uri的request、怎么理解？就是比如：我们的login.jsp放行了，但是我们没有放行.jpg这样的图片资源，当我们访问login.jsp的时候图片是不显示的，因为它没有被放行，从这里可以看出spring security是非常严格的检查机制。假如我们要放行那些怎么办？

spring security 2.X中配置如下：

　　<http auto-config='true'>
      <!-- public 资源文件 –>
      <intercept-url pattern="/**/*.jpg" filters="none" />
      <intercept-url pattern="/**/*.png" filters="none" />
      <intercept-url pattern="/**/*.gif" filters="none" />
      <intercept-url pattern="/**/*.ico" filters="none" />
      <intercept-url pattern="/**/*.css" filters="none" />
      <intercept-url pattern="/**/*.js" filters="none" />

       <!-- 允许访问的uri -->
       <intercept-url pattern="/**" access="ROLE_USER" />
       <!-- 登陆页面配置 -->
       <form-login login-page="/login.jsp" default-target-url="/index.jsp" authentication-failure-url="/login.jsp?error=true"/>
     </http>

当然我们这里讲spring security 3.X，所以3.X的如下：

<http pattern="/**/*.jpg" security="none"/>
<http pattern="/**/*.png" security="none"/>
<http pattern="/**/*.gif" security="none"/>
<http pattern="/**/*.ico" security="none"/>
<http pattern="/**/*.css" security="none"/>
<http pattern="/**/*.js" security="none"/>
<!-- spring securit 3.X新的资源放行配置方式，不受保护的资源 -->
<http pattern="/login.jsp" security="none"/>             

　　<http auto-config='true'> 

     <!-- 允许访问的uri -->
     <intercept-url pattern="/**" access="ROLE_USER" />
     <!-- 登陆页面配置 -->
     <form-login login-page="/login.jsp" default-target-url="/index.jsp" authentication-failure-url="/login.jsp?error=true"/>
   </http>

上面的pattern="/**/*.jpg" 配置意思就是放行，项目中所有的.jpg资源，以后的以此类推的原理。你亦可以放行某一个文件下的，具体就是正则表达式的配置。

好了，我们还是回到刚刚修改的放行资源试试，再次启动服务器访问：http://localhost:8080/SpringMVC/welcome

当我们再次访问的时候login.jsp已经出来了、这个时候我们登陆，成功后直接跳转到/welcome 的响应页面。结果如图;

这里我们没有配置用户资源访问权限，所以访问的资源直接可以访问，如果配置了访问权限登陆成功后，spring security还会检查是否有权访问，无权重定向。

好了到这里，今天分享的入门到此完毕。这个框架还是很值得学习的，功能比较强大，官方文档比较全面，可以好好研读一下，感谢抽宝贵的时间阅读。