文件解析 （JSON解析）

一.什么是JSON

JSON是一种轻量级的数据交换格式，它基于ECMAScript的一个子集，采用完全独立于编程语言的文本格式来存储和表示数据。简洁和清晰的层次结构使得JSDN成为理想的数据交换语言。易于人阅读和理解，同时也易于机器解析和生成，并有效提高网络传输效率。

二.JSON语法

使用大括号 { } 保存对象，每个对象由若干数据组成
每个数据由 key : value 键值对组成
数据之间使用逗号 , 分隔
使用 \ 进行特殊字符的转义

{"key1" : value1,"key1" : value1,......"keyN" : valueN}

使用中括号**[ ]**保存数组(集合)，数组(集合)…可包含多个对象

[{"key1" : value1,"key1" : value1,......"keyN" : valueN},
{"key1" : value1,"key1" : value1,......"keyN" : valueN},
......]

data:[{"key1" : value1,"key1" : value1,......"keyN" : valueN},
{"key1" : value1,"key1" : value1,......"keyN" : valueN},
......]

三.JSON的用途
JSON作为一种轻量级的数据交换格式，它的用途主要是在计算机系统之间进行数据的传递，它有以下几个优点：

·JSON只允许使用**UTF-8**编码，不存在编码问题；
·JSON内容仅包含**key-value**键值对，格式简单，不存在冗余结构，是一种轻量级结构；
·浏览器内置JSON支持，如果把数据用JSON发送给浏览器，可以用**JavaScript**直接处理；

所以，开发Web应用时，使用JSON作为数据传输，在浏览器端非常方便。JSON天生适合JavaScript处理，所以，绝大多数RESTAPI都选择JSON作为数据传输格式。

四.Java解析JSON
使用第三方库来进行JSON文件格式数据的解析
常用的用于解析JSON的第三方库有：

·Jackson
·Gson
·Fastjson

Fastjson

Fastjson是阿里巴巴的开源JSON解析库，它可以解析JSON格式的字符串，支持将java对象系列化为json格式的数据，也可以将json格式的字符串反序列成Java对象。

Fastjson优点：
速度快
使用广泛
测试完备(有多个testcase，每次发布逗号进行回归测试，保证质量稳定)
使用简单(fastjson的API十分简洁)
功能完备(支持泛型，支持流处理超大文本，支持枚举，支持序列化和反序列化扩展)

.Fastjson的主要对象：主要使用JSON，JSONObject，JSONArray三个类，其中JSONObject 和
JSONArray 继承JSON。

JSON类:
JSON类的作用是用于原始转换，常用方法有：

1. 将java对象****序列化为json格式的数据:

   JSON.toJSONString(Object object);

        // 实体数据
		Weather weather = new Weather();
		weather.setCity("西安");
		weather.setComfort_index("非常舒适");
		weather.setDate_y("2022年07月10日");

		// 转换为json格式的字符串( 序列化)
		String json = JSON.toJSONString(weather);
		System.out.println(json);

2. 将json格式的字符串反序列成Java对象

①. JSONObject类：
主要用于封装key-value键值对数据，它继承了LinkedHashMap接口。

**** JSON.parseObject()****

// json格式数据
String jsonStr = "{\"temperature\":\"29℃~41℃\",\"weather\":\"多云转阴\",\"weather_id\":{\"fa\":\"01\",\"fb\":\"02\"},\"wind\":\"东北风微风\",\"week\":\"星期日\",\"city\":\"西安\",\"date_y\":\"2022年07月10日\",\"dressing_index\":\"炎热\",\"dressing_advice\":\"天气炎热，建议着短衫、短裙、短裤、薄型T恤衫等清凉夏季服装。\",\"uv_index\":\"中等\",\"comfort_index\":\"\",\"wash_index\":\"较适宜\",\"travel_index\":\"较不宜\",\"exercise_index\":\"较不宜\",\"drying_index\":\"\"}";

// 转换成JSONObject
JSONObject jsonObj = JSON.parseObject(jsonStr);
System.out.println("日期：" + jsonObj.getString("date_y"));
System.out.println("城市：" + jsonObj.getString("city"));
System.out.println("天气：" + jsonObj.getString("weather"));
System.out.println("温度：" + jsonObj.getString("temperature"));

②. JSONArray类：
JSONArray类主要用于封装数组集合类的数据，它继承自ArrayList类

JSON.parseArray()

