教你学会SSM框架第十一步，菜鸟入门级别的Spring MVC

于 2020-06-16 11:33:56 发布
阅读量543 收藏 1
点赞数
分类专栏： SSM # Spring MVC 文章标签： spring servlet web java
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/super_CSDNer/article/details/106688824
版权

目录

11.1 Spring MVC概述

Spring MVC是Spring提供的一个轻量级Web框架，它实现了Web MVC设计模式。

Spring MVC具有如下特点

  • 是Spring框架的一部分，可以方便地利用Spring所提供的其他功能。
  • 灵活性强，易于与其他框架集成。
  • 提供了一个前端控制器DispatcherServlet，使开发人员无须额外开发控制器对象。
  • 可自动绑定用户输入，并能正确地转换数据类型。
  • 内置了常见的校验器，可以校验用户输入。如果校验不能通过，就会复位向到输入表单。
  • 支持多种视图技术，如JSP、Velocity和FreeMarker等视图技术。
  • 使用基于XML的配置文件，在编辑后，不需要重新编译应用程序。

11.2 第一个SpringMVC应用

11.2.1 创建一个项目，引入jar包，发布类路径

在这里插入图片描述
项目中添加了4个核心JAR包、commons-logging的JAR包以及两个Web相关的JAR包，这两个Web相关的JAR包就是Spring MVC框架所需的JAR包。

11.2.2 配置前端控制器

在web.xml中配置Spring MVC的前端控制器
如下

<?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"
	id="WebApp_ID" version="3.0">
	<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-config.xml</param-value>
		</init-param>
		<!-- 表示容器在启动时立即加载Servlet -->
		<load-on-startup>1</load-on-startup>
	</servlet>
	<servlet-mapping>
		<servlet-name>springmvc</servlet-name>
		<url-pattern>/</url-pattern>
	</servlet-mapping>
</web-app>

主要对< servlet>和< servlet- mapping>元素进行了配置。在< servlet>中配置了Spring MVC的前端控制器 DispatcherServlet，并通过其子元素< init-param>配置了Spring MVC配置文件的位置，< load-on-startup>元素中的1表示容器在启动时立即加载这个Servlet；在< servlet-mapping>中，通过< url-pattern>元素的“/”拦截所有URL，并交由 DispatcherServlet处理=。

11.2.3 创建Controller类

在src目录下创建一个com.ssm.controller包，并在包中创建控制器类ControllerTest，该类需要实现Controller接口，

package com.ssm.controller;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import org.springframework.web.servlet.ModelAndView;
import org.springframework.web.servlet.mvc.Controller;
public class ControllerTest implements Controller {
	@Override
	public ModelAndView handleRequest(HttpServletRequest arg0, HttpServletResponse arg1) throws Exception {
		ModelAndView m=new ModelAndView();
		m.addObject("msg","第一个spring MVC程序");
		m.setViewName("/WEB-INF/jsp/welcome.jsp");
		return m;
	}
}

handleRequest()是Controller接口的实现方法，ControllerTest类会调用该方法处理请求，并返回一个包含视图名或包含视图名与模型的ModelAndview对象。本案例向模型对象中添加了一个名称为msg的字符串对象，并设置返回的视图路径为WEB-INF/jsp/welcome.jsp，这样请求就会被转发到welcome.jsp页面。

11.2.4 创建Spring MVC的配置文件。配置控制器映射信息

在src目录下创建配置文件springmvc-config.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"
	xsi:schemaLocation="http://www.springframework.org/schema/beans 
        http://www.springframework.org/schema/beans/spring-beans-4.3.xsd">
	<!--配置处理器Handle，映射"controllerTest"请求 -->
	<bean name="/controllerTest" class="com.ssm.controller.ControllerTest" />
	<!--处理器映射，将处理器Handle的name作为url进行查找 -->
	<bean class="org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping" />
	<!--处理器适配器，配置对处理器中handleRequest()方法的调用 -->
	<bean class="org.springframework.web.servlet.mvc.SimpleControllerHandlerAdapter" />
	<!--视图解析器 -->
	<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver" />
