Maven搭建Spring Security3.2项目详解

时间：2015-02-12 20:13:00 阅读：440 评论：0 收藏：0 [点我收藏+]

前言

本来是打算在上一篇SpringMVC+Hibernate上写的，结果发现上面那篇一起整合的，结果发现上一篇内容实在是太长了，就另起一篇，这篇主要是采用 Maven搭建Spring+SpringMVC+Hibernate+Security整合，而Spring+SpringMVC+Hibernate已经在上一篇介绍了，在这篇将不再重复写了，主要说明一下SpringSecurity3.2权限控制整合搭建，以及配置，使用注意事项等。

SpringSecurity的Api文档地址：查看

1、Maven映入SpringSecurity依赖包

在pom.xml中引入我们需要引入spring-security-core，spring-security-config，spring-security-taglibs三个包，如下

               <!-- spring-security -->
		<dependency>
			<groupId>org.springframework.security</groupId>
			<artifactId>spring-security-core</artifactId>
			<version>${security.version}</version>
		</dependency>

		<dependency>
			<groupId>org.springframework.security</groupId>
			<artifactId>spring-security-config</artifactId>
			<version>${security.version}</version>
		</dependency>

		<dependency>
			<groupId>org.springframework.security</groupId>
			<artifactId>spring-security-taglibs</artifactId>
			<version>${security.version}</version>
		</dependency>

2、配置security的配置文件

我们新建一个配置文件（起名随意），我这儿就叫spring-security.xml，我现在定义了几个权限，权限信息表内容如下：

技术分享

其中：管理用户和全部用户的权限将通过jsp中security标签配置，其他的通过spring-security.xml文件配置。

先贴出spring-security.xml的文件，详细配置含义我将做一个简单的说明：

<span style="font-size:14px;"><?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
	xmlns:security="http://www.springframework.org/schema/security"
	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-4.1.xsd
                        http://www.springframework.org/schema/security 
                        http://www.springframework.org/schema/security/spring-security-3.2.xsd"
	default-lazy-init="true">

	<description>spring-security配置</description>

	<!-- 静态资源 -->
	<security:http pattern="/css/**" security="none" />
	<security:http pattern="/js/**" security="none" />
	<security:http pattern="/images/**" security="none" />

	<security:http>
		<security:intercept-url pattern="/user/save*"
			access="ROLE_添加用户" requires-channel="any" />
		<security:intercept-url pattern="/user/delete*"
			access="ROLE_删除用户" requires-channel="any" />
		<security:intercept-url pattern="/user/user*"
			access="ROLE_浏览用户" requires-channel="any" />
		<security:intercept-url pattern="/user/update*"
			access="ROLE_修改用户" requires-channel="any" />

		<security:session-management>
			<security:concurrency-control
				expired-url="/login/login.htmls?repeat=true" max-sessions="1"
				error-if-maximum-exceeded="true" />
		</security:session-management>

		<security:form-login login-page="/login/login.htmls"
			authentication-failure-url="/login/login.htmls?error=true"
			default-target-url="/user/main.htmls" always-use-default-target='true'
			username-parameter="nickName" password-parameter="nickPassword" />

		<security:logout invalidate-session="true"
			logout-success-url="/login/login.htmls?logout=true" />

	</security:http>

	<!-- 认证配置 自定义认证实现UserDetailsService接口 -->
	<security:authentication-manager>
		<security:authentication-provider
			user-service-ref="userDetailsService">
			<!-- 配置密码加密方式 -->
			<security:password-encoder hash="md5" />
		</security:authentication-provider>
	</security:authentication-manager>

	<bean id="userDetailsService" class="org.andy.work.service.impl.UserDetailsServiceImpl" />
	
</beans></span>

其中：我们配置了静态文件管理，session对话管理，登录管理，注销配置，权限配置，自定义数据表权限认证配置。

2.1、静态文件管理

我们对于css，image，js这些不用权限拦截。

2.2、session对话管理

session管理max-sessions="1"配置了最多有一个用户登录，（在wab.xml还要添加如下：）

<span style="font-size:14px;"><!-- spring-security 管理session配置 -->
	<listener>
		<listener-class>
			org.springframework.security.web.session.HttpSessionEventPublisher</listener-class>
	</listener></span>

error-if-maximum-exceeded="true" 值为true时，若果有一个用户登录，第二个用户无法登陆，

值为false时，若果有一个用户已经登录，下一个用户登录将踢掉上一个用户。

