org.opendaylight.yangtools.yang.data.codec.gson

Class JSONCodecFactory

java.lang.Object

org.opendaylight.yangtools.yang.data.util.codec.AbstractCodecFactory<org.opendaylight.yangtools.yang.data.codec.gson.JSONCodec<?>>

org.opendaylight.yangtools.yang.data.codec.gson.JSONCodecFactory

@Beta
public final class JSONCodecFactory
extends AbstractCodecFactory<org.opendaylight.yangtools.yang.data.codec.gson.JSONCodec<?>>

Factory for creating JSON equivalents of codecs. Each instance of this object is bound to a particular SchemaContext, but can be reused by multiple JSONNormalizedNodeStreamWriters. There are multiple implementations available, each with distinct thread-safety, CPU/memory trade-offs and reuse characteristics. See getShared(SchemaContext), getPrecomputed(SchemaContext), createLazy(SchemaContext) and createSimple(SchemaContext) for details.

Method Summary

Modifier and Type	Method and Description
protected org.opendaylight.yangtools.yang.data.codec.gson.JSONCodec<?>	binaryCodec(BinaryTypeDefinition type)
protected org.opendaylight.yangtools.yang.data.codec.gson.JSONCodec<?>	bitsCodec(BitsTypeDefinition type)
protected org.opendaylight.yangtools.yang.data.codec.gson.JSONCodec<?>	booleanCodec(BooleanTypeDefinition type)
static JSONCodecFactory	create(SchemaContext context) Deprecated. Use getShared(SchemaContext) instead.
static JSONCodecFactory	createLazy(SchemaContext context) Deprecated. Use JSONCodecFactorySupplier.createLazy(SchemaContext) instead.
static JSONCodecFactory	createSimple(SchemaContext context) Deprecated. Use JSONCodecFactorySupplier.createSimple(SchemaContext) instead.
protected org.opendaylight.yangtools.yang.data.codec.gson.JSONCodec<?>	decimalCodec(DecimalTypeDefinition type)
protected org.opendaylight.yangtools.yang.data.codec.gson.JSONCodec<?>	emptyCodec(EmptyTypeDefinition type)
protected org.opendaylight.yangtools.yang.data.codec.gson.JSONCodec<?>	enumCodec(EnumTypeDefinition type)
static JSONCodecFactory	getPrecomputed(SchemaContext context) Deprecated. Use JSONCodecFactorySupplier.getPrecomputed(SchemaContext) instead.
static com.google.common.base.Optional<JSONCodecFactory>	getPrecomputedIfAvailable(SchemaContext context) Deprecated. Use JSONCodecFactorySupplier.getPrecomputedIfAvailable(SchemaContext) instead.
static JSONCodecFactory	getShared(SchemaContext context) Deprecated. Use JSONCodecFactorySupplier.getShared(SchemaContext) instead.
protected org.opendaylight.yangtools.yang.data.codec.gson.JSONCodec<?>	identityRefCodec(IdentityrefTypeDefinition type, QNameModule module)
protected org.opendaylight.yangtools.yang.data.codec.gson.JSONCodec<?>	instanceIdentifierCodec(InstanceIdentifierTypeDefinition type)
protected org.opendaylight.yangtools.yang.data.codec.gson.JSONCodec<?>	intCodec(IntegerTypeDefinition type)
protected org.opendaylight.yangtools.yang.data.codec.gson.JSONCodec<?>	stringCodec(StringTypeDefinition type)
protected org.opendaylight.yangtools.yang.data.codec.gson.JSONCodec<?>	uintCodec(UnsignedIntegerTypeDefinition type)
protected org.opendaylight.yangtools.yang.data.codec.gson.JSONCodec<?>	unionCodec(UnionTypeDefinition type, List<org.opendaylight.yangtools.yang.data.codec.gson.JSONCodec<?>> codecs)
protected org.opendaylight.yangtools.yang.data.codec.gson.JSONCodec<?>	unknownCodec(UnknownTypeDefinition type)

Methods inherited from class org.opendaylight.yangtools.yang.data.util.codec.AbstractCodecFactory

codecFor, getSchemaContext

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

create

@Deprecated
public static JSONCodecFactory create(SchemaContext context)

