idea's blog

今天想到ati的网站看看Linux的显卡驱动, 没想到变成了ati.amd.com--忘了, amd上个月把ati收购了. 最大的改进是, Linux的驱动可以下载了(因为我是教育网用户, 连接国外网站并不总是正常)! 而且速度在300K/s(用Prozilla)! 不过, 下载的网站并不是ati.com, 也不是amd.com, 而是另外一个网站. 不错, 能下载就好.

idea's rms(idea's resource management system)是一个在线资源管理系统. 使用GPLv2许可证发布. 所以你可以得到它的源代码. idea's rms 使用java/jsp开发, 基于Spring和Hibernate框架.

idea's rms 的典型应用是:

• 作为资源共享和资源发布的平台, 在互联网上提供文件给别人查看和下载.
• 作为企业内部文件共享的平台.
• 作为学校发布教学课件的平台.

访问 idea's rms 首页

在几乎所有的web应用中都需要对访问者(用户)进行权限管理, 因为我们希望某些页面只对特定的用户开放, 以及某些操作只有符合身份的用户才能进行. 这之中涉及到了身份验证和权限管理. 只有单用户系统和多用户单权限系统才不需要权限管理.

在本文中, 使用了基于组的权限管理, 并在Spring框架下利用HandlerInterceptorAdapter和Hibernate进行实现.

User的结构是:

public class User {

	private int id;

	private String name;

	private String password;

	private Set<String> groups = new HashSet<String>();
}

UserGroup表:

user:int
group:String

使用联合主键, 在Java中没有对应的类.

Hibernate映射文件是:

<hibernate-mapping auto-import="true" default-lazy="false">
	<class name="net.ideawu.User" table="User">
		<cache usage="read-write" />
		<id name="id" column="id">
			<generator class="native"/>
		</id>
		<property name="name" column="name"/>
		<property name="password" column="password"/>
		<set name="groups" table="UserGroup" cascade="save-update" lazy="false">
			<key column="user" />
			<element column="`group`" type="string" />
		</set>
	</class>
</hibernate-mapping>

一切的身份验证交给一个继承HandlerInterceptorAdapter的类来做:

import org.springframework.web.servlet.handler.HandlerInterceptorAdapter;
import org.springframework.web.util.UrlPathHelper;
import org.springframework.util.AntPathMatcher;
import org.springframework.util.PathMatcher;
...

public class AuthorizeInterceptor extends HandlerInterceptorAdapter {

	private UrlPathHelper urlPathHelper = new UrlPathHelper();

	private PathMatcher pathMatcher = new AntPathMatcher();

	private  Properties groupMappings;

	/**
	 * Attach URL paths to group.
	 */
	public void setGroupMappings(Properties groupMappings) {
		this.groupMappings = groupMappings;
	}

	public boolean preHandle(HttpServletRequest request,
			HttpServletResponse response,
			Object handler) throws Exception {
		String url = urlPathHelper.getLookupPathForRequest(request);
		String group = lookupGroup(url);	// 找出资源所需要的权限, 即组名
		if(group == null){	// 所请求的资源不需要保护.
			return true;
		}
		// 如果已经登录, 一个User实例被保存在session中.
		User loginUser = (User)request.getSession().getAttribute("loginUser");
		ModelAndView mav = new ModelAndView("system/authorizeError");
		if(loginUser == null){
			mav.addObject("errorMsg", "你还没有登录!");
			throw new ModelAndViewDefiningException(mav);
		}else{
			if(!loginUser.getGroups().contains(group)){
				mav.addObject("errorMsg", "授权失败! 你不在 <b>" + group + "</b> 组!");
				throw new ModelAndViewDefiningException(mav);
			}
			return true;
		}
	}

	/*
	 * 查看 org.springframework.web.servlet.handler.AbstractUrlHandlerMapping.lookupHandler()
	 * Ant模式的最长子串匹配法.
	 */
	private String lookupGroup(String url){
		String group =  groupMappings.getProperty(url);
		if (group == null) {
			String bestPathMatch = null;
			for (Iterator it = this.groupMappings.keySet().iterator(); it.hasNext();) {
				String registeredPath = (String) it.next();
				if (this.pathMatcher.match(registeredPath, url) &&
							(bestPathMatch == null || bestPathMatch.length() <= registeredPath.length())) {
					group = this.groupMappings.getProperty(registeredPath);
					bestPathMatch = registeredPath;
				}
			}
		}
		return group;
	}
}

