ObjectReader (jackson-databind 2.7.0 API)

java.lang.Object
- com.fasterxml.jackson.core.TreeCodec
- - com.fasterxml.jackson.core.ObjectCodec
  - - com.fasterxml.jackson.databind.ObjectReader

All Implemented Interfaces:

Versioned, Serializable
```
public class ObjectReader
extends ObjectCodec
implements Versioned, Serializable
```
Builder object that can be used for per-serialization configuration of deserialization parameters, such as root type to use or object to update (instead of constructing new instance).
Uses "mutant factory" pattern so that instances are immutable (and thus fully thread-safe with no external synchronization); new instances are constructed for different configurations. Instances are initially constructed by ObjectMapper and can be reused, shared, cached; both because of thread-safety and because instances are relatively light-weight.

See Also:
Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`protected DeserializationConfig`	`_config` General serialization configuration settings; while immutable, can use copy-constructor to create modified instances as necessary.
`protected DefaultDeserializationContext`	`_context` Blueprint instance of deserialization context; used for creating actual instance when needed.
`protected DataFormatReaders`	`_dataFormatReaders` Optional detector used for auto-detecting data format that byte-based input uses.
`protected InjectableValues`	`_injectableValues` Values that can be injected during deserialization, if any.
`protected JsonFactory`	`_parserFactory` Factory used for constructing `JsonGenerator`s
`protected JsonDeserializer<Object>`	`_rootDeserializer` We may pre-fetch deserializer as soon as `_valueType` is known, and if so, reuse it afterwards.
`protected ConcurrentHashMap<JavaType,JsonDeserializer<Object>>`	`_rootDeserializers` Root-level cached deserializers.
`protected FormatSchema`	`_schema` When using data format that uses a schema, schema is passed to parser.
`protected boolean`	`_unwrapRoot` Flag that indicates whether root values are expected to be unwrapped or not
`protected Object`	`_valueToUpdate` Instance to update with data binding; if any.
`protected JavaType`	`_valueType` Declared type of value to instantiate during deserialization.

Constructor Summary

Constructors
Modifier	Constructor and Description
`protected`	`ObjectReader(ObjectMapper mapper, DeserializationConfig config)` Constructor used by `ObjectMapper` for initial instantiation
`protected`	`ObjectReader(ObjectMapper mapper, DeserializationConfig config, JavaType valueType, Object valueToUpdate, FormatSchema schema, InjectableValues injectableValues)` Constructor called when a root deserializer should be fetched based on other configuration.
`protected`	`ObjectReader(ObjectReader base, DeserializationConfig config)` Copy constructor used when modifying simple feature flags
`protected`	`ObjectReader(ObjectReader base, DeserializationConfig config, JavaType valueType, JsonDeserializer<Object> rootDeser, Object valueToUpdate, FormatSchema schema, InjectableValues injectableValues, DataFormatReaders dataFormatReaders)` Copy constructor used for building variations.
`protected`	`ObjectReader(ObjectReader base, JsonFactory f)`
`protected`	`ObjectReader(ObjectReader base, TokenFilter filter)`

Method Summary

