Modifier and Type	Class and Description
public static class	DateDeserializers.CalendarDeserializer
protected abstract static class	DateDeserializers.DateBasedDeserializer<T>
public static class	DateDeserializers.DateDeserializer Simple deserializer for handling `java.util.Date` values.
public static class	DateDeserializers.SqlDateDeserializer Compared to plain old `java.util.Date`, SQL version is easier to deal with: mostly because it is more limited.
public static class	DateDeserializers.TimestampDeserializer Simple deserializer for handling `java.sql.Timestamp` values.

Modifier and Type	Field and Description
private static final HashSet<String>	_utilClasses

Access	Constructor and Description
public	DateDeserializers()

Modifier and Type	Method and Description
public static JsonDeserializer<?>	find(Class<?> rawType, String clsName)
public static boolean	hasDeserializerFor(Class<?> rawType)

_utilClasses	back to summary
private static final HashSet<String> _utilClasses

DateDeserializers	back to summary
public DateDeserializers()

find	back to summary
public static JsonDeserializer<?> find(Class<?> rawType, String clsName)

hasDeserializerFor	back to summary
public static boolean hasDeserializerFor(Class<?> rawType)

com.fasterxml.jackson.databind.deser.std back to summary

public Class DateDeserializers.CalendarDeserializer

Class Inheritance

extends DateDeserializers.DateBasedDeserializer<Calendar>

java.lang.Object
com.fasterxml.jackson.databind.JsonDeserializer
com.fasterxml.jackson.databind.deser.std.StdDeserializer
com.fasterxml.jackson.databind.deser.std.StdScalarDeserializer
com.fasterxml.jackson.databind.deser.std.DateDeserializers.DateBasedDeserializer
com.fasterxml.jackson.databind.deser.std.DateDeserializers.CalendarDeserializer

Annotations

@JacksonStdImpl

Field Summary

Modifier and Type	Field and Description
protected final Constructor<Calendar>	_defaultCtor We may know actual expected type; if so, it will be used for instantiation.

Inherited from com.fasterxml.jackson.databind.deser.std.DateDeserializers.DateBasedDeserializer:: _customFormat _formatString

Constructor Summary

Access	Constructor and Description
public	CalendarDeserializer()
public	CalendarDeserializer(Class<? extends Calendar> cc)
public	CalendarDeserializer(DateDeserializers.CalendarDeserializer src, DateFormat df, String formatString)

Method Summary

Modifier and Type	Method and Description
public Calendar	deserialize(JsonParser Parser used for reading JSON content p, DeserializationContext Context that can be used to access information about this deserialization activity. ctxt) Implements abstract com.fasterxml.jackson.databind.JsonDeserializer.deserialize. Method that can be called to ask implementation to deserialize JSON content into the value type this serializer handles.
public Object	getEmptyValue(DeserializationContext ctxt) Overrides com.fasterxml.jackson.databind.JsonDeserializer.getEmptyValue. Method called to determine value to be used for "empty" values (most commonly when deserializing from empty JSON Strings).
protected DateDeserializers.CalendarDeserializer	withDateFormat(DateFormat df, String formatString) Implements abstract com.fasterxml.jackson.databind.deser.std.DateDeserializers.DateBasedDeserializer.withDateFormat.

Inherited from com.fasterxml.jackson.databind.deser.std.DateDeserializers.DateBasedDeserializer:: _parseDate createContextual logicalType

Field Detail

_defaultCtor	back to summary
protected final Constructor<Calendar> _defaultCtor We may know actual expected type; if so, it will be used for instantiation. Since 2.9

_defaultCtor

back to summary

protected final Constructor<Calendar> _defaultCtor

We may know actual expected type; if so, it will be used for instantiation.

Since: 2.9

Constructor Detail

CalendarDeserializer	back to summary
public CalendarDeserializer()

CalendarDeserializer	back to summary
public CalendarDeserializer(Class<? extends Calendar> cc) Annotations @SuppressWarnings:unchecked

CalendarDeserializer	back to summary
public CalendarDeserializer(DateDeserializers.CalendarDeserializer src, DateFormat df, String formatString)

Method Detail

deserialize back to summary

deserialize	back to summary
public Calendar deserialize(JsonParser p, DeserializationContext ctxt) throws IOException Implements abstract com.fasterxml.jackson.databind.JsonDeserializer.deserialize. Doc from com.fasterxml.jackson.databind.JsonDeserializer.deserialize. Method that can be called to ask implementation to deserialize JSON content into the value type this serializer handles. Returned instance is to be constructed by method itself. Pre-condition for this method is that the parser points to the first event that is part of value to deserializer (and which is never JSON 'null' literal, more on this below): for simple types it may be the only value; and for structured types the Object start marker or a FIELD_NAME. The two possible input conditions for structured types result from polymorphism via fields. In the ordinary case, Jackson calls this method when it has encountered an OBJECT_START, and the method implementation must advance to the next token to see the first field name. If the application configures polymorphism via a field, then the object looks like the following. { "@class": "class name", ... } Jackson consumes the two tokens (the `@class` field name and its value) in order to learn the class and select the deserializer. Thus, the stream is pointing to the FIELD_NAME for the first field after the @class. Thus, if you want your method to work correctly both with and without polymorphism, you must begin your method with: if (p.currentToken() == JsonToken.START_OBJECT) { p.nextToken(); } This results in the stream pointing to the field name, so that the two conditions align. Post-condition is that the parser will point to the last event that is part of deserialized value (or in case deserialization fails, event that was not recognized or usable, which may be the same event as the one it pointed to upon call). Handling null values (JsonToken.VALUE_NULL) : Note that this method is never called for the JSON `null` literal to avoid every deserializer from having to handle null values. Instead, the `JsonDeserializer#getNullValue(DeserializationContext)` method is called to produce a null value. To influence null handling, custom deserializers should override `JsonDeserializer#getNullValue(DeserializationContext)` and usually also `JsonDeserializer#getNullAccessPattern()`. Parameters p:JsonParser Parser used for reading JSON content ctxt:DeserializationContext Context that can be used to access information about this deserialization activity. Returns:Calendar Deserialized value Annotations @Override

