Der Java-JSON-Parser, den ich für den großartigsten halte: Jackson
- coldplay.xixinach vorne
- 2020-12-16 09:48:542541Durchsuche
Java Basic TutorialDie Kolumne stellt den Java JSON Parser vor
Empfohlen (kostenlos): Java Basic Tutorial
In der heutigen Programmierwelt ist JSON geworden die Informationen Das bevorzugte Protokoll für die Übertragung vom Client zum Server Es ist keine Übertreibung zu sagen, dass XML derjenige ist, der am Strand erschossen wurde.
Leider verfügt das JDK nicht über eine JSON-Bibliothek. Ich weiß nicht, warum sie nicht entwickelt wurde. Zur Zeit von Log4j wurde auch java.util.logging eingeführt, um mithalten zu können, obwohl es am Ende nicht von vielen Leuten genutzt wurde.
Der Grund, warum Java großartig ist, ist, dass sein Ökosystem nicht über eine JSON-Bibliothek verfügt, die Bibliotheken von Drittanbietern jedoch sehr gut sind. Zum Beispiel die Schweinefüße in diesem Artikel – Jackson, GitHub superscript star 6.1k, der Standard-JSON-Parser von Spring Boot.
Wie kann man das beweisen?
Wenn wir über Starter ein neues Spring Boot-Webprojekt erstellen, können wir Jackson in den Maven-Abhängigkeiten sehen.
Jackson hat viele Vorteile:
- parst große Dateien schneller;
- nimmt während der Laufzeit weniger Speicher ein und bietet eine bessere Leistung;
- API ist sehr flexibel und einfach zu erweitern und anzupassen.
Das Kernmodul von Jackson besteht aus drei Teilen:
- jackson-core, das Kernpaket, stellt verwandte APIs basierend auf der Analyse im „Stream-Modus“ bereit, einschließlich JsonPaser und JsonGenerator.
- jackson-annotations, Annotationspaket, bietet Standard-Annotationsfunktionen;
- jackson-databind, Datenbindungspaket, stellt verwandte APIs basierend auf der Analyse der „Objektbindung“ (ObjectMapper) und verwandte APIs basierend auf der Analyse des „Baummodells“ (JsonNode) bereit. .
01. Jackson-Abhängigkeit einführen
Um Jackson zu verwenden, müssen Sie die Jackson-Abhängigkeit in der Datei pom.xml hinzufügen.
<dependency> <groupid>com.fasterxml.jackson.core</groupid> <artifactid>jackson-databind</artifactid> <version>2.10.1</version> </dependency>
jackson-databind hängt von jackson-core und jackson-annotations ab. Nach dem Hinzufügen von jackson-databind führt Maven also automatisch jackson-core und jackson-annotations in das Projekt ein.
Das Liebenswerte an Maven ist, dass es uns heimlich dabei helfen kann, das zu tun, was wir tun müssen.
02. Verwenden Sie ObjectMapper
Jacksons am häufigsten verwendete API ist ObjectMapper, der auf „Objektbindung“ basiert und Java-Objekte über eine Reihe von writeValue-Methoden in JSON serialisiert und in verschiedenen Formaten gespeichert werden kann.
-
writeValueAsString(Object value)-Methode, speichert das Objekt als StringwriteValueAsString(Object value)方法，将对象存储成字符串 -
writeValueAsBytes(Object value)方法，将对象存储成字节数组 -
writeValue(File resultFile, Object value)方法，将对象存储成文件
来看一下存储成字符串的代码示例：
import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.databind.ObjectMapper;
/**
* 微信搜索「沉默王二」，回复 Java
*
* @author 沉默王二
* @date 2020/11/26
*/
public class Demo {
public static void main(String[] args) throws JsonProcessingException {
Writer wanger = new Writer("沉默王二", 18);
ObjectMapper mapper = new ObjectMapper();
String jsonString = mapper.writerWithDefaultPrettyPrinter()
.writeValueAsString(wanger);
System.out.println(jsonString);
}
}
class Writer {
private String name;
private int age;
public Writer(String name, int age) {
this.name = name;
this.age = age;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public int getAge() {
return age;
}
public void setAge(int age) {
this.age = age;
}
}
程序输出结果如下所示：
{
"name" : "沉默王二",
"age" : 18
}
不是所有的字段都支持序列化和反序列化，需要符合以下规则：
- 如果字段的修饰符是 public，则该字段可序列化和反序列化（不是标准写法）。
- 如果字段的修饰符不是 public，但是它的 getter 方法和 setter 方法是 public，则该字段可序列化和反序列化。getter 方法用于序列化，setter 方法用于反序列化。
- 如果字段只有 public 的 setter 方法，而无 public 的 getter 方 法，则该字段只能用于反序列化。
如果想更改默认的序列化和反序列化规则，需要调用 ObjectMapper 的 setVisibility() 方法。否则将会抛出 InvalidDefinitionException 异常。
ObjectMapper 通过 readValue 的系列方法从不同的数据源将 JSON 反序列化为 Java 对象。
-
readValue(String content, Class<t> valueType)</t>方法，将字符串反序列化为 Java 对象 -
readValue(byte[] src, Class<t> valueType)</t>方法，将字节数组反序列化为 Java 对象 -
readValue(File src, Class<t> valueType)</t>方法，将文件反序列化为 Java 对象
来看一下将字符串反序列化为 Java 对象的代码示例：
import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.databind.ObjectMapper;
/**
* 微信搜索「沉默王二」，回复 Java
*
* @author 沉默王二
* @date 2020/11/26
*/
public class Demo {
public static void main(String[] args) throws JsonProcessingException {
ObjectMapper mapper = new ObjectMapper();
String jsonString = "{\n" +
" \"name\" : \"沉默王二\",\n" +
" \"age\" : 18\n" +
"}";
Writer deserializedWriter = mapper.readValue(jsonString, Writer.class);
System.out.println(deserializedWriter);
}
}
class Writer{
private String name;
private int age;
// getter/setter
@Override
public String toString() {
return "Writer{" +
"name='" + name + '\'' +
", age=" + age +
'}';
}
}
程序输出结果如下所示：
Writer{name='沉默王二', age=18}
PS：如果反序列化的对象有带参的构造方法，它必须有一个空的默认构造方法，否则将会抛出 InvalidDefinitionException
writeValueAsBytes(Object value)-Methode, speichert das Objekt als Byte-Array
writeValue(File resultFile, Object value) Methode, speichere das Objekt als Datei🎜Sehen wir uns das Codebeispiel zum Speichern als String an:🎜Exception in thread "main" com.fasterxml.jackson.databind.exc.InvalidDefinitionException: Cannot construct instance of `com.itwanger.jackson.Writer` (no Creators, like default construct, exist): cannot deserialize from Object value (no delegate- or property-based Creator)
at [Source: (String)"{
"name" : "沉默王二",
"age" : 18
}"; line: 2, column: 3]
at com.fasterxml.jackson.databind.exc.InvalidDefinitionException.from(InvalidDefinitionException.java:67)
at com.fasterxml.jackson.databind.DeserializationContext.reportBadDefinition(DeserializationContext.java:1589)
at com.fasterxml.jackson.databind.DeserializationContext.handleMissingInstantiator(DeserializationContext.java:1055)
at com.fasterxml.jackson.databind.deser.BeanDeserializerBase.deserializeFromObjectUsingNonDefault(BeanDeserializerBase.java:1297)
at com.fasterxml.jackson.databind.deser.BeanDeserializer.deserializeFromObject(BeanDeserializer.java:326)
at com.fasterxml.jackson.databind.deser.BeanDeserializer.deserialize(BeanDeserializer.java:159)
at com.fasterxml.jackson.databind.ObjectMapper._readMapAndClose(ObjectMapper.java:4202)
at com.fasterxml.jackson.databind.ObjectMapper.readValue(ObjectMapper.java:3205)
at com.fasterxml.jackson.databind.ObjectMapper.readValue(ObjectMapper.java:3173)
at com.itwanger.jackson.Demo.main(Demo.java:19)🎜Die Programmausgabe lautet wie folgt:🎜 import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;
/**
* 微信搜索「沉默王二」，回复 Java
*
* @author 沉默王二
* @date 2020/11/26
*/
public class JsonNodeDemo {
public static void main(String[] args) throws JsonProcessingException {
ObjectMapper mapper = new ObjectMapper();
String json = "{ \"name\" : \"沉默王二\", \"age\" : 18 }";
JsonNode jsonNode = mapper.readTree(json);
String name = jsonNode.get("name").asText();
System.out.println(name); // 沉默王二
}
}🎜Nicht alle Felder unterstützen Serialisierung und Deserialisierung und müssen die folgenden Regeln einhalten: 🎜🎜🎜Wenn der Modifikator eines Feldes öffentlich ist, kann das Feld serialisiert und deserialisiert werden (keine Standardschreibweise). 🎜🎜Wenn der Modifikator eines Feldes nicht öffentlich ist, seine Getter- und Setter-Methoden jedoch öffentlich sind, ist das Feld serialisierbar und deserialisierbar. Die Getter-Methode wird zur Serialisierung und die Setter-Methode zur Deserialisierung verwendet. 🎜🎜Wenn ein Feld nur eine öffentliche Setter-Methode, aber keine öffentliche Getter-Methode hat, kann das Feld nur zur Deserialisierung verwendet werden. 🎜🎜🎜Wenn Sie die Standardregeln für Serialisierung und Deserialisierung ändern möchten, müssen Sie die Methode setVisibility() von ObjectMapper aufrufen. Andernfalls wird eine InvalidDefinitionException ausgelöst. 🎜🎜ObjectMapper deserialisiert JSON über die Methodenreihe readValue in Java-Objekte aus verschiedenen Datenquellen. 🎜🎜🎜readValue(String content, Class<t> valueType)</t>-Methode, deserialisiert den String in ein Java-Objekt🎜🎜readValue(byte[] src, Class valueType) code>-Methode, deserialisiert das Byte-Array in ein Java-Objekt🎜🎜readValue(File src, Class<t> valueType)</t>-Methode, deserialisiert die Datei in ein Java-Objekt🎜🎜🎜 Sehen Sie sich den Code an Beispiel für die Deserialisierung eines Strings in ein Java-Objekt: 🎜import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.core.type.TypeReference;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.List;
/**
* 微信搜索「沉默王二」，回复 Java
*
* @author 沉默王二
* @date 2020/11/26
*/
public class TypeReferenceDemo {
public static void main(String[] args) throws JsonProcessingException {
ObjectMapper mapper = new ObjectMapper();
String json = "[{ \"name\" : \"沉默王三\", \"age\" : 18 }, { \"name\" : \"沉默王二\", \"age\" : 19 }]";
List<author> listAuthor = mapper.readValue(json, new TypeReference<list>>(){});
System.out.println(listAuthor);
}
}
class Author{
private String name;
private int age;
// getter/setter
// toString
}</list></author>🎜Die Programmausgabe sieht so aus: 🎜String jsonString = "{\n" +
" \"name\" : \"沉默王二\",\n" +
" \"age\" : 18\n" +
" \"sex\" : \"男\",\n" +
"}";🎜PS: Wenn das deserialisierte Objekt einen Konstruktor mit Parametern hat, muss es einen leeren Standardkonstruktor haben, andernfalls eine InvalidDefinitionException-Zeile wird ausgelöst. 🎜<pre class="brush:php;toolbar:false">class Writer{
private String name;
private int age;
// getter/setter
}</pre>🎜Jacksons am häufigsten verwendete API ist ObjectMapper basierend auf „Objektbindung“. 🎜🎜ObjectMapper kann JSON auch basierend auf „Baummodell“ in JsonNode-Objekte analysieren, siehe Beispiel unten. 🎜<pre class="brush:php;toolbar:false">import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;
/**
* 微信搜索「沉默王二」，回复 Java
*
* @author 沉默王二
* @date 2020/11/26
*/
public class JsonNodeDemo {
public static void main(String[] args) throws JsonProcessingException {
ObjectMapper mapper = new ObjectMapper();
String json = "{ \"name\" : \"沉默王二\", \"age\" : 18 }";
JsonNode jsonNode = mapper.readTree(json);
String name = jsonNode.get("name").asText();
System.out.println(name); // 沉默王二
}
}</pre>
<p>借助 TypeReference 可以将 JSON 字符串数组转成泛型 List，来看下面的示例：</p>
<pre class="brush:php;toolbar:false">import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.core.type.TypeReference;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.List;
/**
* 微信搜索「沉默王二」，回复 Java
*
* @author 沉默王二
* @date 2020/11/26
*/
public class TypeReferenceDemo {
public static void main(String[] args) throws JsonProcessingException {
ObjectMapper mapper = new ObjectMapper();
String json = "[{ \"name\" : \"沉默王三\", \"age\" : 18 }, { \"name\" : \"沉默王二\", \"age\" : 19 }]";
List<author> listAuthor = mapper.readValue(json, new TypeReference<list>>(){});
System.out.println(listAuthor);
}
}
class Author{
private String name;
private int age;
// getter/setter
// toString
}</list></author></pre>
<h3>03、更高级的配置</h3>
<p>Jackson 之所以牛掰的一个很重要的因素是可以实现高度灵活的自定义配置。</p>
<p>在实际的应用场景中，JSON 中常常会有一些 Java 对象中没有的字段，这时候，如果直接解析的话，会抛出 UnrecognizedPropertyException 异常。</p>
<p>下面是一串 JSON 字符串：</p>
<pre class="brush:php;toolbar:false">String jsonString = "{\n" +
" \"name\" : \"沉默王二\",\n" +
" \"age\" : 18\n" +
" \"sex\" : \"男\",\n" +
"}";</pre>
<p>但 Java 对象 Writer 中没有定义 sex 字段：</p>
<pre class="brush:php;toolbar:false">class Writer{
private String name;
private int age;
// getter/setter
}</pre>
<p>我们来尝试解析一下：</p>
<pre class="brush:php;toolbar:false">ObjectMapper mapper = new ObjectMapper();
Writer deserializedWriter = mapper.readValue(jsonString, Writer.class);</pre>
<p>不出意外，抛出异常了，sex 无法识别。</p>
<pre class="brush:php;toolbar:false">Exception in thread "main" com.fasterxml.jackson.databind.exc.UnrecognizedPropertyException: Unrecognized field "sex" (class com.itwanger.jackson.Writer), not marked as ignorable (2 known properties: "name", "age"])
at [Source: (String)"{
"name" : "沉默王二",
"age" : 18,
"sex" : "男"
}"; line: 4, column: 12] (through reference chain: com.itwanger.jackson.Writer["sex"])</pre>
<p>怎么办呢？可以通过 <code>configure() 方法忽略掉这些“无法识别”的字段。
mapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
除此之外，还有其他一些有用的配置信息，来了解一下：
// 在序列化时忽略值为 null 的属性
mapper.setSerializationInclusion(JsonInclude.Include.NON_NULL);
// 忽略值为默认值的属性
mapper.setDefaultPropertyInclusion(JsonInclude.Include.NON_DEFAULT);
04、处理日期格式
对于日期类型的字段，比如说 java.util.Date，如果不指定格式，序列化后将显示为 long 类型的数据，这种默认格式的可读性很差。
{
"age" : 18,
"birthday" : 1606358621209
}
怎么办呢？
第一种方案，在 getter 上使用 @JsonFormat 注解。
private Date birthday;
// GMT+8 是指格林尼治的标准时间，在加上八个小时表示你现在所在时区的时间
@JsonFormat(timezone = "GMT+8", pattern = "yyyy-MM-dd HH:mm:ss")
public Date getBirthday() {
return birthday;
}
public void setBirthday(Date birthday) {
this.birthday = birthday;
}
再来看一下结果：
{
"age" : 18,
"birthday" : "2020-11-26 03:02:30"
}
具体代码如下所示：
ObjectMapper mapper = new ObjectMapper();
Writer wanger = new Writer("沉默王二", 18);
wanger.setBirthday(new Date());
String jsonString = mapper.writerWithDefaultPrettyPrinter()
.writeValueAsString(wanger);
System.out.println(jsonString);
第二种方案，调用 ObjectMapper 的 setDateFormat() 方法。
ObjectMapper mapper = new ObjectMapper();
mapper.setDateFormat(StdDateFormat.getDateTimeInstance());
Writer wanger = new Writer("沉默王二", 18);
wanger.setBirthday(new Date());
String jsonString = mapper.writerWithDefaultPrettyPrinter()
.writeValueAsString(wanger);
System.out.println(jsonString);
输出结果如下所示：
{
"name" : "沉默王二",
"age" : 18,
"birthday" : "2020年11月26日 上午11:09:51"
}
05、字段过滤
在将 Java 对象序列化为 JSON 时，可能有些字段需要过滤，不显示在 JSON 中，Jackson 有一种比较简单的实现方式。
@JsonIgnore 用于过滤单个字段。
@JsonIgnore
public String getName() {
return name;
}
@JsonIgnoreProperties 用于过滤多个字段。
@JsonIgnoreProperties(value = { "age","birthday" })
class Writer{
private String name;
private int age;
private Date birthday;
}
06、自定义序列化和反序列化
当 Jackson 默认序列化和反序列化不能满足实际的开发需要时，可以自定义新的序列化和反序列化类。
自定义的序列化类需要继承 StdSerializer，同时重写 serialize() 方法，利用 JsonGenerator 生成 JSON，示例如下：
/**
* 微信搜索「沉默王二」，回复 Java
*
* @author 沉默王二
* @date 2020/11/26
*/
public class CustomSerializer extends StdSerializer<man> {
protected CustomSerializer(Class<man> t) {
super(t);
}
public CustomSerializer() {
this(null);
}
@Override
public void serialize(Man value, JsonGenerator gen, SerializerProvider provider) throws IOException {
gen.writeStartObject();
gen.writeStringField("name", value.getName());
gen.writeEndObject();
}
}
class Man{
private int age;
private String name;
public Man(int age, String name) {
this.age = age;
this.name = name;
}
public int getAge() {
return age;
}
public void setAge(int age) {
this.age = age;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
}</man></man>
定义好自定义序列化类后，要想在程序中调用它们，需要将其注册到 ObjectMapper 的 Module 中，示例如下所示：
ObjectMapper mapper = new ObjectMapper();
SimpleModule module =
new SimpleModule("CustomSerializer", new Version(1, 0, 0, null, null, null));
module.addSerializer(Man.class, new CustomSerializer());
mapper.registerModule(module);
Man man = new Man( 18,"沉默王二");
String json = mapper.writeValueAsString(man);
System.out.println(json);
程序输出结果如下所示：
{"name":"沉默王二"}
自定义序列化类 CustomSerializer 中没有添加 age 字段，所以只输出了 name 字段。
再来看一下自定义的反序列化类，继承 StdDeserializer，同时重写 deserialize() 方法，利用 JsonGenerator 读取 JSON，示例如下：
public class CustomDeserializer extends StdDeserializer<woman> {
protected CustomDeserializer(Class> vc) {
super(vc);
}
public CustomDeserializer() {
this(null);
}
@Override
public Woman deserialize(JsonParser p, DeserializationContext ctxt) throws IOException, JsonProcessingException {
JsonNode node = p.getCodec().readTree(p);
Woman woman = new Woman();
int age = (Integer) ((IntNode) node.get("age")).numberValue();
String name = node.get("name").asText();
woman.setAge(age);
woman.setName(name);
return woman;
}
}
class Woman{
private int age;
private String name;
public Woman() {
}
// getter/setter
@Override
public String toString() {
return "Woman{" +
"age=" + age +
", name='" + name + '\'' +
'}';
}
}</woman>
通过 JsonNode 把 JSON 读取到一个树形结构中，然后通过 JsonNode 的 get 方法将对应字段读取出来，然后生成新的 Java 对象，并返回。
定义好自定义反序列化类后，要想在程序中调用它们，同样需要将其注册到 ObjectMapper 的 Module 中，示例如下所示：
ObjectMapper mapper = new ObjectMapper();
SimpleModule module =
new SimpleModule("CustomDeserializer", new Version(1, 0, 0, null, null, null));
module.addDeserializer(Woman.class, new CustomDeserializer());
mapper.registerModule(module);
String json = "{ \"name\" : \"三妹\", \"age\" : 18 }";
Woman woman = mapper.readValue(json, Woman.class);
System.out.println(woman);
程序输出结果如下所示：
Woman{age=18, name='三妹'}
07、结语
哎呀，好像不错哦，Jackson 绝对配得上“最牛掰”这三个字，虽然有点虚。如果只想简单的序列化和反序列化，使用 ObjectMapper 的 write 和 read 方法即可。
如果还想更进一步的话，就需要对 ObjectMapper 进行一些自定义配置，或者加一些注解，以及直接自定义序列化和反序列化类，更贴近一些 Java 对象。
需要注意的是，对日期格式的字段要多加小心，尽量不要使用默认配置，可读性很差。
好了，通过这篇文章的系统化介绍，相信你已经完全摸透 Jackson 了，我们下篇文章见。
PS：如果你恰好需要一份 Java 精进路线的话，我这里有一份，我差不多花了 3 天的时间整理的，还挺受欢迎的，已经 2000 多赞了，每个阶段都很详细。
相关免费学习推荐：php编程（视频）
Das obige ist der detaillierte Inhalt vonDer Java-JSON-Parser, den ich für den großartigsten halte: Jackson. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!
Stellungnahme：
Dieser Artikel ist reproduziert unter:segmentfault.com. Bei Verstößen wenden Sie sich bitte an admin@php.cn löschen