public abstract class CollectionBuilder extends Object
Collection
s
to map JSON Array values in.
Objects server both as "factories" for creating new builders (blueprint
style), and as actual builders. For each distinct read operation,
newBuilder(int)
will be called at least once; this instance
may be used and reused multiple times, as calling start()
will reset the state so that more Collection
s may be built.
Modifier and Type | Class and Description |
---|---|
static class |
CollectionBuilder.Default
Default
CollectionBuilder implementation, which uses ArrayList
as the type of List to build, unless instructed otherwise. |
Modifier and Type | Field and Description |
---|---|
protected Class<?> |
_collectionType
Optional
Collection implementation class, used when specific
implementation is desired. |
protected int |
_features |
protected static Object[] |
EMPTY_ARRAY |
Modifier | Constructor and Description |
---|---|
protected |
CollectionBuilder(int features,
Class<?> collImpl) |
Modifier and Type | Method and Description |
---|---|
abstract CollectionBuilder |
add(Object value) |
Object[] |
buildArray()
Alternative build method used when desired result type is
Object[] |
<T> T[] |
buildArray(Class<T> type) |
abstract Collection<Object> |
buildCollection()
The usual build method to use for constructing
Collection |
static CollectionBuilder |
defaultImpl()
Factory method for getting a blueprint instance of the default
CollectionBuilder implementation. |
Object[] |
emptyArray()
Specialized method that is called when an empty
Object[] needs to
be returned. |
<T> T[] |
emptyArray(Class<T> type) |
Collection<Object> |
emptyCollection()
Specialized method that is called when an empty Collection needs to
be constructed; this may be a new Collection, or an immutable shared
one, depending on implementation.
|
boolean |
isEnabled(JSON.Feature f) |
CollectionBuilder |
newBuilder() |
abstract CollectionBuilder |
newBuilder(Class<?> collImpl) |
abstract CollectionBuilder |
newBuilder(int features) |
<T> T[] |
singletonArray(Class<T> type,
T value) |
Object[] |
singletonArray(Object value)
Specialized method that is called when a single-entry array needs to
be constructed.
|
Collection<Object> |
singletonCollection(Object value)
Specialized method that is called when a single-entry Collection needs to
be constructed.
|
abstract CollectionBuilder |
start() |
protected static final Object[] EMPTY_ARRAY
protected final int _features
protected final Class<?> _collectionType
Collection
implementation class, used when specific
implementation is desired.protected CollectionBuilder(int features, Class<?> collImpl)
public static CollectionBuilder defaultImpl()
CollectionBuilder
implementation.public abstract CollectionBuilder newBuilder(int features)
public abstract CollectionBuilder newBuilder(Class<?> collImpl)
public CollectionBuilder newBuilder()
public final boolean isEnabled(JSON.Feature f)
public abstract CollectionBuilder start()
public abstract CollectionBuilder add(Object value)
public abstract Collection<Object> buildCollection()
Collection
public Object[] buildArray()
Object[]
public <T> T[] buildArray(Class<T> type)
public Collection<Object> emptyCollection()
Default implementation simply calls:
start().buildCollection();
public Object[] emptyArray()
Object[]
needs to
be returned.
Default implementation simply returns a shared empty array instance.
public <T> T[] emptyArray(Class<T> type)
public Collection<Object> singletonCollection(Object value)
Default implementation simply calls:
start().add(value).buildCollection();
public Object[] singletonArray(Object value)
Default implementation simply returns equivalent of:
new Object[] { value }
public <T> T[] singletonArray(Class<T> type, T value)
Copyright © 2014–2015 FasterXML. All rights reserved.