spring LibreOffice 实现在线编辑

Spring MVC

Spring MVC是目前主流的实现MVC设计模式的企业级开发框架，Spring框架的一个子模块，无需整合Spring，开发起来更加便捷。

什么是MVC设计模式？

将应用程序分为Controller、Model、View三层，Controller 接收客户端请求，调用 Model 生成业务数据，传递给View。

Spring MVC 就是对这套流程的封装，屏蔽了很多底层代码，开放出接口，让开发者可以更加轻松、便捷地完成基于MVC设计模式的Web开发。

Spring MVC的核心组件

• DispatcherServlet：前置控制器，是整个流程控制的核心，控制其他组件的执行，进行统一调度，降低组件之间的耦合性，相当于总指挥；
• Handler：处理器，完成具体的业务逻辑，相当于 Servlet；
• HandlerMapping：DispatcherServlet 接收到请求之后，通过 HandlerMapping 将不同的请求映射到不同的Handler；
• HandlerInterceptor：处理器拦截器，是一个接口，如果需要完成一些拦截处理，可以实现该接口；
• HandlerExecutionChain：处理器执行链，包括两部分内容：Handler 和 HandlerInterceptor （系统会有一个默认的 HandlerInterceptor，如果需要额外设置拦截，可以添加拦截器）；
• HandlerAdapter：处理器适配器，Handler 执行业务方法之前，需要进行一系列的操作，包括表单数据的验证、数据类型的转换、将表单数据封装到 JavaBean 等，这些操作都是由 HandlerAdapter 来完成，开发者只需要将注意力集中业务逻辑的处理上（适配器设计模式），DispatcherServlet 通过 HandlerAdapter 来执行不同的Handler；
• ModelAndView：装载了模型数据和视图信息，作为 Handler 的处理结果，返回给 DispatcherServlet ；
• ViewResolver：视图解析器，DispatcherServlet 通过它将逻辑视图解析为物理视图，最终将渲染结果响应给客户端。

Spring MVC的工作流程

• 客户端请求被 DispatcherServlet 接收；
• 根据 HandlerMapping 映射到Handler；
• 生成 Handler 和 HandlerInterceptor；
• Handler 和 HandlerInterceptor 以 HandlerExecutionChain 的形式一并返回给 DispatcherServlet；
• DispatcherServlet 通过 HandlerAdapter 来调用 Handler 的方法来完成业务逻辑处理；
• Handler 返回一个 ModelAndView 给 DispatcherServlet；
• DispatcerServlet 将获取的 ModelAndView 对象传给 ViewResolver 视图解析器，将逻辑视图解析为物理视图 View；
• ViewResolver 返回一个View 给 DispatcherServlet；
• DispatcherServlet 根据 View 进行视图渲染（将模型数据 Model 填充到视图 View 中）；
• DispatcherServlet 将渲染后的结果响应给客户端。

Spring MVC 流程非常复杂，实际开发中很简单，因为大部分的组件不需要开发者创建、管理，只需要通过配置文件的方式完成配置即可，真正需要开发者进行处理的只有 Handler、View。

如何使用？

• 创建 Maven 工程，pom.xml；

（当IDEA工具左侧不显示项目名称，可以关闭IDEA，删除.idea文件夹，重新打开IDEA）

（利用webapp模板创建的Web工程目录，src/main/webapp，java源文件目录和resources资源目录需要自己创建）

<dependencies>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-webmvc</artifactId>
        <version>5.2.9.RELEASE</version>
    </dependency>
</dependencies>

• 在web.xml中配置 DispatcherServlet ；

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee
                      http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
         version="4.0">
  <servlet>
    <servlet-name>dispatcherServlet</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>
  </servlet>
  <servlet-mapping>
    <servlet-name>dispatcherServlet</servlet-name>
    <url-pattern>/</url-pattern>
  </servlet-mapping>
</web-app>

• 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"
       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">
    <!--配置自动扫描，将组件扫描到IoC容器中-->
    <context:component-scan base-package="org.westos"></context:component-scan>

    <!--配置视图解析器-->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/"/>
        <!--value="/"代表根目录-->
        <property name="suffix" value=".jsp"/>
    </bean>
</beans>

• 创建 Handler

package org.westos.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;

/**
 * @author lwj
 * @date 2020/12/13 22:29
 */
@Controller
public class HelloHandler {

    @RequestMapping("/index")
    public String index() {
        System.out.println("执行了index...");
        return "index";
    }
}

• 配置Tomcat服务器，启动，运行，成功。

http://localhost:8080/index

Spring MVC 注解

• @RequestMapping

Spring MVC 通过 @RequestMapping 注解将 URL 请求与业务方法进行映射，在 Handler 的类定义处和方法定义处都可以添加 @RequestMapping ，在类定义处添加，相当于客户端多了一层访问路径；

• @Controller