public Calendar deserialize(JsonParser p, DeserializationContext ctxt) throws IOException

Implements abstract com.fasterxml.jackson.databind.JsonDeserializer.deserialize.

Doc from com.fasterxml.jackson.databind.JsonDeserializer.deserialize.

Method that can be called to ask implementation to deserialize JSON content into the value type this serializer handles. Returned instance is to be constructed by method itself.

Pre-condition for this method is that the parser points to the first event that is part of value to deserializer (and which is never JSON 'null' literal, more on this below): for simple types it may be the only value; and for structured types the Object start marker or a FIELD_NAME.

The two possible input conditions for structured types result from polymorphism via fields. In the ordinary case, Jackson calls this method when it has encountered an OBJECT_START, and the method implementation must advance to the next token to see the first field name. If the application configures polymorphism via a field, then the object looks like the following.

      {
          "@class": "class name",
          ...
      }

Jackson consumes the two tokens (the @class field name and its value) in order to learn the class and select the deserializer. Thus, the stream is pointing to the FIELD_NAME for the first field after the @class. Thus, if you want your method to work correctly both with and without polymorphism, you must begin your method with:

       if (p.currentToken() == JsonToken.START_OBJECT) {
         p.nextToken();
       }

This results in the stream pointing to the field name, so that the two conditions align.

Post-condition is that the parser will point to the last event that is part of deserialized value (or in case deserialization fails, event that was not recognized or usable, which may be the same event as the one it pointed to upon call).

Handling null values (JsonToken.VALUE_NULL)
: Note that this method is never called for the JSON null literal to avoid every deserializer from having to handle null values. Instead, the JsonDeserializer#getNullValue(DeserializationContext) method is called to produce a null value. To influence null handling, custom deserializers should override JsonDeserializer#getNullValue(DeserializationContext) and usually also JsonDeserializer#getNullAccessPattern().

Parameters

p:JsonParser: Parser used for reading JSON content
ctxt:DeserializationContext: Context that can be used to access information about this deserialization activity.

Returns:Calendar

Deserialized value

Annotations

@Override

getEmptyValue back to summary

getEmptyValue	back to summary
public Object getEmptyValue(DeserializationContext ctxt) Overrides com.fasterxml.jackson.databind.JsonDeserializer.getEmptyValue. Doc from com.fasterxml.jackson.databind.JsonDeserializer.getEmptyValue. Method called to determine value to be used for "empty" values (most commonly when deserializing from empty JSON Strings). Usually this is same as `getNullValue` (which in turn is usually simply Java null), but it can be overridden for specific types. Or, if type should never be converted from empty String, method can also throw an exception. This method may be called once, or multiple times, depending on what `getEmptyAccessPattern()` returns. Default implementation simply calls `getNullValue` and returns value. Annotations @Override

public Object getEmptyValue(DeserializationContext ctxt)

Overrides com.fasterxml.jackson.databind.JsonDeserializer.getEmptyValue.

Doc from com.fasterxml.jackson.databind.JsonDeserializer.getEmptyValue.

Method called to determine value to be used for "empty" values (most commonly when deserializing from empty JSON Strings). Usually this is same as getNullValue (which in turn is usually simply Java null), but it can be overridden for specific types. Or, if type should never be converted from empty String, method can also throw an exception.

This method may be called once, or multiple times, depending on what getEmptyAccessPattern() returns.

Default implementation simply calls getNullValue and returns value.

Annotations

@Override

withDateFormat	back to summary
protected DateDeserializers.CalendarDeserializer withDateFormat(DateFormat df, String formatString) Implements abstract com.fasterxml.jackson.databind.deser.std.DateDeserializers.DateBasedDeserializer.withDateFormat. Annotations @Override

withDateFormat

back to summary

protected DateDeserializers.CalendarDeserializer withDateFormat(DateFormat df, String formatString)

Implements abstract com.fasterxml.jackson.databind.deser.std.DateDeserializers.DateBasedDeserializer.withDateFormat.

Annotations

@Override

com.fasterxml.jackson.databind.deser.std back to summary

protected abstract Class DateDeserializers.DateBasedDeserializer<T>

Class Inheritance

extends StdScalarDeserializer<T>
implements ContextualDeserializer