</beans>

首先定义了一个名称为“/controllerTest”的Bean，该Bean会将控制器类ControllerTest映射到“/controllerTest”请求中；然后配置了处理器映射器BeanNameUrlHandlerMapping和处理器适配器SimpleControllerHandlerAdapter，其中处理器映射器用于将处理器Bean中的的name（即url）进行处理器查找，而处理器适配器用于完成对ControllerTest处理器中handleRequest()方法的调用；最后配置了视图解析器InternalResourceViewResolver来解析结果视图，并将结果呈现给用户。

注意

在老版本的Spring中，配置文件内必须要配置处理器映射器、处理器适配器和视图解析器。但在Spring 4.0以后，如果不配置处理器映射器、处理器适配器和视图解析器，就会使用Spring内部默认的配置来完成相应的工作。

11.2.5 创建视图（View）页面

在WEB-INF的目录下创建一个JSP文件夹，并创建一个welcome.jsp，使用EL表达式获取msg中的信息

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>入门程序</title>
</head>
<body>
	${msg}
</body>
</html>

11.2.6 启动项目

将项目发布到Tomcat服务器并启动服务器。在浏览器中访问http://localhost:8080/项目名/controllerTest，显示的页面效果如图
在这里插入图片描述
从中可以看到，浏览器中已经显示出了模型对象中的字符串信息，这就说明第一个Spring MVC程序执行成功。

总结, Spring MVC程序的执行流程。

用户通过浏览器向服务器发送请求，请求会被Spring MVC的前端控制器DispatcherServlet所拦截。

  • DispatcherServlet拦截到请求后，会调用HandlerMapping处理器映射器。
  • 处理器映射器根据请求URL找到具体的处理器，生成处理器对象及处理器拦截器（如果有就生成）一并返回给DispatcherServlet。
  • DispatcherServlet会通过返回信息选择合适的HandlerAdapter（处理器适配器）。
  • HandlerAdapter会调用并执行Handler（处理器），这里的处理器就是程序中编写的Controller类，也被称为后端控制器。
  • Controller执行完成后，会返回一个ModelAndView对象，该对象中包含视图名或包含模型与视图名。
  • HandlerAdapter将ModelAndView对象返回给DispatcherServlet。
  • DispatcherServlet会根据ModelAndView对象选择一个合适的ViewResolver（视图解析器）。
  • ViewResolver解析后，会向DispatcherServlet中返回具体的View（视图）。
  • DispatcherServlet对View进行渲染（即将模型数据填充至视图中）。
  • 视图渲染结果会返回给客户端浏览器显示。

在上述执行过程中，DispatcherServlet、HandlerMapping、HandlerAdapter和ViewResolver对象的工作是在框架内部执行的，开发人员并不需要关心这些对象内部的实现过程，只需要配置前端控制器（DispatcherServlet），完成 Controller中的业务处理，并在视图中（View）中展示相应信息即可。

11.3 Spring MVC的注解

在Spring 2.5之前，只能使用实现Controller接口的方式来开发一个控制器。在Spring 2.5之后，新增加了基于注解的控制器以及其他一些常用注解，这些注解的使用极大地减少了程序员的开发工作。
Spring MVC中的常用核心类及其常用注解。

11.3.1 DispatcherServlet

DispatcherServlet的全名是org.Springframework.web.servlet.DispatcherServlet，它在程序中充当着前端控制器的角色。

