環境:java8+maven3
工具:idea
準備工作:idea創建maven工程project。再創建一個maven的單元module。
手動把module改成springMVC的web服務。
springMVC的重要元素:
1.web.xml:web服務的描述信息
2.處理映射的統一DispatcherServlet
3.特殊的bean類型:viewResolve/handleExceptionResolve/MutilPartResolve等
4:controller類
先看原始的單元信息
可以看出項目非常簡單,沒有java代碼,沒有resource資源,pom依賴除了父工程沒有其他的信息
第一步添加maven依賴:springMVC
調整後的依賴pom
dependency裏面沒有版本號,因爲我們在project的pom中定義了.
第二步:src下新增文件夾 webapp,添加web服務的基本信息
添加了web.xml文件,描述當前的web服務,基本信息如下
<?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">
</web-app>
第三步:配置默認的響應servlet。
web服務能響應我們的請求,都是servlet在統一分發處理。springMVC提供了一個servlet幫我們處理
在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">
<!--配置springMVC提供的DispatcherServlet-->
<servlet>
<servlet-name>appServelt</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value>WEB-INF/app-servlet.xml</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
<!--配置Servlet 映射路徑,如果命中,交由該servlet統一處理-->
<servlet-mapping>
<servlet-name>appServelt</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
</web-app>
上面配置了統一處理的請求的servlet。
注意配置servlet的<init-param>元素。這個時候會加載webapp下面的app-sevlet.xml找尋處理視圖的類,處理異常的類。
第四步:我們添加一個配置app-servlet.xml文件
基本配置如下:
<?xml version="1.0" encoding="UTF-8" ?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:context="http://www.springframework.org/schema/context"
xmlns:mvc="http://www.springframework.org/schema/mvc"
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-4.3.xsd
http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.3.xsd">
<!--mvc 使用註解驅動 -->
<mvc:annotation-driven/>
<!--Spring context 的component 掃描路徑-->
<context:component-scan base-package="com.david.spring"/>
<!--特殊的bean 視圖處理器,將一般的controller返回的string對象,映射到jsp文件-->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix" value="/WEB-INF/"/>
<property name="suffix" value=".jsp"/>
</bean>
</beans>
第五步:新增controller對象
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;
/**
* @version $Id: null.java, v 1.0 2020/6/10 2:01 PM david Exp $$
* @Author:louwenbin([email protected])
* @Description:${TODO}(這裏用一句話描述這個類的作用)
* @since 1.0
**/
@Controller
public class IndexController {
@RequestMapping("/index")
public String index(Model model){
model.addAttribute("name","david");
return "index";
}
}
特別注意,這個controller對象的相對路徑是我們app-servlet.xml文件配置的掃描路徑,否則不會加載到webApplicationContext中.
而且這個controller的註解用的是@Controller。不是@RestController
第7步:新增視圖index.jsp文件
jsp的基本代碼:
<?xml version="1.0" encoding="UTF-8" ?>
<jsp:directive.page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8" />
<html>
<header>
</header>
<body>
\${name} : ${name}
</body>
</html>
到現在爲止,最簡單的springMVC項目基本搭建完成。
這個時候就想着如何部署啓動呢。
maven有tomcat的插件可以供我們部署啓動
看maven-tomcat的插件配置
<build>
<plugins>
<plugin>
<groupId>org.apache.tomcat.maven</groupId>
<artifactId>tomcat7-maven-plugin</artifactId>
<version>2.2</version>
<executions>
<execution>
<id>tomcat-run</id>
<goals>
<goal>exec-war</goal>
</goals>
<phase>package</phase>
<configuration>
<path>/</path>
</configuration>
</execution>
</executions>
</plugin>
</plugins>
</build>
這個時候我們可以打包測試一下:看能不能按照我們的期望,打出可執行的jar包來
執行mvn clean install
打出來的包果然有-war-exec.jar。但是上面的包是jar包,不能部署,我們要修改pom.xml的<packaging>參數爲war。
重新執行 mvn clean install
成功打出war包,這個時候我們嘗試用tomcat插件啓動服務
執行mvn tomcat7:run命令
看輸出日誌
成功啓動tomcat
執行curl http://127.0.0.1:8080/spring-mvc-study/index
輸出
說明我們成功的訪問到了我們的服務。
到這裏我們的springMVC工程配置完成。之後就可以以此爲藍本增加功能。