java.lang.Object
com.fasterxml.jackson.databind.JsonDeserializer
com.fasterxml.jackson.databind.deser.std.StdDeserializer
com.fasterxml.jackson.databind.deser.std.StdScalarDeserializer
com.fasterxml.jackson.databind.deser.std.DateDeserializers.DateBasedDeserializer

All Implemented Interfaces

com.fasterxml.jackson.databind.deser.ContextualDeserializer

Known Direct Subclasses

com.fasterxml.jackson.databind.deser.std.DateDeserializers.CalendarDeserializer, com.fasterxml.jackson.databind.deser.std.DateDeserializers.DateDeserializer, com.fasterxml.jackson.databind.deser.std.DateDeserializers.SqlDateDeserializer, com.fasterxml.jackson.databind.deser.std.DateDeserializers.TimestampDeserializer

Field Summary

Modifier and Type	Field and Description
protected final DateFormat	_customFormat Specific format to use, if non-null; if null will just use default format.
protected final String	_formatString Let's also keep format String for reference, to use for error messages

Constructor Summary

Access	Constructor and Description
protected	DateBasedDeserializer(Class<?> clz)
protected	DateBasedDeserializer(DateDeserializers.DateBasedDeserializer<T> base, DateFormat format, String formatStr)

Method Summary

Modifier and Type	Method and Description
protected Date	_parseDate(JsonParser p, DeserializationContext ctxt) Overrides com.fasterxml.jackson.databind.deser.std.StdDeserializer._parseDate.
public JsonDeserializer<?>	createContextual(DeserializationContext Deserialization context to access configuration, additional deserializers that may be needed by this deserializer ctxt, BeanProperty Method, field or constructor parameter that represents the property (and is used to assign deserialized value). Should be available; but there may be cases where caller cannot provide it and null is passed instead (in which case impls usually pass 'this' deserializer as is) property) Implements com.fasterxml.jackson.databind.deser.ContextualDeserializer.createContextual. Method called to see if a different (or differently configured) deserializer is needed to deserialize values of specified property.
public LogicalType	logicalType() Overrides com.fasterxml.jackson.databind.deser.std.StdScalarDeserializer.logicalType. Method for accessing logical type of values this deserializer produces.
protected abstract DateDeserializers.DateBasedDeserializer<T>	withDateFormat(DateFormat df, String formatStr)

Inherited from com.fasterxml.jackson.databind.deser.std.StdScalarDeserializer:: deserialize deserializeWithType getEmptyAccessPattern getNullAccessPattern supportsUpdate

Field Detail

_customFormat	back to summary
protected final DateFormat _customFormat Specific format to use, if non-null; if null will just use default format.

_formatString	back to summary
protected final String _formatString Let's also keep format String for reference, to use for error messages

Constructor Detail

DateBasedDeserializer	back to summary
protected DateBasedDeserializer(Class<?> clz)

DateBasedDeserializer	back to summary
protected DateBasedDeserializer(DateDeserializers.DateBasedDeserializer<T> base, DateFormat format, String formatStr)

Method Detail

_parseDate	back to summary
protected Date _parseDate(JsonParser p, DeserializationContext ctxt) throws IOException Overrides com.fasterxml.jackson.databind.deser.std.StdDeserializer._parseDate. Annotations @Override

_parseDate

back to summary

protected Date _parseDate(JsonParser p, DeserializationContext ctxt) throws IOException

Overrides com.fasterxml.jackson.databind.deser.std.StdDeserializer._parseDate.

Annotations

@Override

createContextual	back to summary
public JsonDeserializer<?> createContextual(DeserializationContext ctxt, BeanProperty property) throws JsonMappingException Implements com.fasterxml.jackson.databind.deser.ContextualDeserializer.createContextual. Doc from com.fasterxml.jackson.databind.deser.ContextualDeserializer.createContextual. Method called to see if a different (or differently configured) deserializer is needed to deserialize values of specified property. Note that instance that this method is called on is typically shared one and as a result method should NOT modify this instance but rather construct and return a new instance. This instance should only be returned as-is, in case it is already suitable for use. Parameters ctxt:DeserializationContext Deserialization context to access configuration, additional deserializers that may be needed by this deserializer property:BeanProperty Method, field or constructor parameter that represents the property (and is used to assign deserialized value). Should be available; but there may be cases where caller cannot provide it and null is passed instead (in which case impls usually pass 'this' deserializer as is) Returns:JsonDeserializer<?> Deserializer to use for deserializing values of specified property; may be this instance or a new instance. Annotations @Override

createContextual

back to summary

public JsonDeserializer<?> createContextual(DeserializationContext ctxt, BeanProperty property) throws JsonMappingException

Implements com.fasterxml.jackson.databind.deser.ContextualDeserializer.createContextual.

Doc from com.fasterxml.jackson.databind.deser.ContextualDeserializer.createContextual.

Method called to see if a different (or differently configured) deserializer is needed to deserialize values of specified property. Note that instance that this method is called on is typically shared one and as a result method should NOT modify this instance but rather construct and return a new instance. This instance should only be returned as-is, in case it is already suitable for use.

Parameters

ctxt:DeserializationContext: Deserialization context to access configuration, additional deserializers that may be needed by this deserializer
property:BeanProperty: Method, field or constructor parameter that represents the property (and is used to assign deserialized value). Should be available; but there may be cases where caller cannot provide it and null is passed instead (in which case impls usually pass 'this' deserializer as is)

