Package javax.json.spi

Class JsonProvider

java.lang.Object

javax.json.spi.JsonProvider

public abstract class JsonProvider
extends Object

JsonProvider is the actual implementation of all the Json logic. A JsonProvider instance can be used concurrently. It can be accessed via

     
 JsonProvider provider = JsonProvider.provider();
     
 

Method Summary

Modifier and Type	Method	Description
abstract JsonArrayBuilder	createArrayBuilder()
JsonArrayBuilder	createArrayBuilder(Collection<?> initialData)
JsonArrayBuilder	createArrayBuilder(JsonArray initialData)
abstract JsonBuilderFactory	createBuilderFactory(Map<String,?> config)
JsonPatch	createDiff(JsonStructure source, JsonStructure target)	Create a JsonPatch by comparing the source to the target as defined in RFC-6902.
abstract JsonGenerator	createGenerator(OutputStream out)
abstract JsonGenerator	createGenerator(Writer writer)
abstract JsonGeneratorFactory	createGeneratorFactory(Map<String,?> config)
JsonMergePatch	createMergeDiff(JsonValue source, JsonValue target)	Create a merge patch by comparing the source to the target.
JsonMergePatch	createMergePatch(JsonValue patch)	Create a merge patch based on the given JsonValue.
abstract JsonObjectBuilder	createObjectBuilder()	Create an empty JsonObjectBuilder
JsonObjectBuilder	createObjectBuilder(Map<String,Object> map)	Creates a JSON object builder, initialized with the specified Map.
JsonObjectBuilder	createObjectBuilder(JsonObject jsonObject)	Creates a JSON object builder, initialized with the specified JsonObject.
abstract JsonParser	createParser(InputStream in)
abstract JsonParser	createParser(Reader reader)
abstract JsonParserFactory	createParserFactory(Map<String,?> config)
JsonPatch	createPatch(JsonArray array)	Create a JsonPatch as defined in RFC-6902.
JsonPatchBuilder	createPatchBuilder()	Create a new JsonPatchBuilder
JsonPatchBuilder	createPatchBuilder(JsonArray initialData)	Create a new JsonPatchBuilder from initial data.
JsonPointer	createPointer(String path)	Create a JsonPointer based on the given path string
abstract JsonReader	createReader(InputStream in)
abstract JsonReader	createReader(Reader reader)
abstract JsonReaderFactory	createReaderFactory(Map<String,?> config)
JsonNumber	createValue(double value)
JsonNumber	createValue(int value)
JsonNumber	createValue(long value)
JsonString	createValue(String value)
JsonNumber	createValue(BigDecimal value)
JsonNumber	createValue(BigInteger value)
abstract JsonWriter	createWriter(OutputStream out)
abstract JsonWriter	createWriter(Writer writer)
abstract JsonWriterFactory	createWriterFactory(Map<String,?> config)
static JsonProvider	provider()

Methods inherited from class java.lang.Object

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

Method Details

provider

public static JsonProvider provider()

createParser

public abstract JsonParser createParser(Reader reader)

createParser

public abstract JsonParser createParser(InputStream in)

createParserFactory

public abstract JsonParserFactory createParserFactory(Map<String,?> config)

createGenerator

public abstract JsonGenerator createGenerator(Writer writer)

createGenerator

public abstract JsonGenerator createGenerator(OutputStream out)

createGeneratorFactory

public abstract JsonGeneratorFactory createGeneratorFactory(Map<String,?> config)

createReader

public abstract JsonReader createReader(Reader reader)

createReader

public abstract JsonReader createReader(InputStream in)

createWriter

public abstract JsonWriter createWriter(Writer writer)

createWriter

public abstract JsonWriter createWriter(OutputStream out)

createWriterFactory

public abstract JsonWriterFactory createWriterFactory(Map<String,?> config)

createReaderFactory

public abstract JsonReaderFactory createReaderFactory(Map<String,?> config)

createObjectBuilder

public abstract JsonObjectBuilder createObjectBuilder()

Create an empty JsonObjectBuilder

Since:

1.0

createObjectBuilder

public JsonObjectBuilder createObjectBuilder(JsonObject jsonObject)

Creates a JSON object builder, initialized with the specified JsonObject.

Since:

1.1

createObjectBuilder

public JsonObjectBuilder createObjectBuilder(Map<String,Object> map)

Creates a JSON object builder, initialized with the specified Map.

Since:

1.1

createArrayBuilder

public abstract JsonArrayBuilder createArrayBuilder()

createArrayBuilder

public JsonArrayBuilder createArrayBuilder(JsonArray initialData)

createArrayBuilder

public JsonArrayBuilder createArrayBuilder(Collection<?> initialData)

createPointer

public JsonPointer createPointer(String path)

Create a JsonPointer based on the given path string

Since:

1.1

createBuilderFactory

public abstract JsonBuilderFactory createBuilderFactory(Map<String,?> config)

createValue

public JsonString createValue(String value)

createValue

public JsonNumber createValue(int value)

createValue

public JsonNumber createValue(long value)

createValue

public JsonNumber createValue(double value)

createValue

public JsonNumber createValue(BigDecimal value)

createValue

public JsonNumber createValue(BigInteger value)

createPatch

public JsonPatch createPatch(JsonArray array)

Create a JsonPatch as defined in RFC-6902.

Parameters:

array - with the patch operations

Returns:

the JsonPatch based on the given operations

Since:

1.1

See Also:

• createDiff(JsonStructure, JsonStructure)

createDiff

public JsonPatch createDiff(JsonStructure source,
 JsonStructure target)

Create a JsonPatch by comparing the source to the target as defined in RFC-6902. Applying this JsonPatch to the source you will give you the target.

Since:

1.1

See Also:

• createPatch(JsonArray)

createPatchBuilder

public JsonPatchBuilder createPatchBuilder()

Create a new JsonPatchBuilder

Since:

1.1

createPatchBuilder

public JsonPatchBuilder createPatchBuilder(JsonArray initialData)

Create a new JsonPatchBuilder from initial data.

Parameters:

initialData - the initial patch operations

Since:

1.1

createMergePatch

public JsonMergePatch createMergePatch(JsonValue patch)

Create a merge patch based on the given JsonValue. If you have the following JsonMergePatch:

 {
   "a":"z",
   "c": {
     "f": null
   }
 }
 

and apply it to the following JSON

 {
   "a": "b",
   "c": {
     "d": "e",
     "f": "g"
   }
 }
 

you will get the following result:

 {
   "a": "z",
   "c": {
     "d": "e",
   }
 }
 

Since:

1.1

See Also:

• createMergeDiff(JsonValue, JsonValue)

createMergeDiff

public JsonMergePatch createMergeDiff(JsonValue source,
 JsonValue target)

Create a merge patch by comparing the source to the target. Applying this JsonMergePatch to the source will give you the target. A MergePatch is a JsonValue as defined in http://tools.ietf.org/html/rfc7396 If you have a JSON like

 {
   "a": "b",
   "c": {
     "d": "e",
     "f": "g"
   }
 }
 

and comparing it with

 {
   "a": "z",
   "c": {
     "d": "e",
   }
 }
 

you will get the following JsonMergePatch:

 {
   "a":"z",
   "c": {
     "f": null
   }
 }
 

Since:

1.1

See Also:

• createMergePatch(JsonValue)