Spring Boot MVC

一、概述

本文主要基于 Spring MVC 而不是 Spring Boot

1、主流框架

image.png

2、三层架构

在JavaEE开发中,系统标准的三层架构包括:表现层、业务层、持久层。
image.png

表现层
也就是我们常说的web层。它负责接收客户端请求,向客户端响应结果,通常客户端使用http协议请求web,web需要接收http请求完成http响应。

表现层包括展示层和控制层:控制层负责接收请求,展示层负责结果的显示。表现层依赖业务层,接收到客户请求一般会调用业务层进行业务处理,并将处理结果响应给客户端。

表现层的设计一般都使用MVC模型(MVC是表现层的设计模型,和其他层没有关系)。

业务层
也就是我们常说的service层。它负责业务逻辑处理,和我们开发项目的需求息息相关。

表现层依赖业务层,但是业务层不依赖表现层。

业务层在业务处理时可能会依赖持久层,如果要对数据持久化需要保证事务一致性,事务应该放到业务层来控制。

持久层
也就是我们常说的dao层,负责数据持久化,包括数据层(数据库)和数据访问层。

数据库是对数据进行持久化的载体,数据访问层是业务层和持久层交互的接口,业务层需要通过数据访问层将数据持久化到数据库中。

3、MVC模型

MVC 全名是 Model View Controller,是模型(model)-视图(view)-控制器(controller)的缩写,是一种用于设计创建Web应用程序表现层的模式。

image.png

Model(模型)
通常指的就是我们的数据模型。作用一般就是封装数据。

View(视图)
通常用于展示数据。常见的 jsp 或者 html 就属于该模型。

Controller(控制器)
是应用程序中处理用户交互的部分。作用一般就是处理程序逻辑。

4、项目结构

示例:企业名称(upc),项目名称(sprite)
image.png

二、SpringMVC概述

image.png

1、角色划分

名称 描述
DispatcherServlet 前端控制器
HandlerMapping 请求到处理器映射
HandlerAdapter 处理器适配器
ViewResolver 视图解析器
Controller 处理器或页面控制器
Validator 验证器
命令对象 Command 请求参数绑定道德对象就叫命令对象
表单对象 Form Object 提供给表单展示和提交到的对象就叫表单对象

2、请求响应流程

TODO...

3、核心组件

DispatcherServlet(前端控制器)
它是整个流程控制的中心(不需要程序员开发,需要web.xml配置)
用户请求到达前端控制器,由它调用其它组件处理用户的请求,降低了组件之间的耦合性。

HandlerMapping(处理映射器)
负责根据用户请求找到Handler处理器(不需要程序员开发)
SpringMVC提供了不同的映射器实现不同的映射方式:

  • 配置文件方式
  • 实现接口方式
  • 注解方式。

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

HandlAdapter(处理器适配器)
通过HandlerAdapter对处理器进行执行(不需要程序员开发)
这是适配器模式的应用。通过扩展适配器可以对更多类型的处理器进行执行。

View Resolver(视图解析器)
负责将处理结果生成View视图(不需要程序原开发,只需要配置)
View Resolver 实现根据逻辑视图名解析成物理视图名即具体的页面地址,再生成View视图对象,最后对View进行渲染并将处理结果通过页面只是给用户。

View(视图)
SpringMVC 框架提供了很多的View视图类型的支持,包括:jstlView、freemarkerView、pdfView 等。

三、请求参数绑定

1、绑定机制

SpringMVC是对Servlet的进一步封装,表单中的请求参数都是基于 key=value形式的。
SpringMVC绑定请求参数的过程是通过把表单提交请求参数,作为控制器中方法参数进行绑定的。
例如:

<a href="account/findAccount?accountId=10">查询账户</a>

中请求参数是:

accountId=10

Controller实现:

@Controller
@RequestMapping("/account")
public class AccountController {

    /**
     * 查询账户
     * @param accountId
     * @return
     */
    @RequestMapping("/findAccount")
    public String findAccount(Integer accountId) {
        System.out.println("查询了账户..." + accountId);;
        return "success";
    }
}

2、支持数据类型

2.1 基本类型和String类型作为参数
● jsp代码

<!-- 基本类型示例 -->
<a href="account/findAccount?accountId=10&accountName=zhangsan">查询账户</a>

● 控制器代码

@Controller
@RequestMapping("/account")
public class AccountController {
    /**
     * 查询账户
     * @param accountId
     * @return
     */
    @RequestMapping("/findAccount")
    public String findAccount(Integer accountId, String accountName) {
        System.out.println("账户ID:" + accountId);
        System.out.println("账户名:" + accountName);
        return "success";
    }
}

2.2 POJO 类型作为参数
● jsp代码

<form action="/account/saveAccount" method="post">
    账户名称:<input type="text" name="name"/><br>
    账户金额:<input type="text" name="money"/><br>
    账户省份:<input type="text" name="address.provinceName"/><br>
    账户城市:<input type="text" name="address.cityName"/><br>
    <input type="submit" value="存钱"/>
</form>

● pojo代码

public class Account implements Serializable {
    private static final long serialVersionUID = -5563373251161427274L;
    private Integer id;
    private String name;
    private Float money;
    private Address address; // 关联类型
}
public class Address implements Serializable {
    private static final long serialVersionUID = -5238737091461947353L;
    private String provinceName;
    private String cityName;
}