下面我们需要在Spring的应用上下文配置文件中设置:

<bean id="authorizeInterceptor" class="net.ideawu.AuthorizeInterceptor">
	<property name="groupMappings">
		<value>
			<!-- Attach URL paths to group -->
			/admin/*=admin
		</value>
	</property>
</bean>

<bean id="simpleUrlHandlerMapping" class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">
	<property name="interceptors">
		<list>
			<ref bean="authorizeInterceptor" />
		</list>
	</property>
	<property name="mappings">
		<value>
			/index.do=indexController
			/browse.do=browseController
			/admin/removeArticle.do=removeArticleController
		</value>
	</property>
</bean>

注意到"/admin/*=admin", 所以/admin目录下的所有资源只有在admin组的用户才能访问, 这样就不用担心普通访客删除文章了. 使用这种方法, 你不需要在removeArticleController中作身份验证和权限管理, 一切都交给AuthorizeInterceptor.

ideabook 采用GPLv2发布, 因为我不愿意自己再写一个许可证, 而且也没有必要. 以前没使用, 是因为我没有时间阅读GPL.

这个版本的 ideabook 相对前一个 jsp + javabean 版本性能提高了. 当然, 结构似乎有点复杂.

一些特性:

1. 基于 Spring 框架.
2. 使用数据库连接池.
3. 使用 jstl, 所以 jsp 代码更加简洁.
4. 增加 access 层, 实现最新留言的缓存, 从而减少数据库连接次数, 提高性能.

访问 ideabook 首页

这篇文章将教你快速地上手使用 Spring 框架. 如果你手上有一本《Spring in Action》, 那么你最好从第三部分"Spring 在 Web 层的应用--建立 Web 层"开始看, 否则那将是一场恶梦!

首先, 我需要在你心里建立起 Spring MVC 的基本概念. 基于 Spring 的 Web 应用程序接收到 http://localhost:8080/hello.do(事实上请求路径是 /hello.do) 的请求后, Spring 将这个请求交给一个名为 helloController 的程序进行处理, helloController 再调用 一个名为 hello.jsp 的 jsp 文件生成 HTML 代码发给用户的浏览器显示. 上面的名称(/hello.do, helloController, hello.jsp) 都是变量, 你可以更改.

在 Spring MVC 中, jsp 文件中尽量不要有 Java 代码, 只有 HTML 代码和"迭代(forEach)"与"判断(if)"两个jstl标签. jsp 文件只作为渲染(或称为视图 View)模板使用.

好了, 我们开始吧. 首先我们需要一个放在 WEB-INF 目录下的 web.xml 文件:

web.xml:

 1 <?xml version="1.0" encoding="UTF-8"?>
 2 
 3 <web-app version="2.4" xmlns="http://java.sun.com/xml/ns/j2ee"
 4          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 5          xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
 6          http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
 7 
 8     <context-param>
 9         <param-name>contextConfigLocation</param-name>
10         <param-value>
11             /WEB-INF/database.xml
12             /WEB-INF/applicationContext.xml
13         </param-value>
14     </context-param>
15 
16     <listener>
17         <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
18     </listener>
19 
20     <filter>
21         <filter-name>encodingFilter</filter-name>
22         <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
23         <init-param>
24             <param-name>encoding</param-name>
25             <param-value>UTF-8</param-value>
26         </init-param>
27     </filter>
28 
29     <filter-mapping>
30         <filter-name>encodingFilter</filter-name>
31         <url-pattern>*.do</url-pattern>
32     </filter-mapping>
33 
34     <servlet>
35         <servlet-name>ideawu</servlet-name>
36         <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
37         <load-on-startup>1</load-on-startup>
38     </servlet>
39 
40     <servlet-mapping>
41         <servlet-name>ideawu</servlet-name>
42         <url-pattern>*.do</url-pattern>
43     </servlet-mapping>
44 
45     <welcome-file-list>
46         <welcome-file>index.jsp</welcome-file>
47         <welcome-file>index.html</welcome-file>
48     </welcome-file-list>
49 
50     <jsp-config>
51         <taglib>
52             <taglib-uri>http://java.sun.com/jsp/jstl/core</taglib-uri>
53             <taglib-location>/WEB-INF/tld/c.tld</taglib-location>
54         </taglib>
55         <taglib>
56             <taglib-uri>http://java.sun.com/jsp/jstl/fmt</taglib-uri>
57             <taglib-location>/WEB-INF/tld/fmt.tld</taglib-location>
58         </taglib>
59     </jsp-config>
60 
61 </web-app> 

它配置了以下功能:

• 配置 DispatcherServlet (servlet 标签), 它是一个 Java Servlet 程序. 我们将它命名为 ideawu. 然后我们再配置 Servlet 映射(servlet-mapping 标签), 也就是你希望哪些请求被DispatcherServlet处理. 这里, 我们设置后缀名为 do(*.do) 的所有URL请求都被名为 ideawu 的 DispatcherServlet 的程序处理. 选择 .do 只是一个习惯,但是你不要选择 .html! 虽然《Spring in Action》选择了 .html, 但是那是一种非常糟糕的作法, 特别是你整合 Apache 和 Tomcat 的时候.

• 配置 CharacterEncodingFilter (filter 标签), 否则你会发现中文乱码. 因为我的 jsp 和 html 文件都是 UTF-8 编码的, 所以我在 param-value 标签中设置了 UTF-8. 估计你使用的是 GB2312 或者 GBK, 立即转到 UTF-8 上来吧.

• 分解配置文件. context-param 标签指明我们的配置文件还有 /WEB-INF/database.xml 和 /WEB-INF/applicationContext.xml. ContextLoaderListener(listener 标签) 由此得知配置文件是哪些, 它会将它们载入.

因为我们将 DispatcherServlet 命名为 ideawu, 所以我们在 WEB-INF 目录下建立一个名为 ideawu-servlet.xml 的文件:

ideawu-servlet.xml:

 1 <?xml version="1.0" encoding="UTF-8" ?>
 2 <!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN" "http://www.springframework.org/dtd/spring-beans.dtd">
 3 
 4 <beans>
 5 
 6     <bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
 7         <property name="prefix" value="/WEB-INF/jsp/" />
 8         <property name="suffix" value=".jsp" />
 9     </bean>
10 
11     <bean id="simpleUrlHandlerMapping" class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">
12         <property name="mappings">
13             <props>
14                 <prop key="/hello.do">helloController</prop>
15             </props>
16         </property>
17     </bean>
18 
19     <bean id="helloController" class="com.ideawu.HelloController">
20         <!--
21         <property name="helloManager" ref="helloManager" />
22         -->
23     </bean>
24 
25 </beans> 

它配置了以下功能:

• 配置 InternalResourceViewResolver, 它是 jsp 渲染模板的处理器. 如果你告诉 InternalResourceViewResolver 处理一个名为 hello 的模板时, 它会渲染 /WEB-INF/jsp/hello.jsp 文件. 把 jsp 文件放到 /WEB-INF/jsp/ 目录下是被鼓励的, 这样可以防止用户不经过 Controller 直接访问 jsp 文件从而出错(有些顽皮的人很喜欢这样做).

• 配置 SimpleUrlHandlerMapping, 在上面的配置文件中, /hello.do 的请求将被 helloController 处理. "/hello.do"和"helloController" 是变量, 你可以更改. 但是你注意到了吗, hello.do 以 .do 作为后缀名. 如果这里(本文的条件下)你 不使用.do 作为后缀名, 就没有程序来处理这个请求了. 因为 DispatcherServlet 将收到的请求转交给 SimpleUrlHandlerMapping, DispatcherServlet 收不到的请求, SimpleUrlHandlerMapping 当然也收不到了. 你可以在 props 标签内配置多个 prop 标签.

• 我们将在后面编写 com.ideawu.HelloController 类.

上面, 我们在 web.xml 文件中告诉 ContextLoaderListener, 我们还有另外两个配置文件 /WEB-INF/database.xml 和 /WEB-INF/applicationContext.xml.

applicationContext.xml:

 1 <?xml version="1.0" encoding="UTF-8"?>
 2 <!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN" "http://www.springframework.org/dtd/spring-beans.dtd">
 3 
 4 <beans>
 5 
 6     <bean id="propertyConfigurer" class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer">
 7         <property name="locations">
 8             <list>
 9                 <value>/WEB-INF/jdbc.properties</value>
10             </list>
11         </property>
12     </bean>
13 
14 </beans> 

它配置了以下功能:

• 读取 /WEB-INF/jdbc.properties 文件. 你可以在 list 标签中配置多个 value 标签.

database.xml:

 1 <?xml version="1.0" encoding="UTF-8"?>
 2 <!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN" "http://www.springframework.org/dtd/spring-beans.dtd">
 3 
 4 <beans>
 5 
 6     <!-- Remove this if your database setting is fine.
 7     <bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource" destroy-method="close">
 8         <property name="driverClassName" value="${jdbc.driverClassName}"/>
 9         <property name="url" value="${jdbc.url}"/>
10         <property name="username" value="${jdbc.username}"/>
11         <property name="password" value="${jdbc.password}"/>
12     </bean>
13     -->
14 
15     <!-- Transaction manager for a single JDBC DataSource
16     <bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
17         <property name="dataSource" ref="dataSource"/>
18     </bean>
19     -->
20 
21     <!--
22     <bean id="attributeManager" class="com.ideawu.core.AttributeManager">
23         <property name="dataSource" ref="dataSource"/>
24     </bean>
25     -->
26 
27 </beans> 

它配置了以下功能(不过,已经注释掉了):

• 配置数据库连接. 类似${jbbc.url}是一种访问变量的方法. 我们可以从 /WEB-INF/jdbc.properties 中找到这个变量的值. 如果你的数据库已经配置好, 就将第一个注释去掉.

jdbc.properties:

1 jdbc.driverClassName=com.mysql.jdbc.Driver
2 jdbc.url=jdbc:mysql://localhost/test?useUnicode=true&characterEncoding=UTF-8
3 jdbc.username=test
4 jdbc.password=12345 

现在, 我们来编写 Java 代码吧.

 1 /***********************************************************
 2 * Date: 2006-8-26
 3 * File: HelloController.java
 4 * Author: ideawu
 5 ***********************************************************/
 6 
 7 package com.ideawu;
 8 
 9 import org.springframework.web.servlet.mvc.Controller;
