第一個Spring MVC Web程式

    技术2022-05-11  7

    我們的第一個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)  

    最新回复(0)