在解析從我們的一個(gè)RESTful Web服務(wù)接收到的JSON字符串時(shí)，我收到此錯(cuò)誤“線程“ main”中的異常com.fasterxml.jackson.databind.exc.UnrecognizedPropertyException：無(wú)法識(shí)別的字段“人”（類Hello $ Person），不是標(biāo)記為“可忽略” 。

經(jīng)過(guò)一番研究，我發(fā)現(xiàn)這是在Java應(yīng)用程序中使用Jackson開(kāi)源庫(kù)解析JSON文檔時(shí)的常見(jiàn)錯(cuò)誤之一。 錯(cuò)誤消息說(shuō)在我們的例子中，它找不到合適的屬性名稱“ person”，讓我們首先看一下我們要解析的JSON，我們用來(lái)表示JSON文檔的類和錯(cuò)誤。消息本身。

錯(cuò)誤信息：

Exception in thread "main" com.fasterxml.jackson.databind.exc.UnrecognizedPropertyException:Unrecognized field "person" (class Hello$Person), not marked as ignorable (4 known properties: , "id", "city", "name", "phone"])

錯(cuò)誤消息指出，它可以在Person類中找到ID，城市，名稱和電話屬性，但無(wú)法找到“ person”字段。

我們的POJO類如下所示：

class Person{private int id;private String name;private String city;private long phone;.....}

和JSON字符串：

{"person": [{"id": "11","name": "John","city": "NewYork","phone": 7647388372}]}

如果仔細(xì)看，“ person”字段指向JSON數(shù)組而不是對(duì)象，這意味著它不能直接映射到person類。

如何解決這個(gè)問(wèn)題呢

以下是解決此問(wèn)題并擺脫此錯(cuò)誤的步驟：

1）配置encunger未知屬性時(shí)，杰克遜的ObjectMapper不會(huì)失敗

您可以通過(guò)禁用ObjectMapper的D eserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES屬性來(lái)執(zhí)行此操作，如下所示：

// Jackson code to convert JSON String to Java objectObjectMapper objectMapper = new ObjectMapper();objectMapper.disable(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES);Person p = objectMapper.readValue(JSON, Person.class);System.out.println(p);

現(xiàn)在，錯(cuò)誤將消失，但是輸出不是您期望的，它將輸出以下內(nèi)容：

Person [id=0, name=null, city=null, phone=0]

您可以看到Person類沒(méi)有正確創(chuàng)建，即使JSON String包含其值，相關(guān)屬性也為null。

原因是JSON String包含一個(gè)JSON數(shù)組 ，person字段指向一個(gè)數(shù)組，而Person類中沒(méi)有對(duì)應(yīng)于該字段的字段。

為了正確地解析JSON字符串，我們需要?jiǎng)?chuàng)建一個(gè)包裝器類Community ，它將具有一個(gè)屬性來(lái)保留Person數(shù)組，如下所示：

static class Community {private List<Person> person;public List<Person> getPerson() {return person;}public void setPerson(List<Person> person) {this.person = person;}}

現(xiàn)在，我們將JSON字符串轉(zhuǎn)換為該Community類，并從列表中打印每個(gè)人，如下所示：

ObjectMapper objectMapper = new ObjectMapper();//objectMapper.disable(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES);Community c = objectMapper.readValue(JSON, Community.class);for (Person p : c.getPerson()) {System.out.println(p);}

這將正確打印人的詳細(xì)信息，如下所示：

Person [id=11, name=John, city=NewYork, phone=7647388372]

現(xiàn)在，回到更普遍的情況， 在JSON上添加了一個(gè)新字段，但您的Person類中不提供新字段 ，讓我們看看會(huì)發(fā)生什么。

假設(shè)我們要解析的JSON字符串如下：

{"person": [{"id": "11","name": "John","city": "NewYork","phone": 7647388372,"facebook": "JohnTheGreat"}]}

使用此JSON String運(yùn)行相同的程序時(shí)，將出現(xiàn)以下錯(cuò)誤：

同樣， 杰克遜無(wú)法識(shí)別新的“ facebook”屬性。 現(xiàn)在，我們可以通過(guò)禁用告訴Jackson在未知屬性上失敗的功能來(lái)忽略此屬性，如下所示：

ObjectMapper objectMapper = new ObjectMapper();objectMapper.disable(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES);Community c = objectMapper.readValue(JSON, Community.class);

這將正確打印人員類別，如下所示：

Person [id=11, name=John, city=NewYork, phone=7647388372]

或者，您也可以使用@JsonIgnoreProperties批注忽略未聲明的屬性。

@JsonIgnoreProperties是Jackson中的一個(gè)類級(jí)注釋，它將忽略您尚未在POJO中定義的每個(gè)屬性。 當(dāng)您僅在JSON中查找?guī)讉€(gè)屬性并且不想編寫(xiě)整個(gè)映射時(shí)，此功能非常有用。

