javax.json.stream
Interface JsonParserFactory


public interface JsonParserFactory

Factory to create JsonParser instances. If a factory instance is configured with some configuration, that would be used to configure the created parser instances.

JsonParser can also be created using Json's createParser methods. If multiple parser instances are created, then creating them using a parser factory is preferred.

For example:

 JsonParserFactory factory = Json.createParserFactory();
 JsonParser parser1 = factory.createParser(...);
 JsonParser parser2 = factory.createParser(...);
 

All of the methods in this class are safe for use by multiple concurrent threads.

Author:
Jitendra Kotamraju

Method Summary
 JsonParser createParser(InputStream in)
          Creates a JSON parser from the specified byte stream.
 JsonParser createParser(InputStream in, String encoding)
          Creates a JSON parser from the specified byte stream.
 JsonParser createParser(JsonArray array)
          Creates a JSON parser from the specified JSON array.
 JsonParser createParser(JsonObject obj)
          Creates a JSON parser from the specified JSON object.
 JsonParser createParser(Reader reader)
          Creates a JSON parser from a character stream
 

Method Detail

createParser

JsonParser createParser(Reader reader)
Creates a JSON parser from a character stream

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

createParser

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

createParser

JsonParser createParser(InputStream in,
                        String encoding)
Creates a JSON parser from the specified byte stream. The bytes of the stream are decoded to characters using the specified encoding.

Parameters:
in - i/o stream from which JSON is to be read
encoding - the name of character encoding of the stream.
Throws:
JsonException - if the named encoding is not supported. The cause of the exception would be UnsupportedEncodingException
See Also:
Charset

createParser

JsonParser createParser(JsonObject obj)
Creates a JSON parser from the specified JSON object.

Parameters:
obj - JSON object

createParser

JsonParser createParser(JsonArray array)
Creates a JSON parser from the specified JSON array.

Parameters:
array - JSON array



Copyright © 2012 Oracle and/or its affiliates. All rights reserved.