通过简单的toJson 和fromJson能完成绝大部分的互转工作, 不再需要额外的配置.
• 能够提供模板, 容易的更改Json的展现, 和反向的Java Object生成
• 适用于任何的Java对象, 包括基本类型
• 支持JDK1.5+
### Nutz.Json：高效、灵活的JSON处理工具
#### 前言
随着Web应用的发展，JSON（JavaScript Object Notation）作为一种轻量级的数据交换格式，因其简洁和易读性而受到开发者的广泛欢迎。然而，在Java环境中实现JSON与Java对象之间的相互转换，通常需要依赖第三方库或框架来完成。NutZ.Json便是这样一款针对Java环境设计的轻量级、高性能的JSON处理工具，旨在简化JSON与Java对象间的转换过程，并提供灵活多变的配置选项。
#### 特点与优势
- **简单的互转功能**：NutZ.Json提供了`toJson`和`fromJson`两个核心方法，能够轻松实现Java对象到JSON字符串以及反之的转换。这种设计极大地简化了开发流程，无需复杂的配置即可快速上手。
- **模板化配置**：NutZ.Json允许用户通过模板来自定义JSON的输出格式，以及控制如何从JSON字符串反序列化为Java对象。这种灵活性使得开发者可以根据实际需求定制输出样式，比如调整键值对的排序顺序或是忽略某些字段等。
- **广泛兼容性**：该库支持所有标准的Java对象类型，包括基本数据类型如`int`、`double`等，同时也兼容复杂的数据结构如数组、集合等。此外，它还支持JDK 1.5及以上的版本，确保了良好的跨平台兼容性。
- **高性能表现**：作为一款专为性能优化而生的工具，NutZ.Json在处理大数据量时仍能保持高效的转换速度，特别适合于对性能有较高要求的应用场景。
#### 使用指南
- **基础使用**
- Java对象转JSON：可以通过调用`Json.toJson()`方法将任意Java对象转换为JSON字符串。例如：
```java
Json.toJson(6.5); // 输出：6.5
Json.toJson("json"); // 输出："json"
Json.toJson(new int[0]); // 输出：[]
```
- JSON转Java对象：使用`Json.fromJson()`方法可以将JSON字符串反序列化为对应的Java对象。示例：
```java
int intValue = Json.fromJson(int.class, Lang.inr("65"));
float floatValue = Json.fromJson(float.class, Lang.inr("65"));
int[] intArray = Json.fromJson(int[].class, Lang.inr("[65]"));
```
- **Map操作**
- Java对象转JSON：对于Map类型的对象，NutZ.Json会自动忽略值为null的键值对，从而生成更简洁的JSON输出。
```java
Map<String, Object> map = new HashMap<>();
map.put("name", "Peter");
map.put("age", 21);
map.put("friends", null);
String result = Json.toJson(map);
// 输出：{"age":21,"name":"Peter"}
```
- JSON转Java对象：可以从JSON字符串反序列化为Map类型。
```java
String json = "{\"age\":21,\"name\":\"Peter\"}";
Map<String, Object> map = Json.fromJson(HashMap.class, Lang.inr(json));
```
- **Bean操作**
- Java对象转JSON：对于具有getter和setter方法的Java Bean对象，NutZ.Json同样会忽略未赋值的属性。
```java
public static class UserObject {
private String name;
private int age;
// ... 其他属性及getter/setter方法
}
UserObject peter = new UserObject();
peter.setName("Peter");
peter.setAge(22);
String result = Json.toJson(peter);
// 输出：{"name":"Peter","age":22}
```
- JSON转Java对象：支持复杂对象的序列化。
```java
String json = "{\"name\":\"Amy\",\"age\":21,\"sex\":\"Female\",\"birthday\":\"2023-01-01\",\"bestFriend\":{\"name\":\"Peter\",\"age\":22}}";
UserObject amy = Json.fromJson(UserObject.class, Lang.inr(json));
```
#### 结语
NutZ.Json以其简洁易用的API设计、强大的自定义能力以及广泛的兼容性，为Java开发者提供了一款强大而灵活的JSON处理工具。无论是在日常开发还是高性能系统构建中，NutZ.Json都能够胜任并发挥出色的表现。
