Spring·基础入门篇(十四) SpringMVC的入门案例

1. 编写入门程序案例

1.1 创建Maven的WEB工程

springmvc实际案例 springmvc入门案例_SpringMVC

1.2 导入pom.xml坐标

<!-- 版本锁定 -->
<properties>
  <spring.version>5.0.2.RELEASE</spring.version>
</properties>
<dependencies>
  <dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-context</artifactId>
    <version>${spring.version}</version>
  </dependency>
  <dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-web</artifactId>
    <version>${spring.version}</version>
  </dependency>
  <dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-webmvc</artifactId>
    <version>${spring.version}</version>
  </dependency>
  <dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>servlet-api</artifactId>
    <version>2.5</version>
    <scope>provided</scope>
  </dependency>
  <dependency>
    <groupId>javax.servlet.jsp</groupId>
    <artifactId>jsp-api</artifactId>
    <version>2.0</version>
    <scope>provided</scope>
  </dependency>
</dependencies>

1.3 配置核心的控制器（DispatcherServlet）

在web.xml中配置一个Servlet

<!-- 配置 spring mvc 的核心控制器 -->
<servlet>
  <servlet-name>SpringMVCDispatcherServlet</servlet-name>
  <servlet-class>
    org.springframework.web.servlet.DispatcherServlet
  </servlet-class>
  <!-- 配置初始化参数，用于读取 SpringMVC 的配置文件 -->
  <init-param>
    <param-name>contextConfigLocation</param-name>
    <param-value>classpath:springmvc.xml</param-value>
  </init-param>
  <!-- 配置 servlet 的对象的创建时间点：应用加载时创建。
  取值只能是非 0 正整数，表示启动顺序 -->
  <load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
  <servlet-name>SpringMVCDispatcherServlet</servlet-name>
  <url-pattern>/</url-pattern>
</servlet-mapping>

1.4 编写springmvc.xml的配置文件

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       xmlns:context="http://www.springframework.org/schema/context"
       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.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">
    <!-- 配置创建 spring 容器要扫描的包 -->
    <context:component-scan base-package="top.lzchao"></context:component-scan>
    <!-- 配置视图解析器 -->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/pages/"></property>
        <property name="suffix" value=".jsp"></property>
    </bean>
</beans>

1.5 编写 index.jsp 和 success.jsp

<body>
	<h3>入门案例</h3>
	<a href="hello">入门案例</a>
</body>

在WEB-INF目录下创建pages文件夹，编写success.jsp的成功页面:

<body>
	<h3>入门成功！！</h3>
</body>

1.5 编写控制器并使用注解配置

/**
 * @author: LzCc
 * @blog: 
 * @description: spring mvc 的入门案例
 */
@Controller("helloController")
public class HelloController {
    @RequestMapping("/hello")
    public String helloWorld(){
        System.out.println("HelloController 的 helloWorld 方法执行了...");
        return "success";
    }
}

1.6 启动Tomcat服务器，进行测试

springmvc实际案例 springmvc入门案例_入门案例_02

2. 入门案例的执行过程及原理分析

2.1 案例的执行过程

  1. 当启动Tomcat服务器的时候，因为配置了load-on-startup标签，所以会创建DispatcherServlet对象，就会加载springmvc.xml配置文件
  2. 开启了注解扫描，那么HelloController对象就会被创建
  3. 从index.jsp发送请求，请求会先到达DispatcherServlet核心控制器，根据配置@RequestMapping注解找到执行的具体方法
  4. 根据执行方法的返回值，再根据配置的视图解析器，去指定的目录下查找指定名称的JSP文件
  5. Tomcat服务器渲染页面，做出响应

2.2 SpringMVC 的请求响应流程

springmvc实际案例 springmvc入门案例_RequestMapping_03

3. 入门案例中涉及的组件

3.1 DispatcherServlet：前端控制器

用户请求到达前端控制器，它就相当于 mvc 模式中的 c，dispatcherServlet 是整个流程控制的中心，由它调用其它组件处理用户的请求，dispatcherServlet 的存在降低了组件之间的耦合性

3.2 HandlerMapping：处理器映射器

HandlerMapping 负责根据用户请求找到 Handler 即处理器，SpringMVC 提供了不同的映射器实现不同的映射方式，例如：配置文件方式，实现接口方式，注解方式等

3.3 Handler：处理器

它就是我们开发中要编写的具体业务控制器。由DispatcherServlet 把用户请求转发到 Handler。由Handler 对具体的用户请求进行处理。

3.4 HandlAdapter：处理器适配器

通过 HandlerAdapter 对处理器进行执行，这是适配器模式的应用，通过扩展适配器可以对更多类型的处理器进行执行

3.5 View Resolver：视图解析器

View Resolver 负责将处理结果生成 View 视图，View Resolver 首先根据逻辑视图名解析成物理视图名即具体的页面地址，再生成 View 视图对象，最后对 View 进行渲染将处理结果通过页面展示给用户

