SpringMVC：RestFul 风格、实现请求转发和重定向、乱码问题解决、前后端传递参数、JSON 字符串

SpringMVC - 02

一、RestFul 风格

1. 概述

1. RestFul 是一个资源定位以及资源操作的风格；

2. 基于 RestFul 风格设计的软件更简洁，更有层次，更易于实现缓存等机制；

3. 相同的请求地址，通过不同的请求方式操作资源可以实现不同的效果，请求方式有：POST（添加）、DELETE（删除）、PUT（修改）、GET（查询）；

4. 所有地址栏的请求方式默认为 GET 类型；

5. 用到的注解有：

注解	说明
@PathVariable	让方法参数的值对应绑定到一个 URL 模板变量上
@RequestMapping(value = “请求地址”, method = RequestMethod.请求方式)	通过指定的请求方式请求地址
@GetMapping(“请求地址”)	组合注解，通过 Get 方式请求地址
@PostMapping(“请求地址”)	组合注解，通过 Post 方式请求地址

注意：

1. 注解 @PathVariable 声明在指定参数上，这样就可以在请求地址中用 {参数} 与方法中的指定参数绑定；
2. 注解 @GetMapping、@PostMapping、@DeleteMapping、@PutMapping 等是组合注解，声明在方法上，是对 @RequestMapping 注解的简化，作用都是：通过指定的请求方法来请求地址。

2. 实现

实现 RestFul 风格方法：

• 将注解 @PathVariable 声明在指定参数上；
• 指定请求方式来请求地址：
  • 方式一：使用注解 @RequestMapping 中的 method 属性来指定请求方式，注意：此时需要在请求地址前加上 value ；
  • 方式二：使用组合注解 @GetMapping、@PostMapping 等来指定请求方式。

3. 结果

之前在前端传入参数时，用 ? 传参，多个参数之间用 & 连接

现在使用 RestFul 风格传入参数，不需要写参数名

---

二、请求转发和重定向

通过 SpringMVC 实现请求转发和重定向方法：

• 请求转发：return + "页面名"

• 重定向：return + "redirect:/页面名.jsp"

注意：

1. 请求转发时，视图解析器会自动在页面名上添加前缀和后缀，从而形成一个完成的路径；
2. 重定向时，不能访问 WEB-INF 下的页面。

请求转发

重定向

---

三、乱码问题

可能出现乱码的原因：

• 后台编码存在问题；
• 提交方式不同导致乱码，如用 GET 方式提交时不乱码，而用 POST 方式提交时乱码。

解决方法：使用 SpringMVC 提供的乱码过滤器，在 web.xml 中进行配置

<filter>
    <filter-name>encodingfilter-name>
    <filter-class>org.springframework.web.filter.CharacterEncodingFilterfilter-class>
    <init-param>
        <param-name>encodingparam-name>
        <param-value>utf-8param-value>
    init-param>