自然在session-manager中我们可以配置session失效时，跳转的url如，invalid-session-url="/invalidSession.jsp"，如果session失效时，刷新将跳转到invalidSession.jsp页面。

2.3、登录管理

通过security:form-login配置登录，login-page为登录跳转的url，authentication-failure-url为登录失败时的url（次url可以不存在），

username-parameter和password-parameter为登录表单是用户名和密码，如果不写默认为j_password和j_username

2.4、注销管理

通过security:logout标签配置注销，invalidate-session：注销时session是否失效。logout-success-url：注销成功后跳转的地址。

logout-url：为注销的url，如果不填写，则默认为j_spring_security_logout

2.5、权限配置

security:intercept-url为要拦截权限认证的的url，pattern为拦截的正则匹配url，access：所需的权限，可以是一个权限组，用逗号隔开，requires-channel：拦截http还是https的，如果两个都拦截用any。

2.6、配置自定义的权限认证机制

通过我们数据库的权限表信息，我们自定义权限认证机制，需要我们实现UserDetailsService接口，配置用户密码的加密方式。

security:password-encoder：配置密码加密规则。

3、web.xml容器配置

<span style="font-size:14px;">         <context-param>
		<param-name>contextConfigLocation</param-name>
		<param-value>
			classpath:spring.xml
		    classpath:spring-hibernate.xml
			classpath:spring-security.xml
		</param-value>
	</context-param>

       <!-- Spring-Security filter 最好配置在控制层filter的前面 -->
	<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-security 管理session配置 -->
	<listener>
		<listener-class>
			org.springframework.security.web.session.HttpSessionEventPublisher</listener-class>
	</listener></span>

配置了加载的spring-security文件，security拦截的filter，以及security的session监听。

4、自定义认证，实现UserDetailsService接口

UserDetailsServiceImpl如下：

<span style="font-size:14px;">package org.andy.work.service.impl;

import java.util.HashSet;
import java.util.Set;

import org.andy.work.dao.UserDao;
import org.andy.work.entity.AcctAuthority;
import org.andy.work.entity.AcctRole;
import org.andy.work.entity.AcctUser;
import org.apache.log4j.Logger;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.security.core.GrantedAuthority;
import org.springframework.security.core.authority.SimpleGrantedAuthority;
import org.springframework.security.core.userdetails.User;
import org.springframework.security.core.userdetails.UserDetails;
import org.springframework.security.core.userdetails.UserDetailsService;
import org.springframework.security.core.userdetails.UsernameNotFoundException;

/**
 * 创建时间：2015-2-9 下午5:24:44
 * 
 * @author andy
 * @version 2.2
 *          <p>
 *          描述： 实现SpringSecurity的UserDetails接口 自定义认证
 */

public class UserDetailsServiceImpl implements UserDetailsService {

	private static final Logger LOGGER = Logger
			.getLogger(UserDetailsServiceImpl.class);

	// 注入查询User的dao层
	@Autowired
	private UserDao userDao;

	@Override
	public UserDetails loadUserByUsername(String username)
			throws UsernameNotFoundException {
		LOGGER.info("认证用户：" + username);

		// 查询数据库获取改用户的信息
		AcctUser acctUser = userDao.findByNickName(username);

		if (null == acctUser) {
			throw new UsernameNotFoundException("用户：" + username + "不存在");
		}

		Set<GrantedAuthority> authorities = getAuthorities(acctUser);

		// 将没有使用到的属性设置为true
		UserDetails userDetails = new User(acctUser.getNickName(),
				acctUser.getNickPassword(), true, true, true, true, authorities);

		return userDetails;
	}

	// 获得用户所有角色的权限
	private Set<GrantedAuthority> getAuthorities(AcctUser acctUser) {
		Set<GrantedAuthority> authoritySet = new HashSet<GrantedAuthority>();

		// 默认所有的用户有"浏览用户"的权利
		authoritySet.add(new SimpleGrantedAuthority("ROLE_浏览用户"));

		// 依次添加
		if (null != acctUser.getAcctRoles()
				&& acctUser.getAcctRoles().size() > 0)
			for (AcctRole role : acctUser.getAcctRoles()) {
				if (null != role.getAcctAuthorities()
						&& role.getAcctAuthorities().size() > 0)
					for (AcctAuthority authority : role.getAcctAuthorities()) {
						authoritySet.add(new SimpleGrantedAuthority(authority
								.getPrefixedName()));
					}
			}

		return authoritySet;
	}

}
</span>