// json格式数据
String jsonStr =  "{\r\n" + 
				"\r\n" + 
				"	\"title\": \"上海市政派出所信息\",\r\n" + 
				"	\"list\": [{\r\n" + 
				"		\"name\": \"文保分局沪东高校派出所\",\r\n" + 
				"		\"addr\": \"中山北一路801号\",\r\n" + 
				"		\"tel\": \"22027732\"\r\n" + 
				"	}, {\r\n" + 
				"		\"name\": \"文保分局沪西高校派出所\",\r\n" + 
				"		\"addr\": \"芙蓉江路55号\",\r\n" + 
				"		\"tel\": \"62751704\"\r\n" + 
				"	}, {\r\n" + 
				"		\"name\": \"水上公安局吴淞水上派出所\",\r\n" + 
				"		\"addr\": \"淞浦路187号\",\r\n" + 
				"		\"tel\": \"56671442\"\r\n" + 
				"	}, {\r\n" + 
				"		\"name\": \"水上公安局杨浦水上派出所\",\r\n" + 
				"		\"addr\": \"杨树浦路1291号\",\r\n" + 
				"		\"tel\": \"65898004\"\r\n" + 
				"	}, {\r\n" + 
				"		\"name\": \"水上公安局外滩水上派出所\",\r\n" + 
				"		\"addr\": \"中山东二路8弄3号\",\r\n" + 
				"		\"tel\": \"63305388\"\r\n" + 
				"	}]\r\n" + 
				"}";

// 转换成JSONArray
JSONArray jsonArray = JSON.parseArray(jsonStr);

// 遍历JSONArray
for(int i =0 ; i 

四.常见问题

问题一：
FastJson默认过滤null值，不显示null值字段。

Map map = new HashMap(){
    {
        put("age", 18);
        put("name", "张三");
        put("sex", null);
    }
};

System.out.println(JSONObject.toJSONString(map));

【运行结果】：

【解决】：
转换成JSON字符串时，使用Feature枚举值进行设置。

Map map = new HashMap(){
    {
        put("age", 18);
        put("name", "张三");
        put("sex", null);
    }
};
// 使用Feature类型的枚举值进行设置
System.out.println(JSONObject.toJSONString(map,Feature.WriteMapNullValue));

问题二：控制JSON的字段顺序

// 实体类
public class PoliceStation {
	private String name;
	private String addr;
	private String tel;
	
	
	public String getName() {
		return name;
	}
	public void setName(String name) {
		this.name = name;
	}
	public String getAddr() {
		return addr;
	}
	public void setAddr(String addr) {
		this.addr = addr;
	}
	public String getTel() {
		return tel;
	}
	public void setTel(String tel) {
		this.tel = tel;
	}
}

// 测试类
PoliceStation ps = new PoliceStation();
ps.setName("电子城派出所");
ps.setAddr("旺旺星球");
ps.setTel("14587091409");

System.out.println(JSON.toJSONString(ps));

【运行结果】：

【解决】：输出结果与字段定义顺序不一致。需要在定义实体类字段时，使用@JSONFiled注解的ordinal属性进行顺序配置。

import com.alibaba.fastjson2.annotation.JSONField;
public class PoliceStation {
	@JSONField(ordinal = 1)
	private String name;
	
	@JSONField(ordinal = 2)
	private String addr;
	
	@JSONField(ordinal = 3)
	private String tel;
}

问题三：
控制JSON的Date字段格式

// 实体订单类
public class Order{
    // 订单编号
	private String orderId;
	
    // 创建日期
	private LocalDateTime creationTime;
	
	public Order() {
		this.orderId = UUID.randomUUID().toString();
		this.creationTime = LocalDateTime.now();
	}

	public String getOrderId() {
		return orderId;
	}

	public void setOrderId(String orderId) {
		this.orderId = orderId;
	}

	public LocalDateTime getCreationTime() {
		return creationTime;
	}

	public void setCreationTime(LocalDateTime creationTime) {
		this.creationTime = creationTime;
	}
}

// 测试类
public class Test {
	public static void main(String[] args) {
		Order order1 = new Order();
		String json = JSON.toJSONString(order1);
		System.out.println(json);
	}
}

【运行结果】
【解决】
输出日期字段时，默认格式不符合需求时，可以在定义实体类的Date字段，使用@JSONFiled注解的format属性进行格式配置。

// 订单类
public class Order{
	// 订单编号
	private String orderId;
	
	// 创建日期
	@JSONField(format = "yyyy-MM-dd HH:mm:ss")
	private LocalDateTime creationTime;
}