10 import org.springframework.web.servlet.ModelAndView;
11 
12 import javax.servlet.http.HttpServletRequest;
13 import javax.servlet.http.HttpServletResponse;
14 
15 /**
16  * @author ideawu
17  *
18  */
19 public class HelloController implements Controller {
20 /*  
21     private HelloManager helloManager;
22 
23     public void setHelloManager(HelloManager helloManager) {
24         this.helloManager = helloManager;
25     }
26 */
27 
28     public ModelAndView handleRequest(HttpServletRequest request,
29             HttpServletResponse response)throws Exception{
30 
31         request.setAttribute("hello_1", "你好啊, Spring!");
32         request.setAttribute("hello_2", "Hello World!");
33 
34         return new ModelAndView("hello");
35     }
36 
37 }

return new ModelAndView("hello"); 告诉 InternalResourceViewResolver jsp 模板的名字叫作 hello. request.setAttribute() 设置的对象我们可以在 jsp 文件中使用.

hello.jsp:

 1 <%@ page contentType="text/html; charset=UTF-8" %>
 2 <%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
 3 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 4 <html xmlns="http://www.w3.org/1999/xhtml">
 5 <head>
 6     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
 7     <title>Hello World!</title>
 8 </head>
 9 <body>
10 
11 <h2>${hello_1}</h2>
12 
13 <h2>${hello_2}</h2>
14 
15 </body>
16 </html> 

你可以下载整个 Web 应用程序. 在 Debian Linux, Tomcat 5.5.16, JDK1.5.0 下运行良好. 解压后得到一个 spring 文件夹, 放到你的 webapps 目录下, 在浏览器中输入 http://localhost:8080/spring/hello.do 就可以访问了.