环境: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(louwb@runyong.cn)
* @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工程配置完成。之后就可以以此为蓝本增加功能。