@Controller 在类定义处添加，将该类交给 IoC 容器来管理（结合 springmvc.xml 的自动扫描配置使用），同时使其成为一个控制器，可以接收客户端请求；

package org.westos.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;

/**
 * @author lwj
 * @date 2020/12/13 22:29
 */
@Controller
@RequestMapping("/hello")
public class HelloHandler {

    @RequestMapping("/index")
    public String index() {
        System.out.println("执行了index...");
        return "index";
    }
}

http://localhost:8080/hello/index

• @RequestMapping 相关参数

1、value：指定URL请求的实际地址，是 @RequestMapping 的默认值。

@RequestMapping("/index")
public String index() {
    System.out.println("执行了index...");
    return "index";
}

等于

@RequestMapping(value = "/index")
public String index() {
    System.out.println("执行了index...");
    return "index";
}

2、method：指定请求的Method类型，GET、POST、PUT、DELETE。

@RequestMapping(value = "/index", method = RequestMethod.GET)
public String index() {
    System.out.println("执行了index...");
    return "index";
}

上述代码表示 index 方法只可以接收 GET 请求。

使用Postman工具来模拟一个POST请求访问index方法。

3、params：指定请求中必须包含某些参数，否则无法调用该方法。

@RequestMapping(value = "/index", method = RequestMethod.GET, params = {"name", "id=5"})
public String index() {
    System.out.println("执行了index...");
    return "index";
}

上述代码表示请求中必须包含 name 和 id 两个参数，并且 id 的值必须是5。

http://localhost:8080/hello/index?name=zhangsan&id=5

关于参数绑定，在形参列表中通过添加 @RequestParam 注解完成 HTTP 请求参数与业务方法形参的映射。

（当请求参数名和方法形参名一致时，可以不用添加 @RequestParam 注解）

@RequestMapping(value = "/index", method = RequestMethod.GET, params = {"name", "id=5"})
public String index(@RequestParam("name") String str, @RequestParam("id") int age) {
    System.out.println("执行了index...");
    System.out.println(str);
    System.out.println(age);
    return "index";
}

上述代码表示将请求的参数 name 和 id 分别赋给形参 str 和 age，同时自动完成了数据类型转换，将字符串"10"转换为 int 类型的10，再赋给 age，这些工作都是由 HandlerAdapter 完成。

Spring MVC 同时支持 RESTful 风格的 URL 。

传统类型：http://localhost:8080/hello/index?name=zhangsan&id=5

RESTful：http://localhost:8080/hello/rest/zhangsan/10

@RequestMapping(value = "/rest/{name}/{id}")
public String rest(@PathVariable("name") String name, @PathVariable("id") int id) {
    System.out.println(name);
    System.out.println(id);
    return "index";
}

通过 @PathVariable 注解完成请求参数与形参的映射。

• 映射 Cookie

Spring MVC 通过映射可以直接在业务方法中获取Cookie的值。

@RequestMapping(value = "/cookie")
public String cookie(@CookieValue(value = "JSESSIONID") String sessionId) {
    System.out.println(sessionId);
    return "index";
}

• 使用 JavaBean 绑定参数

Spring MVC 会根据请求参数名和 JavaBean 属性名进行自动匹配，自动为对象填充属性值，同时支持级联属性。

package org.westos.entity;

import lombok.Data;

/**
 * @author lwj
 * @date 2020/12/19 15:57
 */
@Data
public class Address {
    private String value;
}
package org.westos.entity;

import lombok.Data;

/**
 * @author lwj
 * @date 2020/12/19 15:58
 */
@Data
public class User {
    private long id;
    private String name;
    private Address address;
}
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Title</title>
</head>
<body>
    <%--页面上的路径与重定向是需要添加Web项目的上下文路径的--%>
    <form action="/hello/register" method="post">
        <label for="id">用户id：</label>
        <input type="text" name="id" id="id"> <br>
        <label for="name">用户名：</label>
        <input type="text" name="name" id="name"> <br>
        <label for="value">用户地址：</label>
        <input type="text" name="address.value" id="value"> <br>
        <input type="submit" value="注册">
    </form>
</body>
</html>
@RequestMapping(value = "/register", method = RequestMethod.POST)
public String register(User user) {
    System.out.println(user);
    return "index";
}

上述会出现中文乱码问题，只需在 web.xml 中添加 Spring MVC 自带的过滤器即可。

<filter>
    <filter-name>characterEncodingFilter</filter-name>
    <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
    <init-param>
        <param-name>encoding</param-name>
        <param-value>UTF-8</param-value>
    </init-param>
</filter>
<filter-mapping>
    <filter-name>characterEncodingFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

JSP 页面的转发与重定向

Spring MVC 默认是以转发的形式响应 jsp页面。

1. 转发

@RequestMapping("/forward")
public String forward() {
    return "forward:/index.jsp";
    //return "index";
}

1. 重定向

@RequestMapping("/redirect")
public String redirect() {
    return "redirect:/index.jsp";
}