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

发布时间:2023年12月21日

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 中进行配置

<!-- 配置 SpringMVC 的乱码过滤器 -->
<filter>
    <filter-name>encoding</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>encoding</filter-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 目录
<!-- jackson-databind -->
<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.14.1</version>
</dependency>
  • 配置 web.xmlspring-mvc.xml (通过配置处理乱码问题)
<?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">

    <!-- 配置 DispatcherServlet 前端控制器 -->
    <servlet>
        <servlet-name>springmvc</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <!-- DispatcherServlet 绑定 Spring 的配置文件 -->
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:spring-mvc.xml</param-value>
        </init-param>
        <!-- 启动级别:1,和服务器一起启动 -->
        <load-on-startup>1</load-on-startup>
    </servlet>

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


    <!-- 配置 SpringMVC 的乱码过滤器 -->
    <filter>
        <filter-name>encoding</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>encoding</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>

</web-app>
<?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"
       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">

    <!-- 自动扫描包,让指定包下的注解生效,由 IOC 容器统一管理 -->
    <context:component-scan base-package="com.Sun3285"/>

    <!-- 让 SpringMVC 不处理静态资源 -->
    <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>

    <!-- JSON 乱码问题配置 -->
    <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 字符串。

需要导入的依赖如下:

<!-- fastjson2 -->
<dependency>
    <groupId>com.alibaba.fastjson2</groupId>
    <artifactId>fastjson2</artifactId>
    <version>2.0.23</version>
</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 域,数据在一次会话中有效,重定向时也可以得到数据。
文章来源:https://blog.csdn.net/taiyang3285/article/details/135133563
本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。