DeserializationProblemHandler क्लास को रजिस्टर किया जा सकता है ताकि डीसीरियलाइजेशन प्रक्रिया के दौरान संभावित रूप से रिकवरेबल समस्या आने पर कॉल किया जाए। हम DeserializationProblemHandler क्लास के handleUnknownProperty() मेथड को इम्प्लीमेंट करके JSON डीसीरियलाइज करते समय उत्पन्न एरर्स को हैंडल कर सकते हैं।
सिंटैक्स
public boolean handleUnknownProperty(DeserializationContext ctxt, JsonParser p,
JsonDeserializer<?> deserializer, Object beanOrClass, String propertyName)
throws IOException
उदाहरण
import java.io.*;
import com.fasterxml.jackson.core.*;
import com.fasterxml.jackson.databind.*;
import com.fasterxml.jackson.databind.deser.*;
public class DeserializationErrorTest {
public static void main(String[] args) throws JsonMappingException, JsonGenerationException, IOException {
String jsonString = "{\"id\":\"101\", \"name\":\"Ravi Chandra\", \"address\":\"Pune\", \"salary\":\"40000\" }";
ObjectMapper objectMapper = new ObjectMapper();
DeserializationProblemHandler deserializationProblemHandler = new UnMarshallingErrorHandler();
objectMapper.addHandler(deserializationProblemHandler);
Customer customer = objectMapper.readValue(jsonString, Customer.class);
System.out.println(customer);
}
}
// UnMarshallingErrorHandler क्लास
class UnMarshallingErrorHandler extends DeserializationProblemHandler {
@Override
public boolean handleUnknownProperty(DeserializationContext ctxt, JsonParser jp,
JsonDeserializer<?> deserializer, Object beanOrClass, String propertyName)
throws IOException, JsonProcessingException {
boolean result = false;
super.handleUnknownProperty(ctxt, jp, deserializer, beanOrClass, propertyName);
System.out.println("Property with name '" + propertyName + "' doesn't exist in Class of type '" +
beanOrClass.getClass().getName() + "'");
return true; // true = एरर हैंडल्ड, डीसीरियलाइजेशन जारी रखें
// false = डीसीरियलाइजेशन तुरंत रोकें
}
}
// Customer क्लास
class Customer {
private int id;
private String name;
private String address;
// salary फील्ड नहीं है!
// गेटर्स/सेटर्स/टूस्ट्रिंग...
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 getAddress() { return address; }
public void setAddress(String address) { this.address = address; }
@Override
public String toString() {
return "Customer [id=" + id + ", name=" + name + ", address=" + address + "]";
}
}
आउटपुट जब true रिटर्न किया जाता है
Property with name 'salary' doesn't exist in Class of type 'Customer'
Customer [id=101, name=Ravi Chandra, address=Pune]
आउटपुट जब false रिटर्न किया जाता है
Property with name 'salary' doesn't exist in Class of type 'Customer'
Exception in thread "main"
com.fasterxml.jackson.databind.exc.UnrecognizedPropertyException:
Unrecognized field "salary" (class Customer), not marked as ignorable
(3 known properties: "id", "address", "name")
at [Source: (String)"{"id":"101", "name":"Ravi Chandra", "address":"Pune", "salary":"40000" }"; line: 1, column: 65]
DeserializationProblemHandler के अन्य मेथड्स
| मेथड | उद्देश्य |
|---|---|
| handleUnknownProperty() | अज्ञात प्रॉपर्टी (सबसे आम) |
| handleMissingInstantiator() | कोई उपयुक्त कंस्ट्रक्टर/फैक्टरी नहीं |
| handleInstantiationProblem() | इंस्टेंशिएशन विफलता |
| handleTypeMismatch() | टाइप मिसमैच (स्ट्रिंग vs नंबर) |
| handleWeirdStringValue() | अनपेक्षित स्ट्रिंग वैल्यू (नल, नैन, आदि) |
| handleWeirdNumberValue() | अनपेक्षित नंबर वैल्यू |
| handleWeirdKey() | मैप के लिए अजीब की |
ग्लोबल कॉन्फिगरेशन विकल्प
// सभी अज्ञात प्रॉपर्टीज इग्नोर करें (हैंडलर के बिना)
objectMapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
// या एनोटेशन के साथ
@JsonIgnoreProperties(ignoreUnknown = true)
class Customer { ... }
कस्टम हैंडलर में एक्सेप्शन थ्रो करना
@Override
public boolean handleUnknownProperty(...) {
if (propertyName.equals("deprecatedField")) {
return true; // चुपचाप इग्नोर करें
}
// अन्य के लिए कस्टम एक्सेप्शन थ्रो करें
throw new JsonMappingException(jp, "Unexpected field: " + propertyName);
}
उपयोग के मामले
- बैकवर्ड कम्पैटिबिलिटी: नए API फील्ड्स को पुराने क्लाइंट्स के लिए इग्नोर करना
- लॉगिंग/मॉनिटरिंग: अज्ञात प्रॉपर्टीज को ट्रैक करना
- कंडीशनल प्रोसेसिंग: यूजर रोल/परमिशन के आधार पर फील्ड्स शामिल/बहिष्कृत करना
- माइग्रेशन: लीगेसी फील्ड नामों को नए नामों में मैप करना