Methods
Modifier and Type	Method and Description
`protected Object`	`_bind(JsonParser p, Object valueToUpdate)` Actual implementation of value reading+binding operation.
`protected Object`	`_bindAndClose(JsonParser p)`
`protected JsonNode`	`_bindAndCloseAsTree(JsonParser p)`
`protected <T> MappingIterator<T>`	`_bindAndReadValues(JsonParser p)`
`protected JsonNode`	`_bindAsTree(JsonParser p)`
`protected JsonParser`	`_considerFilter(JsonParser p)` Consider filter when creating JsonParser.
`protected Object`	`_detectBindAndClose(byte[] src, int offset, int length)`
`protected Object`	`_detectBindAndClose(DataFormatReaders.Match match, boolean forceClosing)`
`protected JsonNode`	`_detectBindAndCloseAsTree(InputStream in)`
`protected <T> MappingIterator<T>`	`_detectBindAndReadValues(DataFormatReaders.Match match, boolean forceClosing)`
`protected JsonDeserializer<Object>`	`_findRootDeserializer(DeserializationContext ctxt)` Method called to locate deserializer for the passed root-level value.
`protected JsonDeserializer<Object>`	`_findTreeDeserializer(DeserializationContext ctxt)`
`protected void`	`_initForMultiRead(JsonParser p)` Alternative to `_initForReading(JsonParser)` used in cases where reading of multiple values means that we may or may not want to advance the stream, but need to do other initialization.
`protected JsonToken`	`_initForReading(JsonParser p)` NOTE: changed from static to non-static in 2.5; unfortunate but necessary change to support overridability
`protected InputStream`	`_inputStream(File f)`
`protected InputStream`	`_inputStream(URL src)`
`protected ObjectReader`	`_new(ObjectReader base, DeserializationConfig config)` Overridable factory method called by various "withXxx()" methods
`protected ObjectReader`	`_new(ObjectReader base, DeserializationConfig config, JavaType valueType, JsonDeserializer<Object> rootDeser, Object valueToUpdate, FormatSchema schema, InjectableValues injectableValues, DataFormatReaders dataFormatReaders)` Overridable factory method called by various "withXxx()" methods
`protected ObjectReader`	`_new(ObjectReader base, JsonFactory f)` Overridable factory method called by various "withXxx()" methods
`protected <T> MappingIterator<T>`	`_newIterator(JsonParser p, DeserializationContext ctxt, JsonDeserializer<?> deser, boolean parserManaged)` Factory method used to create `MappingIterator` instances; either default, or custom subtype.
`protected JsonDeserializer<Object>`	`_prefetchRootDeserializer(JavaType valueType)` Method called to locate deserializer ahead of time, if permitted by configuration.
`protected void`	`_reportUndetectableSource(Object src)`
`protected void`	`_reportUnkownFormat(DataFormatReaders detector, DataFormatReaders.Match match)` Method called to indicate that format detection failed to detect format of given input
`protected Object`	`_unwrapAndDeserialize(JsonParser p, DeserializationContext ctxt, JavaType rootType, JsonDeserializer<Object> deser)`
`protected void`	`_verifySchemaType(FormatSchema schema)`
`protected ObjectReader`	`_with(DeserializationConfig newConfig)`
`ObjectReader`	`at(JsonPointer pointer)` Convenience method to bind from `JsonPointer` `JsonPointerBasedFilter` is registered and will be used for parsing later.
`ObjectReader`	`at(String value)` Convenience method to bind from `JsonPointer`.
`JsonNode`	`createArrayNode()`
`protected DefaultDeserializationContext`	`createDeserializationContext(JsonParser p)` Internal helper method called to create an instance of `DeserializationContext` for deserializing a single root value.
`JsonNode`	`createObjectNode()`
`ObjectReader`	`forType(Class<?> valueType)` Method for constructing a new reader instance that is configured to data bind into specified type.
`ObjectReader`	`forType(JavaType valueType)` Method for constructing a new reader instance that is configured to data bind into specified type.
`ObjectReader`	`forType(TypeReference<?> valueTypeRef)` Method for constructing a new reader instance that is configured to data bind into specified type.
`ContextAttributes`	`getAttributes()`
`DeserializationConfig`	`getConfig()`
`JsonFactory`	`getFactory()`
`InjectableValues`	`getInjectableValues()`
`TypeFactory`	`getTypeFactory()`
`boolean`	`isEnabled(DeserializationFeature f)`
`boolean`	`isEnabled(JsonParser.Feature f)`
`boolean`	`isEnabled(MapperFeature f)`
`JsonNode`	`readTree(InputStream in)` Method that reads content from given input source, using configuration of this reader, and binds it as JSON Tree.
`<T extends TreeNode> T`	`readTree(JsonParser p)` Convenience method that binds content read using given parser, using configuration of this reader, except that content is bound as JSON tree instead of configured root value type.
`JsonNode`	`readTree(Reader r)` Method that reads content from given input source, using configuration of this reader, and binds it as JSON Tree.
`JsonNode`	`readTree(String json)` Method that reads content from given JSON input String, using configuration of this reader, and binds it as JSON Tree.
`<T> T`	`readValue(byte[] src)` Method that binds content read from given byte array, using configuration of this reader.
`<T> T`	`readValue(byte[] src, int offset, int length)` Method that binds content read from given byte array, using configuration of this reader.
`<T> T`	`readValue(File src)`
`<T> T`	`readValue(InputStream src)` Method that binds content read from given input source, using configuration of this reader.
`<T> T`	`readValue(JsonNode src)` Convenience method for converting results from given JSON tree into given value type.
`<T> T`	`readValue(JsonParser p)` Method that binds content read using given parser, using configuration of this reader, including expected result type.
`<T> T`	`readValue(JsonParser p, Class<T> valueType)` Convenience method that binds content read using given parser, using configuration of this reader, except that expected value type is specified with the call (instead of currently configured root type).
`<T> T`	`readValue(JsonParser p, JavaType valueType)` Type-safe overloaded method, basically alias for `readValue(JsonParser, ResolvedType)`.
`<T> T`	`readValue(JsonParser p, ResolvedType valueType)` Convenience method that binds content read using given parser, using configuration of this reader, except that expected value type is specified with the call (instead of currently configured root type).
`<T> T`	`readValue(JsonParser p, TypeReference<?> valueTypeRef)` Convenience method that binds content read using given parser, using configuration of this reader, except that expected value type is specified with the call (instead of currently configured root type).
`<T> T`	`readValue(Reader src)` Method that binds content read from given input source, using configuration of this reader.
`<T> T`	`readValue(String src)` Method that binds content read from given JSON string, using configuration of this reader.
`<T> T`	`readValue(URL src)` Method that binds content read from given input source, using configuration of this reader.
`<T> MappingIterator<T>`	`readValues(byte[] src)` Overloaded version of `readValue(InputStream)`.
`<T> MappingIterator<T>`	`readValues(byte[] src, int offset, int length)` Overloaded version of `readValue(InputStream)`.
`<T> MappingIterator<T>`	`readValues(File src)` Overloaded version of `readValue(InputStream)`.
`<T> MappingIterator<T>`	`readValues(InputStream src)` Method for reading sequence of Objects from parser stream.
`<T> MappingIterator<T>`	`readValues(JsonParser p)` Method for reading sequence of Objects from parser stream.
`<T> Iterator<T>`	`readValues(JsonParser p, Class<T> valueType)` Convenience method that is equivalent to:
`<T> Iterator<T>`	`readValues(JsonParser p, JavaType valueType)` Convenience method that is equivalent to:
`<T> Iterator<T>`	`readValues(JsonParser p, ResolvedType valueType)` Convenience method that is equivalent to:
`<T> Iterator<T>`	`readValues(JsonParser p, TypeReference<?> valueTypeRef)` Convenience method that is equivalent to:
`<T> MappingIterator<T>`	`readValues(Reader src)` Overloaded version of `readValue(InputStream)`.
`<T> MappingIterator<T>`	`readValues(String json)` Overloaded version of `readValue(InputStream)`.
`<T> MappingIterator<T>`	`readValues(URL src)` Overloaded version of `readValue(InputStream)`.
`JsonParser`	`treeAsTokens(TreeNode n)`
`<T> T`	`treeToValue(TreeNode n, Class<T> valueType)`
`Version`	`version()` Method that will return version information stored in and read from jar that contains this class.
`ObjectReader`	`with(Base64Variant defaultBase64)`
`ObjectReader`	`with(ContextAttributes attrs)`
`ObjectReader`	`with(DeserializationConfig config)` Mutant factory method that will construct a new instance that has specified underlying `DeserializationConfig`.
`ObjectReader`	`with(DeserializationFeature feature)` Method for constructing a new reader instance that is configured with specified feature enabled.
`ObjectReader`	`with(DeserializationFeature first, DeserializationFeature... other)` Method for constructing a new reader instance that is configured with specified features enabled.
`ObjectReader`	`with(FormatFeature feature)` Method for constructing a new reader instance that is configured with specified feature enabled.
`ObjectReader`	`with(FormatSchema schema)` Method for constructing a new instance with configuration that passes specified `FormatSchema` to `JsonParser` that is constructed for parsing content.
`ObjectReader`	`with(InjectableValues injectableValues)` Method for constructing a new instance with configuration that uses passed `InjectableValues` to provide injectable values.
`ObjectReader`	`with(JsonFactory f)` Method for constructing a new reader instance with configuration that uses passed `JsonFactory` for constructing underlying Readers.
`ObjectReader`	`with(JsonNodeFactory f)` Method for constructing a new reader instance with configuration that uses passed `JsonNodeFactory` for constructing `JsonNode` instances.
`ObjectReader`	`with(JsonParser.Feature feature)` Method for constructing a new reader instance that is configured with specified feature enabled.
`ObjectReader`	`with(Locale l)`
`ObjectReader`	`with(TimeZone tz)`
`ObjectReader`	`withAttribute(Object key, Object value)`
`ObjectReader`	`withAttributes(Map<?,?> attrs)`
`ObjectReader`	`withFeatures(DeserializationFeature... features)` Method for constructing a new reader instance that is configured with specified features enabled.
`ObjectReader`	`withFeatures(FormatFeature... features)` Method for constructing a new reader instance that is configured with specified features enabled.
`ObjectReader`	`withFeatures(JsonParser.Feature... features)` Method for constructing a new reader instance that is configured with specified features enabled.
`ObjectReader`	`withFormatDetection(DataFormatReaders readers)` Fluent factory method for constructing a reader that will try to auto-detect underlying data format, using specified `DataFormatReaders`.
`ObjectReader`	`withFormatDetection(ObjectReader... readers)` Fluent factory method for constructing a reader that will try to auto-detect underlying data format, using specified list of `JsonFactory` instances, and default `DataFormatReaders` settings (for customized `DataFormatReaders`, you can construct instance yourself).
`ObjectReader`	`withHandler(DeserializationProblemHandler h)`
`ObjectReader`	`without(DeserializationFeature feature)` Method for constructing a new reader instance that is configured with specified feature disabled.
`ObjectReader`	`without(DeserializationFeature first, DeserializationFeature... other)` Method for constructing a new reader instance that is configured with specified features disabled.
`ObjectReader`	`without(FormatFeature feature)` Method for constructing a new reader instance that is configured with specified feature disabled.
`ObjectReader`	`without(JsonParser.Feature feature)` Method for constructing a new reader instance that is configured with specified feature disabled.
`ObjectReader`	`withoutAttribute(Object key)`
`ObjectReader`	`withoutFeatures(DeserializationFeature... features)` Method for constructing a new reader instance that is configured with specified features disabled.
`ObjectReader`	`withoutFeatures(FormatFeature... features)` Method for constructing a new reader instance that is configured with specified features disabled.
`ObjectReader`	`withoutFeatures(JsonParser.Feature... features)` Method for constructing a new reader instance that is configured with specified features disabled.
`ObjectReader`	`withoutRootName()` Convenience method that is same as calling: `withRootName("")` which will forcibly prevent use of root name wrapping when writing values with this `ObjectReader`.
`ObjectReader`	`withRootName(PropertyName rootName)`
`ObjectReader`	`withRootName(String rootName)` Method for constructing a new instance with configuration that specifies what root name to expect for "root name unwrapping".
`ObjectReader`	`withType(Class<?> valueType)` Deprecated. since 2.5 Use `forType(Class)` instead
`ObjectReader`	`withType(JavaType valueType)` Deprecated. since 2.5 Use `forType(JavaType)` instead
`ObjectReader`	`withType(Type valueType)` Deprecated. since 2.5 Use `forType(Class)` instead
`ObjectReader`	`withType(TypeReference<?> valueTypeRef)` Deprecated. since 2.5 Use `forType(TypeReference)` instead
`ObjectReader`	`withValueToUpdate(Object value)` Method for constructing a new instance with configuration that updates passed Object (as root value), instead of constructing a new value.
`ObjectReader`	`withView(Class<?> activeView)` Method for constructing a new instance with configuration that uses specified View for filtering.
`void`	`writeTree(JsonGenerator jgen, TreeNode rootNode)`
`void`	`writeValue(JsonGenerator gen, Object value)`