涉及到的AcctUser，AcctRole，AcctAuthority类我就不贴了，不然一大把，我会提供源码。

5、Security的认证错误提示

我们可以通过sessionScope.SPRING_SECURITY_LAST_EXCEPTION.message获取认证错误。

6、Security获取session中的用户名和用户信息

security将用户信息存放在session中，可以通过以下两种获得：

6.1、后台获取

<span style="font-size:14px;">		//获取security的上下文
		SecurityContext securityContext = SecurityContextHolder.getContext();
		//获取认证对象
		Authentication authentication = securityContext.getAuthentication();
		//在认证对象中获取主体对象
		Object principal = authentication.getPrincipal();
		
		String username = "";
		if(principal instanceof UserDetails){
			username = ((UserDetails) principal).getUsername();
		}else {
			username = principal.toString();
		}</span>

6.1、前台获取

先引入security的标签库：

<span style="font-size:14px;"><%@taglib prefix="security" uri="http://www.springframework.org/security/tags"%></span>

在查看：

<span style="font-size:14px;"><security:authentication property="name"/></span>

7、前台标签授权

通过security:authorize标签设置权限，其有三种属性分别如下：

ifAnyGranted:：只有当前用户拥有所指定的权限中的一个的时候，就能显示标签内部的内容（相当于“或”的关系）

ifAllGranted：只有当前用户拥有所指定的权限时，才显示标签的内容（相当于“与”的关系）

ifNotGranted：没有指定的权限的时候，显示标签内容（相当于“非”的关系）

自然也可以通过method限制是那种http的请求（http的请求有8种：- GET - DELETE - HEAD - OPTIONS - POST - PUT - PATCH - TRACE）。

8、后台Controller

LoginController

<span style="font-size:14px;"><span style="font-size:14px;">package org.andy.work.controller;

import org.andy.work.entity.AcctUser;
import org.apache.log4j.Logger;
import org.springframework.stereotype.Controller;
import org.springframework.validation.Errors;
import org.springframework.web.bind.annotation.ModelAttribute;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;

/**
 * 创建时间：2015-2-10 下午9:23:34
 * 
 * @author andy
 * @version 2.2 描述：
 */
@Controller
@RequestMapping("/login")
public class LoginController {

	private static final Logger LOGGER = Logger
			.getLogger(LoginController.class);

	@RequestMapping("/login")
	public String login(@ModelAttribute AcctUser acctUser,
			@RequestParam(required = false) Boolean logout,
			Errors errors
			) {
		LOGGER.info("login");
		
		if(null != logout){
			errors.reject("msg", "已经安全退出");
		}
		
		return "/login/login";
	}


}</span>
</span>

UserController类

<span style="font-size:14px;">package org.andy.work.controller;

import java.util.List;

import org.andy.work.entity.AcctUser;
import org.andy.work.service.UserService;
import org.apache.log4j.Logger;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.security.core.Authentication;
import org.springframework.security.core.context.SecurityContext;
import org.springframework.security.core.context.SecurityContextHolder;
import org.springframework.security.core.userdetails.UserDetails;
import org.springframework.stereotype.Controller;
import org.springframework.ui.ModelMap;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;

/**  
 * 创建时间：2015-2-7 上午11:49:00  
 * @author andy  
 * @version 2.2  
 * 描述： 用户Controller
 */
@Controller
@RequestMapping("/user")
public class UserController {

	private static final Logger LOGGER = Logger.getLogger(UserController.class);
	
	@Autowired
	private UserService userService;
	
	@RequestMapping("/showInfo/{userId}")
	public String showUserInfo(ModelMap modelMap, @PathVariable String userId){
		LOGGER.info("查询用户：" + userId);
		AcctUser userInfo = userService.load(userId);
		modelMap.addAttribute("userInfo", userInfo);
		return "/user/showInfo";
	}
	
	@RequestMapping("/showInfos")
	public @ResponseBody List<AcctUser> showUserInfos(){
		LOGGER.info("查询用户全部用户");
		List<AcctUser> userInfos = userService.findAll();
		return userInfos;
	}
	
	
	@RequestMapping("/main")
	public String main(ModelMap modelMap){
		LOGGER.info("显示主页面");
		//后台获取security保存的session中的用户信息
		
		//获取security的上下文
		SecurityContext securityContext = SecurityContextHolder.getContext();
		//获取认证对象
		Authentication authentication = securityContext.getAuthentication();
		//在认证对象中获取主体对象
		Object principal = authentication.getPrincipal();
		
		String username = "";
		if(principal instanceof UserDetails){
			username = ((UserDetails) principal).getUsername();
		}else {
			username = principal.toString();
		}
		modelMap.addAttribute("username", username);
		return "/user/main";
	}
	
	
	@RequestMapping("/manage")
	public String manage(ModelMap modelMap){
		LOGGER.info("显示主页面");
		modelMap.addAttribute("msg", "manage");
		return "/user/option";
	}
	
