文件解析（JSON解析）

朴灿烈づ我的快乐病毒、 2024-05-07 17:12 13阅读 0赞

**一.什么是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);

1.  将**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 <jsonArray.size(); i++) {
        JSONObject item = jsonArray.getJSONObject(i);
        System.out.println(item);
    }

**四.常见问题**

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

Map<String, Object> map = new HashMap<String, Object>(){
        {
            put("age", 18);
            put("name", "张三");
            put("sex", null);
        }
    };
    
    System.out.println(JSONObject.toJSONString(map));

【运行结果】：  
![在这里插入图片描述][3668839dc6504bb798c5a1c34c0d4f73.png]  
【解决】：  
转换成JSON字符串时，使用Feature枚举值进行设置。

Map<String, Object> map = new HashMap<String, Object>(){
        {
            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));

【运行结果】：  
![在这里插入图片描述][80b50e28064c42f4a4fe4608d3ea2f9c.png]  
【解决】：输出结果与字段定义顺序不一致。需要在定义实体类字段时，使用@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);
    	}
    }

【运行结果】  
![在这里插入图片描述][93d5bf9131414ce2a118dbb2bd43abe3.png]【解决】  
输出日期字段时，默认格式不符合需求时，可以在定义实体类的Date字段，使用@JSONFiled注解的format属性进行格式配置。

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

[3668839dc6504bb798c5a1c34c0d4f73.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/07/7dc9e2afc0ec4b018f1be0b4e684f822.png
[80b50e28064c42f4a4fe4608d3ea2f9c.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/07/f4b2e0efe6ee4f2db71435c5c86007be.png
[93d5bf9131414ce2a118dbb2bd43abe3.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/07/865ec6fc036149899712a737daa66964.png