Deprecated. Use getShared(SchemaContext) instead.

Instantiate a new codec factory attached to a particular context.

Parameters:

context - SchemaContext to which the factory should be bound

Returns:

A codec factory instance.

getPrecomputed

@Deprecated
public static JSONCodecFactory getPrecomputed(SchemaContext context)

Deprecated. Use JSONCodecFactorySupplier.getPrecomputed(SchemaContext) instead.

Get a thread-safe, eagerly-caching JSONCodecFactory for a SchemaContext. This method can, and will, return the same instance as long as the associated SchemaContext is present. Returned object can be safely used by multiple threads concurrently. If the SchemaContext instance does not have a cached instance of JSONCodecFactory, it will be completely precomputed before this method will return. Choosing this implementation is appropriate when the memory overhead of keeping a full codec tree is not as great a concern as predictable performance. When compared to the implementation returned by getShared(SchemaContext), this implementation is expected to offer higher performance and have lower peak memory footprint when most of the SchemaContext is actually in use. For call sites which do not want to pay the CPU cost of pre-computing this implementation, but still would like to use it if is available (by being populated by some other caller), you can use getPrecomputedIfAvailable(SchemaContext).

Parameters:

context - SchemaContext instance

Returns:

A sharable JSONCodecFactory

Throws:

NullPointerException - if context is null

getPrecomputedIfAvailable

@Deprecated
public static com.google.common.base.Optional<JSONCodecFactory> getPrecomputedIfAvailable(SchemaContext context)

Deprecated. Use JSONCodecFactorySupplier.getPrecomputedIfAvailable(SchemaContext) instead.

Get a thread-safe, eagerly-caching JSONCodecFactory for a SchemaContext, if it is available. This method is a non-blocking equivalent of getPrecomputed(SchemaContext) for use in code paths where the potential of having to pre-compute the implementation is not acceptable. One such scenario is when the code base wants to opportunistically take advantage of pre-computed version, but is okay with a fallback to a different implementation.

Parameters:

context - SchemaContext instance

Returns:

A sharable JSONCodecFactory, or absent if such an implementation is not available.

Throws:

NullPointerException - if context is null

getShared

@Deprecated
public static JSONCodecFactory getShared(SchemaContext context)

Deprecated. Use JSONCodecFactorySupplier.getShared(SchemaContext) instead.

Get a thread-safe, lazily-caching JSONCodecFactory for a SchemaContext. This method can, and will, return the same instance as long as the associated SchemaContext is present or the factory is not invalidated by memory pressure. Returned object can be safely used by multiple threads concurrently. Choosing this implementation is a safe default, as it will not incur prohibitive blocking, nor will it tie up memory in face of pressure.

Parameters:

context - SchemaContext instance

Returns:

A sharable JSONCodecFactory

Throws:

NullPointerException - if context is null

createLazy

@Deprecated
public static JSONCodecFactory createLazy(SchemaContext context)

Deprecated. Use JSONCodecFactorySupplier.createLazy(SchemaContext) instead.

Create a new thread-unsafe, lazily-caching JSONCodecFactory for a SchemaContext. This method will return distinct objects every time it is invoked. Returned object may not be used from multiple threads concurrently. This implementation is appropriate for one-off serialization from a single thread. It will aggressively cache codecs for reuse and will tie them up in memory until the factory is freed.

Parameters:

context - SchemaContext instance

Returns:

A non-sharable JSONCodecFactory

Throws:

NullPointerException - if context is null

createSimple

@Deprecated
public static JSONCodecFactory createSimple(SchemaContext context)

Deprecated. Use JSONCodecFactorySupplier.createSimple(SchemaContext) instead.

Create a simplistic, thread-safe JSONCodecFactory for a SchemaContext. This method will return distinct objects every time it is invoked. Returned object may be use from multiple threads concurrently. This implementation exists mostly for completeness only, as it does not perform any caching at all and each codec is computed every time it is requested. This may be useful in extremely constrained environments, where memory footprint is more critical than performance.

Parameters:

context - SchemaContext instance

Returns:

A non-sharable JSONCodecFactory

Throws:

NullPointerException - if context is null.

binaryCodec

