2025-02-10

這篇文章將教你快速地上手使用 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 文件:
Java代碼 
<?xml version="1.0" encoding="UTF-8"?> 
 
<web-app version="2.4" xmlns="http://java.sun.com/xml/ns/j2ee" 
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
         xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee 
         http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"> 
  
     <context-param> 
         <param-name>contextConfigLocation</param-name> 
        <param-value> 
            /WEB-INF/database.xml 
            /WEB-INF/applicationContext.xml 
        </param-value> 
    </context-param> 
 
   <listener> 
       <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class> 
            </listener> 
 
    <filter> 
        <filter-name>encodingFilter</filter-name> 
        <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class> 
        <init-param> 
            <param-name>encoding</param-name> 
            <param-value>UTF-8</param-value> 
        </init-param> 
    </filter> 
 
    <filter-mapping> 
        <filter-name>encodingFilter</filter-name> 
        <url-pattern>*.do</url-pattern> 
    </filter-mapping> 
 
    <servlet> 
        <servlet-name>ideawu</servlet-name> 
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> 
        <load-on-startup>1</load-on-startup> 
    </servlet> 
 
    <servlet-mapping> 
        <servlet-name>ideawu</servlet-name> 
        <url-pattern>*.do</url-pattern> 
    </servlet-mapping> 
 
    <welcome-file-list> 
        <welcome-file>index.jsp</welcome-file> 
        <welcome-file>index.html</welcome-file> 
    </welcome-file-list> 
 
    <jsp-config> 
        <taglib> 
            <taglib-uri>http://java.sun.com/jsp/jstl/core</taglib-uri> 
            <taglib-location>/WEB-INF/tld/c.tld</taglib-location> 
        </taglib> 
        <taglib> 
            <taglib-uri>http://java.sun.com/jsp/jstl/fmt</taglib-uri> 
            <taglib-location>/WEB-INF/tld/fmt.tld</taglib-location> 
        </taglib> 
   </jsp-config> 
 
</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:
Java代碼 
<?xml version="1.0" encoding="UTF-8" ?> 
 <!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN" "http://www.springframework.org/dtd/spring-beans.dtd"> 
  
<beans> 
  
     <bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver"> 
         <property name="prefix" value="/WEB-INF/jsp/" /> 
         <property name="suffix" value=".jsp" /> 
     </bean> 
 
    <bean id="simpleUrlHandlerMapping" class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping"> 
        <property name="mappings"> 
            <props> 
                <prop key="/hello.do">helloController</prop> 
            </props> 
        </property> 
   </bean> 
 
    <bean id="helloController" class="com.ideawu.HelloController"> 
        <!– 
        <property name="helloManager" ref="helloManager" /> 
        –> 
    </bean> 
 
</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:
Java代碼 
 <?xml version="1.0" encoding="UTF-8"?> 
 <!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN" "http://www.springframework.org/dtd/spring-beans.dtd"> 
  
 <beans> 
  
     <bean id="propertyConfigurer" class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer"> 
         <property name="locations"> 
             <list> 
                <value>/WEB-INF/jdbc.properties</value> 
            </list> 
        </property> 
    </bean> 
 
</beans> 

它配置瞭以下功能:

讀取 /WEB-INF/jdbc.properties 文件. 你可以在 list 標簽中配置多個 value 標簽.

database.xml:
Java代碼 
<?xml version="1.0" encoding="UTF-8"?> 
<!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN" "http://www.springframework.org/dtd/spring-beans.dtd"> 
 
<beans> 
 
    <!– Remove this if your database setting is fine. 
    <bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource" destroy-method="close"> 
        <property name="driverClassName" value="${jdbc.driverClassName}"/> 
        <property name="url" value="${jdbc.url}"/> 
       <property name="username" value="${jdbc.username}"/> 
       <property name="password" value="${jdbc.password}"/> 
   </bean> 
   –> 
 
   <!– Transaction manager for a single JDBC DataSource 
   <bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager"> 
       <property name="dataSource" ref="dataSource"/> 
   </bean> 
   –> 
 
   <!– 
   <bean id="attributeManager" class="com.ideawu.core.AttributeManager"> 
       <property name="dataSource" ref="dataSource"/> 
   </bean> 
   –> 
 
lt;/beans> 

它配置瞭以下功能(不過,已經註釋掉瞭):

配置數據庫連接. 類似${jbbc.url}是一種訪問變量的方法. 我們可以從 /WEB-INF/jdbc.properties 中找到這個變量的值. 如果你的數據庫已經配置好, 就將第一個註釋去掉.

jdbc.properties:
jdbc.driverClassName=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost/test?useUnicode=true&characterEncoding=UTF-8
jdbc.username=test
jdbc.password=12345
現在, 我們來編寫 Java 代碼吧.
Java代碼 
/***********************************************************
 * Date: 2006-8-26
 * File: HelloController.java
 * Author: ideawu
 ***********************************************************/ 
  
 package com.ideawu; 
  
import org.springframework.web.servlet.mvc.Controller; 
mport org.springframework.web.servlet.ModelAndView; 
 
import javax.servlet.http.HttpServletRequest; 
import javax.servlet.http.HttpServletResponse; 
 
/**
 * @author ideawu
 *
 */ 
public class HelloController implements Controller { 
/*  
    private HelloManager helloManager;
 
    public void setHelloManager(HelloManager helloManager) {
        this.helloManager = helloManager;
    }
*/ 
 
    public ModelAndView handleRequest(HttpServletRequest request, 
            HttpServletResponse response)throws Exception{ 
 
        request.setAttribute("hello_1", "你好啊, Spring!"); 
        request.setAttribute("hello_2", "Hello World!"); 
 
        return new ModelAndView("hello"); 
    } 
 

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

hello.jsp:
Java代碼 
<%@ page contentType="text/html; charset=UTF-8" %> 
 <%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %> 
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 
 <html xmlns="http://www.w3.org/1999/xhtml"> 
 <head> 
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> 
     <title>Hello World!</title> 
 </head> 
 <body> 
 
<h2>${hello_1}</h2> 
 
<h2>${hello_2}</h2> 
 
</body> 
</html> 

你可以下載整個 Web 應用程序. 在 Debian Linux, Tomcat 5.5.16, JDK1.5.0 下運行良好. 解壓後得到一個 spring 文件夾, 放到你的 webapps 目錄下, 在瀏覽器中輸入

作者“熱愛我的熱愛”
 

發佈留言

發佈留言必須填寫的電子郵件地址不會公開。 必填欄位標示為 *