3.6 View：视图

SpringMVC 框架提供了很多的 View 视图类型的支持，包括：jstlView、freemarkerView、pdfView等。我们最常用的视图就是 jsp

一般情况下需要通过页面标签或页面模版技术将模型数据通过页面展示给用户，需要由程序员根据业务需求开
发具体的页面。

3.7 <mvc:annotation-driven>说明

在 SpringMVC 的各个组件中，处理器映射器、处理器适配器、视图解析器称为 SpringMVC 的三大组件。

使 用 <mvc:annotation-driven> 自动加载 RequestMappingHandlerMapping （处理映射器） 和RequestMappingHandlerAdapter （处理适配器），可 用 在 SpringMVC.xml 配 置 文 件 中 使 用<mvc:annotation-driven>替代注解处理器和适配器的配置。

<mvc:annotation-driven>

上面的标签相当于在 xml 中配置了：

<!-- HandlerMapping -->
<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping"></bean>
<bean class="org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping"></bean>
<!-- HandlerAdapter -->
<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter"></bean>
<bean class="org.springframework.web.servlet.mvc.HttpRequestHandlerAdapter"></bean>
<bean class="org.springframework.web.servlet.mvc.SimpleControllerHandlerAdapter"></bean>
<!-- HadnlerExceptionResolvers -->
<bean class="org.springframework.web.servlet.mvc.method.annotation.ExceptionHandlerExceptionResolver"></bean>
<bean class="org.springframework.web.servlet.mvc.annotation.ResponseStatusExceptionResolver"></bean>
<bean class="org.springframework.web.servlet.mvc.support.DefaultHandlerExceptionResolver"
></bean>

一般开发中，我们都需要写上此标签

明确：我们只需要编写处理具体业务的控制器以及视图

4. RequestMapping 注解

4.1 使用说明

  • 源码：
@Target({ElementType.METHOD, ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Mapping
public @interface RequestMapping {
}
  • 作用：用于建立请求 URL 和处理请求方法之间的对应关系
  • 属性:
  • value：用于指定请求的 URL。它和 path 属性的作用是一样的。
  • method：用于指定请求的方式。
  • headers：用于指定限制请求消息头的条件。
  • params：用于指定限制请求参数的条件。它支持简单的表达式。要求请求参数的 key 和 value 必须和配置的一模一样。

例如：
params = {“accountName”}，表示请求参数必须有accountName
params = {“moeny!100”}，表示请求参数中 money 不能是100。

4.2 使用示例

RequestMapping 注解出现的位置
  • 出现在类上：
    请求 URL 的第一级访问目录。此处不写的话，就相当于应用的根目录。写的话需要以/开头。它出现的目的是为了使我们的 URL 可以按照模块化管理:

例如：
* 账户模块：
/account/add
/account/update
/account/delete
…
* 订单模块：
/order/add
/order/update
/order/delete
前面的部分就是把 RequsetMappding 写在类上，使我们的 URL 更加精细。

  • 出现在方法上：
    请求 URL 的第二级访问目录。

控制器：

@Controller("accountController")
@RequestMapping("/account")
public class AccountController {
	@RequestMapping("/findAccount")
	public String findAccount() {
		System.out.println("查询了账户。。。。");
		return "success";
	}
}

jsp：

<!-- 第一种访问方式 -->
<a href="${pageContext.request.contextPath}/account/findAccount">查询账户</a>
<br/>
<!-- 第二种访问方式 -->
<a href="account/findAccount">查询账户</a>

当我们使用此种方式配置时，在 jsp 中第二种写法时，不要在访问 URL 前面加/，否则无法找到资源

method 属性

控制器：

@RequestMapping(value="/saveAccount",method=RequestMethod.POST)
public String saveAccount() {
	System.out.println("保存了账户");
	return "success";
}

jsp：

<!-- 请求方式的示例 -->
<a href="account/saveAccount">保存账户，get 请求</a>
<br/>
<form action="account/saveAccount" method="post">
	<input type="submit" value="保存账户，post 请求">
</form>
当使用 get 请求时，提示错误信息是 405，信息是方法不支持 get 方式请求

springmvc实际案例 springmvc入门案例_RequestMapping_04

params 属性

控制器：

@RequestMapping(value="/removeAccount",params= {"accountName", "money>100"})
public String removeAccount() {
	System.out.println("删除了账户");
	return "success";
}

jsp:

<!-- 请求参数的示例 -->
<a href="account/removeAccount?accountName=aaa&money>100">删除账户，金额 100</a>
<br/>
<a href="account/removeAccount?accountName=aaa&money>150">删除账户，金额 150</a>
当我们点击第一个超链接时,可以访问成功。
当我们点击第二个超链接时，无法访问。如下图：

springmvc实际案例 springmvc入门案例_RequestMapping_05