ObjectReader (The Adobe AEM Quickstart and Web Application.)

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

All Implemented Interfaces:

Versioned, java.io.Serializable
```
public class ObjectReader
extends ObjectCodec
implements Versioned, java.io.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.
NOTE: this class is NOT meant as sub-classable (with Jackson 2.8 and above) by users. It is left as non-final mostly to allow frameworks that require bytecode generation for proxying and similar use cases, but there is no expecation that functionality should be extended by sub-classing.

See Also:

Serialized Form

Method Summary

All Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`ObjectReader`	`at(JsonPointer pointer)` Convenience method to bind from `JsonPointer` `JsonPointerBasedFilter` is registered and will be used for parsing later.
`ObjectReader`	`at(java.lang.String pointerExpr)` Convenience method to bind from `JsonPointer`.
`JsonNode`	`createArrayNode()` Method for construct root level Array nodes for Tree Model instances.
`JsonParser`	`createNonBlockingByteArrayParser()` Factory method for constructing properly initialized `JsonParser` to read content using non-blocking (asynchronous) mode.
`JsonNode`	`createObjectNode()` Method for construct root level Object nodes for Tree Model instances.
`JsonParser`	`createParser(byte[] content)` Factory method for constructing properly initialized `JsonParser` to read content from specified byte array.
`JsonParser`	`createParser(byte[] content, int offset, int len)` Factory method for constructing properly initialized `JsonParser` to read content from specified byte array.
`JsonParser`	`createParser(char[] content)` Factory method for constructing properly initialized `JsonParser` to read content from specified character array Parser is not managed (or "owned") by ObjectReader: caller is responsible for properly closing it once content reading is complete.
`JsonParser`	`createParser(char[] content, int offset, int len)` Factory method for constructing properly initialized `JsonParser` to read content from specified character array.
`JsonParser`	`createParser(java.io.DataInput content)` Factory method for constructing properly initialized `JsonParser` to read content using specified `DataInput`.
`JsonParser`	`createParser(java.io.File src)` Factory method for constructing properly initialized `JsonParser` to read content from specified `File`.
`JsonParser`	`createParser(java.io.InputStream in)` Factory method for constructing properly initialized `JsonParser` to read content using specified `InputStream`.
`JsonParser`	`createParser(java.io.Reader r)` Factory method for constructing properly initialized `JsonParser` to read content using specified `Reader`.
`JsonParser`	`createParser(java.lang.String content)` Factory method for constructing properly initialized `JsonParser` to read content from specified String.
`JsonParser`	`createParser(java.net.URL src)` Factory method for constructing properly initialized `JsonParser` to read content from specified `File`.
`ObjectReader`	`forType(java.lang.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()` Accessor for finding underlying data format factory (`JsonFactory`) codec will use for data binding.
`InjectableValues`	`getInjectableValues()`
`TypeFactory`	`getTypeFactory()`
`JavaType`	`getValueType()`
`boolean`	`isEnabled(DeserializationFeature f)`
`boolean`	`isEnabled(JsonParser.Feature f)`
`boolean`	`isEnabled(MapperFeature f)`
`boolean`	`isEnabled(StreamReadFeature f)`
`JsonNode`	`missingNode()`
`JsonNode`	`nullNode()`
`JsonNode`	`readTree(byte[] json)` Same as `readTree(InputStream)` except content read from passed-in byte array.
`JsonNode`	`readTree(byte[] json, int offset, int len)` Same as `readTree(InputStream)` except content read from passed-in byte array.
`JsonNode`	`readTree(java.io.DataInput src)` Same as `readTree(InputStream)` except content read using passed-in `DataInput`.
`JsonNode`	`readTree(java.io.InputStream src)` 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(java.io.Reader src)` Same as `readTree(InputStream)` except content accessed through passed-in `Reader`
`JsonNode`	`readTree(java.lang.String json)` Same as `readTree(InputStream)` except content read from passed-in `String`
`<T> T`	`readValue(byte[] content)` Method that binds content read from given byte array, using configuration of this reader.
`<T> T`	`readValue(byte[] content, java.lang.Class<T> valueType)` Same as `readValue(byte[])` except that target value type overridden as `valueType`
`<T> T`	`readValue(byte[] buffer, int offset, int length)` Method that binds content read from given byte array, using configuration of this reader.
`<T> T`	`readValue(byte[] buffer, int offset, int length, java.lang.Class<T> valueType)` Same as `readValue(byte[],int,int)` except that target value type overridden as `valueType`
`<T> T`	`readValue(java.io.DataInput src)`
`<T> T`	`readValue(java.io.DataInput content, java.lang.Class<T> valueType)` Same as `readValue(DataInput)` except that target value type overridden as `valueType`
`<T> T`	`readValue(java.io.File src)` Method that binds content read from given `File` using configuration of this reader.
`<T> T`	`readValue(java.io.File src, java.lang.Class<T> valueType)` Same as `readValue(File)` except that target value type overridden as `valueType`
`<T> T`	`readValue(java.io.InputStream src)` Method that binds content read from given input source, using configuration of this reader.
`<T> T`	`readValue(java.io.InputStream src, java.lang.Class<T> valueType)` Same as `readValue(InputStream)` except that target value type overridden as `valueType`
`<T> T`	`readValue(JsonNode content)` Convenience method for converting results from given JSON tree into given value type.
`<T> T`	`readValue(JsonNode content, java.lang.Class<T> valueType)` Same as `readValue(JsonNode)` except that target value type overridden as `valueType`
`<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, java.lang.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<T> 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(java.io.Reader src)` Method that binds content read from given input source, using configuration of this reader.
`<T> T`	`readValue(java.io.Reader src, java.lang.Class<T> valueType)` Same as `readValue(Reader)` except that target value type overridden as `valueType`
`<T> T`	`readValue(java.lang.String src)` Method that binds content read from given JSON string, using configuration of this reader.
`<T> T`	`readValue(java.lang.String src, java.lang.Class<T> valueType)` Same as `readValue(String)` except that target value type overridden as `valueType`
`<T> T`	`readValue(java.net.URL src)` Method that binds content read from given input source, using configuration of this reader.
`<T> T`	`readValue(java.net.URL src, java.lang.Class<T> valueType)` Same as `readValue(URL)` except that target value type overridden as `valueType`
`<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(java.io.DataInput src)`
`<T> MappingIterator<T>`	`readValues(java.io.File src)` Overloaded version of `readValue(InputStream)`.
`<T> MappingIterator<T>`	`readValues(java.io.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> java.util.Iterator<T>`	`readValues(JsonParser p, java.lang.Class<T> valueType)` Convenience method that is equivalent to:
`<T> java.util.Iterator<T>`	`readValues(JsonParser p, JavaType valueType)` Convenience method that is equivalent to:
`<T> java.util.Iterator<T>`	`readValues(JsonParser p, ResolvedType valueType)` Convenience method that is equivalent to:
`<T> java.util.Iterator<T>`	`readValues(JsonParser p, TypeReference<T> valueTypeRef)` Convenience method that is equivalent to:
`<T> MappingIterator<T>`	`readValues(java.io.Reader src)` Overloaded version of `readValue(InputStream)`.
`<T> MappingIterator<T>`	`readValues(java.lang.String json)` Overloaded version of `readValue(InputStream)`.
`<T> MappingIterator<T>`	`readValues(java.net.URL src)` Overloaded version of `readValue(InputStream)`.
`JsonParser`	`treeAsTokens(TreeNode n)` Method for constructing a `JsonParser` for reading contents of a JSON tree, as if it was external serialized JSON content.
`<T> T`	`treeToValue(TreeNode n, java.lang.Class<T> valueType)` Convenience method for converting given JSON tree into instance of specified value type.
`<T> T`	`treeToValue(TreeNode n, JavaType valueType)` Same as `treeToValue(TreeNode, Class)` but with type-resolved target value type.
`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(java.util.Locale l)`
`ObjectReader`	`with(StreamReadFeature feature)` Method for constructing a new reader instance that is configured with specified feature enabled.
`ObjectReader`	`with(java.util.TimeZone tz)`
`ObjectReader`	`withAttribute(java.lang.Object key, java.lang.Object value)`
`ObjectReader`	`withAttributes(java.util.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`	`without(StreamReadFeature feature)` Method for constructing a new reader instance that is configured with specified feature disabled.
`ObjectReader`	`withoutAttribute(java.lang.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(java.lang.String rootName)` Method for constructing a new instance with configuration that specifies what root name to expect for "root name unwrapping".
`ObjectReader`	`withType(java.lang.Class<?> valueType)` Deprecated. since 2.5 Use `forType(Class)` instead
`ObjectReader`	`withType(JavaType valueType)` Deprecated. since 2.5 Use `forType(JavaType)` instead
`ObjectReader`	`withType(java.lang.reflect.Type valueType)` Deprecated. since 2.5 Use `forType(Class)` instead
`ObjectReader`	`withType(TypeReference<?> valueTypeRef)` Deprecated. since 2.5 Use `forType(TypeReference)` instead
`ObjectReader`	`withValueToUpdate(java.lang.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(java.lang.Class<?> activeView)` Method for constructing a new instance with configuration that uses specified View for filtering.
`void`	`writeTree(JsonGenerator g, TreeNode rootNode)` Method for serializing JSON content from given Tree instance, using specified generator.
`void`	`writeValue(JsonGenerator gen, java.lang.Object value)` Method to serialize given Java Object, using generator provided.

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

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

- 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
    
    Specified by:
    
    version in class ObjectCodec
    
    Returns:
    
    Version of the component
  - 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.
    
    Parameters:
    
    feature - Feature to enable
    
    Returns:
    
    Reader instance 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.
    
    Parameters:
    
    features - Features to enable
    
    Returns:
    
    Reader instance 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.
    
    Parameters:
    
    feature - Feature to disable
    
    Returns:
    
    Reader instance 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.
    
    Parameters:
    
    features - Features to disable
    
    Returns:
    
    Reader instance with specified features disabled
  - with
```
public ObjectReader with(StreamReadFeature feature)
```
    Method for constructing a new reader instance that is configured with specified feature enabled.
    
    Returns:
    
    Reader instance with specified feature enabled
    
    Since:
    
    2.11
  - without
```
public ObjectReader without(StreamReadFeature feature)
```
    Method for constructing a new reader instance that is configured with specified feature disabled.
    
    Returns:
    
    Reader instance with specified feature enabled
    
    Since:
    
    2.11
  - 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
  - at
```
public ObjectReader at(java.lang.String pointerExpr)
```
    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
  - 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(java.lang.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(java.lang.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(java.lang.Class<?> valueType)
```
    Deprecated. since 2.5 Use forType(Class) instead
  - withType
```
@Deprecated
public ObjectReader withType(java.lang.reflect.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(java.lang.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(java.lang.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(java.util.Locale l)
```
  - with
```
public ObjectReader with(java.util.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 cannot 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 cannot 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(java.util.Map<?,?> attrs)
```
    Since:
    
    2.3
  - withAttribute
```
public ObjectReader withAttribute(java.lang.Object key,
                                  java.lang.Object value)
```
    Since:
    
    2.3
  - withoutAttribute
```
public ObjectReader withoutAttribute(java.lang.Object key)
```
    Since:
    
    2.3
  - isEnabled
```
public boolean isEnabled(DeserializationFeature f)
```
  - isEnabled
```
public boolean isEnabled(MapperFeature f)
```
  - isEnabled
```
public boolean isEnabled(JsonParser.Feature f)
```
  - isEnabled
```
public boolean isEnabled(StreamReadFeature f)
```
    Since:
    
    2.11
  - getConfig
```
public DeserializationConfig getConfig()
```
    Since:
    
    2.2
  - getFactory
```
public JsonFactory getFactory()
```
    Description copied from class: ObjectCodec
    
    Accessor for finding underlying data format factory (JsonFactory) codec will use for data binding.
    
    Overrides:
    
    getFactory in class ObjectCodec
    
    Returns:
    
    Underlying JsonFactory instance
    
    Since:
    
    2.1
  - getTypeFactory
```
public TypeFactory getTypeFactory()
```
  - getAttributes
```
public ContextAttributes getAttributes()
```
    Since:
    
    2.3
  - getInjectableValues
```
public InjectableValues getInjectableValues()
```
    Since:
    
    2.6
  - getValueType
```
public JavaType getValueType()
```
    Since:
    
    2.10
  - createParser
```
public JsonParser createParser(java.io.File src)
                        throws java.io.IOException
```
    Factory method for constructing properly initialized JsonParser to read content from specified File. Parser is not managed (or "owned") by ObjectReader: caller is responsible for properly closing it once content reading is complete.
    
    Throws:
    
    java.io.IOException
    
    Since:
    
    2.11
  - createParser
```
public JsonParser createParser(java.net.URL src)
                        throws java.io.IOException
```
    Factory method for constructing properly initialized JsonParser to read content from specified File. Parser is not managed (or "owned") by ObjectReader: caller is responsible for properly closing it once content reading is complete.
    
    Throws:
    
    java.io.IOException
    
    Since:
    
    2.11
  - createParser
```
public JsonParser createParser(java.io.InputStream in)
                        throws java.io.IOException
```
    Factory method for constructing properly initialized JsonParser to read content using specified InputStream. Parser is not managed (or "owned") by ObjectReader: caller is responsible for properly closing it once content reading is complete.
    
    Throws:
    
    java.io.IOException
    
    Since:
    
    2.11
  - createParser
```
public JsonParser createParser(java.io.Reader r)
                        throws java.io.IOException
```
    Factory method for constructing properly initialized JsonParser to read content using specified Reader. Parser is not managed (or "owned") by ObjectReader: caller is responsible for properly closing it once content reading is complete.
    
    Throws:
    
    java.io.IOException
    
    Since:
    
    2.11
  - createParser
```
public JsonParser createParser(byte[] content)
                        throws java.io.IOException
```
    Factory method for constructing properly initialized JsonParser to read content from specified byte array. Parser is not managed (or "owned") by ObjectReader: caller is responsible for properly closing it once content reading is complete.
    
    Throws:
    
    java.io.IOException
    
    Since:
    
    2.11
  - createParser
```
public JsonParser createParser(byte[] content,
                               int offset,
                               int len)
                        throws java.io.IOException
```
    Factory method for constructing properly initialized JsonParser to read content from specified byte array. Parser is not managed (or "owned") by ObjectReader: caller is responsible for properly closing it once content reading is complete.
    
    Throws:
    
    java.io.IOException
    
    Since:
    
    2.11
  - createParser
```
public JsonParser createParser(java.lang.String content)
                        throws java.io.IOException
```
    Factory method for constructing properly initialized JsonParser to read content from specified String. Parser is not managed (or "owned") by ObjectReader: caller is responsible for properly closing it once content reading is complete.
    
    Throws:
    
    java.io.IOException
    
    Since:
    
    2.11
  - createParser
```
public JsonParser createParser(char[] content)
                        throws java.io.IOException
```
    Factory method for constructing properly initialized JsonParser to read content from specified character array Parser is not managed (or "owned") by ObjectReader: caller is responsible for properly closing it once content reading is complete.
    
    Throws:
    
    java.io.IOException
    
    Since:
    
    2.11
  - createParser
```
public JsonParser createParser(char[] content,
                               int offset,
                               int len)
                        throws java.io.IOException
```
    Factory method for constructing properly initialized JsonParser to read content from specified character array. Parser is not managed (or "owned") by ObjectReader: caller is responsible for properly closing it once content reading is complete.
    
    Throws:
    
    java.io.IOException
    
    Since:
    
    2.11
  - createParser
```
public JsonParser createParser(java.io.DataInput content)
                        throws java.io.IOException
```
    Factory method for constructing properly initialized JsonParser to read content using specified DataInput. Parser is not managed (or "owned") by ObjectReader: caller is responsible for properly closing it once content reading is complete.
    
    Throws:
    
    java.io.IOException
    
    Since:
    
    2.11
  - createNonBlockingByteArrayParser
```
public JsonParser createNonBlockingByteArrayParser()
                                            throws java.io.IOException
```
    Factory method for constructing properly initialized JsonParser to read content using non-blocking (asynchronous) mode. Parser is not managed (or "owned") by ObjectReader: caller is responsible for properly closing it once content reading is complete.
    
    Throws:
    
    java.io.IOException
    
    Since:
    
    2.11
  - readValue
```
public <T> T readValue(JsonParser p)
                throws java.io.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:
    
    java.io.IOException
  - readValue
```
public <T> T readValue(JsonParser p,
                       java.lang.Class<T> valueType)
                throws java.io.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
    
    Type Parameters:
    
    T - Nominal parameter for target type
    
    Parameters:
    
    p - Parser to use for decoding content to bind
    
    valueType - Java value type to bind content to
    
    Returns:
    
    Value deserialized
    
    Throws:
    
    java.io.IOException - for low-level read issues, or JsonParseException for decoding problems
  - readValue
```
public <T> T readValue(JsonParser p,
                       TypeReference<T> valueTypeRef)
                throws java.io.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
    
    Type Parameters:
    
    T - Nominal parameter for target type
    
    Parameters:
    
    p - Parser to use for decoding content to bind
    
    valueTypeRef - Java value type to bind content to
    
    Returns:
    
    Value deserialized
    
    Throws:
    
    java.io.IOException - for low-level read issues, or JsonParseException for decoding problems
  - readValue
```
public <T> T readValue(JsonParser p,
                       ResolvedType valueType)
                throws java.io.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
    
    Type Parameters:
    
    T - Nominal parameter for target type
    
    Parameters:
    
    p - Parser to use for decoding content to bind
    
    valueType - Java value type to bind content to
    
    Returns:
    
    Value deserialized
    
    Throws:
    
    java.io.IOException - for low-level read issues, or JsonParseException for decoding problems
  - readValue
```
public <T> T readValue(JsonParser p,
                       JavaType valueType)
                throws java.io.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:
    
    java.io.IOException
  - readValues
```
public <T> java.util.Iterator<T> readValues(JsonParser p,
                                            java.lang.Class<T> valueType)
                                     throws java.io.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
    
    Type Parameters:
    
    T - Nominal parameter for target type
    
    Parameters:
    
    p - Parser to use for decoding content to bind
    
    valueType - Java value type to bind content to
    
    Returns:
    
    Iterator for incrementally deserializing values
    
    Throws:
    
    java.io.IOException - for low-level read issues, or JsonParseException for decoding problems
  - readValues
```
public <T> java.util.Iterator<T> readValues(JsonParser p,
                                            TypeReference<T> valueTypeRef)
                                     throws java.io.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
    
    Type Parameters:
    
    T - Nominal parameter for target type
    
    Parameters:
    
    p - Parser to use for decoding content to bind
    
    valueTypeRef - Java value type to bind content to
    
    Returns:
    
    Iterator for incrementally deserializing values
    
    Throws:
    
    java.io.IOException - for low-level read issues, or JsonParseException for decoding problems
  - readValues
```
public <T> java.util.Iterator<T> readValues(JsonParser p,
                                            ResolvedType valueType)
                                     throws java.io.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
    
    Type Parameters:
    
    T - Nominal parameter for target type
    
    Parameters:
    
    p - Parser to use for decoding content to bind
    
    valueType - Java value type to bind content to
    
    Returns:
    
    Iterator for incrementally deserializing values
    
    Throws:
    
    java.io.IOException - for low-level read issues, or JsonParseException for decoding problems
  - readValues
```
public <T> java.util.Iterator<T> readValues(JsonParser p,
                                            JavaType valueType)
                                     throws java.io.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:
    
    java.io.IOException
  - createArrayNode
```
public JsonNode createArrayNode()
```
    Description copied from class: ObjectCodec
    
    Method for construct root level Array nodes for Tree Model instances.
    
    Specified by:
    
    createArrayNode in class ObjectCodec
    
    Returns:
    
    Array node created
  - createObjectNode
```
public JsonNode createObjectNode()
```
    Description copied from class: ObjectCodec
    
    Method for construct root level Object nodes for Tree Model instances.
    
    Specified by:
    
    createObjectNode in class ObjectCodec
    
    Returns:
    
    Object node created
  - missingNode
```
public JsonNode missingNode()
```
    Overrides:
    
    missingNode in class TreeCodec
    
    Returns:
    
    Node that represents "missing" node during traversal: something referenced but that does not exist in content model
  - nullNode
```
public JsonNode nullNode()
```
    Overrides:
    
    nullNode in class TreeCodec
    
    Returns:
    
    Node that represents explict null value in content
  - treeAsTokens
```
public JsonParser treeAsTokens(TreeNode n)
```
    Description copied from class: ObjectCodec
    
    Method for constructing a JsonParser for reading contents of a JSON tree, as if it was external serialized JSON content.
    
    Specified by:
    
    treeAsTokens in class ObjectCodec
    
    Parameters:
    
    n - Content to traverse over
    
    Returns:
    
    Parser constructed for traversing over contents of specified node
  - readTree
```
public <T extends TreeNode> T readTree(JsonParser p)
                                throws java.io.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. Returns JsonNode that represents the root of the resulting tree, if there was content to read, or null if no more content is accessible via passed JsonParser.
    NOTE! Behavior with end-of-input (no more content) differs between this readTree method, and all other methods that take input source: latter will return "missing node", NOT null
    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
    
    Returns:
    
    next tree from p, or null if empty.
    
    Throws:
    
    java.io.IOException - for low-level read issues, or JsonParseException for decoding problems
  - writeTree
```
public void writeTree(JsonGenerator g,
                      TreeNode rootNode)
```
    Description copied from class: ObjectCodec
    
    Method for serializing JSON content from given Tree instance, using specified generator.
    
    Specified by:
    
    writeTree in class ObjectCodec
    
    Parameters:
    
    g - Generator to use for serializing value
    
    rootNode - Tree to serialize
  - readValue
```
public <T> T readValue(java.io.InputStream src)
                throws java.io.IOException
```
    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).
    
    Parameters:
    
    src - Source to read content from
    
    Throws:
    
    java.io.IOException
  - readValue
```
public <T> T readValue(java.io.InputStream src,
                       java.lang.Class<T> valueType)
                throws java.io.IOException
```
    Same as readValue(InputStream) except that target value type overridden as valueType
    
    Parameters:
    
    src - Source to read content from
    
    valueType - Target type to bind content to
    
    Throws:
    
    java.io.IOException
    
    Since:
    
    2.11
  - readValue
```
public <T> T readValue(java.io.Reader src)
                throws java.io.IOException
```
    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).
    
    Parameters:
    
    src - Source to read content from
    
    Throws:
    
    java.io.IOException
  - readValue
```
public <T> T readValue(java.io.Reader src,
                       java.lang.Class<T> valueType)
                throws java.io.IOException
```
    Same as readValue(Reader) except that target value type overridden as valueType
    
    Parameters:
    
    src - Source to read content from
    
    valueType - Target type to bind content to
    
    Throws:
    
    java.io.IOException
    
    Since:
    
    2.11
  - readValue
```
public <T> T readValue(java.lang.String src)
                throws JsonProcessingException,
                       JsonMappingException
```
    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).
    
    Parameters:
    
    src - String that contains content to read
    
    Throws:
    
    JsonProcessingException
    
    JsonMappingException
  - readValue
```
public <T> T readValue(java.lang.String src,
                       java.lang.Class<T> valueType)
                throws java.io.IOException
```
    Same as readValue(String) except that target value type overridden as valueType
    
    Parameters:
    
    src - String that contains content to read
    
    valueType - Target type to bind content to
    
    Throws:
    
    java.io.IOException
    
    Since:
    
    2.11
  - readValue
```
public <T> T readValue(byte[] content)
                throws java.io.IOException
```
    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).
    
    Parameters:
    
    content - Byte array that contains encoded content to read
    
    Throws:
    
    java.io.IOException
  - readValue
```
public <T> T readValue(byte[] content,
                       java.lang.Class<T> valueType)
                throws java.io.IOException
```
    Same as readValue(byte[]) except that target value type overridden as valueType
    
    Parameters:
    
    content - Byte array that contains encoded content to read
    
    valueType - Target type to bind content to
    
    Throws:
    
    java.io.IOException
    
    Since:
    
    2.11
  - readValue
```
public <T> T readValue(byte[] buffer,
                       int offset,
                       int length)
                throws java.io.IOException
```
    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).
    
    Parameters:
    
    buffer - Byte array that contains encoded content to read
    
    offset - Offset of the first content byte in buffer
    
    length - Length of content in buffer, in bytes
    
    Throws:
    
    java.io.IOException
  - readValue
```
public <T> T readValue(byte[] buffer,
                       int offset,
                       int length,
                       java.lang.Class<T> valueType)
                throws java.io.IOException
```
    Same as readValue(byte[],int,int) except that target value type overridden as valueType
    
    Parameters:
    
    buffer - Byte array that contains encoded content to read
    
    offset - Offset of the first content byte in buffer
    
    length - Length of content in buffer, in bytes
    
    valueType - Target type to bind content to
    
    Throws:
    
    java.io.IOException
    
    Since:
    
    2.11
  - readValue
```
public <T> T readValue(java.io.File src)
                throws java.io.IOException
```
    Method that binds content read from given File using configuration of this reader. Value return is either newly constructed, or root value that was specified with withValueToUpdate(Object).
    
    Parameters:
    
    src - File that contains content to read
    
    Throws:
    
    java.io.IOException
  - readValue
```
public <T> T readValue(java.io.File src,
                       java.lang.Class<T> valueType)
                throws java.io.IOException
```
    Same as readValue(File) except that target value type overridden as valueType
    
    Parameters:
    
    src - File that contains content to read
    
    valueType - Target type to bind content to
    
    Throws:
    
    java.io.IOException
    
    Since:
    
    2.11
  - readValue
```
public <T> T readValue(java.net.URL src)
                throws java.io.IOException
```
    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).
    
    NOTE: handling of URL is delegated to JsonFactory.createParser(java.net.URL) and usually simply calls URL.openStream(), meaning no special handling is done. If different HTTP connection options are needed you will need to create InputStream separately.
    
    Throws:
    
    java.io.IOException
  - readValue
```
public <T> T readValue(java.net.URL src,
                       java.lang.Class<T> valueType)
                throws java.io.IOException
```
    Same as readValue(URL) except that target value type overridden as valueType
    
    Parameters:
    
    src - URL pointing to resource that contains content to read
    
    valueType - Target type to bind content to
    
    Throws:
    
    java.io.IOException
    
    Since:
    
    2.11
  - readValue
```
public <T> T readValue(JsonNode content)
                throws java.io.IOException
```
    Convenience method for converting results from given JSON tree into given value type. Basically short-cut for:
```
   objectReader.readValue(src.traverse())
```
    Parameters:
    
    content - Tree that contains content to convert
    
    Throws:
    
    java.io.IOException
  - readValue
```
public <T> T readValue(JsonNode content,
                       java.lang.Class<T> valueType)
                throws java.io.IOException
```
    Same as readValue(JsonNode) except that target value type overridden as valueType
    
    Parameters:
    
    content - Tree that contains content to convert
    
    valueType - Target type to convert content to
    
    Throws:
    
    java.io.IOException
    
    Since:
    
    2.11
  - readValue
```
public <T> T readValue(java.io.DataInput src)
                throws java.io.IOException
```
    Throws:
    
    java.io.IOException
  - readValue
```
public <T> T readValue(java.io.DataInput content,
                       java.lang.Class<T> valueType)
                throws java.io.IOException
```
    Same as readValue(DataInput) except that target value type overridden as valueType
    
    Parameters:
    
    content - DataInput that contains content to read
    
    valueType - Target type to bind content to
    
    Throws:
    
    java.io.IOException
    
    Since:
    
    2.11
  - readTree
```
public JsonNode readTree(java.io.InputStream src)
                  throws java.io.IOException
```
    Method that reads content from given input source, using configuration of this reader, and binds it as JSON Tree. Returns JsonNode that represents the root of the resulting tree, if there was content to read, or "missing node" (instance of JsonNode for which JsonNode.isMissingNode() returns true, and behaves otherwise similar to "null node") if no more content is accessible through passed-in input source.
    NOTE! Behavior with end-of-input (no more content) differs between this readTree method, and readTree(JsonParser) -- latter returns null for "no content" case.
    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:
    
    java.io.IOException
  - readTree
```
public JsonNode readTree(java.io.Reader src)
                  throws java.io.IOException
```
    Same as readTree(InputStream) except content accessed through passed-in Reader
    
    Throws:
    
    java.io.IOException
  - readTree
```
public JsonNode readTree(java.lang.String json)
                  throws JsonProcessingException,
                         JsonMappingException
```
    Same as readTree(InputStream) except content read from passed-in String
    
    Throws:
    
    JsonProcessingException
    
    JsonMappingException
  - readTree
```
public JsonNode readTree(byte[] json)
                  throws java.io.IOException
```
    Same as readTree(InputStream) except content read from passed-in byte array.
    
    Throws:
    
    java.io.IOException
  - readTree
```
public JsonNode readTree(byte[] json,
                         int offset,
                         int len)
                  throws java.io.IOException
```
    Same as readTree(InputStream) except content read from passed-in byte array.
    
    Throws:
    
    java.io.IOException
  - readTree
```
public JsonNode readTree(java.io.DataInput src)
                  throws java.io.IOException
```
    Same as readTree(InputStream) except content read using passed-in DataInput.
    
    Throws:
    
    java.io.IOException
  - readValues
```
public <T> MappingIterator<T> readValues(JsonParser p)
                                  throws java.io.IOException
```
    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:
    
    java.io.IOException
  - readValues
```
public <T> MappingIterator<T> readValues(java.io.InputStream src)
                                  throws java.io.IOException
```
    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:
    
    java.io.IOException
  - readValues
```
public <T> MappingIterator<T> readValues(java.io.Reader src)
                                  throws java.io.IOException
```
    Overloaded version of readValue(InputStream).
    
    Throws:
    
    java.io.IOException
  - readValues
```
public <T> MappingIterator<T> readValues(java.lang.String json)
                                  throws java.io.IOException
```
    Overloaded version of readValue(InputStream).
    
    Parameters:
    
    json - String that contains JSON content to parse
    
    Throws:
    
    java.io.IOException
  - readValues
```
public <T> MappingIterator<T> readValues(byte[] src,
                                         int offset,
                                         int length)
                                  throws java.io.IOException
```
    Overloaded version of readValue(InputStream).
    
    Throws:
    
    java.io.IOException
  - readValues
```
public final <T> MappingIterator<T> readValues(byte[] src)
                                        throws java.io.IOException
```
    Overloaded version of readValue(InputStream).
    
    Throws:
    
    java.io.IOException
  - readValues
```
public <T> MappingIterator<T> readValues(java.io.File src)
                                  throws java.io.IOException
```
    Overloaded version of readValue(InputStream).
    
    Throws:
    
    java.io.IOException
  - readValues
```
public <T> MappingIterator<T> readValues(java.net.URL src)
                                  throws java.io.IOException
```
    Overloaded version of readValue(InputStream).
    NOTE: handling of URL is delegated to JsonFactory.createParser(java.net.URL) and usually simply calls URL.openStream(), meaning no special handling is done. If different HTTP connection options are needed you will need to create InputStream separately.
    
    Parameters:
    
    src - URL to read to access JSON content to parse.
    
    Throws:
    
    java.io.IOException
  - readValues
```
public <T> MappingIterator<T> readValues(java.io.DataInput src)
                                  throws java.io.IOException
```
    Throws:
    
    java.io.IOException
    
    Since:
    
    2.8
  - treeToValue
```
public <T> T treeToValue(TreeNode n,
                         java.lang.Class<T> valueType)
                  throws JsonProcessingException
```
    Description copied from class: ObjectCodec
    
    Convenience method for converting given JSON tree into instance of specified value type. This is equivalent to first constructing a JsonParser to iterate over contents of the tree, and using that parser for data binding.
    
    Specified by:
    
    treeToValue in class ObjectCodec
    
    Type Parameters:
    
    T - Nominal parameter for target type
    
    Parameters:
    
    n - Tree to convert
    
    valueType - Java target value type to convert content to
    
    Returns:
    
    Converted value instance
    
    Throws:
    
    JsonProcessingException - if structural conversion fails
  - treeToValue
```
public <T> T treeToValue(TreeNode n,
                         JavaType valueType)
                  throws JsonProcessingException
```
    Same as treeToValue(TreeNode, Class) but with type-resolved target value type.
    
    Throws:
    
    JsonProcessingException
    
    Since:
    
    2.13
  - writeValue
```
public void writeValue(JsonGenerator gen,
                       java.lang.Object value)
                throws java.io.IOException
```
    Description copied from class: ObjectCodec
    
    Method to serialize given Java Object, using generator provided.
    
    Specified by:
    
    writeValue in class ObjectCodec
    
    Parameters:
    
    gen - Generator to use for serializing value
    
    value - Value to serialize
    
    Throws:
    
    java.io.IOException - for low-level write issues, or JsonGenerationException for decoding problems

Class ObjectReader

Method Summary

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

Methods inherited from class java.lang.Object

Method Detail

version

with

with

withFeatures

without

without

withoutFeatures

with

withFeatures

without

withoutFeatures

with

without

with

withFeatures

without

withoutFeatures

at

at

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

isEnabled

isEnabled

isEnabled

isEnabled

getConfig

getFactory

getTypeFactory

getAttributes

getInjectableValues

getValueType

createParser

createParser

createParser

createParser

createParser

createParser

createParser

createParser

createParser

createParser

createNonBlockingByteArrayParser

readValue

readValue

readValue

readValue

readValue

readValues

readValues

readValues