【示例】在使用DispatcherServlet时，只需将其配置在项目的web.xml文件中，其配置代码如下。
在这里插入图片描述
在上述代码中，< load-on-startup>元素和< init-param>元素都是可选的。如果< load-on-startup>元素的值为1，在应用程序启动时就会立即加载该Servlet；如果< load-on-startup>元素不存在，应用程序会就在第一个Servlet请求时加载该Servlet。如果< init-param>元素存在并且通过其子元素配置了Spring MVC配置文件的路径，应用程序在启动时就会加载配置路径下的配置文件；如果没有通过< init-param>元素配置，应用程序就会默认到WEB-INF目录下寻找如下方式命名的配置文件。

servletName-servlet.xml

其中，servletName指的是部署在web.xml中的DispatcherServlet的名称，在上面web.xml中的配置代码中即为springmvc，而-servlet.xml是配置文件名的固定写法，所以应用程序会在WEB-INF下寻找springmvc-servlet.xml。

11.3.2 Controller注解类型

org.springframework.stereotype.Controller注解类型用于指示Spring类的实例是一个控制器，其注解形式为@Controller。该注解在使用时不需要再实现Controller接口，只需要将@Controller注解加入控制器类上，然后通过Spring的扫描机制找到标注了该注解的控制器即可。

【示例】@Controller注解在控制器类中的使用示例如下。
在这里插入图片描述
为了保证Spring能够找到控制器类，还需要在Spring MVC的配置文件中添加相应的扫描配置信息，具体如下。

  • 在配置文件的声明中引入spring-context。
  • 使用< context: component-scan>元素指定需要扫描的类包。
    完整的配置文件如图所示    。
springmvc-config.xml

在这里插入图片描述

在图中，< context: component-scan>元素的属性base-package指定了需要扫描的类包为com.ssm.controller。在运行时，该类包及其子包下所有标注了注解的类都会被Spring所处理。与实现了Controller接口的方式相比，使用注解的方式显然更加简单。同时，Controller接口的实现类只能处理一个单一的请求动作，而基于注解的控制器可以同时处理多个请求动作，在使用上更加灵活。因此，在实际开发中通常都会使用基于注解的形式。注意使用注解方式时，程序的运行需要依赖Spring的AOP包，因此需要向lib目录中添加spring.aop-4.3.6 RELEASE.jar，否则程序运行时会报错。

11.3.3 RequestMapping注解类型

1. @RequestMapping注解的使用

Spring通过@Controller注解找到相应的控制器类后，还需要知道控制器内部对每一个请求是如何处理的，这就需要使用org.springframework.web.bind.annotation.RequestMapping注解类型。RequestMapping用于映射一个请求或一个方法，其注解形式为@RequestMapping，可以使用该注解标注在一个方法或一个类上。

  • 标注在方法上
    当标注在一个方法上时，该方法将成为一个请求处理方法，它会在程序接收到对应的URL请求时被调用。

【示例】使用@RequestMapping注解标注在方法上的示例如下。
在这里插入图片描述
使用@RequestMapping注解后，上述代码中的handleRequest()方法就可以通过地址http://localhost:8080/chapter11/annotationController进行访问。

  • 标注在类上
    当标注在一个类上时，该类中的所有方法都将映射为相对于类级别的请求，表示该控制器所处理的所有请求都被映射到value属性值所指定的路径下。

【示例】使用@RequestMapping注解标注在类上的示例如下。
在这里插入图片描述
由于在类上添加了@RequestMapping注解，并且其value属性值为“/controll”，因此上述代码方法的请求路径将变为http://localhost:8080/chapter11/controll/annotationController=。如果该类中还包含其他方法，那么在其他方法的请求路径中也需要加入“/ control”。

2. @RequestMapping注解的属性

@RequestMapping注解除了可以指定value属性外，还可以指定一些其他属性，如图所示
@RequestMapping注解的属性
在这里插入图片描述

  • 在图中，所有属性都是可选的，但其默认属性是value。当value是其唯一属性时，可以省略属性名，例如下面两种标注的含义相同。
@RequestMapping(value="/annotationController")
@RequestMapping("/annotationController")
3. 组合注解

