• 2006-08-26

    Spring MVC 入门

    Views: 26442 | 21 Comments

    这篇文章将教你快速地上手使用 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, 但是那是一种非常糟糕的作法, 特别是你整合 ApacheTomcat 的时候.

    • 配置 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 就可以访问了.

    Posted by ideawu at 2006-08-26 10:17:43
  • 2006-07-31

    我不喜欢struts-html Tag Lib 的原因

    Views: 16934 | 1 Comment

    我不喜欢 struts-html Tag Lib,因为它违反了一个基本原则----taglib不要生产html标签。在java代码中生产html是一种非常糟糕的作法(不过,有部分人不这样认为),它把程序员和美工溶为一体。

    我们来看看struts是如何用拙劣的方法生成html链接的,假设taglib引用前缀为html:

    <html:link page="stupid.html">
            <bean:message key="some.text" />
    </html:link>

    这是什么代码?如果你只使用简单的html(再加上el)就像下面:

    <a href="stupid.html">${some.text}</a>

    当然,这是两种不同的理念。struts-html tag lib 试图以MS Visual Studio编写应用程序类似的方式编写web application,于是就采用了MS Visual Studio的一些方法(在我看来是陋习)。

    正如前面说的,在java代码中生成html把程序员和美工溶为一体。当你尝试把两者分开时,美工必须从java代码中查找html的id,class属性,以及生成了什么标签。这对美工是一场恶梦!

    我也看到有些标签库把生成分页码(就是previouse 1 2 3 ... next 类似功能)的功能完全包装在java代码中。然后这样使用:

    <page:pagenum page="1" link="browse.jsp" pageSize="8" />(注:当然还有更多的属性可能达10个之多)

    这是什么鬼东西?!美工如何知道你生成了什么?难道你招来一个美工,你还要求他掌握你自己发明的语言(你别因此得意),然后他到了另一家又得学习另一个自以为是的人发明的语言吗?

    因为把程序员和美工溶为一体并不是完全无用的,所以有一部分人会反对我的说法,有一部分人会同意我的说法。

    Posted by ideawu at 2006-07-31 09:37:00
  • 2006-07-16

    Tomcat网站server.xml设置

    Views: 21944 | No Comments

    Tomcat 5 的最小的server.xml配置文件大概如下:

    01 <Server port="8005" shutdown="SHUTDOWN">
    02	<Service name="Catalina">
    03		<Connector port="8080" />
    04		<Engine name="Catalina" defaultHost="localhost">
    05			<Host name="localhost" appBase="/home/ideawu/webapps">
    06				<Context path="/bbs" docBase="bbs_file" />
    07			</Host>
    08		</Engine>
    09	</Service>
    10 </Server>
    

    第3行设置的Tomcat的监听端口。如果你要访问自己机器上的网站,在浏览器里输入http://localhost:8080。

    Host是虚拟主机,一般是一个网站。Context表示一个Web Application(Web应用程序),如一个网站的留言板,论坛可以分别是一个Web应用程序。

    appBase="/home/ideawu/webapps"表示你的网站的程序放在 /home/ideawu/webapps 目录下,你也可以使用相对Tomcat安装路径的路径,不过一般不这么做。

    path="/bbs" docBase="bbs_file"表示一个目录为bbs_file的Web应用程序,程序的文件放在 /home/ideawu/webapps/bbs_file 目录下,你可以通过 http://localhost:8080/bbs 或者 http://localhost:8080/bbs_file 访问。也就是说,path是docBase的一个映射。

    你的网站的首页默认应该放在 /home/ideawu/webapps/ROOT 目录下,可以设置Context的path为空串来更改。

    Posted by ideawu at 2006-07-16 18:29:26
  • 2006-06-23

    如何使用ServletContextListener

    Views: 17455 | No Comments

    这个J2EE小提示阐述了ServletContextListener的用法。这个事件类作为Web应用程序的一部分,处理Web应用程序的servlet上下文(context)的变化的通知。这可以解释为,好像有个人在服务器旁不断地通知我们服务器在发生什么事件。那当然需要监听者了。因此,在通知上下文(context)初始化和销毁的时候,ServletContextListner非常有用。

    import javax.servlet.ServletContextListener;
    import javax.servlet.ServletContextEvent;
    import javax.servlet.*;
    
    public	class MyListener implements ServletContextListener {
    
    	private ServletContext context = null;
    
    	/* 这个方法在Web应用服务被移除,没有能力再接受请求的时候被调用。
    	 */
    	public void contextDestroyed(ServletContextEvent event){
    		//Output a simple message to the server's console
    		System.out.println("The Simple Web App. Has Been Removed");
    		this.context = null;
    
    	}
    
    	// 这个方法在Web应用服务做好接受请求的时候被调用。
    	public void contextInitialized(ServletContextEvent event){
    		this.context = event.getServletContext();
    
    		//Output a simple message to the server's console
    		System.out.println("The Simple Web App. Is Ready");
    
    	}
    }
    
    <web-app>
    	<listener>
    		<listener-class>
    			com.listeners.MyContextListener
    		</listener-class>
    	</listener>
    	<servlet/>
    	<servlet-mapping/>
    </web-app> 
    

    原文在:http://www.java-tips.org/java-ee-tips/java-servlet/how-to-work-with-servletcontextlistener.html
    题目为:How to work with ServletContextListener

    Posted by ideawu at 2006-06-23 18:20:15
  • 2006-06-23

    在JSP中使用缓存

    Views: 14303 | No Comments

    “掌握了缓存机制,标志程序员进入中高级阶段。”---banq

    首先创建一个缓存类,具体依赖你的程序。然后在JSP中把这个缓存类声明为scope="application"的Bean,它只创建一次,存在于application对象中,事实在它是ServletContext对象,对应用中的所有JSP文件都可见。

    缓存类的实现可以参考Jive论坛(也就是Yazd)中的util包,下面是一个假想的博客文章缓存实现的大概思路,并不是可运行代码。

    public class Cache{
    
    	// Article 是文章类,String是它的id,通过id来查找文章
    	// java.util.HashMap, 你可以用其它合适的素数来替代103
    	protected HashMap<String, Article> cachedObjectsHash =
    		new HashMap<String, Article>(103);
    
    	// 根据访问计数来维护的链表,保存了Article的id。最先移除的Article是表尾的对象
    	protected LinkedList<String> accessedList = new LinkedList<String>();
    
    	// HashMap的最大体积(文章数)
    	protected int maxSize =  1024;
    
    	// 把Article的id加入到倒数第2位,也可以加入到表头
    	public void add(Object key, Article article){
    		if(!cachedObjectsHash.contains(article)){
    			cachedObjectsHash.add(article.getId()+"", article);
    			if(cachedObjectsHash.size() > maxSize){
    				cachedObjectsHash.remove(accessedList.getLast());
    				accessedList.removeLast();
    			}
    			accessedList.addFirst(article.getId()+"");
    		}
    	}
    
    	public Article get(Object key){
    		// 如果在链表中找到,位置前移
    		// 返回
    		// 否则查找数据库,并cacheObjectsHash.add()
    	}
    }
    

    相关资源:

    Posted by ideawu at 14:11:49
  • 2006-05-19

    jsp+mysql数据库留言本ideabook

    Views: 14308 | No Comments

    我写的ideabook留言本是一款简单的JSP+MYSQL数据库留言本。我希望它成为初学者学习JSP+MYSQL的最好代码。它也可以作为实际应用的留言本使用。

    • 结构清晰,功能分配经过精心设计。所以代码非常简单。
    • 基于XHTML+DIV的页面代码设计。生成的页面通过XHTML 1.0验证。
    • 在保持数据库内容不变的情况下,分页显示的内容不变,有利于搜索引擎的收录。
    • 反垃圾留言功能。
    • 体积小巧。

    程序已经在 ideabook首页 http://www.ideawu.net/person/ideabook/ 进行测试。 提供源代码下载。

    Posted by ideawu at 2006-05-19 10:59:59
|<<<123>>>| 2/3 Pages, 16 Results.