● 控制器代码

@Controller
@RequestMapping("/account")
public class AccountController {
    /**
     * 保存账户
     * @param account
     * @return
     */
    @RequestMapping("/saveAccount")
    public String saveAccount(Account account) {
        System.out.println("保存了账户:" + account);
        return "success";
    }

3、乱码问题

3.1 jsp页面乱码
自带的index.jsp中文显示乱码,可在文件头添加如下语句解决:

<%@ page contentType="text/html;charset=UTF-8" language="java" %>

3.2 post请求乱码
在 web.xml 中配置一个过滤器

<!-- 配置 SpringMVC 编码过滤器 -->
<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>
<!-- 启动过滤器 -->
<init-param>
  <param-name>forceEncoding</param-name>
  <param-value>true</param-value>
</init-param>
</filter>
<!-- 过滤所有请求 -->
<filter-mapping>
<filter-name>CharacterEncodingFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>

3.3 get请求乱码
修改 tomcat 安装目录下的 /conf/server.xml 配置文件

<Connector connectionTimeout="20000" port="8080" protocol="HTTP/1.1" redirectPort="8843"/>

改为:

<Connector connectionTimeout="20000" port="8080" protocol="HTTP/1.1" redirectPort="8843" URIEncoding="UTF-8"/>

4、自定义类型转换器

第一步:定义一个类,实现 Converter 接口,该接口有两个泛型。

// 接口定义
package org.springframework.core.convert.converter;

public interface Converter<S, T> {
    T convert(S var1);
}
/**
 * @version 1.0
 * 字符串转日期的自定义类型转换器
 */

public class StringToDateConverter implements Converter<String, Date> {
    @Override
    public Date convert(String source) {
        DateFormat format = null;
        try {
            if(StringUtils.isEmpty(source)) {
                throw new NullPointerException("请输入要转换的日期");
            }
            format = new SimpleDateFormat("yyyy-MM-dd");
            Date date = format.parse(source);
            return date;
        } catch (Exception e) {
            throw new RuntimeException("输入日期有误");
        }
    }
}

第二步:在 spring 配置文件中配置类型转换器。将自定义的转换器注册到类型转换服务中去(工程的springmvc.xml添加)。

<!-- 配置类型转换器工厂 -->
<bean id="converterService"   class="org.springframework.context.support.ConversionServiceFactoryBean">
    <!-- 给工厂注入一个新的类型转换器 -->
    <property name="converters">
        <array>
            <!-- 配置自定义类型转换器 -->
            <bean class="com.upc.sprite.converter.StringToDateConverter"></bean>
        </array>
    </property>
</bean>

第三步:在 annotation-driven 标签中引用配置的类型转换服务

<!-- 引用自定义类型转换器 -->
<mvc:annotation-driven conversion-service="converterService"/>

5、使用 ServletAPI 对象作为方法参数

SpringMVC 支持使用原始 ServletAPI 对象作为控制器方法的参数,支持的对象有:

HttpSession
HttpServletRequest
HttpServletResponse
InputStream
OutputStream
Reader
Writer
Locale
java.security.Principal

我们可以把上述对象,直接写在控制的方法参数中使用,不分顺序。
● jsp 代码

<!-- 原始 ServletAPI 作为控制器参数 -->
<a href="account/testServletAPI">测试访问 ServletAPI</a>

● 控制器中的代码

@RequestMapping("/testServletAPI")
public String testServletAPI(HttpSession session, HttpServletRequest request, HttpServletResponse response) {
    System.out.println(request);
    System.out.println(response);
    System.out.println(session);
    System.out.println(session.getServletContext());
    return "success";
}

四、常用注解

1、RequestMapping

用来处理请求地址映射,共有6个属性,可用于类或者方法上。用于类上,表示类中的所有响应请求的方法都是以该地址作为父路径。

value 属性
指定请求的实际地址,指定的地址可以是URI Template模式。只有这一个属性时可省略value字段,多个属性时必须显式写出value属性。

method 属性
指定请求的method类型,GET、POST、PUT、DELETE等。

consumes 属性
指定处理请求的提交内容类型(Content-Type),例如application/json,text/html。

produces 属性
指定返回的内容类型,仅当request请求头中的(Accept)类型中包含该指定类型才返回。

params 属性
指定request中必须包含某些参数值才让该方法处理。

headers 属性
指定request中必须包含某些指定的header值,才能让该方法处理请求。

params 属性示例

TODO... Restful 风格

2、RequestParam

将请求参数绑定到你控制器的方法参数上,共有3个属性。

value
指定请求参数名,必须配置。

required
指定是否必须,默认值为true。即请求中必须包含该参数,如果没有则抛出异常。

defaultValue
指定参数默认值。如果设置了该值,required将自动设为false。如果没有传该参数,就是用默认值。

3、RequestHeader

4、RequestBody

5、PathVariable

6、CookieValue

7、ModelAttribute

8、SessionAttribute

参考资料

Tomcat部署时war和war exploded区别
Content-type 对照表
HTTP 状态码详解
Spring @RequestParam注解的使用
附件1:SpringMVC_02基础框架(提取码:zd50)
附件2:SpringMVC_03参数绑定(提取码:gsxu)

评论

暂无评论