該注釋在類級(jí)別提供控制，即您可以告訴Jackson ，對(duì)于該類，請(qǐng)忽略通過(guò)執(zhí)行以下操作未定義的任何屬性

@JsonIgnoreProperties(ignoreUnknown = true)

因此，我們的Person類現(xiàn)在看起來(lái)像：

@JsonIgnoreProperties(ignoreUnknown = true)static class Person{private int id;private String name;private String city;private long phone;......}

樣例程序

import java.io.IOException; import java.util.List;import com.fasterxml.jackson.core.JsonParseException; import com.fasterxml.jackson.databind.DeserializationFeature; import com.fasterxml.jackson.databind.JsonMappingException; import com.fasterxml.jackson.databind.ObjectMapper;/** {"person": [{"id": "11","name": "John","city": "NewYork","phone": 7647388372}]} */public class Hello {private static String JSON = "{\r\n" + " \"person\": [\r\n" + " {\r\n"+ " \"id\": \"11\",\r\n" + " \"name\": \"John\",\r\n"+ " \"city\": \"NewYork\",\r\n" + " \"phone\": 7647388372,\r\n"+ " \"facebook\": \"JohnTheGreat\"\r\n" + " }\r\n" + " ]\r\n" + " } ";public static void main(String args[]) throws JsonParseException,JsonMappingException, IOException {ObjectMapper objectMapper = new ObjectMapper();objectMapper.disable(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES);Community c = objectMapper.readValue(JSON, Community.class);for (Person p : c.getPerson()) {System.out.println(p);}}static class Community {private List<Person> person;public List<Person> getPerson() {return person;}public void setPerson(List<Person> person) {this.person = person;}}static class Person {private int id;private String name;private String city;private long phone;public int getId() {return id;}public void setId(int id) {this.id = id;}public String getName() {return name;}public void setName(String name) {this.name = name;}public String getCity() {return city;}public void setCity(String city) {this.city = city;}public long getPhone() {return phone;}public void setPhone(long phone) {this.phone = phone;}@Overridepublic String toString() {return "Person [id=" + id + ", name=" + name + ", city=" + city+ ", phone=" + phone + "]";}} }

當(dāng)我運(yùn)行該程序的第一個(gè)版本時(shí)，遇到以下錯(cuò)誤：

Exception in thread "main" com.fasterxml.jackson.databind.JsonMappingException: No suitable constructor found for type [simple type, class Hello$Person]: can not instantiate from JSON object (need to add/enable type information?)at [Source: java.io.StringReader@5e329ba8; line: 2, column: 3]at com.fasterxml.jackson.databind.JsonMappingException.from(JsonMappingException.java:164)at com.fasterxml.jackson.databind.deser.BeanDeserializerBase.deserializeFromObjectUsingNonDefault(BeanDeserializerBase.java:984)at com.fasterxml.jackson.databind.deser.BeanDeserializer.deserializeFromObject(BeanDeserializer.java:276)at com.fasterxml.jackson.databind.deser.BeanDeserializer.deserialize(BeanDeserializer.java:121)at com.fasterxml.jackson.databind.ObjectMapper._readMapAndClose(ObjectMapper.java:2888)at com.fasterxml.jackson.databind.ObjectMapper.readValue(ObjectMapper.java:2034)at Hello.main(Hello.java:40)

發(fā)生此錯(cuò)誤是因?yàn)槲业那短最?Person不是靜態(tài)的，這意味著由于具有任何Outer類實(shí)例而無(wú)法將其實(shí)例化。 使Person類變?yōu)殪o態(tài)后，該問(wèn)題得以解決。

如果您以前不熟悉此細(xì)節(jié)，建議您檢查一下
Java基礎(chǔ)知識(shí)：核心平臺(tái) ，這是Pluralsight的免費(fèi)課程，旨在學(xué)習(xí)有關(guān)Java編程語(yǔ)言的此類詳細(xì)信息。 您可以注冊(cè)一個(gè)免費(fèi)試用版，這使您有10天的訪問(wèn)時(shí)間，足以免費(fèi)學(xué)習(xí)整個(gè)Java。

現(xiàn)在，讓我們看看真正的錯(cuò)誤：

Exception in thread "main" com.fasterxml.jackson.databind.exc.UnrecognizedPropertyException:Unrecognized field "person" (class Hello$Person), not marked as ignorable (4 known properties: , "id", "city", "name", "phone"])at [Source: java.io.StringReader@4fbc9499; line: 2, column: 14] (through reference chain: Person["person"])at com.fasterxml.jackson.databind.exc.UnrecognizedPropertyException.from(UnrecognizedPropertyException.java:79)at com.fasterxml.jackson.databind.DeserializationContext.reportUnknownProperty(DeserializationContext.java:555)at com.fasterxml.jackson.databind.deser.std.StdDeserializer.handleUnknownProperty(StdDeserializer.java:708)at com.fasterxml.jackson.databind.deser.BeanDeserializerBase.handleUnknownProperty(BeanDeserializerBase.java:1160)at com.fasterxml.jackson.databind.deser.BeanDeserializer.deserializeFromObject(BeanDeserializer.java:315)at com.fasterxml.jackson.databind.deser.BeanDeserializer.deserialize(BeanDeserializer.java:121)at com.fasterxml.jackson.databind.ObjectMapper._readMapAndClose(ObjectMapper.java:2888)at com.fasterxml.jackson.databind.ObjectMapper.readValue(ObjectMapper.java:2034)at Hello.main(Hello.java:40)