Methods inherited from class com.fasterxml.jackson.core.ObjectCodec
getJsonFactory

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - _config
```
protected final DeserializationConfig _config
```
    General serialization configuration settings; while immutable, can use copy-constructor to create modified instances as necessary.
  - _context
```
protected final DefaultDeserializationContext _context
```
    Blueprint instance of deserialization context; used for creating actual instance when needed.
  - _parserFactory
```
protected final JsonFactory _parserFactory
```
    Factory used for constructing JsonGenerators
  - _unwrapRoot
```
protected final boolean _unwrapRoot
```
    Flag that indicates whether root values are expected to be unwrapped or not
  - _valueType
```
protected final JavaType _valueType
```
    Declared type of value to instantiate during deserialization. Defines which deserializer to use; as well as base type of instance to construct if an updatable value is not configured to be used (subject to changes by embedded type information, for polymorphic types). If _valueToUpdate is non-null, only used for locating deserializer.
  - _rootDeserializer
```
protected final JsonDeserializer<Object> _rootDeserializer
```
    We may pre-fetch deserializer as soon as _valueType is known, and if so, reuse it afterwards. This allows avoiding further deserializer lookups and increases performance a bit on cases where readers are reused.
    
    Since:
    
    2.1
  - _valueToUpdate
```
protected final Object _valueToUpdate
```
    Instance to update with data binding; if any. If null, a new instance is created, if non-null, properties of this value object will be updated instead. Note that value can be of almost any type, except not ArrayType; array types can not be modified because array size is immutable.
  - _schema
```
protected final FormatSchema _schema
```
    When using data format that uses a schema, schema is passed to parser.
  - _injectableValues
```
protected final InjectableValues _injectableValues
```
    Values that can be injected during deserialization, if any.
  - _dataFormatReaders
```
protected final DataFormatReaders _dataFormatReaders
```
    Optional detector used for auto-detecting data format that byte-based input uses.
    NOTE: If defined non-null, readValue() methods that take Reader or String input will fail with exception, because format-detection only works on byte-sources. Also, if format can not be detect reliably (as per detector settings), a JsonParseException will be thrown).
    
    Since:
    
    2.1
  - _rootDeserializers
```
protected final ConcurrentHashMap<JavaType,JsonDeserializer<Object>> _rootDeserializers
```
    Root-level cached deserializers. Passed by ObjectMapper, shared with it.
- Constructor Detail
  - ObjectReader
```
protected ObjectReader(ObjectMapper mapper,
            DeserializationConfig config)
```
    Constructor used by ObjectMapper for initial instantiation
  - ObjectReader
