SpringMVC--JSON

1、JSON简介

JSON（javaScript Object Notation,JS对象标记）是一种轻量级的数据交换格式，使用较广泛。
采用完全独立于编程语言的文本格式来存储和表示数据。
简洁和清晰的层次结构使得JSON成为理想的数据交换语言。
易于阅读和编写，同时也易于机器解析和生成，并有效地提升网络传输协议。

JSON可以表示javaScript所支持的所有类型。其语法格式为：

• 对象表示为键值对，数据由逗号隔开{“name”:“姚先生”}
• 花括号保存对象
• 方括号表示数组

JSON和javaScript对象的关系：
JSON是javaScript对象的字符串表示法，它是使用文本表示一个js对象的信息，本质是一个字符串。

var obj ={s1:'hello',s2:'world'};
var json ="{"s1":"hello","s2":"world"}";//这是一个json字符串

JSON和javaScript对象转换

<script type="text/javascript">
    var user={
        name:"李先生",
        age:18
    };
    //JSON.stringify()方法；实现js对象转换为JSON字符串
    var json = JSON.stringify(user);
    console.log(json);


    //JSON.parse()方法；实现JSON字符串转换为js对象
    var obj = JSON.parse(json);
    console.log(obj);

    console.log(user)
</script>

2、jackson

jackson是目前比较好的json解析工具。
我们这块的学习使用jackson。

2.1、代码展示：

1、首先需要导入它的jar包

<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.10.0</version>
</dependency>

2、配置web.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">

    <servlet>
        <servlet-name>SpringMVC</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <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>
    <servlet-mapping>
        <servlet-name>SpringMVC</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>

    <!--过滤器-->
    <filter>
        <filter-name>encoding</filter-name>
        <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
    </filter>
    <filter-mapping>
        <filter-name>encoding</filter-name>
        <url-pattern>/</url-pattern>
    </filter-mapping>
</web-app>

3、创建springmvc的配置文件，springmvc-servlet.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
       https://www.springframework.org/schema/context/spring-context.xsd">

    <!--自动扫描指定的包-->
    <context:component-scan base-package="com.ljy.controller"/>

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

</beans>

4、创建一个实体类，User

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

5、创建测试类UserController

@Controller
public class UserController {
    @RequestMapping("/j1")
    @ResponseBody  //该注解让不走视图解析器，直接返回一个字符串
    public String json01() throws JsonProcessingException {
        ObjectMapper mapper = new ObjectMapper();
        User user = new User("李先生", 18, "男");
        String string = mapper.writeValueAsString(user);
        return string;
    }
}

6、配置Tomcat，启动测试
7、乱码解决
需要设置编码格式为utf-8，并且设置返回类型
通过@RequestMapping的produces属性来设置

@Controller
public class UserController {
    @RequestMapping(value="/j1",produces = "application/json;charset=utf-8")
    @ResponseBody   //该注解让不走视图解析器，直接返回一个字符串
    public String json01() throws JsonProcessingException {
        ObjectMapper mapper = new ObjectMapper();
        User user = new User("李先生", 18, "男");
        String string = mapper.writeValueAsString(user);
        return string;
    }
}

再次测试，结果为：

乱码解决优化

如果项目中请求多的话每一个添加都比较麻烦，所以可以通过spring自己的配置来统一指定。

    <!--乱码问题配置-->
    <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>

返回json字符串的方式

第一种：就是上面使用的在方法上面加注解@ResponseBody
第二种：在类上直接使用@RestController，这样里面所有的方法都只会返回json字符串。在前后端分离开发中，一般都使用RestController，便捷。

2.2、测试集合

    @RequestMapping("/j2")
    public String json02() throws JsonProcessingException {
        ObjectMapper mapper = new ObjectMapper();
        User user1 = new User("姚明",38,"男");
        User user2 = new User("易建联",25,"男");
        User user3 = new User("王治郅",42,"男");
        User user4 = new User("孙悦",28,"男");
        List<User> list = new ArrayList<User>();
        list.add(user1);
        list.add(user2);
        list.add(user3);
        list.add(user4);
        //将我们传入的对象解析为json格式
        String str = mapper.writeValueAsString(list);
        return str;
    }

2.3、输出时间测试

@RequestMapping("/j3")
    public String json03() throws JsonProcessingException {
        ObjectMapper mapper = new ObjectMapper();
        Date date = new Date();
        String str = mapper.writeValueAsString(date);
        return str;
    }

测试结果：
这块的这一串数字是1970年1月1日到当前时间的毫秒数。
jackson默认是会把时间转成timestamps形式

解决方案：
取消timestamps形式，自定义时间格式

    @RequestMapping("/j3")
    public String json03() throws JsonProcessingException {
        ObjectMapper mapper = new ObjectMapper();
        //不使用时间戳的方式
        mapper.configure(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS,false);
        //自定义日期格式
        SimpleDateFormat sdf = new SimpleDateFormat("yyyy-mm-dd hh:mm:ss");
        //指定日期格式
        mapper.setDateFormat(sdf);
        
        Date date = new Date();
        String str = mapper.writeValueAsString(date);
        return str;
    }

测试结果

3、Fastjson

fastjson.jar是阿里开发的一款专门用于java开发的包，可以方便的实现json对象与javaBean对象的转换，实现javaBean对象与json字符串的转换，实现json对象与json字符串的转换。

fastjson依赖

        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>fastjson</artifactId>
            <version>1.2.60</version>
        </dependency>

fastjson三个主要的类：

• JSONObject：代表json对象
• JSONArray：代表json对象数组
• JSON：代表jsonObject和jsonArray的转化