前面已经对@RequestMapping注解及其属性进行了详细讲解，而在Spring 4.3版本中引入了组合注解来帮助简化常用的HTTP方法的映射，并更好地表达被注解方法的语义。其组合注解如下所示

  • @GetMapping：匹配GET方式的请求。
  • @PostMapping：匹配POST方式的请求。
  • @PutMapping：匹配PUT方式的请求。
  • @DeleteMapping：匹配DELETE方式的请求。
  • @PatchMapping：匹配PATCH方式的请求。

以@GetMapping为例，该组合注解是

@RequestMapping(method = RequestMethod.GET)

的缩写，它会将Http Get映射到特定的处理方法上。在实际开发中，传统的@RequestMapping注解使用方式如下。
在这里插入图片描述
而使用新注解@GetMapping后，可以省略method属性，从而简化代码，使用方式如下。
在这里插入图片描述

4. 请求处理方法的参数类型和返回类型

在控制器类中，每一个请求处理方法都可以有多个不同类型的参数，以及一个多种类型的返回结果。例如handleRequest()方法的参数就是对应请求的HttpServletRequest和HttpServletResponse两种参数类型。除此之外，还可以使用其他的参数类型，例如在请求处理方法中需要访问HttpSession对象，就可以添加HttpSession作为参数，Spring会将对象正确地传递给方法，其使用示例如下。
在这里插入图片描述
在请求处理方法中，可以出现的参数类型如下。

  • javax.servlet.ServletRequest/javax.servlet.http.HttpServletRequest
  • javax.servlet.ServletResponse/javax.servlet.http.HttpServletResponse
  • javax.servlet.http.HttpSession
  • org.springframework.web.context.request.WebRequest或
  • org.springframework.web.context.request.NativeWebRequest
  • java.util.Locale
  • java.util.TimeZone (Java 6+)/java.time.Zoneld(on Java 8)
  • java.io.InputStream/java.io.Reader
  • Java.io.OutputStream/java.io.Writer
  • org.springframework.http.HttpMethod
  • java.security.Principal
  • @PathVariable、@MatrixVariable、@RequestParam、@RequestHeader、@RequestBody、
  • @RequestPart、@SessionAttribute、@RequestAttribute注解
  • HttpEntity<?>
  • java.util.Map/org.springframework.ui.Model/lorg.springframework.ui.ModelMap
  • org.springframework.web.servlet.mvc.support.RedirectAttributes
  • org.springframework.validation.Errors/org.springframework.validation.BindingResult
  • org.springframework.web.bind.support.SessionStatus
  • org.springframework.web.util.UriComponentsBuilder
注意

org.springframework.ui.Model类型不是一个Servlet API类型，而是一个包含Map对象的Spring MVC类型。如果方法中添加了Model参数，那么每次调用该请求处理方法时，Spring MVC都会创建Model对象，并将其作为参数传递给方法。

前面的一个例子中，请求处理方法返回的是一个ModelAndView类型的数据。除了这种类型外，请求处理方法还可以返回其他类型的数据。Spring MVC所支持的常见方法返回类型如下。

  • ModelAndView
  • Model
  • Map
  • View
  • String
  • void
  • HttpEntity<?>或ResponseEntity<?>
  • Callable<?>
  • DeferredResult<?>

在上述列举的返回类型中，常见的返回类型有ModelAndView、String和void。其中，ModelAndView类型中可以添加Model数据，并指定视图；String类型的返回值可以跳转视图，但不能携带数据；而=void类型主要在异步请求时使用，它只返回数据，而不会跳转视图。
由于ModelAndView类型未能实现数据与视图之间的解耦，因此在开发时，方法的返回类型通常都会使用String。既然String类型的返回值不能携带数据，那么在方法中是如何将数据带入视图页面呢？这就用到了上面所讲解的Model参数类型，通过该参数类型即可添加需要在视图中显示的属性。