Returns:JsonDeserializer<?>

Deserializer to use for deserializing values of specified property; may be this instance or a new instance.

Annotations

@Override

logicalType back to summary

logicalType	back to summary
public LogicalType logicalType() Overrides com.fasterxml.jackson.databind.deser.std.StdScalarDeserializer.logicalType. Doc from com.fasterxml.jackson.databind.JsonDeserializer.logicalType. Method for accessing logical type of values this deserializer produces. Typically used for further configuring handling of values, for example, to find which coercions are legal. Returns:LogicalType Logical type of values this deserializer produces, if known; `null` if not Annotations @Override

public LogicalType logicalType()

Overrides com.fasterxml.jackson.databind.deser.std.StdScalarDeserializer.logicalType.

Doc from com.fasterxml.jackson.databind.JsonDeserializer.logicalType.

Method for accessing logical type of values this deserializer produces. Typically used for further configuring handling of values, for example, to find which coercions are legal.

Returns:LogicalType

Logical type of values this deserializer produces, if known; null if not

Annotations

@Override

withDateFormat	back to summary
protected abstract DateDeserializers.DateBasedDeserializer<T> withDateFormat(DateFormat df, String formatStr)

com.fasterxml.jackson.databind.deser.std back to summary

public Class DateDeserializers.DateDeserializer

Class Inheritance

extends DateDeserializers.DateBasedDeserializer<Date>

java.lang.Object
com.fasterxml.jackson.databind.JsonDeserializer
com.fasterxml.jackson.databind.deser.std.StdDeserializer
com.fasterxml.jackson.databind.deser.std.StdScalarDeserializer
com.fasterxml.jackson.databind.deser.std.DateDeserializers.DateBasedDeserializer
com.fasterxml.jackson.databind.deser.std.DateDeserializers.DateDeserializer

Annotations

@JacksonStdImpl

Simple deserializer for handling java.util.Date values.

One way to customize Date formats accepted is to override method DeserializationContext#parseDate that this basic deserializer calls.

Field Summary

Modifier and Type	Field and Description
public static final DateDeserializers.DateDeserializer	instance

Inherited from com.fasterxml.jackson.databind.deser.std.DateDeserializers.DateBasedDeserializer:: _customFormat _formatString

Constructor Summary

Access	Constructor and Description
public	DateDeserializer()
public	DateDeserializer(DateDeserializers.DateDeserializer base, DateFormat df, String formatString)

Method Summary

Modifier and Type	Method and Description
public Date	deserialize(JsonParser Parser used for reading JSON content p, DeserializationContext Context that can be used to access information about this deserialization activity. ctxt) Implements abstract com.fasterxml.jackson.databind.JsonDeserializer.deserialize. Method that can be called to ask implementation to deserialize JSON content into the value type this serializer handles.
public Object	getEmptyValue(DeserializationContext ctxt) Overrides com.fasterxml.jackson.databind.JsonDeserializer.getEmptyValue. Method called to determine value to be used for "empty" values (most commonly when deserializing from empty JSON Strings).
protected DateDeserializers.DateDeserializer	withDateFormat(DateFormat df, String formatString) Implements abstract com.fasterxml.jackson.databind.deser.std.DateDeserializers.DateBasedDeserializer.withDateFormat.

Inherited from com.fasterxml.jackson.databind.deser.std.DateDeserializers.DateBasedDeserializer:: _parseDate createContextual logicalType

Field Detail

instance	back to summary
public static final DateDeserializers.DateDeserializer instance

Constructor Detail

DateDeserializer	back to summary
public DateDeserializer()

DateDeserializer	back to summary
public DateDeserializer(DateDeserializers.DateDeserializer base, DateFormat df, String formatString)

Method Detail

deserialize back to summary

deserialize	back to summary
public Date deserialize(JsonParser p, DeserializationContext ctxt) throws IOException Implements abstract com.fasterxml.jackson.databind.JsonDeserializer.deserialize. Doc from com.fasterxml.jackson.databind.JsonDeserializer.deserialize. Method that can be called to ask implementation to deserialize JSON content into the value type this serializer handles. Returned instance is to be constructed by method itself. Pre-condition for this method is that the parser points to the first event that is part of value to deserializer (and which is never JSON 'null' literal, more on this below): for simple types it may be the only value; and for structured types the Object start marker or a FIELD_NAME. The two possible input conditions for structured types result from polymorphism via fields. In the ordinary case, Jackson calls this method when it has encountered an OBJECT_START, and the method implementation must advance to the next token to see the first field name. If the application configures polymorphism via a field, then the object looks like the following. { "@class": "class name", ... } Jackson consumes the two tokens (the `@class` field name and its value) in order to learn the class and select the deserializer. Thus, the stream is pointing to the FIELD_NAME for the first field after the @class. Thus, if you want your method to work correctly both with and without polymorphism, you must begin your method with: if (p.currentToken() == JsonToken.START_OBJECT) { p.nextToken(); } This results in the stream pointing to the field name, so that the two conditions align. Post-condition is that the parser will point to the last event that is part of deserialized value (or in case deserialization fails, event that was not recognized or usable, which may be the same event as the one it pointed to upon call). Handling null values (JsonToken.VALUE_NULL) : Note that this method is never called for the JSON `null` literal to avoid every deserializer from having to handle null values. Instead, the `JsonDeserializer#getNullValue(DeserializationContext)` method is called to produce a null value. To influence null handling, custom deserializers should override `JsonDeserializer#getNullValue(DeserializationContext)` and usually also `JsonDeserializer#getNullAccessPattern()`. Parameters p:JsonParser Parser used for reading JSON content ctxt:DeserializationContext Context that can be used to access information about this deserialization activity. Returns:Date Deserialized value Annotations @Override