protected org.opendaylight.yangtools.yang.data.codec.gson.JSONCodec<?> binaryCodec(BinaryTypeDefinition type)

Specified by:

binaryCodec in class AbstractCodecFactory<org.opendaylight.yangtools.yang.data.codec.gson.JSONCodec<?>>

booleanCodec

protected org.opendaylight.yangtools.yang.data.codec.gson.JSONCodec<?> booleanCodec(BooleanTypeDefinition type)

Specified by:

booleanCodec in class AbstractCodecFactory<org.opendaylight.yangtools.yang.data.codec.gson.JSONCodec<?>>

bitsCodec

protected org.opendaylight.yangtools.yang.data.codec.gson.JSONCodec<?> bitsCodec(BitsTypeDefinition type)

Specified by:

bitsCodec in class AbstractCodecFactory<org.opendaylight.yangtools.yang.data.codec.gson.JSONCodec<?>>

decimalCodec

protected org.opendaylight.yangtools.yang.data.codec.gson.JSONCodec<?> decimalCodec(DecimalTypeDefinition type)

Specified by:

decimalCodec in class AbstractCodecFactory<org.opendaylight.yangtools.yang.data.codec.gson.JSONCodec<?>>

emptyCodec

protected org.opendaylight.yangtools.yang.data.codec.gson.JSONCodec<?> emptyCodec(EmptyTypeDefinition type)

Specified by:

emptyCodec in class AbstractCodecFactory<org.opendaylight.yangtools.yang.data.codec.gson.JSONCodec<?>>

enumCodec

protected org.opendaylight.yangtools.yang.data.codec.gson.JSONCodec<?> enumCodec(EnumTypeDefinition type)

Specified by:

enumCodec in class AbstractCodecFactory<org.opendaylight.yangtools.yang.data.codec.gson.JSONCodec<?>>

identityRefCodec

protected org.opendaylight.yangtools.yang.data.codec.gson.JSONCodec<?> identityRefCodec(IdentityrefTypeDefinition type,
                                                                                        QNameModule module)

Specified by:

identityRefCodec in class AbstractCodecFactory<org.opendaylight.yangtools.yang.data.codec.gson.JSONCodec<?>>

instanceIdentifierCodec

protected org.opendaylight.yangtools.yang.data.codec.gson.JSONCodec<?> instanceIdentifierCodec(InstanceIdentifierTypeDefinition type)

Specified by:

instanceIdentifierCodec in class AbstractCodecFactory<org.opendaylight.yangtools.yang.data.codec.gson.JSONCodec<?>>

intCodec

protected org.opendaylight.yangtools.yang.data.codec.gson.JSONCodec<?> intCodec(IntegerTypeDefinition type)

Specified by:

intCodec in class AbstractCodecFactory<org.opendaylight.yangtools.yang.data.codec.gson.JSONCodec<?>>

stringCodec

protected org.opendaylight.yangtools.yang.data.codec.gson.JSONCodec<?> stringCodec(StringTypeDefinition type)

Specified by:

stringCodec in class AbstractCodecFactory<org.opendaylight.yangtools.yang.data.codec.gson.JSONCodec<?>>

uintCodec

protected org.opendaylight.yangtools.yang.data.codec.gson.JSONCodec<?> uintCodec(UnsignedIntegerTypeDefinition type)

Specified by:

uintCodec in class AbstractCodecFactory<org.opendaylight.yangtools.yang.data.codec.gson.JSONCodec<?>>

unionCodec

protected org.opendaylight.yangtools.yang.data.codec.gson.JSONCodec<?> unionCodec(UnionTypeDefinition type,
                                                                                  List<org.opendaylight.yangtools.yang.data.codec.gson.JSONCodec<?>> codecs)

Specified by:

unionCodec in class AbstractCodecFactory<org.opendaylight.yangtools.yang.data.codec.gson.JSONCodec<?>>

unknownCodec

protected org.opendaylight.yangtools.yang.data.codec.gson.JSONCodec<?> unknownCodec(UnknownTypeDefinition type)

Specified by:

unknownCodec in class AbstractCodecFactory<org.opendaylight.yangtools.yang.data.codec.gson.JSONCodec<?>>