Interface JsonParserFactory


  • public interface JsonParserFactory
    Factory for creating JsonParser instances. If a factory instance is configured with a configuration, the configuration applies to all parser instances created using that factory instance.

    This is a near-exact copy of the same-titled Java EE 8 Class: javax.json.stream.JsonParserFactory
    Commenting has been slightly modified to accompany HiLited Code Examples.
    Java Source Code remains identical to the Sun-Oracle & 'GlassFish' Released Distributions.

    Read included License: HERE, and the CDDL+GPL-1.1
    All javax.json.stream.* Code Obtained From: GitHub JavaEE jsonp  Public Archive.


    The class Json also provides methods to create JsonParser instances, but using JsonParserFactory is preferred when creating multiple parser instances as shown in the following example:

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


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


    • Method Detail

      • createParser

        🡇     🗕  🗗  🗖
        JsonParser createParser​(java.io.Reader reader)
        Creates a JSON parser from a character stream.
        Parameters:
        reader - a i/o reader from which JSON is to be read
        Returns:
        the created JSON parser
      • createParser

        🡅  🡇     🗕  🗗  🗖
        JsonParser createParser​(java.io.InputStream in)
        Creates a JSON parser from the specified byte stream. The character encoding of the stream is determined as specified in RFC 7159.
        Parameters:
        in - i/o stream from which JSON is to be read
        Returns:
        the created JSON parser
        Throws:
        JsonException - if encoding cannot be determined or i/o error (IOException would be cause of JsonException)
      • createParser

        🡅  🡇     🗕  🗗  🗖
        JsonParser createParser​(java.io.InputStream in,
                                java.nio.charset.Charset charset)
        Creates a JSON parser from the specified byte stream. The bytes of the stream are decoded to characters using the specified charset.
        Parameters:
        in - i/o stream from which JSON is to be read
        charset - a charset
        Returns:
        the created JSON parser
      • getConfigInUse

        🡅     🗕  🗗  🗖
        java.util.Map<java.lang.String,​?> getConfigInUse()
        Returns a read-only map of supported provider specific configuration properties that are used to configure the JSON parsers. If there are any specified configuration properties that are not supported by the provider, they won't be part of the returned map.
        Returns:
        a map of supported provider specific properties that are used to configure the created parsers. The map may be empty but not null