【SpringMVC从看懂到看开】6 - JSON（完整项目版）

11 JSON

11.1 什么是JSON

• JSON，JavaScript Object Notation，JavaScript对象简谱，一般用英文缩写JSON/ˈdʒeɪsən/来表达
• JSON是一种轻量级的数据交换格式
• 特点
  • 轻量（相较于xml）
  • 独立于编程语言
  • 易于阅读
  • 易于机器解析和生成

11.2 JSON的组成

JSON组成有

• 对象
• 数组
• 字符串
• 数字
• 三个字面量：true、false、null（注意只能小写）

表达：

• { }：表示对象，内部只能由key : value组成
• [ ]：表示数组，内部由一个个值组成，值之间由逗号,分开
• 对象可以嵌套数组、数组也可以嵌套对象

实例：几个合法的JSON表达式

• {"a": 1, "b": [1, 2, 3]}
• [1, 2, "3", {"a": 4}]
• 3.14
• "plain_text"

11.3 JavaScript对象和JSON之间的转换

JSON对于JavaScript来说就是一个字符串，只是它含有数据信息
下面我们使用JavaScript内置的一个JSON对象的两个方法来转换JavaScript对象和JSON：

• JSON.parse()：JSON -->JavaScript对象
• JSON.JSON.stringify() JavaScript对象 -->JSON

    <script>
        let json = '[[1, 2, 3],{"Address":{"province":"广东","city":"汕头"}}]';
        let json2obj = JSON.parse(json);
        console.log(json2obj);
        console.log('###################')
        let obj2json = JSON.stringify(json2obj);
        console.log(json);
    </script>

结果可以得到

11.4 建立测试环境

整个工程结构如下

首先创建工程，并添加框架支持
在pom.xml中导入相关依赖

    <dependencies>
        <!-- spring-webmvc依赖 -->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
            <version>5.2.7.RELEASE</version>
        </dependency>


        <!-- servlet依赖 -->
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>servlet-api</artifactId>
            <version>2.5</version>
            <scope>provided</scope>
        </dependency>

        <!-- jsp依赖 -->
        <dependency>
            <groupId>javax.servlet.jsp</groupId>
            <artifactId>jsp-api</artifactId>
            <version>2.2</version>
            <scope>provided</scope>
        </dependency>


        <!-- jackson依赖 -->
        <dependency>
            <groupId>com.fasterxml.jackson.core</groupId>
            <artifactId>jackson-databind</artifactId>
            <version>2.11.1</version>
        </dependency>

        <!-- Lombok依赖 -->
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <version>1.18.2</version>
        </dependency>

    </dependencies>

在web.xml中配置DispatcherServlet和Filter过滤器

<?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">
    <!--1.注册DispatcherServlet-->
    <servlet>
        <servlet-name>SpringMVC</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <!--通过初始化参数指定SpringMVC配置文件的位置，进行关联-->
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:springmvc-servlet.xml</param-value>
        </init-param>
        <!-- 启动顺序，数字越小，启动越早 -->
        <load-on-startup>1</load-on-startup>
    </servlet>

    <!--所有请求都会被springmvc拦截 -->
    <servlet-mapping>
        <servlet-name>SpringMVC</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>

    <!-- 2. Filter过滤器 -->
    <filter>
        <filter-name>encodingFilter</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>encodingFilter</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>
</web-app>

在resources下新建springmvc-servlet.xml，配置视图解析器和其他支持mvc注解驱动

<?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
       http://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.cap.controller"/>
    <!-- 让Spring MVC不处理静态资源 -->
    <mvc:default-servlet-handler />
    <!--
    支持mvc注解驱动
        在spring中一般采用@RequestMapping注解来完成映射关系
        要想使@RequestMapping注解生效
        必须向上下文中注册DefaultAnnotationHandlerMapping
        和一个AnnotationMethodHandlerAdapter实例
        这两个实例分别在类级别和方法级别处理。
        而annotation-driven配置帮助我们自动完成上述两个实例的注入。
     -->
    <mvc:annotation-driven />

    <!-- 视图解析器 -->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"
          id="internalResourceViewResolver">
        <!-- 前缀 -->
        <property name="prefix" value="/WEB-INF/jsp/" />
        <!-- 后缀 -->
        <property name="suffix" value=".jsp" />
    </bean>

</beans>

新建控制器JsonController

package com.cap.controller;

import org.springframework.stereotype.Controller;

/**
 * @author cap
 */
@Controller
public class JsonController {
}

新建实体类User

package com.cap.pojo;

import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;

@Data
@AllArgsConstructor
@NoArgsConstructor
public class User {
    private int id;
    private String name;
    private String sex;
}

在tomcat上部署项目
在项目中添加lib，导入依赖

11.5 Jackson

市面上有很多用来处理Java对象和Json之间转化的工具，有Jackson、Gson等等，这里我们使用Jackson为例
首先导入Jackson依赖

<!-- jackson依赖 -->
<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.11.1</version>
</dependency>

11.5.1 Jackson处理对象

编写方法

@Controller
public class JsonController {
    @ResponseBody //跳过视图解析器，直接返回字符串
    @RequestMapping("/jc/jc1")
    public String tester() throws JsonProcessingException {
        //Jackson提供的读、写JSON的对象
        ObjectMapper objectMapper = new ObjectMapper();
        User user = new User(1, "张三", "男");
        return objectMapper.writeValueAsString(user);
    }
}

结果得到

11.5.2 处理JSON乱码问题的两种方式

发现出现了乱码问题，我们需要设置一下他的编码格式为utf-8，以及它返回的类型；

通过@RequestMaping的produces属性来实现，修改下代码

@RequestMapping(value = "/json1",produces = "application/json;charset=utf-8")

上一种处理乱码的方式比较麻烦，每一个方法都要复写一遍，可以在springmvc-servlet.xml中同一配置

<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>

11.5.3 Jackson处理时间

    @ResponseBody //跳过视图解析器，直接返回字符串
    @RequestMapping(value = "/jc/jc2",produces = "application/json;charset=utf-8")
    public String tester2(){
        ObjectMapper objectMapper = new ObjectMapper();
        Date date = new Date();
        SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
        return sdf.format(date);

    }

不使用时间戳的方式

    @ResponseBody //跳过视图解析器，直接返回字符串
    @RequestMapping(value = "/jc/jc2",produces = "application/json;charset=utf-8")
    public String tester2() throws JsonProcessingException {
        ObjectMapper objectMapper = new ObjectMapper();
        objectMapper.configure(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS, false);
        Date date = new Date();
        SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
        objectMapper.setDateFormat(sdf);
        return objectMapper.writeValueAsString(date);

    }