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

Class JsonParserStream

java.lang.Object

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

All Implemented Interfaces:

Closeable, Flushable, AutoCloseable

@Beta
public final class JsonParserStream
extends Object
implements Closeable, Flushable

This class parses JSON elements from a GSON JsonReader. It disallows multiple elements of the same name unlike the default GSON JsonParser.

Method Summary

Modifier and Type	Method	Description
void	close()
static @NonNull JsonParserStream	create(@NonNull NormalizedNodeStreamWriter writer, @NonNull JSONCodecFactory codecFactory)	Create a new JsonParserStream backed by specified NormalizedNodeStreamWriter and JSONCodecFactory.
static @NonNull JsonParserStream	create(@NonNull NormalizedNodeStreamWriter writer, @NonNull JSONCodecFactory codecFactory, @NonNull SchemaNode parentNode)	Create a new JsonParserStream backed by specified NormalizedNodeStreamWriter and JSONCodecFactory.
static @NonNull JsonParserStream	createLenient(@NonNull NormalizedNodeStreamWriter writer, @NonNull JSONCodecFactory codecFactory)	Create a new JsonParserStream backed by specified NormalizedNodeStreamWriter and JSONCodecFactory.
static @NonNull JsonParserStream	createLenient(@NonNull NormalizedNodeStreamWriter writer, @NonNull JSONCodecFactory codecFactory, @NonNull SchemaNode parentNode)	Create a new JsonParserStream backed by specified NormalizedNodeStreamWriter and JSONCodecFactory.
void	flush()
JsonParserStream	parse(com.google.gson.stream.JsonReader reader)
void	read(com.google.gson.stream.JsonReader in, AbstractNodeDataWithSchema<?> parent)

Methods inherited from class java.lang.Object

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

Method Detail

create

public static @NonNull JsonParserStream create(@NonNull NormalizedNodeStreamWriter writer,
                                               @NonNull JSONCodecFactory codecFactory)

Create a new JsonParserStream backed by specified NormalizedNodeStreamWriter and JSONCodecFactory. The stream will be logically rooted at the top of the SchemaContext associated with the specified codec factory.

Parameters:

writer - NormalizedNodeStreamWriter to use for instantiation of normalized nodes

codecFactory - JSONCodecFactory to use for parsing leaves

Returns:

A new JsonParserStream

Throws:

NullPointerException - if any of the arguments are null

create

public static @NonNull JsonParserStream create(@NonNull NormalizedNodeStreamWriter writer,
                                               @NonNull JSONCodecFactory codecFactory,
                                               @NonNull SchemaNode parentNode)

Create a new JsonParserStream backed by specified NormalizedNodeStreamWriter and JSONCodecFactory. The stream will be logically rooted at the specified parent node.

Parameters:

writer - NormalizedNodeStreamWriter to use for instantiation of normalized nodes

codecFactory - JSONCodecFactory to use for parsing leaves

parentNode - Logical root node

Returns:

A new JsonParserStream

Throws:

NullPointerException - if any of the arguments are null

createLenient

public static @NonNull JsonParserStream createLenient(@NonNull NormalizedNodeStreamWriter writer,
                                                      @NonNull JSONCodecFactory codecFactory)

Create a new JsonParserStream backed by specified NormalizedNodeStreamWriter and JSONCodecFactory. The stream will be logically rooted at the top of the SchemaContext associated with the specified codec factory.

Returned parser will treat incoming JSON data leniently:

• JSON elements referring to unknown constructs will be silently ignored

Parameters:

writer - NormalizedNodeStreamWriter to use for instantiation of normalized nodes

codecFactory - JSONCodecFactory to use for parsing leaves

Returns:

A new JsonParserStream

Throws:

NullPointerException - if any of the arguments are null

createLenient

public static @NonNull JsonParserStream createLenient(@NonNull NormalizedNodeStreamWriter writer,
                                                      @NonNull JSONCodecFactory codecFactory,
                                                      @NonNull SchemaNode parentNode)

Create a new JsonParserStream backed by specified NormalizedNodeStreamWriter and JSONCodecFactory. The stream will be logically rooted at the specified parent node.

Returned parser will treat incoming JSON data leniently:

• JSON elements referring to unknown constructs will be silently ignored

Parameters:

writer - NormalizedNodeStreamWriter to use for instantiation of normalized nodes

codecFactory - JSONCodecFactory to use for parsing leaves

parentNode - Logical root node

Returns:

A new JsonParserStream

Throws:

NullPointerException - if any of the arguments are null

parse

public JsonParserStream parse(com.google.gson.stream.JsonReader reader)

read

public void read(com.google.gson.stream.JsonReader in,
                 AbstractNodeDataWithSchema<?> parent)
          throws IOException

Throws:

IOException

flush

public void flush()
           throws IOException

Specified by:

flush in interface Flushable

Throws:

IOException

close

public void close()
           throws IOException

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Throws:

IOException