Spring MVC 開發快速入門

這篇文章將教你快速地上手使用 Spring 框架，以下需要用spring3.0以上的jar包
　　首先， 我需要在你心里建立起 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)模板使用.

　　好了， 我們開始吧. 首先新建一個java web工程，我們需要一個放在 WEB-INF 目錄下的 web.xml 文件:

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.4" 
    xmlns="http://java.sun.com/xml/ns/javaee" 
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
    http://java.sun.com/xml/ns/javaee/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-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:

<?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:

<?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:

<?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>
     -->
 
 </beans> 

 

它配置了以下功能(不過，已經注釋掉了):

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

　　jdbc.properties:

jdbc.driverClassName=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/test?useUnicode=true&characterEncoding=utf8
jdbc.username=root
jdbc.password=1234

現在， 我們來編寫 Java 代碼吧.

package com.ideawu;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import org.springframework.web.servlet.ModelAndView;
import org.springframework.web.servlet.mvc.Controller;

public class HelloController implements Controller{
    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:

<%@ page language="java" import="java.util.*" pageEncoding="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>
  <head>
    
    <title>hello</title>
    

  </head>
  
  <body>
   <h1>${hello_1}</h1><br/>
   <h1>${hello_2}</h1>
  </body>
</html>

 

在瀏覽器中輸入 http://localhost:8080/spring/hello.do 就可以訪問了。spring 為工程名字