Package javax.json

Interface JsonWriterFactory


  • public interface JsonWriterFactory
    Factory to create JsonWriter instances. If a factory instance is configured with some configuration, that would be used to configure the created writer instances.

    This is a near-exact copy of the same-titled Java EE 8 Class: javax.json.JsonWriterFactory
    Commenting has been slightly modified to accompany HiLiting the 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.* Code Obtained From: GitHub JavaEE jsonp  Public Archive.


    JsonWriter can also be created using Json's createWriter methods. If multiple writer instances are created, then creating them using a writer factory is preferred.

    Example:
     JsonWriterFactory    factory = Json.createWriterFactory(...);
     JsonWriter           writer1 = factory.createWriter(...);
     JsonWriter           writer2 = factory.createWriter(...);
    

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


    • Method Summary

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method Description
      JsonWriter createWriter​(OutputStream out)
      Creates a JSON writer to write a JSON object or array structure to the specified byte stream.
      JsonWriter createWriter​(OutputStream out, java.nio.charset.Charset charset)
      Creates a JSON writer to write a JSON object or array structure to the specified byte stream.
      JsonWriter createWriter​(Writer writer)
      Creates a JSON writer to write a JSON object or array structure to the specified character stream.
      Map<String,​?> getConfigInUse()
      Returns read-only map of supported provider specific configuration properties that are used to configure the created JSON writer objects.
    • Method Detail

      • createWriter

        🡇     🗕  🗗  🗖
        JsonWriter createWriter​(java.io.Writer writer)
        Creates a JSON writer to write a JSON object or array structure to the specified character stream. The writer is configured with the factory configuration.
        Parameters:
        writer - to which JSON object or array is written
        Returns:
        a JSON writer
      • createWriter

        🡅  🡇     🗕  🗗  🗖
        JsonWriter createWriter​(java.io.OutputStream out)
        Creates a JSON writer to write a JSON object or array structure to the specified byte stream. Characters written to the stream are encoded into bytes using UTF-8 encoding. The writer is configured with the factory configuration.
        Parameters:
        out - to which JSON object or array is written
        Returns:
        a JSON writer
      • createWriter

        🡅  🡇     🗕  🗗  🗖
        JsonWriter createWriter​(java.io.OutputStream out,
                                java.nio.charset.Charset charset)
        Creates a JSON writer to write a JSON object or array structure to the specified byte stream. Characters written to the stream are encoded into bytes using the specified charset. The writer is configured with the factory configuration.
        Parameters:
        out - to which JSON object or array is written
        charset - a charset
        Returns:
        a JSON writer
      • getConfigInUse

        🡅     🗕  🗗  🗖
        java.util.Map<java.lang.String,​?> getConfigInUse()
        Returns read-only map of supported provider specific configuration properties that are used to configure the created JSON writer objects. 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 writers. The map may be empty but not null.