當(dāng)您運(yùn)行程序的最終版本時(shí)，將看到以下輸出：

Person [id=11, name=John, city=NewYork, phone=7647388372]

這意味著我們能夠在Jackson中成功解析包含未知屬性的JSON 。

如何編譯和運(yùn)行該程序？

您可以簡(jiǎn)單地將代碼復(fù)制粘貼到您喜歡的IDE（例如Eclipse）中，以編譯和運(yùn)行該程序。

在Eclipse中，您甚至不需要?jiǎng)?chuàng)建類文件，因?yàn)槿绻麑⒋a復(fù)制粘貼到Java項(xiàng)目中，它將自動(dòng)創(chuàng)建類和包。

如果Eclipse是您的主要IDE，并且您想了解更多這樣的工作效率提示，建議您查看
Eclipse導(dǎo)覽–第1部分和第2部分作者：Tod Gentille 。

這是一門(mén)免費(fèi)的在線課程，旨在學(xué)習(xí)Eclipse IDE的基本和高級(jí)功能，這是每個(gè)Java開(kāi)發(fā)人員都應(yīng)注意的。 您可以通過(guò)注冊(cè)免費(fèi)試用版來(lái)訪問(wèn)此課程，從而使您有10天的時(shí)間訪問(wèn)整個(gè)Pluralsight庫(kù)，這是學(xué)習(xí)編程和其他技術(shù)的最有價(jià)值的資源之一。 順便說(shuō)一句，十天就足夠一起學(xué)習(xí)Java和Eclipse。

無(wú)論如何，一旦復(fù)制粘貼代碼，您所需要做的就是在pom.xml中包含Maven依賴項(xiàng)，或者手動(dòng)下載Jackson開(kāi)源庫(kù)所需的JAR文件 。

對(duì)于Maven用戶

您可以在項(xiàng)目的pom.xml上添加以下Maven依賴項(xiàng)，然后運(yùn)行mvn build或mvn install命令進(jìn)行編譯：

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

此依賴項(xiàng)需要jackson-core和jackson-annotations但Maven會(huì)自動(dòng)為您下載該依賴項(xiàng)。

手動(dòng)下載JAR

如果您不使用Maven或任何其他構(gòu)建工具eggradle，則可以轉(zhuǎn)到Maven中央庫(kù)并下載以下三個(gè)JAR文件，并將它們包括在類路徑中：

jackson-databind-2.2.3.jar jackson-core-2.2.3.jar jackson-annotations-2.2.3.jar

一旦成功編譯了類，就可以像在Eclipse中運(yùn)行任何其他Java程序一樣運(yùn)行它們，如此處所示，或者可以使用命令行運(yùn)行JAR文件，如下所示
在這里 。

簡(jiǎn)而言之，當(dāng)您嘗試將JSON解析為不包含JSON中定義的所有字段的Java對(duì)象時(shí)，會(huì)出現(xiàn)“ com.fasterxml.jackson.databind.exc.UnrecognizedPropertyException：無(wú)法識(shí)別的字段XXX，未標(biāo)記為可忽略”的錯(cuò)誤。 您可以通過(guò)禁用Jackson的功能來(lái)解決此錯(cuò)誤，該功能會(huì)告訴它如果遇到未知屬性時(shí)將失敗，或者通過(guò)在類級(jí)別使用注釋@JsonIgnoreProperties來(lái)@JsonIgnoreProperties 。

進(jìn)階學(xué)習(xí)

• Spring MVC簡(jiǎn)介
• Eugen Paraschiv的Spring REST
• 使用Jersey的Java中的RESTFul Services

感謝您到目前為止閱讀本文。 如果您喜歡我的解釋，請(qǐng)與您的朋友和同事分享。 如果您有任何疑問(wèn)或反饋，請(qǐng)留下筆記。

翻譯自: https://www.javacodegeeks.com/2017/10/jackson-json-parsing-error-unrecognizedpropertyexception-unrecognized-field-not-marked-ignorable-solved.html

總結(jié)

以上是生活随笔為你收集整理的杰克逊JSON解析错误-UnrecognizedPropertyException：无法识别的字段，未标记为可忽略[已解决]...的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問(wèn)題。

如果覺(jué)得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。