1、新建maven工程
File–>New–>Other–>Maven Project–>next–>Create a simple project
next–>填写Group Id 和 Artifact Id ,选择打包方式为war包–>finish
项目格式如下:
2、生成web.xml文件
此时的webapp下并没有WEB-INF文件夹,需要自动生成。选中项目名,右击–>Java EE Tools–>Generate Deployment Descriptor Stub(如果不存在Java EE Tools选项,可能是因为没有下载这个插件,需要提前下载插件)
此时webapp下自动生成了WEB-INF文件夹
3、添加maven依赖
在pom.xml文件中,添加如下依赖
<!-- junit -->
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
</dependency>
<!-- spring MVC -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>5.2.8.RELEASE</version>
</dependency>
<!-- JSP -->
<dependency>
<groupId>javax.servlet.jsp</groupId>
<artifactId>jsp-api</artifactId>
<version>2.2</version>
</dependency>
<!-- servlet -->
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>servlet-api</artifactId>
<version>2.5</version>
</dependency>
<!-- jstl -->
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>jstl</artifactId>
<version>1.2</version>
</dependency>
保存后,观察项目下是否出现Maven Dependencies包,如果没有需要更新更新项目。
此时,我这里就没有这个包,因为在eclipse中,保存pom.xml后,有时候并不会自动帮你下载这些依赖,此时需要选中项目,右击,选择Maven–>Update Project,将默认的后两个对勾去掉—>ok
观察eclipse的右下角,会看到一个绿色进度条,就是maven在帮我们下载依赖,不过可能速度很快,有时候会看不见。下载完成后,会发现项目多了一个Maven Dependencies包
4、配置web.xml
打开web.xml,配置DispatcherServlet。
<servlet>
<servlet-name>springmvc</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:springmvc.xml</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>springmvc</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
最终的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_2_5.xsd"
version="2.5">
<display-name>SpringmvcTest</display-name>
<welcome-file-list>
<welcome-file>index.html</welcome-file>
<welcome-file>index.htm</welcome-file>
<welcome-file>index.jsp</welcome-file>
<welcome-file>default.html</welcome-file>
<welcome-file>default.htm</welcome-file>
<welcome-file>default.jsp</welcome-file>
</welcome-file-list>
<servlet>
<servlet-name>springmvc</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:springmvc.xml</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>springmvc</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
</web-app>
由于生成的web.xml文件有默认的欢迎页面,我们可以新建一个index.jsp作为欢迎页面,表示一启动这个项目,就会自动显示给用户的视图为index.jsp
index.jsp保存在webapp下,因为webapp下的视图是对任意用户都可见的,而存在在WEB-INF文件夹下的视图是用户不可见的,用户必须通过请求,然后后台程序运行后,显示给用户。
新建的index.jsp如下,将其中编码的格式全部由ISO-8859-1变为UTF-8,为了防止出现中文乱码现象
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>Insert title here</title>
</head>
<body>
Welcome Client
</body>
</html>
5、新建springmvc.xml文件
由于DispatcherServlet必须要对应一个spring配置文件,在web.xml中显示的路径为springmvc.xml,所以在src/main/resources目录下,新建一个springmvc.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/context
http://www.springframework.org/schema/context/spring-context.xsd
http://www.springframework.org/schema/mvc
http://www.springframework.org/schema/mvc/spring-mvc.xsd">
<context:component-scan base-package="com.study.controller" />
<mvc:default-servlet-handler />
<mvc:annotation-driven />
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver" id="InternalResourceViewResolver">
<property name="prefix" value="/WEB-INF/jsp/"></property>
<property name="suffix" value=".jsp"></property>
</bean>
</beans>
6、新建controller
在src/maim/java 下新建一个Package,包的名字要和springmvc.xml文件中 标签对应的扫描包的名字相同,我这里是com.study.controller
在包下新建一个类HelloController
package com.study.controller;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;
@Controller
public class HelloController {
@RequestMapping("/test") //要访问的url路径
public String test(Model model) {
model.addAttribute("msg", "Hello SpringMVC!"); //要显示的数据
return "hello"; //要返回的jsp视图
}
}
7、新建jsp视图
在springmvc中,试图解析器的前缀是WEB-INF/jsp,所以在WEB-INF文件夹下新建一个jsp文件夹,在该文件夹下新建一个hello.jsp,将其中的ISO-8859-1都改为UTF-8格式
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>Insert title here</title>
</head>
<body>
${msg}
</body>
</html>
8、部署tomcat
选中项目,右击,选择 Build Path–>Add Librabies–>默认选中Server Runtime
next–>选中tomcat v9.0,前提是tomcat已经部署到eclipse中了–>finish
此时在项目文件下,多了一个新的文件夹
8、运行,并解决错误
右击项目,选择Run as -->Run on Server–>next–>只选择当前要运行的项目,如果还有别的项目,记得使用remove移除。这是为了防止别的项目干扰
点击finish,默认调转到index.jsp页面
接着访问/hello页面,会发现报404错误,说没有找到页面,但是控制台Console并没有报错
解决办法:右击项目,选择Properties–>Projects Facts,将Dynamic Web Module的版本修改为4.0,然后将java的版本修改为1.8 —>Apply—>Apply and Close
此时观察整个项目,会发现JRE System Library变成了[JavaSE-1.8],并且在target目录的META-INF目录下生成了maven文件夹
右击项目,重新运行,此时输入test页面,如下
有时出现404或500错误时,要执行以下步骤,看是否能解决:
右击项目名,选择Properties–>Deplyment Assembly,查看是否将maven依赖导入WEB-INF/lib下
如果没有则–>add–>添加Maven Dependencies
一般执行以上两个步骤后,运行就没有问题了。