返回String类型方法如下
在这里插入图片描述
在上述方法代码中增加了一个Model类型的参数，通过该参数实例的addAttribute()方法即可添加所需数据。String类型除了可以返回上述代码中的视图页面外，还可以进行复位向与请求转发，具体方式如下。

（1）redirect复位向
例如，在修改用户信息操作后，将请求复位向到用户查询方法的实现代码如下。
在这里插入图片描述
（2）forward请求转发
例如，用户执行修改操作时，转发到用户修改页面的实现代码如下。
在这里插入图片描述

11.3.4 ViewResolver（视图解析器）

Spring MVC中的视图解析器负责解析视图，可以在配置文件中定义一个ViewResolver来配置视图解析器，其配置示例如下。
在这里插入图片描述
在上述代码中定义了一个id为viewResolver的视图解析器，并设置了视图的前缀和后缀属性。这样设置后，方法中所定义的view路径将可以简化。例如，逻辑视图名只需设置为“welcome”，而不再需要设置为“/WEB-INF/jsp/welcome.jsp”，在访问时视图解析器会自动地增加前缀和后缀。

11.4 基于注解的Spring MVC应用

11.4.1 搭建项目环境

在Eclipse中创建一个Web项目（项目基本内容和上一个项目相同，），引入相关的jar包，并发布到类路径
在这里插入图片描述
可以看出多添加Spring AOP所需的JAR（spring-aop-4.3.6.RELEASE.Jar）

11.4.2 修改配置文件

在springmvc-config.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"
	xsi:schemaLocation="http://www.springframework.org/schema/beans 
        http://www.springframework.org/schema/beans/spring-beans-4.3.xsd
        http://www.springframework.org/schema/context
        http://www.springframework.org/schema/context/spring-context-4.3.xsd">
	<!--指定需要扫描的包 -->
	<context:component-scan base-package="com.ssm.controller" />
	<!-- 定义视图解析器 -->
	<bean id="viewResoler"
		class="org.springframework.web.servlet.view.InternalResourceViewResolver">
		<!-- 设置前缀 -->
		<property name="prefix" value="/WEB-INF/jsp/" />
		<!-- 设置后缀 -->
		<property name="suffix" value=".jsp" />
	</bean>
</beans>

首先通过组件扫描器指定了需要扫描的包，然后定义了视图解析器，并在视图解析器中设置了视图文件的路径前缀和文件后缀名。

11.4.3 修改Controller类

修改类和方法，并在类和方法上添加注解

package com.ssm.controller;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;
@Controller
@RequestMapping(value = "/controll")
public class ControllerTest {
	@RequestMapping(value = "/annotationController")
	public String handleRequest(HttpServletRequest arg0, HttpServletResponse arg1,Model model) throws Exception {
		model.addAttribute("msg", "第一个Spring MVC程序");
		return "welcome";
	}
}
  • 使用@Controller注解来标注控制器类，并使用@RequestMapping注解标注在类名和方法名上来映射请求方法。
  • 在项目启动时，Spring就会扫描到此类，以及此类中标注了@RequestMapping注解的方法。由于标注在类上的@RequestMapping注解的value值为“/controll”，因此类中所有请求方法的路径都需要加上“/controll”。由于类中的handleRequest()方法的返回类型为String，而String类型的返回值又无法携带数据，因此需要通过参数Model对象的addAttribute()方法来添加数据信息。
  • 因为在配置文件的视图解析器中定义了视图文件的前缀和后缀名，所以handleRequest()方法只需返回视图名“welcome”即可，在访问此方法时，系统会自动访问“WEB(-?)INF/jsp/”路径下名称为welcome的jsp文件。

11.4.4 启动项目，测试应用

将项目发布到Tomcat服务器并启动，在浏览器中访问地址http://localhost:8080/chapter11_2/controll/annotationController，运行结果同上项目。

Devin Dever
关注
  • 0
    点赞
  • 踩
  • 1
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论
专栏目录
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

Devin Dever

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值