	@RequestMapping("/save")
	public String save(ModelMap modelMap){
		LOGGER.info("保存");
		modelMap.addAttribute("msg", "save");
		return "/user/option";
	}
	
	@RequestMapping("/update")
	public String update(ModelMap modelMap){
		LOGGER.info("修改");
		modelMap.addAttribute("msg", "update");
		return "/user/option";
	}
	
	@RequestMapping("/delete")
	public String delete(ModelMap modelMap){
		LOGGER.info("删除");
		modelMap.addAttribute("msg", "delete");
		return "/user/option";
	}
	
}
</span>

9、前台

<span style="font-size:14px;"><%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<%@taglib prefix="form" uri="http://www.springframework.org/tags/form"%>
<%@taglib prefix="spring" uri="http://www.springframework.org/tags"%>
<%@taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core"%>
<%@taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt"%>

<%
	String path = request.getContextPath();
	String basePath = request.getScheme() + "://"
			+ request.getServerName() + ":" + request.getServerPort()
			+ path + "/";
%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<base href="<%=basePath%>" />
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>login</title>
</head>
<body>
	<div>${sessionScope.SPRING_SECURITY_LAST_EXCEPTION.message}</div>

	<form:form action="j_spring_security_check" modelAttribute="acctUser" method="post">
		<form:errors path="*" cssStyle="color:red;" />
		<br />
		用户：<form:input path="nickName" />
		<br />
		密码：<form:password path="nickPassword" />
		<br />
		<form:button>登录</form:button>
	</form:form>
</body>
</html></span>

main.jsp

<span style="font-size:14px;"><%@page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<%@taglib prefix="form" uri="http://www.springframework.org/tags/form"%>
<%@taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core"%>
<%@taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %>
<%@taglib prefix="security" uri="http://www.springframework.org/security/tags"%>

<%
	String path = request.getContextPath();
	String basePath = request.getScheme() + "://"
			+ request.getServerName() + ":" + request.getServerPort()
			+ path + "/";
%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<base href="<%=basePath%>" />
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>login</title>
</head>
<body>

    welcome! <security:authentication property="name"/>
    <br/>
    	  后台获取用户名：${username }
	<div style="border: 1px; "><a target="_blank" href="j_spring_security_logout">注销</a></div>
	
	<br/>
	
	<security:authorize ifAnyGranted="ROLE_浏览用户">
	<div>
		<a target="_blank" href="user/showInfo.htmls">全部用户</a>
	</div>
	</security:authorize>
	
	
	<security:authorize ifAllGranted="ROLE_管理用户">
		<div>
			<a target="_blank" href="user/manage.htmls">管理用户</a>
		</div>
	</security:authorize>
	
	<div>
		<a target="_blank" href="user/save.htmls">添加用户</a>
	</div>
	<div>
		<a target="_blank" href="user/update.htmls">修改部用户</a>
	</div>
	<div>
		<a target="_blank" href="user/delete.htmls">删除用户</a>
	</div>
	
</body>
</html></span>

10、测试

现在andy用户拥有“浏览用户”和“添加用户”权限

用户密码错误时：

技术分享

正确密码登陆后：

技术分享

点击添加用户，正确跳转。如下：

技术分享

点击全部用户，无权限提示。

技术分享

11、Spring security自定义认证错误提示

首先，拷贝spring-security-core写的messages_zh_CN.properties国际化文件，放到项目的src/main/resources目录中

修改对应的提示，按照我们自己的需求，我命名为messages.properties

其次，我们需在spring的配置文件中添加如下内容：

<span style="font-size:14px;"><span style="font-size:14px;">	<!-- 定义上下文返回的消息的国际化 -->
	<bean id="messageSource"
		class="org.springframework.context.support.ReloadableResourceBundleMessageSource">
		<property name="basename" value="classpath:messages" />
	</bean>

	<bean id="localeResolver"
		class="org.springframework.web.servlet.i18n.AcceptHeaderLocaleResolver" /></span></span>

ok，Maven搭建Spring+Hibernate+security整合完毕。