第一個Spring MVC Web程式

我們的第一個Spring MVC Web程式將使用Tomcat 5.0.28來示範，我們在webapps目錄下建立一個springapp目錄，這次為了方便，我們直接使用spring.jar，以及其相依的commons-logging.jar，請將這兩個jar放到 springapp/WEB-INF/lib下。

　Spring MVC框架的中心是dispatcher：org.springframework.web.servlet.DispatcherServlet。DispatcherServlet負責將Web請求分派（dispatch）給handler，Spring為handler定義了預設介面：org.springframework.web.servlet.mvc.Controller：

Controller.java

public interface Controller { 
    public ModelAndView handleRequest(HttpServletRequest req, HttpServletResponse res) throws Exception; 
}

　DispatcherServlet分派請求的根據是委託給實作org.springframework.web.servlet.HandlerMapping介面的物件來處理，例如org.springframework.web.servlet.handler.SimpleUrlHandlerMapping，請求與handler之間的映射是撰寫在Bean定義檔中。

　DispatcherServlet本身是一個Servlet，我們要先在web.xml中定義：

web.xml

<?xml version="1.0" encoding="ISO-8859-1"?> 
                                                                                
<web-app 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" 
    version="2.4"> 
                                                                                
    <description> 
        Spring App Examples. 
    </description> 
    <display-name>Spring App Examples</display-name> 
    
    <servlet> 
        <servlet-name>hello</servlet-name> 
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> 
    </servlet> 
    <servlet-mapping> 
        <servlet-name>hello</servlet-name> 
        <url-pattern>*.do</url-pattern> 
    </servlet-mapping> 
                                                                                
</web-app>

　在web.xml中，我們定義了一個DispatcherServlet的實例hello，所有*.do結尾的請求都會由它來處理，DispatcherServlet預設會使用Servlet的名稱為前置，讀取name-servlet.xml作為其Bean定義檔，以上面的設定即讀取hello-servlet.xml。依這個機制，如果您要多個模組，可以定義不同的名稱來使用多個DispatcherServlet的實例，並分別讀取不同的Bean定義檔。

　您也可以自行定義Bean定義檔的名稱，像是：

<servlet> 
    <servlet-name>hello</servlet-name> 
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> 
    <init-param> 
        <param-name>contextConfigLocation</param-name> 
        <param-value>/WEB-INF/hello1-servlet.xml, /WEB-INF/hello2-servlet.xml</param-value> 
    </init-param>      
</servlet>

　我們這邊使用預設的hello-servlet.xml作為Bean定義檔的名稱，其內容如下：

hello-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="urlMapping" class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping"> 
        <property name="mappings"> 
            <props> 
                <prop key="/hellouser.do">helloUserAction</prop> 
            </props> 
        </property> 
    </bean> 
    
    <bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver"> 
        <property name="viewClass"> 
            <value>org.springframework.web.servlet.view.InternalResourceView</value> 
        </property> 
    </bean> 
    
    <bean id="helloUserAction" class="onlyfun.caterpillar.HelloUserAction"> 
        <property name="helloWord"> 
            <value>Hello!</value> 
        </property> 
        <property name="viewPage"> 
            <value>/WEB-INF/jsp/hellouser.jsp</value> 
        </property> 
    </bean> 
</beans>

　DispatcherServlet將請求與handler的映射交給HandlerMapping的實作org.springframework.web.servlet.view.InternalResourceViewResolver，在上面的設定中，我們將/hellouser.do的請求交給名稱為helloUserAction的handler，它是個實作Controller介面的類別，我們待會再來看看它。

　先來關心一下viewResolver，Spring可以讓您使用不同的表示層技術，透過viewResolver的轉換，您的表示層可以使用純綷的JSP/Servlet、JSTL、Velocity、Tiles等等，在這邊我們使用JSP/Servlet，您只要簡單的設定viewClass屬性為org.springframework.web.servlet.view.InternalResourceView。如果您的表示層使用JSTL，則可以設定org.springframework.web.servlet.view.JstlView，同樣的，對於Spring支援的其它表示層技術，Spring都提供有一個viewClass可以設定。

　來看看helloUserAction，它實作了Controller介面：

HelloUserAction.java

package onlyfun.caterpillar; 

import java.io.IOException; 
import java.util.*; 
import javax.servlet.*; 
import javax.servlet.http.*; 
import org.springframework.web.servlet.mvc.Controller; 
import org.springframework.web.servlet.ModelAndView; 
import org.springframework.web.bind.RequestUtils; 

public class HelloUserAction implements Controller { 
   private String helloWord; 
    private String viewPage; 
    
   public ModelAndView handleRequest(HttpServletRequest req, HttpServletResponse res) 
        throws ServletException, IOException { 
      String user = RequestUtils.getRequiredStringParameter(req, "user"); 
      Map model = new HashMap(); 
      model.put("helloWord", getHelloWord()); 
      model.put("user", user); 
    
       return new ModelAndView(getViewPage(), model); 
    } 
    
    public void setViewPage(String viewPage) { 
       this.viewPage = viewPage; 
    } 
    
    public String getViewPage() { 
       return viewPage; 
    } 

    public void setHelloWord(String helloWord) { 
       this.helloWord = helloWord; 
    } 
    
    public String getHelloWord() { 
       return helloWord; 
    } 
}

　handlerRequest()在MVC/Model2中扮演的作用，在於處理請求內容、呼叫商務物件、準備Model，它必須返回一個ModelAndView的實例，表示最後要顯示給使用者觀看的表示層資源。

　在上面的例子中，我們只是將請求中的user參數取出，填入Model中，ModelAndView接受一個Map物件作為請求，之後viewResolver會根據所設定的viewClass將之轉換為View層可以抽取出來的資料源。

　在上面的例子中，我們使用了依賴注入的方式設定helloWord，以及View的位址，利用依賴注入的方式，我們可以避免將View的資源位址寫死在程式中，而請您回顧一下viewPage屬性，我們設定其為/WEB-INF/jsp/hellouser.jsp，將資源設定在WEB-INF中，可以避免使用者直接存取資源，以獲得較高的安全性與資源訪問控制

　hellouser.jsp的內容如下，我們使用了JSP 2.0的Expression Language將Model取出以顯示在頁面上：

hellouser.jsp

<html> 
<head><title>HelloPage</title></head> 
<body> 
    <H1> ${helloWord}, ${user}!!</H2> 
</body> 
</html>

現在可以啟動您的Servlet容器了，在網址列輸入本地測試位址：

http://localhost:8080/springapp/hellouser.do?user=Justin

我們給了一個請求參數user=Justin，程式執行的結果如下：

<html> 
<head><title>HelloPage</title></head> 
<body> 
    <H1> Hello!, Justin!!</H2> 
</body> 
</html>

Comments  (Hide)