剛接觸Spring MVC
寫個簡易教學備忘一下
流程:
1.建立一個Maven專案
我是使用maven-archetype-quickstart
version 1.1
可以直接使用內建Dynamic Web Module的
2.安裝JAR檔
<dependencies>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>4.2.6.RELEASE</version>
</dependency>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>3.8.1</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.6</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-jdbc</artifactId>
<version>4.2.6.RELEASE</version>
</dependency>
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>3.1.0</version>
</dependency>
<dependency>
<groupId>jstl</groupId>
<artifactId>jstl</artifactId>
<version>1.2</version>
</dependency>
</dependencies>
3.轉換為Dynamic Web專案(使用的archetype有內建的就跳過吧)
專案上按右鍵
Properties -> Project Facets -> Covert to faceted form... ->
打勾Dynamic Web Module ->Apply ->OK
4.轉換為符合maven標準的資料夾格式(使用的archetype以符合就跳過)
在src/main 新增resources資料夾
在src/main 新增webapp資料夾
在src/main/webapp 新增WEB-INF資料夾
專案上按右鍵
Properties -> Deployment Assembly
Add -> Folder 選取src/main/webapp確認
Add -> Java Build Path Entries 選取Maven Dependencies確認
5.新增web.xml
放置於src/main/webapp/WEB-INF/web.xml
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd" version="3.0">
<display-name>Spring MVC DEMO</display-name>
<welcome-file-list>
<welcome-file>index.jsp</welcome-file>
</welcome-file-list>
<servlet>
<servlet-name>dispatcher</servlet-name>
<servlet-class>
org.springframework.web.servlet.DispatcherServlet
</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>dispatcher</servlet-name>
<url-pattern>*.do</url-pattern>
</servlet-mapping>
</web-app>
6.新增dispatcher-servlet.xml
放置於src/main/webapp/WEB-INF/dispatcher-servlet.xml
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:mvc="http://www.springframework.org/schema/mvc" xmlns:context="http://www.springframework.org/schema/context"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="
http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/mvc
http://www.springframework.org/schema/mvc/spring-mvc.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context.xsd">
<context:component-scan base-package="controller" />
<bean id="viewResolver"
class="org.springframework.web.servlet.view.UrlBasedViewResolver">
<property name="viewClass"
value="org.springframework.web.servlet.view.JstlView" />
<property name="prefix" value="/WEB-INF/jsp/" />
<property name="suffix" value=".jsp" />
</bean>
</beans>
7.新增一個package命名為controller
在裡面放置一個Hello.java
package controller;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.servlet.ModelAndView;
@Controller
public class Hello {
@RequestMapping("/hello_path")
public ModelAndView hello() {
String message = "<h1>Hello World!</h1>";
return new ModelAndView("hello", "message_el", message);
}
}
8.在WEB-INF內新增一個資料夾命名為jsp
在jsp資料夾內放置一個hello.jsp
src/main/webapp/WEB-INF/jsp/hello.jsp
<%@ page language="java" contentType="text/html; charset=BIG5"
pageEncoding="BIG5"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title>Spring MVC Demo</title>
</head>
<body>
${message_el}
</body>
</html>
9.啟動tomcat
網址輸入
http://localhost:8080/ProjectName/hello_path.do
ProjectName看你取什麼名字就打什麼
總結一下Spring MVC的運作流程
從web.xml讀取DispatcherServlet
dispatcher取的servlet-name後面加上-servert.xml就是它會去找的檔案名稱
我這邊把servlet-name取名為dispatcher所以它去尋找dispatcher-servlet.xml
之後從dispatcher-servlet.xml讀取JstlView
這邊能夠設定prefix與suffix
對應到的就是設定jsp檔案的路徑以及檔案的副檔名
以及能夠設定該去掃描哪個package
會去scan此package底下的Class檔案中的annotation
而此範例是寫了一個@Controller
告訴Spring這是一個Controller Class
底下的方法就是設置@RequestMapping
@RequestMapping對應的是網址列該打上的path
也可以加入method
@RequestMapping(value = "/hello_path", method = { RequestMethod.GET, RequestMethod.POST })
初學容易搞混web.xml設置的url-pattern與@RequestMapping的路徑有什麼不同
web.xml的url-pattern是設定怎樣的path要去找spring的dispatcher來做轉發
所以也可以在web.xml內設定專門給servlet用的路徑
本範例是使用路徑結尾為.do的交由spring mvc做轉發處理
http://localhost:8080/ProjectName/hello_path.do
看到.do便知道此request先交由spring mvc dispatcher處理
spring mvc會去比對@RequestMapping是否有value是hello_path的
於是轉交該方法來執行
此範例return為ModelAndView物件
return new ModelAndView("hello", "message", message);
ModelAndView(String viewName, String modelName, Object modelObject)
hello代表的是jsp檔名
在dispatcher-servlet.xml中我們已經設定了
<property name="prefix" value="/WEB-INF/jsp/" />
<property name="suffix" value=".jsp" />
所以spring mvc會解譯為 /WEB-INF/jsp/hello.jsp
能夠對應到server端內的資料夾路徑
modelName message_el就是帶往jsp檔案時相對應的名稱
能夠用EL $(message_el}來call massege物件
而message物件就是我們在hello方法內所寫的String message
相關檔案放在
https://gist.github.com/ripple0129/45872576a10615819c15ab81a06fdfe4