filter>
<filter-mapping>
    <filter-name>encodingfilter-name>
    <url-pattern>/*url-pattern>
filter-mapping>

举例：用 POST 方式提交表单时显示乱码，通过配置过滤器解决乱码问题。

出现乱码

配置过滤器解决乱码问题

---

补充知识

1. 出现乱码的原因还可能是客户端乱码，此时，只需要改变客户端界面显示的编码即可。
2. 解决 Tomcat 显示的乱码方法：找到 Tomcat\apache-tomcat-8.5.85\conf 路径：
   • 打开 server.xml 文件，在 Connector 标签中添加属性 URIEncoding = "UTF-8" ；
   • 打开 logging.properties 文件，注释掉之前的，并增加 java.util.logging.ConsoleHandler.encoding = GBK 。

---

四、前后端传递参数

接收请求参数三种情况：

1. 提交的域名称和处理方法的参数名一致：不需要处理；
2. 提交的域名称和处理方法的参数名不一致：在处理方法的参数前加注解 @RequestParam 声明；
3. 提交的是一个对象，处理方法的参数也使用对象：要求提交的名称与对象的属性名一一对应。

数据回显可以使用的三种对象：

1. Model ：相当于 ModelMap 的精简版，经常使用；
2. ModelMap ：继承了 LinkedHashMap，拥有 LinkedHashMap 的全部功能；
3. ModelAndView ：可以存储数据的同时，也可以设置返回的逻辑视图，进行页面的跳转。

注意：注解 @PathVariable 和 @RequestParam 的区别：

• 相同点：都是声明在方法的参数上；
• 不同点：
  • @PathVariable 是 RestFul 风格中使用，让方法参数的值对应绑定到一个 URL 模板变量上，此时需要在请求地址中用 {参数} 与方法中的指定参数绑定，使用见第一部分；
  • @RequestParam 可以解决提交的域名称与方法的参数名不一致时，接收不到参数的问题，最好都写上，使用见第三部分。

---

五、JSON

1. 概述

1. JSON：JavaScript Object Notation，JS 对象标记，是一种轻量级的数据交换格式，在前后端分离中使用广泛；
2. JSON 采用文本格式来存储和表示数据；
3. JSON 就是一个字符串，格式为：键名用双引号包裹，使用冒号分隔，然后是值，例如：{"name":"Sun3285","age":23} ；
4. 优点：易于阅读和编写，也易于机器解析和生成，提升了网络传输效率；
5. 使用 JSON 要记得处理乱码问题；
6. 实现 JSON 的转换方法有很多，最后的实现结果是一样的，其中 Jackson 是目前比较好的 JSON 解析工具。

2. Jackson

使用 Jackson 需要用到 ObjectMapper 对象，分为两步：

1. 创建 ObjectMapper 对象：ObjectMapper mapper = new ObjectMapper() ；
2. 对象调用 writeValueAsString 方法将任意对象转换为 JSON 字符串：mapper.writeValueAsString(object) 。

具体步骤：

• 新建普通 Maven 模块，转为 Web 项目，导入 jackson-databind 依赖，在项目结构中添加 lib 目录

<dependency>
    <groupId>com.fasterxml.jackson.coregroupId>
    <artifactId>jackson-databindartifactId>
    <version>2.14.1version>
dependency>

• 配置 web.xml 和 spring-mvc.xml （通过配置处理乱码问题）

<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>springmvcservlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServletservlet-class>
        
        <init-param>
            <param-name>contextConfigLocationparam-name>
            <param-value>classpath:spring-mvc.xmlparam-value>
        init-param>
        
        <load-on-startup>1load-on-startup>
    servlet>

    <servlet-mapping>
        <servlet-name>springmvcservlet-name>
        <url-pattern>/url-pattern>
    servlet-mapping>


    
    <filter>
        <filter-name>encodingfilter-name>
        <filter-class>org.springframework.web.filter.CharacterEncodingFilterfilter-class>
        <init-param>
            <param-name>encodingparam-name>
            <param-value>utf-8param-value>
        init-param>
    filter>
    <filter-mapping>
        <filter-name>encodingfilter-name>
        <url-pattern>/*url-pattern>
    filter-mapping>

web-app>

<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"
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
        https://www.springframework.org/schema/beans/spring-beans.xsd
        http://www.springframework.org/schema/context
        https://www.springframework.org/schema/context/spring-context.xsd
        http://www.springframework.org/schema/mvc
        https://www.springframework.org/schema/mvc/spring-mvc.xsd">

    
    <context:component-scan base-package="com.Sun3285"/>

    
    <mvc:default-servlet-handler/>

    
    <mvc:annotation-driven/>

    
    <bean id="internalResourceViewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        
        <property name="prefix" value="/WEB-INF/jsp/"/>
        
        <property name="suffix" value=".jsp"/>
    bean>

    
    <mvc:annotation-driven>
        <mvc:message-converters register-defaults="true">
            <bean class="org.springframework.http.converter.StringHttpMessageConverter">
                <constructor-arg value="UTF-8"/>
            bean>
            <bean class="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter">
                <property name="objectMapper">
                    <bean class="org.springframework.http.converter.json.Jackson2ObjectMapperFactoryBean">
                        <property name="failOnEmptyBeans" value="false"/>
                    bean>
                property>
            bean>
        mvc:message-converters>
    mvc:annotation-driven>

beans>

• 编写控制类，在方法中新建一个 ObjectMapper 对象，调用方法将任意对象转换为 JSON 字符串

注意：这里也可以把重复代码封装到工具类中，从而调用方法来得到 JSON 字符串。

• 配置 Tomcat，运行

3. fastjson

fastjson 是阿里开发的 jar 包，也可以得到 JSON 字符串。

需要导入的依赖如下：

<dependency>
    <groupId>com.alibaba.fastjson2groupId>
    <artifactId>fastjson2artifactId>
    <version>2.0.23version>
dependency>

可以调用的方法有：

方法名	说明
toJSONString(Object object)	静态方法，将 Java 对象转为 JSON 字符串
parseObject(String str, Class objectClass)	静态方法，将 JSON 字符串转为 Java 对象

注意：

1. 两个方法都为静态方法，由 JSON 类直接调用；
2. parseObject 方法中的第二个参数为 Class 类，如：User.class ；
3. JSON 类中还有其他方法，用到的时候去查。

使用

4. 总结

1. JSON 就是一个字符串；

2. 使用 JSON 要记得处理乱码问题，在 spring-mvc.xml 配置文件中统一配置；

3. 用到的注解：

   • @RestController ：声明在类上，作用：表示这个类是控制类，并且其中所有方法的返回值都不会经过视图解析器，而是直接返回一个字符串，相当于注解 @Controller 和 @ResponseBody 的结合；
   • @ResponseBody ：声明在方法上，作用：方法中的返回值不会经过视图解析器，而是直接返回一个字符串，和注解 @Controller 配合使用。

---

注意：

1. SpringMVC 默认将数据放在 request 域中，例如，用 Model 对象保存数据，会将数据放在 request 域中，数据只在一次请求中有效，此时在重定向时，就不会得到保存的数据。解决办法：可以在控制类上加注解 @SessionAttributes("变量") 声明，这样就会将变量存放在 session 域，数据在一次会话中有效，重定向时也可以得到数据。