public Date deserialize(JsonParser p, DeserializationContext ctxt) throws IOException

Implements abstract com.fasterxml.jackson.databind.JsonDeserializer.deserialize.

Doc from com.fasterxml.jackson.databind.JsonDeserializer.deserialize.

Method that can be called to ask implementation to deserialize JSON content into the value type this serializer handles. Returned instance is to be constructed by method itself.

Pre-condition for this method is that the parser points to the first event that is part of value to deserializer (and which is never JSON 'null' literal, more on this below): for simple types it may be the only value; and for structured types the Object start marker or a FIELD_NAME.

The two possible input conditions for structured types result from polymorphism via fields. In the ordinary case, Jackson calls this method when it has encountered an OBJECT_START, and the method implementation must advance to the next token to see the first field name. If the application configures polymorphism via a field, then the object looks like the following.

      {
          "@class": "class name",
          ...
      }

Jackson consumes the two tokens (the @class field name and its value) in order to learn the class and select the deserializer. Thus, the stream is pointing to the FIELD_NAME for the first field after the @class. Thus, if you want your method to work correctly both with and without polymorphism, you must begin your method with:

       if (p.currentToken() == JsonToken.START_OBJECT) {
         p.nextToken();
       }

This results in the stream pointing to the field name, so that the two conditions align.

Post-condition is that the parser will point to the last event that is part of deserialized value (or in case deserialization fails, event that was not recognized or usable, which may be the same event as the one it pointed to upon call).

Handling null values (JsonToken.VALUE_NULL)
: Note that this method is never called for the JSON null literal to avoid every deserializer from having to handle null values. Instead, the JsonDeserializer#getNullValue(DeserializationContext) method is called to produce a null value. To influence null handling, custom deserializers should override JsonDeserializer#getNullValue(DeserializationContext) and usually also JsonDeserializer#getNullAccessPattern().

Parameters

p:JsonParser: Parser used for reading JSON content
ctxt:DeserializationContext: Context that can be used to access information about this deserialization activity.

Returns:Date

Deserialized value

Annotations

@Override

getEmptyValue back to summary

getEmptyValue	back to summary
public Object getEmptyValue(DeserializationContext ctxt) Overrides com.fasterxml.jackson.databind.JsonDeserializer.getEmptyValue. Doc from com.fasterxml.jackson.databind.JsonDeserializer.getEmptyValue. Method called to determine value to be used for "empty" values (most commonly when deserializing from empty JSON Strings). Usually this is same as `getNullValue` (which in turn is usually simply Java null), but it can be overridden for specific types. Or, if type should never be converted from empty String, method can also throw an exception. This method may be called once, or multiple times, depending on what `getEmptyAccessPattern()` returns. Default implementation simply calls `getNullValue` and returns value. Annotations @Override

public Object getEmptyValue(DeserializationContext ctxt)

Overrides com.fasterxml.jackson.databind.JsonDeserializer.getEmptyValue.

Doc from com.fasterxml.jackson.databind.JsonDeserializer.getEmptyValue.

Method called to determine value to be used for "empty" values (most commonly when deserializing from empty JSON Strings). Usually this is same as getNullValue (which in turn is usually simply Java null), but it can be overridden for specific types. Or, if type should never be converted from empty String, method can also throw an exception.

This method may be called once, or multiple times, depending on what getEmptyAccessPattern() returns.

Default implementation simply calls getNullValue and returns value.

Annotations

@Override

withDateFormat	back to summary
protected DateDeserializers.DateDeserializer withDateFormat(DateFormat df, String formatString) Implements abstract com.fasterxml.jackson.databind.deser.std.DateDeserializers.DateBasedDeserializer.withDateFormat. Annotations @Override

withDateFormat

back to summary

protected DateDeserializers.DateDeserializer withDateFormat(DateFormat df, String formatString)

Implements abstract com.fasterxml.jackson.databind.deser.std.DateDeserializers.DateBasedDeserializer.withDateFormat.

Annotations

@Override

com.fasterxml.jackson.databind.deser.std back to summary

public Class DateDeserializers.SqlDateDeserializer

Class Inheritance

extends DateDeserializers.DateBasedDeserializer<Date>

java.lang.Object
com.fasterxml.jackson.databind.JsonDeserializer
com.fasterxml.jackson.databind.deser.std.StdDeserializer
com.fasterxml.jackson.databind.deser.std.StdScalarDeserializer
com.fasterxml.jackson.databind.deser.std.DateDeserializers.DateBasedDeserializer
com.fasterxml.jackson.databind.deser.std.DateDeserializers.SqlDateDeserializer

Compared to plain old java.util.Date, SQL version is easier to deal with: mostly because it is more limited.

Field Summary

Inherited from com.fasterxml.jackson.databind.deser.std.DateDeserializers.DateBasedDeserializer:: _customFormat _formatString

Constructor Summary

Access	Constructor and Description
public	SqlDateDeserializer()
public	SqlDateDeserializer(DateDeserializers.SqlDateDeserializer src, DateFormat df, String formatString)

Method Summary

Modifier and Type	Method and Description
public Date	deserialize(JsonParser Parser used for reading JSON content p, DeserializationContext Context that can be used to access information about this deserialization activity. ctxt) Implements abstract com.fasterxml.jackson.databind.JsonDeserializer.deserialize. Method that can be called to ask implementation to deserialize JSON content into the value type this serializer handles.
public Object	getEmptyValue(DeserializationContext ctxt) Overrides com.fasterxml.jackson.databind.JsonDeserializer.getEmptyValue. Method called to determine value to be used for "empty" values (most commonly when deserializing from empty JSON Strings).
protected DateDeserializers.SqlDateDeserializer	withDateFormat(DateFormat df, String formatString) Implements abstract com.fasterxml.jackson.databind.deser.std.DateDeserializers.DateBasedDeserializer.withDateFormat.

Inherited from com.fasterxml.jackson.databind.deser.std.DateDeserializers.DateBasedDeserializer:: _parseDate createContextual logicalType

Constructor Detail

SqlDateDeserializer	back to summary
public SqlDateDeserializer()

SqlDateDeserializer	back to summary
public SqlDateDeserializer(DateDeserializers.SqlDateDeserializer src, DateFormat df, String formatString)

Method Detail

deserialize back to summary

deserialize	back to summary
public Date deserialize(JsonParser p, DeserializationContext ctxt) throws IOException Implements abstract com.fasterxml.jackson.databind.JsonDeserializer.deserialize. Doc from com.fasterxml.jackson.databind.JsonDeserializer.deserialize. Method that can be called to ask implementation to deserialize JSON content into the value type this serializer handles. Returned instance is to be constructed by method itself. Pre-condition for this method is that the parser points to the first event that is part of value to deserializer (and which is never JSON 'null' literal, more on this below): for simple types it may be the only value; and for structured types the Object start marker or a FIELD_NAME. The two possible input conditions for structured types result from polymorphism via fields. In the ordinary case, Jackson calls this method when it has encountered an OBJECT_START, and the method implementation must advance to the next token to see the first field name. If the application configures polymorphism via a field, then the object looks like the following. { "@class": "class name", ... } Jackson consumes the two tokens (the `@class` field name and its value) in order to learn the class and select the deserializer. Thus, the stream is pointing to the FIELD_NAME for the first field after the @class. Thus, if you want your method to work correctly both with and without polymorphism, you must begin your method with: if (p.currentToken() == JsonToken.START_OBJECT) { p.nextToken(); } This results in the stream pointing to the field name, so that the two conditions align. Post-condition is that the parser will point to the last event that is part of deserialized value (or in case deserialization fails, event that was not recognized or usable, which may be the same event as the one it pointed to upon call). Handling null values (JsonToken.VALUE_NULL) : Note that this method is never called for the JSON `null` literal to avoid every deserializer from having to handle null values. Instead, the `JsonDeserializer#getNullValue(DeserializationContext)` method is called to produce a null value. To influence null handling, custom deserializers should override `JsonDeserializer#getNullValue(DeserializationContext)` and usually also `JsonDeserializer#getNullAccessPattern()`. Parameters p:JsonParser Parser used for reading JSON content ctxt:DeserializationContext Context that can be used to access information about this deserialization activity. Returns:Date Deserialized value Annotations @Override

public Date deserialize(JsonParser p, DeserializationContext ctxt) throws IOException

Implements abstract com.fasterxml.jackson.databind.JsonDeserializer.deserialize.

Doc from com.fasterxml.jackson.databind.JsonDeserializer.deserialize.

Method that can be called to ask implementation to deserialize JSON content into the value type this serializer handles. Returned instance is to be constructed by method itself.

Pre-condition for this method is that the parser points to the first event that is part of value to deserializer (and which is never JSON 'null' literal, more on this below): for simple types it may be the only value; and for structured types the Object start marker or a FIELD_NAME.

The two possible input conditions for structured types result from polymorphism via fields. In the ordinary case, Jackson calls this method when it has encountered an OBJECT_START, and the method implementation must advance to the next token to see the first field name. If the application configures polymorphism via a field, then the object looks like the following.

      {
          "@class": "class name",
          ...
      }

Jackson consumes the two tokens (the @class field name and its value) in order to learn the class and select the deserializer. Thus, the stream is pointing to the FIELD_NAME for the first field after the @class. Thus, if you want your method to work correctly both with and without polymorphism, you must begin your method with:

       if (p.currentToken() == JsonToken.START_OBJECT) {
         p.nextToken();
       }

This results in the stream pointing to the field name, so that the two conditions align.

Post-condition is that the parser will point to the last event that is part of deserialized value (or in case deserialization fails, event that was not recognized or usable, which may be the same event as the one it pointed to upon call).

Handling null values (JsonToken.VALUE_NULL)
: Note that this method is never called for the JSON null literal to avoid every deserializer from having to handle null values. Instead, the JsonDeserializer#getNullValue(DeserializationContext) method is called to produce a null value. To influence null handling, custom deserializers should override JsonDeserializer#getNullValue(DeserializationContext) and usually also JsonDeserializer#getNullAccessPattern().

Parameters

p:JsonParser: Parser used for reading JSON content
ctxt:DeserializationContext: Context that can be used to access information about this deserialization activity.

Returns:Date

Deserialized value

Annotations

@Override

getEmptyValue back to summary

getEmptyValue	back to summary
public Object getEmptyValue(DeserializationContext ctxt) Overrides com.fasterxml.jackson.databind.JsonDeserializer.getEmptyValue. Doc from com.fasterxml.jackson.databind.JsonDeserializer.getEmptyValue. Method called to determine value to be used for "empty" values (most commonly when deserializing from empty JSON Strings). Usually this is same as `getNullValue` (which in turn is usually simply Java null), but it can be overridden for specific types. Or, if type should never be converted from empty String, method can also throw an exception. This method may be called once, or multiple times, depending on what `getEmptyAccessPattern()` returns. Default implementation simply calls `getNullValue` and returns value. Annotations @Override

public Object getEmptyValue(DeserializationContext ctxt)

Overrides com.fasterxml.jackson.databind.JsonDeserializer.getEmptyValue.

Doc from com.fasterxml.jackson.databind.JsonDeserializer.getEmptyValue.

Method called to determine value to be used for "empty" values (most commonly when deserializing from empty JSON Strings). Usually this is same as getNullValue (which in turn is usually simply Java null), but it can be overridden for specific types. Or, if type should never be converted from empty String, method can also throw an exception.

This method may be called once, or multiple times, depending on what getEmptyAccessPattern() returns.

Default implementation simply calls getNullValue and returns value.

Annotations

@Override

withDateFormat	back to summary
protected DateDeserializers.SqlDateDeserializer withDateFormat(DateFormat df, String formatString) Implements abstract com.fasterxml.jackson.databind.deser.std.DateDeserializers.DateBasedDeserializer.withDateFormat. Annotations @Override

withDateFormat

back to summary

protected DateDeserializers.SqlDateDeserializer withDateFormat(DateFormat df, String formatString)

Implements abstract com.fasterxml.jackson.databind.deser.std.DateDeserializers.DateBasedDeserializer.withDateFormat.

Annotations

@Override

com.fasterxml.jackson.databind.deser.std back to summary

public Class DateDeserializers.TimestampDeserializer

Class Inheritance

extends DateDeserializers.DateBasedDeserializer<Timestamp>

java.lang.Object
com.fasterxml.jackson.databind.JsonDeserializer
com.fasterxml.jackson.databind.deser.std.StdDeserializer
com.fasterxml.jackson.databind.deser.std.StdScalarDeserializer
com.fasterxml.jackson.databind.deser.std.DateDeserializers.DateBasedDeserializer
com.fasterxml.jackson.databind.deser.std.DateDeserializers.TimestampDeserializer

Simple deserializer for handling java.sql.Timestamp values.

One way to customize Timestamp formats accepted is to override method DeserializationContext#parseDate that this basic deserializer calls.

Field Summary

Inherited from com.fasterxml.jackson.databind.deser.std.DateDeserializers.DateBasedDeserializer:: _customFormat _formatString

Constructor Summary

Access	Constructor and Description
public	TimestampDeserializer()
public	TimestampDeserializer(DateDeserializers.TimestampDeserializer src, DateFormat df, String formatString)

Method Summary

Modifier and Type	Method and Description
public Timestamp	deserialize(JsonParser Parser used for reading JSON content p, DeserializationContext Context that can be used to access information about this deserialization activity. ctxt) Implements abstract com.fasterxml.jackson.databind.JsonDeserializer.deserialize. Method that can be called to ask implementation to deserialize JSON content into the value type this serializer handles.
public Object	getEmptyValue(DeserializationContext ctxt) Overrides com.fasterxml.jackson.databind.JsonDeserializer.getEmptyValue. Method called to determine value to be used for "empty" values (most commonly when deserializing from empty JSON Strings).
protected DateDeserializers.TimestampDeserializer	withDateFormat(DateFormat df, String formatString) Implements abstract com.fasterxml.jackson.databind.deser.std.DateDeserializers.DateBasedDeserializer.withDateFormat.

Inherited from com.fasterxml.jackson.databind.deser.std.DateDeserializers.DateBasedDeserializer:: _parseDate createContextual logicalType

Constructor Detail

TimestampDeserializer	back to summary
public TimestampDeserializer()

TimestampDeserializer	back to summary
public TimestampDeserializer(DateDeserializers.TimestampDeserializer src, DateFormat df, String formatString)

Method Detail

deserialize back to summary

deserialize	back to summary
public Timestamp deserialize(JsonParser p, DeserializationContext ctxt) throws IOException Implements abstract com.fasterxml.jackson.databind.JsonDeserializer.deserialize. Doc from com.fasterxml.jackson.databind.JsonDeserializer.deserialize. Method that can be called to ask implementation to deserialize JSON content into the value type this serializer handles. Returned instance is to be constructed by method itself. Pre-condition for this method is that the parser points to the first event that is part of value to deserializer (and which is never JSON 'null' literal, more on this below): for simple types it may be the only value; and for structured types the Object start marker or a FIELD_NAME. The two possible input conditions for structured types result from polymorphism via fields. In the ordinary case, Jackson calls this method when it has encountered an OBJECT_START, and the method implementation must advance to the next token to see the first field name. If the application configures polymorphism via a field, then the object looks like the following. { "@class": "class name", ... } Jackson consumes the two tokens (the `@class` field name and its value) in order to learn the class and select the deserializer. Thus, the stream is pointing to the FIELD_NAME for the first field after the @class. Thus, if you want your method to work correctly both with and without polymorphism, you must begin your method with: if (p.currentToken() == JsonToken.START_OBJECT) { p.nextToken(); } This results in the stream pointing to the field name, so that the two conditions align. Post-condition is that the parser will point to the last event that is part of deserialized value (or in case deserialization fails, event that was not recognized or usable, which may be the same event as the one it pointed to upon call). Handling null values (JsonToken.VALUE_NULL) : Note that this method is never called for the JSON `null` literal to avoid every deserializer from having to handle null values. Instead, the `JsonDeserializer#getNullValue(DeserializationContext)` method is called to produce a null value. To influence null handling, custom deserializers should override `JsonDeserializer#getNullValue(DeserializationContext)` and usually also `JsonDeserializer#getNullAccessPattern()`. Parameters p:JsonParser Parser used for reading JSON content ctxt:DeserializationContext Context that can be used to access information about this deserialization activity. Returns:Timestamp Deserialized value Annotations @Override

public Timestamp deserialize(JsonParser p, DeserializationContext ctxt) throws IOException

Implements abstract com.fasterxml.jackson.databind.JsonDeserializer.deserialize.

Doc from com.fasterxml.jackson.databind.JsonDeserializer.deserialize.

Method that can be called to ask implementation to deserialize JSON content into the value type this serializer handles. Returned instance is to be constructed by method itself.

Pre-condition for this method is that the parser points to the first event that is part of value to deserializer (and which is never JSON 'null' literal, more on this below): for simple types it may be the only value; and for structured types the Object start marker or a FIELD_NAME.

The two possible input conditions for structured types result from polymorphism via fields. In the ordinary case, Jackson calls this method when it has encountered an OBJECT_START, and the method implementation must advance to the next token to see the first field name. If the application configures polymorphism via a field, then the object looks like the following.

      {
          "@class": "class name",
          ...
      }

Jackson consumes the two tokens (the @class field name and its value) in order to learn the class and select the deserializer. Thus, the stream is pointing to the FIELD_NAME for the first field after the @class. Thus, if you want your method to work correctly both with and without polymorphism, you must begin your method with:

       if (p.currentToken() == JsonToken.START_OBJECT) {
         p.nextToken();
       }

This results in the stream pointing to the field name, so that the two conditions align.

Post-condition is that the parser will point to the last event that is part of deserialized value (or in case deserialization fails, event that was not recognized or usable, which may be the same event as the one it pointed to upon call).

Handling null values (JsonToken.VALUE_NULL)
: Note that this method is never called for the JSON null literal to avoid every deserializer from having to handle null values. Instead, the JsonDeserializer#getNullValue(DeserializationContext) method is called to produce a null value. To influence null handling, custom deserializers should override JsonDeserializer#getNullValue(DeserializationContext) and usually also JsonDeserializer#getNullAccessPattern().

Parameters

p:JsonParser: Parser used for reading JSON content
ctxt:DeserializationContext: Context that can be used to access information about this deserialization activity.

Returns:Timestamp

Deserialized value

Annotations

@Override

getEmptyValue back to summary

public Object getEmptyValue(DeserializationContext ctxt)

Overrides com.fasterxml.jackson.databind.JsonDeserializer.getEmptyValue.

Doc from com.fasterxml.jackson.databind.JsonDeserializer.getEmptyValue.

Method called to determine value to be used for "empty" values (most commonly when deserializing from empty JSON Strings). Usually this is same as getNullValue (which in turn is usually simply Java null), but it can be overridden for specific types. Or, if type should never be converted from empty String, method can also throw an exception.

This method may be called once, or multiple times, depending on what getEmptyAccessPattern() returns.

Default implementation simply calls getNullValue and returns value.

Annotations

@Override

withDateFormat

back to summary

protected DateDeserializers.TimestampDeserializer withDateFormat(DateFormat df, String formatString)

Implements abstract com.fasterxml.jackson.databind.deser.std.DateDeserializers.DateBasedDeserializer.withDateFormat.

Annotations

@Override

public Class DateDeserializers

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public Class DateDeserializers.CalendarDeserializer

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

protected abstract Class DateDeserializers.DateBasedDeserializer<T>

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public Class DateDeserializers.DateDeserializer

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public Class DateDeserializers.SqlDateDeserializer

Field Summary

Constructor Summary

Method Summary

Constructor Detail

Method Detail

public Class DateDeserializers.TimestampDeserializer

Field Summary

Constructor Summary

Method Summary

Constructor Detail

Method Detail