```
protected ObjectReader(ObjectMapper mapper,
            DeserializationConfig config,
            JavaType valueType,
            Object valueToUpdate,
            FormatSchema schema,
            InjectableValues injectableValues)
```
    Constructor called when a root deserializer should be fetched based on other configuration.
  - ObjectReader
```
protected ObjectReader(ObjectReader base,
            DeserializationConfig config,
            JavaType valueType,
            JsonDeserializer<Object> rootDeser,
            Object valueToUpdate,
            FormatSchema schema,
            InjectableValues injectableValues,
            DataFormatReaders dataFormatReaders)
```
    Copy constructor used for building variations.
  - ObjectReader
```
protected ObjectReader(ObjectReader base,
            DeserializationConfig config)
```
    Copy constructor used when modifying simple feature flags
  - ObjectReader
```
protected ObjectReader(ObjectReader base,
            JsonFactory f)
```
  - ObjectReader
```
protected ObjectReader(ObjectReader base,
            TokenFilter filter)
```
- Method Detail
  - version
```
public Version version()
```
    Method that will return version information stored in and read from jar that contains this class.
    
    Specified by:
    
    version in interface Versioned
    
    Overrides:
    
    version in class ObjectCodec
  - _new
```
protected ObjectReader _new(ObjectReader base,
                JsonFactory f)
```
    Overridable factory method called by various "withXxx()" methods
    
    Since:
    
    2.5
  - _new
```
protected ObjectReader _new(ObjectReader base,
                DeserializationConfig config)
```
    Overridable factory method called by various "withXxx()" methods
    
    Since:
    
    2.5
  - _new
```
protected ObjectReader _new(ObjectReader base,
                DeserializationConfig config,
                JavaType valueType,
                JsonDeserializer<Object> rootDeser,
                Object valueToUpdate,
                FormatSchema schema,
                InjectableValues injectableValues,
                DataFormatReaders dataFormatReaders)
```
    Overridable factory method called by various "withXxx()" methods
    
    Since:
    
    2.5
  - _newIterator
```
protected <T> MappingIterator<T> _newIterator(JsonParser p,
                                  DeserializationContext ctxt,
                                  JsonDeserializer<?> deser,
                                  boolean parserManaged)
```
    Factory method used to create MappingIterator instances; either default, or custom subtype.
    
    Since:
    
    2.5
  - _initForReading
```
protected JsonToken _initForReading(JsonParser p)
                             throws IOException
```
    NOTE: changed from static to non-static in 2.5; unfortunate but necessary change to support overridability
    
    Throws:
    
    IOException
  - _initForMultiRead
```
protected void _initForMultiRead(JsonParser p)
                          throws IOException
```
    Alternative to _initForReading(JsonParser) used in cases where reading of multiple values means that we may or may not want to advance the stream, but need to do other initialization.
    Base implementation only sets configured FormatSchema, if any, on parser.
    
    Throws:
    
    IOException
    Since:
    
    2.5
  - with
```
public ObjectReader with(DeserializationFeature feature)
```
    Method for constructing a new reader instance that is configured with specified feature enabled.
  - with
```
public ObjectReader with(DeserializationFeature first,
                DeserializationFeature... other)
```
    Method for constructing a new reader instance that is configured with specified features enabled.
  - withFeatures
```
public ObjectReader withFeatures(DeserializationFeature... features)
```
    Method for constructing a new reader instance that is configured with specified features enabled.
  - without
```
public ObjectReader without(DeserializationFeature feature)
```
    Method for constructing a new reader instance that is configured with specified feature disabled.
  - without
```
public ObjectReader without(DeserializationFeature first,
                   DeserializationFeature... other)
```
    Method for constructing a new reader instance that is configured with specified features disabled.
  - withoutFeatures
```
public ObjectReader withoutFeatures(DeserializationFeature... features)
```
    Method for constructing a new reader instance that is configured with specified features disabled.
  - with
```
public ObjectReader with(JsonParser.Feature feature)
```
    Method for constructing a new reader instance that is configured with specified feature enabled.
  - withFeatures
```
public ObjectReader withFeatures(JsonParser.Feature... features)
```
    Method for constructing a new reader instance that is configured with specified features enabled.
  - without
```
public ObjectReader without(JsonParser.Feature feature)
```
    Method for constructing a new reader instance that is configured with specified feature disabled.
  - withoutFeatures
```
public ObjectReader withoutFeatures(JsonParser.Feature... features)
```
    Method for constructing a new reader instance that is configured with specified features disabled.
  - with
```
public ObjectReader with(FormatFeature feature)
```
    Method for constructing a new reader instance that is configured with specified feature enabled.
    
    Since:
    
    2.7
  - withFeatures
```
public ObjectReader withFeatures(FormatFeature... features)
```
    Method for constructing a new reader instance that is configured with specified features enabled.
    
    Since:
    
    2.7
  - without
```
public ObjectReader without(FormatFeature feature)
```
    Method for constructing a new reader instance that is configured with specified feature disabled.
    
    Since:
    
    2.7
  - withoutFeatures
```
public ObjectReader withoutFeatures(FormatFeature... features)
```
    Method for constructing a new reader instance that is configured with specified features disabled.
    
    Since:
    
    2.7
  - with
```
public ObjectReader with(DeserializationConfig config)
```
    Mutant factory method that will construct a new instance that has specified underlying DeserializationConfig.
    NOTE: use of this method is not recommended, as there are many other re-configuration methods available.
  - with
```
public ObjectReader with(InjectableValues injectableValues)
```
    Method for constructing a new instance with configuration that uses passed InjectableValues to provide injectable values.
    Note that the method does NOT change state of this reader, but rather construct and returns a newly configured instance.
  - with
```
public ObjectReader with(JsonNodeFactory f)
```
    Method for constructing a new reader instance with configuration that uses passed JsonNodeFactory for constructing JsonNode instances.
    Note that the method does NOT change state of this reader, but rather construct and returns a newly configured instance.
  - with
```
public ObjectReader with(JsonFactory f)
```
    Method for constructing a new reader instance with configuration that uses passed JsonFactory for constructing underlying Readers.
    NOTE: only factories that DO NOT REQUIRE SPECIAL MAPPERS (that is, ones that return false for JsonFactory.requiresCustomCodec()) can be used: trying to use one that requires custom codec will throw exception
    
    Since:
    
    2.1
  - withRootName
