本文讲解如何搭建Spring MVC 的入门程序,使用IDEA2017开发工具,使用Maven作为构建工具。
1 创建Web项目
填写项目名称
建立好项目后,使用IDEA的插件把Java项目改为Web项目。
注意:如果没有插件,可以在IDEA的插件市场搜索"JBLJavaToWeb"插件并安装
最终项目结构如下:
2 导入SpringMVC依赖
在项目的pom.xml导入Spring MVC的Maven依赖
<dependencies>
<!--SpringMVC依赖-->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>5.0.2.RELEASE</version>
</dependency>
</dependencies>
3 配置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">
<!-- 配置核心控制器 -->
<servlet>
<servlet-name>dispatcherServlet</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<!-- springmvc配置文件加载路径
1)默认情况下,读取WEB-INF下面的文件
2)可以改为加载类路径下(resources目录),加上classpath:
-->
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:springmvc.xml</param-value>
</init-param>
<!--
DispatcherServlet对象创建时间问题
1)默认情况下,第一次访问该Servlet的创建对象,意味着在这个时间才去加载springMVC.xml
2)可以改变为在项目启动时候就创建该Servlet,提高用户访问体验。
<load-on-startup>1</load-on-startup>
数值越大,对象创建优先级越低! (数值越低,越先创建)
-->
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>dispatcherServlet</servlet-name>
<url-pattern>*.do</url-pattern>
</servlet-mapping>
</web-app>
注意事项:
- DispathcerServlet是Spring MVC提供的核心控制器,这是一个Servlet程序,该Servlet会接收所有请求
- 核心控制器会读取一个springmvc.xml配置,加载Spring MVC的核心配置
- 配置*.do,代表只拦截以.do结尾的请求,后续我们可以进行更改
- 代表在项目启动时实例化DispathcerServlet,如果没有配置,则在第一次访问Servlet时进行实例化
4 编写Controller控制器
接下来我们编写普通控制器类,控制器类是开发Spring MVC程序过程写的最多的类了。控制器类通常叫Controller,在里面编写接收参数,调用业务方法,返回视图页面等逻辑。
HelloController:
package com.yiidian.controller;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
/**
* 控制器
* 一点教程网 - www.yiidian.com
*/
@Controller
public class HelloController {
@RequestMapping("/hello.do")
public String hello(){
System.out.println("进入控制器的方法");
//注意:这里返回的只是页面名称,不是完整的页面访问路径
return "success";
}
}
@Controller注解是为了让Spring IOC容器初始化时自动扫描到该Controller类;@RequestMapping是为了映射请求路径,这里因为类与方法上都有映射所以访问时应该是/hello.do;方法返回的结果是视图的名称success,该名称不是完整页面路径,最终会经过视图解析器解析为完整页面路径并跳转。
5 配置springmvc.xml
在项目的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:mvc="http://www.springframework.org/schema/mvc"
xmlns:context="http://www.springframework.org/schema/context"
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">
<!-- 1.扫描Controller的包-->
<context:component-scan base-package="com.yiidian.controller"/>
<!-- 2.配置视图解析器 -->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<!-- 2.1 页面前缀 -->
<property name="prefix" value="/pages/"/>
<!-- 2.2 页面后缀 -->
<property name="suffix" value=".jsp"/>
</bean>
<!-- 3.开启mvc注解驱动-->
<mvc:annotation-driven/>
</beans>
在Spring中一般采用@RequestMapping注解来完成映射关系,要想使@RequestMapping注解生效必须向上下文中注册DefaultAnnotationHandlerMapping和一个AnnotationMethodHandlerAdapter实例,这两个实例分别在类级别和方法级别处理。而mvc:annotation-driven/配置帮助我们自动完成上述两个实例的注入。
6 编写JSP测试页面
在webapp目录中创建视图,Controller方法执行完毕会跳转到该视图:
具体内容如下:
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>一点教程网-提示页面</title>
</head>
<body>
执行成功啦!
</body>
</html>
7 项目部署到Tomcat
把项目部署到Tomcat,然后启动Tomcat运行项目,请注意查看启动信息,如果有异常应该先解决异常信息。
运行成功后的结果如下所示: