javax.json.spi

Class JsonProvider

java.lang.Object

javax.json.spi.JsonProvider

public abstract class JsonProvider
extends Object

Service provider for JSON objects.

Author:

Jitendra Kotamraju

See Also:

ServiceLoader

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	JsonProvider()

Method Summary

Methods

Modifier and Type	Method and Description
abstract JsonGenerator	createGenerator(OutputStream out) Creates a JSON generator which can be used to write JSON text to the specified byte stream.
abstract JsonGenerator	createGenerator(Writer writer) Creates a JSON generator which can be used to write JSON text to the specified character stream.
abstract JsonGeneratorFactory	createGeneratorFactory() Creates a generator factory which can be used to create JsonGenerator.
abstract JsonGeneratorFactory	createGeneratorFactory(JsonConfiguration config) Creates a generator factory which can be used to create JsonGenerator.
abstract JsonParser	createParser(InputStream in) Creates a JSON parser from the specified byte stream.
abstract JsonParser	createParser(Reader reader) Creates a JSON parser from the specified character stream
abstract JsonParserFactory	createParserFactory() Creates a parser factory which can be used to create JsonParser.
abstract JsonParserFactory	createParserFactory(JsonConfiguration config) Creates a parser factory which can be used to create JsonParser.
static JsonProvider	provider() Creates a JSON provider object.

Methods inherited from class java.lang.Object

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

Constructor Detail

JsonProvider

protected JsonProvider()

Method Detail

provider

public static JsonProvider provider()

Creates a JSON provider object. The provider is loaded using ServiceLoader.load(Class) method. If there is no available service provider is found, then the default service provider is returned.

Returns:

a JSON provider

See Also:

ServiceLoader

createParser

public abstract JsonParser createParser(Reader reader)

Creates a JSON parser from the specified character stream

Parameters:

reader - i/o reader from which JSON is to be read

createParser

public abstract JsonParser createParser(InputStream in)

Creates a JSON parser from the specified byte stream. The character encoding of the stream is determined as per the RFC.

Parameters:

in - i/o stream from which JSON is to be read

Throws:

JsonException - if encoding cannot be determined or i/o error (IOException would be cause of JsonException)

createParserFactory

public abstract JsonParserFactory createParserFactory()

Creates a parser factory which can be used to create JsonParser.

Returns:

JSON parser factory

createParserFactory

public abstract JsonParserFactory createParserFactory(JsonConfiguration config)

Creates a parser factory which can be used to create JsonParser. The created parser factory is configured with the specified configuration

Parameters:

config - configuration of the parser factory

Returns:

JSON parser factory

createGenerator

public abstract JsonGenerator createGenerator(Writer writer)

Creates a JSON generator which can be used to write JSON text to the specified character stream.

Parameters:

writer - a i/o writer to which JSON is written

createGenerator

public abstract JsonGenerator createGenerator(OutputStream out)

Creates a JSON generator which can be used to write JSON text to the specified byte stream.

Parameters:

out - i/o stream to which JSON is written

createGeneratorFactory

public abstract JsonGeneratorFactory createGeneratorFactory()

Creates a generator factory which can be used to create JsonGenerator.

Returns:

JSON generator factory

createGeneratorFactory

public abstract JsonGeneratorFactory createGeneratorFactory(JsonConfiguration config)

Creates a generator factory which can be used to create JsonGenerator. The created generator factory is configured with the specified configuration.

Parameters:

config - configuration of the generator factory

Returns:

JSON generator factory