Spring MVC 开发快速入门

作者:网络 来源:佚名 更新时间:2008-07-07 11:23:47 点击:

  这篇文章将教你快速地上手使用 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-namecontextconfiglocation</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-classorg.springframework.web.context.contextloaderlistener</listener-class>
18 </listener>
19
20 filter
21 filter-nameencodingfilter</filter-name>
22 filter-classorg.springframework.web.filter.characterencodingfilter</filter-class>
23 init-param
24 param-nameencoding</param-name>
25 param-valueutf-8</param-value>
26 </init-param>
27 </filter>
28
29 filter-mapping
30 filter-nameencodingfilter</filter-name>
31 url-pattern*.do</url-pattern>
32 </filter-mapping>
33
34 servlet
35 servlet-nameideawu</servlet-name>
36 servlet-classorg.springframework.web.servlet.dispatcherservlet</servlet-class>
37 load-on-startup1</load-on-startup>
38 </servlet>
39
40 servlet-mapping
41 servlet-nameideawu</servlet-name>
42 url-pattern*.do</url-pattern>
43 </servlet-mapping>
44
45 welcome-file-list
46 welcome-fileindex.jsp</welcome-file>
47 welcome-fileindex.html</welcome-file>
48 </welcome-file-list>
49
50 jsp-config
51 taglib
52 taglib-urihttp://java.sun.com/jsp/jstl/core</taglib-uri>
53 taglib-location/web-inf/tld/c.tld</taglib-location>
54 </taglib>
55 taglib
56 taglib-urihttp://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 titlehello 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 就可以访问了。