```
public ObjectReader withRootName(String rootName)
```
    Method for constructing a new instance with configuration that specifies what root name to expect for "root name unwrapping". See MapperConfigBase.withRootName(String) for details.
    Note that the method does NOT change state of this reader, but rather construct and returns a newly configured instance.
  - withRootName
```
public ObjectReader withRootName(PropertyName rootName)
```
    Since:
    
    2.6
  - withoutRootName
```
public ObjectReader withoutRootName()
```
    Convenience method that is same as calling: withRootName("") which will forcibly prevent use of root name wrapping when writing values with this ObjectReader.
    
    Since:
    
    2.6
  - with
```
public ObjectReader with(FormatSchema schema)
```
    Method for constructing a new instance with configuration that passes specified FormatSchema to JsonParser that is constructed for parsing content.
    Note that the method does NOT change state of this reader, but rather construct and returns a newly configured instance.
  - forType
```
public ObjectReader forType(JavaType valueType)
```
    Method for constructing a new reader instance that is configured to data bind into specified type.
    Note that the method does NOT change state of this reader, but rather construct and returns a newly configured instance.
    
    Since:
    
    2.5
  - forType
```
public ObjectReader forType(Class<?> valueType)
```
    Method for constructing a new reader instance that is configured to data bind into specified type.
    Note that the method does NOT change state of this reader, but rather construct and returns a newly configured instance.
    
    Since:
    
    2.5
  - forType
```
public ObjectReader forType(TypeReference<?> valueTypeRef)
```
    Method for constructing a new reader instance that is configured to data bind into specified type.
    Note that the method does NOT change state of this reader, but rather construct and returns a newly configured instance.
    
    Since:
    
    2.5
  - withType
```
@Deprecated
public ObjectReader withType(JavaType valueType)
```
    Deprecated. since 2.5 Use forType(JavaType) instead
  - withType
```
@Deprecated
public ObjectReader withType(Class<?> valueType)
```
    Deprecated. since 2.5 Use forType(Class) instead
  - withType
```
@Deprecated
public ObjectReader withType(Type valueType)
```
    Deprecated. since 2.5 Use forType(Class) instead
  - withType
```
@Deprecated
public ObjectReader withType(TypeReference<?> valueTypeRef)
```
    Deprecated. since 2.5 Use forType(TypeReference) instead
  - withValueToUpdate
```
public ObjectReader withValueToUpdate(Object value)
```
    Method for constructing a new instance with configuration that updates passed Object (as root value), instead of constructing a new value.
    Note that the method does NOT change state of this reader, but rather construct and returns a newly configured instance.
  - withView
```
public ObjectReader withView(Class<?> activeView)
```
    Method for constructing a new instance with configuration that uses specified View for filtering.
    Note that the method does NOT change state of this reader, but rather construct and returns a newly configured instance.
  - with
```
public ObjectReader with(Locale l)
```
  - with
```
public ObjectReader with(TimeZone tz)
```
  - withHandler
```
public ObjectReader withHandler(DeserializationProblemHandler h)
```
  - with
```
public ObjectReader with(Base64Variant defaultBase64)
```
  - withFormatDetection
```
public ObjectReader withFormatDetection(ObjectReader... readers)
```
    Fluent factory method for constructing a reader that will try to auto-detect underlying data format, using specified list of JsonFactory instances, and default DataFormatReaders settings (for customized DataFormatReaders, you can construct instance yourself). to construct appropriate JsonParser for actual parsing.
    Note: since format detection only works with byte sources, it is possible to get a failure from some 'readValue()' methods. Also, if input can not be reliably (enough) detected as one of specified types, an exception will be thrown.
    Note: not all JsonFactory types can be passed: specifically, ones that require "custom codec" (like XML factory) will not work. Instead, use method that takes ObjectReader instances instead of factories.
    
    Parameters:
    readers - Data formats accepted, in decreasing order of priority (that is, matches checked in listed order, first match wins)
    
    Returns:
    Newly configured writer instance
    Since:
    
    2.1
  - withFormatDetection
```
public ObjectReader withFormatDetection(DataFormatReaders readers)
```
    Fluent factory method for constructing a reader that will try to auto-detect underlying data format, using specified DataFormatReaders.
    NOTE: since format detection only works with byte sources, it is possible to get a failure from some 'readValue()' methods. Also, if input can not be reliably (enough) detected as one of specified types, an exception will be thrown.
    
    Parameters:
    readers - DataFormatReaders to use for detecting underlying format.
    
    Returns:
    Newly configured writer instance
    Since:
    
    2.1
  - with
```
public ObjectReader with(ContextAttributes attrs)
```
    Since:
    
    2.3
  - withAttributes
```
public ObjectReader withAttributes(Map<?,?> attrs)
```
    Since:
    
    2.3
  - withAttribute
```
public ObjectReader withAttribute(Object key,
                         Object value)
```
    Since:
    
    2.3
  - withoutAttribute
```
public ObjectReader withoutAttribute(Object key)
```
    Since:
    
    2.3
  - _with
```
protected ObjectReader _with(DeserializationConfig newConfig)
```
  - isEnabled
```
public boolean isEnabled(DeserializationFeature f)
```
  - isEnabled
```
public boolean isEnabled(MapperFeature f)
```
  - isEnabled
```
public boolean isEnabled(JsonParser.Feature f)
```
  - getConfig
```
public DeserializationConfig getConfig()
```
    Since:
    
    2.2
  - getFactory
```
public JsonFactory getFactory()
```
    Overrides:
    
    getFactory in class ObjectCodec
    
    Since:
    
    2.1
  - getTypeFactory
```
public TypeFactory getTypeFactory()
```
  - getAttributes
```
public ContextAttributes getAttributes()
```
    Since:
    
    2.3
  - getInjectableValues
```
public InjectableValues getInjectableValues()
```
    Since:
    
    2.6
  - readValue
```
public <T> T readValue(JsonParser p)
            throws IOException
```
    Method that binds content read using given parser, using configuration of this reader, including expected result type. Value return is either newly constructed, or root value that was specified with withValueToUpdate(Object).
    NOTE: this method never tries to auto-detect format, since actual (data-format specific) parser is given.
    
    Throws:
    
    IOException
  - readValue
```
public <T> T readValue(JsonParser p,
              Class<T> valueType)
            throws IOException
```
    Convenience method that binds content read using given parser, using configuration of this reader, except that expected value type is specified with the call (instead of currently configured root type). Value return is either newly constructed, or root value that was specified with withValueToUpdate(Object).
    NOTE: this method never tries to auto-detect format, since actual (data-format specific) parser is given.
    
    Specified by:
    
    readValue in class ObjectCodec
    
    Throws:
    
    IOException
  - readValue
```
public <T> T readValue(JsonParser p,
              TypeReference<?> valueTypeRef)
            throws IOException
```
    Convenience method that binds content read using given parser, using configuration of this reader, except that expected value type is specified with the call (instead of currently configured root type). Value return is either newly constructed, or root value that was specified with withValueToUpdate(Object).
    NOTE: this method never tries to auto-detect format, since actual (data-format specific) parser is given.
    
    Specified by:
    
    readValue in class ObjectCodec
    
    Throws:
    
    IOException
  - readValue
```
public <T> T readValue(JsonParser p,
              ResolvedType valueType)
            throws IOException,
                   JsonProcessingException
```
    Convenience method that binds content read using given parser, using configuration of this reader, except that expected value type is specified with the call (instead of currently configured root type). Value return is either newly constructed, or root value that was specified with withValueToUpdate(Object).
    NOTE: this method never tries to auto-detect format, since actual (data-format specific) parser is given.
    
    Specified by:
    
    readValue in class ObjectCodec
    
    Throws:
    
    IOException
    
    JsonProcessingException
  - readValue
```
public <T> T readValue(JsonParser p,
              JavaType valueType)
            throws IOException
```
    Type-safe overloaded method, basically alias for readValue(JsonParser, ResolvedType).
    NOTE: this method never tries to auto-detect format, since actual (data-format specific) parser is given.
    
    Throws:
    
    IOException
  - readValues
```
public <T> Iterator<T> readValues(JsonParser p,
                         Class<T> valueType)
                       throws IOException
```
    Convenience method that is equivalent to:
```
   withType(valueType).readValues(p);
```
    Method reads a sequence of Objects from parser stream. Sequence can be either root-level "unwrapped" sequence (without surrounding JSON array), or a sequence contained in a JSON Array. In either case JsonParser MUST point to the first token of the first element, OR not point to any token (in which case it is advanced to the next token). This means, specifically, that for wrapped sequences, parser MUST NOT point to the surrounding START_ARRAY (one that contains values to read) but rather to the token following it which is the first token of the first value to read.
    NOTE: this method never tries to auto-detect format, since actual (data-format specific) parser is given.
    Specified by:
    
    readValues in class ObjectCodec
    
    Throws:
    
    IOException
  - readValues
```
public <T> Iterator<T> readValues(JsonParser p,
                         TypeReference<?> valueTypeRef)
                       throws IOException
```
    Convenience method that is equivalent to:
```
   withType(valueTypeRef).readValues(p);
```
    Method reads a sequence of Objects from parser stream. Sequence can be either root-level "unwrapped" sequence (without surrounding JSON array), or a sequence contained in a JSON Array. In either case JsonParser MUST point to the first token of the first element, OR not point to any token (in which case it is advanced to the next token). This means, specifically, that for wrapped sequences, parser MUST NOT point to the surrounding START_ARRAY (one that contains values to read) but rather to the token following it which is the first token of the first value to read.
    NOTE: this method never tries to auto-detect format, since actual (data-format specific) parser is given.
    Specified by:
    
    readValues in class ObjectCodec
    
    Throws:
    
    IOException
  - readValues
```
public <T> Iterator<T> readValues(JsonParser p,
                         ResolvedType valueType)
                       throws IOException
```
    Convenience method that is equivalent to:
```
   withType(valueType).readValues(p);
```
    Method reads a sequence of Objects from parser stream. Sequence can be either root-level "unwrapped" sequence (without surrounding JSON array), or a sequence contained in a JSON Array. In either case JsonParser MUST point to the first token of the first element, OR not point to any token (in which case it is advanced to the next token). This means, specifically, that for wrapped sequences, parser MUST NOT point to the surrounding START_ARRAY (one that contains values to read) but rather to the token following it which is the first token of the first value to read.
    NOTE: this method never tries to auto-detect format, since actual (data-format specific) parser is given.
    Specified by:
    
    readValues in class ObjectCodec
    
    Throws:
    
    IOException
  - readValues
```
public <T> Iterator<T> readValues(JsonParser p,
                         JavaType valueType)
                       throws IOException
```
    Convenience method that is equivalent to:
```
   withType(valueType).readValues(p);
```
    Method reads a sequence of Objects from parser stream. Sequence can be either root-level "unwrapped" sequence (without surrounding JSON array), or a sequence contained in a JSON Array. In either case JsonParser MUST point to the first token of the first element, OR not point to any token (in which case it is advanced to the next token). This means, specifically, that for wrapped sequences, parser MUST NOT point to the surrounding START_ARRAY (one that contains values to read) but rather to the token following it which is the first token of the first value to read.
    NOTE: this method never tries to auto-detect format, since actual (data-format specific) parser is given.
    Throws:
    
    IOException
  - createArrayNode
```
public JsonNode createArrayNode()
```
    Specified by:
    
    createArrayNode in class ObjectCodec
  - createObjectNode
```
public JsonNode createObjectNode()
```
    Specified by:
    
    createObjectNode in class ObjectCodec
  - treeAsTokens
```
public JsonParser treeAsTokens(TreeNode n)
```
    Specified by:
    
    treeAsTokens in class ObjectCodec
  - readTree
```
public <T extends TreeNode> T readTree(JsonParser p)
                            throws IOException
```
    Convenience method that binds content read using given parser, using configuration of this reader, except that content is bound as JSON tree instead of configured root value type.
    Note: if an object was specified with withValueToUpdate(java.lang.Object), it will be ignored.
    NOTE: this method never tries to auto-detect format, since actual (data-format specific) parser is given.
    
    Specified by:
    
    readTree in class ObjectCodec
    
    Throws:
    
    IOException
  - writeTree
```
public void writeTree(JsonGenerator jgen,
             TreeNode rootNode)
```
    Specified by:
    
    writeTree in class ObjectCodec
  - readValue
```
public <T> T readValue(InputStream src)
            throws IOException,
                   JsonProcessingException
```
    Method that binds content read from given input source, using configuration of this reader. Value return is either newly constructed, or root value that was specified with withValueToUpdate(Object).
    
    Throws:
    
    IOException
    
    JsonProcessingException
  - readValue
```
public <T> T readValue(Reader src)
            throws IOException,
                   JsonProcessingException
```
    Method that binds content read from given input source, using configuration of this reader. Value return is either newly constructed, or root value that was specified with withValueToUpdate(Object).
    
    Throws:
    
    IOException
    
    JsonProcessingException
  - readValue
```
public <T> T readValue(String src)
            throws IOException,
                   JsonProcessingException
```
    Method that binds content read from given JSON string, using configuration of this reader. Value return is either newly constructed, or root value that was specified with withValueToUpdate(Object).
    
    Throws:
    
    IOException
    
    JsonProcessingException
  - readValue
```
public <T> T readValue(byte[] src)
            throws IOException,
                   JsonProcessingException
```
    Method that binds content read from given byte array, using configuration of this reader. Value return is either newly constructed, or root value that was specified with withValueToUpdate(Object).
    
    Throws:
    
    IOException
    
    JsonProcessingException
  - readValue
```
public <T> T readValue(byte[] src,
              int offset,
              int length)
            throws IOException,
                   JsonProcessingException
```
    Method that binds content read from given byte array, using configuration of this reader. Value return is either newly constructed, or root value that was specified with withValueToUpdate(Object).
    
    Throws:
    
    IOException
    
    JsonProcessingException
  - readValue
```
public <T> T readValue(File src)
            throws IOException,
                   JsonProcessingException
```
    Throws:
    
    IOException
    
    JsonProcessingException
  - readValue
```
public <T> T readValue(URL src)
            throws IOException,
                   JsonProcessingException
```
    Method that binds content read from given input source, using configuration of this reader. Value return is either newly constructed, or root value that was specified with withValueToUpdate(Object).
    
    Throws:
    
    IOException
    
    JsonProcessingException
  - readValue
```
public <T> T readValue(JsonNode src)
            throws IOException,
                   JsonProcessingException
```
    Convenience method for converting results from given JSON tree into given value type. Basically short-cut for:
```
   objectReader.readValue(src.traverse())
```
    Throws:
    
    IOException
    
    JsonProcessingException
  - readTree
```
public JsonNode readTree(InputStream in)
                  throws IOException,
                         JsonProcessingException
```
    Method that reads content from given input source, using configuration of this reader, and binds it as JSON Tree.
    Note that if an object was specified with a call to withValueToUpdate(Object) it will just be ignored; result is always a newly constructed JsonNode instance.
    
    Throws:
    
    IOException
    
    JsonProcessingException
  - readTree
```
public JsonNode readTree(Reader r)
                  throws IOException,
                         JsonProcessingException
```
    Method that reads content from given input source, using configuration of this reader, and binds it as JSON Tree.
    Note that if an object was specified with a call to withValueToUpdate(Object) it will just be ignored; result is always a newly constructed JsonNode instance.
    
    Throws:
    
    IOException
    
    JsonProcessingException
  - readTree
```
public JsonNode readTree(String json)
                  throws IOException,
                         JsonProcessingException
```
    Method that reads content from given JSON input String, using configuration of this reader, and binds it as JSON Tree.
    Note that if an object was specified with a call to withValueToUpdate(Object) it will just be ignored; result is always a newly constructed JsonNode instance.
    
    Throws:
    
    IOException
    
    JsonProcessingException
  - readValues
```
public <T> MappingIterator<T> readValues(JsonParser p)
                              throws IOException,
                                     JsonProcessingException
```
    Method for reading sequence of Objects from parser stream.
    Sequence can be either root-level "unwrapped" sequence (without surrounding JSON array), or a sequence contained in a JSON Array. In either case JsonParser must point to the first token of the first element, OR not point to any token (in which case it is advanced to the next token). This means, specifically, that for wrapped sequences, parser MUST NOT point to the surrounding START_ARRAY but rather to the token following it.
    
    Throws:
    
    IOException
    
    JsonProcessingException
  - readValues
```
public <T> MappingIterator<T> readValues(InputStream src)
                              throws IOException,
                                     JsonProcessingException
```
    Method for reading sequence of Objects from parser stream.
    Sequence can be either wrapped or unwrapped root-level sequence: wrapped means that the elements are enclosed in JSON Array; and unwrapped that elements are directly accessed at main level. Assumption is that iff the first token of the document is START_ARRAY, we have a wrapped sequence; otherwise unwrapped. For wrapped sequences, leading START_ARRAY is skipped, so that for both cases, underlying JsonParser will point to what is expected to be the first token of the first element.
    Note that the wrapped vs unwrapped logic means that it is NOT possible to use this method for reading an unwrapped sequence of elements written as JSON Arrays: to read such sequences, one has to use readValues(JsonParser), making sure parser points to the first token of the first element (i.e. the second START_ARRAY which is part of the first element).
    
    Throws:
    
    IOException
    
    JsonProcessingException
  - readValues
```
public <T> MappingIterator<T> readValues(Reader src)
                              throws IOException,
                                     JsonProcessingException
```
    Overloaded version of readValue(InputStream).
    
    Throws:
    
    IOException
    
    JsonProcessingException
  - readValues
```
public <T> MappingIterator<T> readValues(String json)
                              throws IOException,
                                     JsonProcessingException
```
    Overloaded version of readValue(InputStream).
    
    Parameters:
    json - String that contains JSON content to parse
    
    Throws:
    
    IOException
    
    JsonProcessingException
  - readValues
```
public <T> MappingIterator<T> readValues(byte[] src,
                                int offset,
                                int length)
                              throws IOException,
                                     JsonProcessingException
```
    Overloaded version of readValue(InputStream).
    
    Throws:
    
    IOException
    
    JsonProcessingException
  - readValues
```
public final <T> MappingIterator<T> readValues(byte[] src)
                                    throws IOException,
                                           JsonProcessingException
```
    Overloaded version of readValue(InputStream).
    
    Throws:
    
    IOException
    
    JsonProcessingException
  - readValues
```
public <T> MappingIterator<T> readValues(File src)
                              throws IOException,
                                     JsonProcessingException
```
    Overloaded version of readValue(InputStream).
    
    Throws:
    
    IOException
    
    JsonProcessingException
  - readValues
```
public <T> MappingIterator<T> readValues(URL src)
                              throws IOException,
                                     JsonProcessingException
```
    Overloaded version of readValue(InputStream).
    
    Parameters:
    src - URL to read to access JSON content to parse.
    
    Throws:
    
    IOException
    
    JsonProcessingException
  - treeToValue
```
public <T> T treeToValue(TreeNode n,
                Class<T> valueType)
              throws JsonProcessingException
```
    Specified by:
    
    treeToValue in class ObjectCodec
    
    Throws:
    
    JsonProcessingException
  - writeValue
```
public void writeValue(JsonGenerator gen,
              Object value)
                throws IOException,
                       JsonProcessingException
```
    Specified by:
    
    writeValue in class ObjectCodec
    
    Throws:
    
    IOException
    
    JsonProcessingException
  - _bind
```
protected Object _bind(JsonParser p,
           Object valueToUpdate)
                throws IOException
```
    Actual implementation of value reading+binding operation.
    
    Throws:
    
    IOException
  - _considerFilter
```
protected JsonParser _considerFilter(JsonParser p)
```
    Consider filter when creating JsonParser.
  - _bindAndClose
```
protected Object _bindAndClose(JsonParser p)
                        throws IOException
```
    Throws:
    
    IOException
  - _bindAndCloseAsTree
```
protected JsonNode _bindAndCloseAsTree(JsonParser p)
                                throws IOException
```
    Throws:
    
    IOException
  - _bindAsTree
```
protected JsonNode _bindAsTree(JsonParser p)
                        throws IOException
```
    Throws:
    
    IOException
  - _bindAndReadValues
```
protected <T> MappingIterator<T> _bindAndReadValues(JsonParser p)
                                         throws IOException
```
    Throws:
    
    IOException
    Since:
    
    2.1
  - _unwrapAndDeserialize
```
protected Object _unwrapAndDeserialize(JsonParser p,
                           DeserializationContext ctxt,
                           JavaType rootType,
                           JsonDeserializer<Object> deser)
                                throws IOException
```
    Throws:
    
    IOException
  - _detectBindAndClose
```
protected Object _detectBindAndClose(byte[] src,
                         int offset,
                         int length)
                              throws IOException
```
    Throws:
    
    IOException
  - _detectBindAndClose
```
protected Object _detectBindAndClose(DataFormatReaders.Match match,
                         boolean forceClosing)
                              throws IOException
```
    Throws:
    
    IOException
  - _detectBindAndReadValues
```
protected <T> MappingIterator<T> _detectBindAndReadValues(DataFormatReaders.Match match,
                                              boolean forceClosing)
                                               throws IOException,
                                                      JsonProcessingException
```
    Throws:
    
    IOException
    
    JsonProcessingException
  - _detectBindAndCloseAsTree
```
protected JsonNode _detectBindAndCloseAsTree(InputStream in)
                                      throws IOException
```
    Throws:
    
    IOException
  - _reportUnkownFormat
```
protected void _reportUnkownFormat(DataFormatReaders detector,
                       DataFormatReaders.Match match)
                            throws JsonProcessingException
```
    Method called to indicate that format detection failed to detect format of given input
    
    Throws:
    
    JsonProcessingException
  - _verifySchemaType
```
protected void _verifySchemaType(FormatSchema schema)
```
    Since:
    
    2.2
  - createDeserializationContext
```
protected DefaultDeserializationContext createDeserializationContext(JsonParser p)
```
    Internal helper method called to create an instance of DeserializationContext for deserializing a single root value. Can be overridden if a custom context is needed.
  - _reportUndetectableSource
```
protected void _reportUndetectableSource(Object src)
                                  throws JsonProcessingException
```
    Throws:
    
    JsonProcessingException
  - _inputStream
```
protected InputStream _inputStream(URL src)
                            throws IOException
```
    Throws:
    
    IOException
  - _inputStream
```
protected InputStream _inputStream(File f)
                            throws IOException
```
    Throws:
    
    IOException
  - _findRootDeserializer
```
protected JsonDeserializer<Object> _findRootDeserializer(DeserializationContext ctxt)
                                                  throws JsonMappingException
```
    Method called to locate deserializer for the passed root-level value.
    
    Throws:
    
    JsonMappingException
  - _findTreeDeserializer
```
protected JsonDeserializer<Object> _findTreeDeserializer(DeserializationContext ctxt)
                                                  throws JsonMappingException
```
    Throws:
    
    JsonMappingException
    Since:
    
    2.6
  - _prefetchRootDeserializer
```
protected JsonDeserializer<Object> _prefetchRootDeserializer(JavaType valueType)
```
    Method called to locate deserializer ahead of time, if permitted by configuration. Method also is NOT to throw an exception if access fails.
  - at
```
public ObjectReader at(String value)
```
    Convenience method to bind from JsonPointer. JsonPointerBasedFilter is registered and will be used for parsing later.
    
    Since:
    
    2.6
  - at
```
public ObjectReader at(JsonPointer pointer)
```
    Convenience method to bind from JsonPointer JsonPointerBasedFilter is registered and will be used for parsing later.
    
    Since:
    
    2.6

Class ObjectReader

Field Summary

Constructor Summary

Method Summary

Methods inherited from class com.fasterxml.jackson.core.ObjectCodec

Methods inherited from class java.lang.Object

Field Detail

_config

_context

_parserFactory

_unwrapRoot

_valueType

_rootDeserializer

_valueToUpdate

_schema

_injectableValues

_dataFormatReaders

_rootDeserializers

Constructor Detail

ObjectReader

ObjectReader

ObjectReader

ObjectReader

ObjectReader

ObjectReader

Method Detail

version

_new

_new

_new

_newIterator

_initForReading

_initForMultiRead

with

with

withFeatures

without

without

withoutFeatures

with

withFeatures

without

withoutFeatures

with

withFeatures

without

withoutFeatures

with

with

with

with

withRootName

withRootName

withoutRootName

with

forType

forType

forType

withType

withType

withType

withType

withValueToUpdate

withView

with

with

withHandler

with

withFormatDetection

withFormatDetection

with

withAttributes

withAttribute

withoutAttribute

_with

isEnabled

isEnabled

isEnabled

getConfig

getFactory