Package org.bson.json

Interface StrictJsonWriter

  • All Known Implementing Classes:
    StrictCharacterStreamJsonWriter

    public interface StrictJsonWriter
    An interface for creating JSON texts that largely conform to RFC 7159.
    Since:
    3.5

    • Method Detail

      • writeName

        void writeName​(String name)
        Writes the name of a member to the writer.
        Parameters:
        name - the member name
        Throws:
        BsonInvalidOperationException - if not in the correct state to write a member name
        BSONException - if the underlying Writer throws an IOException

      • writeBoolean

        void writeBoolean​(boolean value)
        Writes a boolean to the writer.
        Parameters:
        value - the boolean value.
        Throws:
        BsonInvalidOperationException - if not in the correct state to write a value
        BSONException - if the underlying Writer throws an IOException

      • writeBoolean

        void writeBoolean​(String name,
                  boolean value)
        Writes a a member with a boolean value to the writer.
        Parameters:
        name - the member name
        value - the boolean value
        Throws:
        BsonInvalidOperationException - if not in the correct state to write a member
        BSONException - if the underlying Writer throws an IOException

      • writeNumber

        void writeNumber​(String value)
        Writes a number to the writer.
        Parameters:
        value - the Double value, as a String so that clients can take full control over formatting
        Throws:
        BsonInvalidOperationException - if not in the correct state to write a value
        BSONException - if the underlying Writer throws an IOException

      • writeNumber

        void writeNumber​(String name,
                 String value)
        Writes a member with a numeric value to the writer.
        Parameters:
        name - the member name
        value - the Double value, as a String so that clients can take full control over formatting
        Throws:
        BsonInvalidOperationException - if not in the correct state to write a member
        BSONException - if the underlying Writer throws an IOException

      • writeString

        void writeString​(String value)
        Writes a String to the writer.
        Parameters:
        value - the String value
        Throws:
        BsonInvalidOperationException - if not in the correct state to write a value
        BSONException - if the underlying Writer throws an IOException

      • writeString

        void writeString​(String name,
                 String value)
        Writes a member with a string value to the writer.
        Parameters:
        name - the member name
        value - the String value
        Throws:
        BsonInvalidOperationException - if not in the correct state to write a member
        BSONException - if the underlying Writer throws an IOException

      • writeRaw

        void writeRaw​(String value)
        Writes a raw value without quoting or escaping.
        Parameters:
        value - the String value
        Throws:
        BsonInvalidOperationException - if not in the correct state to write a value
        BSONException - if the underlying Writer throws an IOException

      • writeRaw

        void writeRaw​(String name,
              String value)
        Writes a member with a raw value without quoting or escaping.
        Parameters:
        name - the member name
        value - the raw value
        Throws:
        BsonInvalidOperationException - if not in the correct state to write a member
        BSONException - if the underlying Writer throws an IOException

      • writeNull

        void writeNull​()
        Writes a null value to the writer.
        Throws:
        BsonInvalidOperationException - if not in the correct state to write a value
        BSONException - if the underlying Writer throws an IOException

      • writeNull

        void writeNull​(String name)
        Writes a member with a null value to the writer.
        Parameters:
        name - the member name
        Throws:
        BsonInvalidOperationException - if not in the correct state to write a member
        BSONException - if the underlying Writer throws an IOException

      • writeStartArray

        void writeStartArray​()
        Writes the start of a array to the writer.
        Throws:
        BsonInvalidOperationException - if not in the correct state to write a value
        BSONException - if the underlying Writer throws an IOException

      • writeStartArray

        void writeStartArray​(String name)
        Writes the start of JSON array member to the writer.
        Parameters:
        name - the member name
        Throws:
        BsonInvalidOperationException - if not in the correct state to write a member
        BSONException - if the underlying Writer throws an IOException

      • writeStartObject

        void writeStartObject​()
        Writes the start of a JSON object to the writer.
        Throws:
        BsonInvalidOperationException - if not in the correct state to write a value
        BSONException - if the underlying Writer throws an IOException

      • writeStartObject

        void writeStartObject​(String name)
        Writes the start of a JSON object member to the writer.
        Parameters:
        name - the member name
        Throws:
        BsonInvalidOperationException - if not in the correct state to write a member
        BSONException - if the underlying Writer throws an IOException

      • writeEndArray

        void writeEndArray​()
        Writes the end of a JSON array to the writer.
        Throws:
        BsonInvalidOperationException - if not in the correct state to write the end of an array
        BSONException - if the underlying Writer throws an IOException

      • writeEndObject

        void writeEndObject​()
        Writes the end of a JSON object to the writer.
        Throws:
        BsonInvalidOperationException - if not in the correct state to write the end of an object
        BSONException - if the underlying Writer throws an IOException

      • isTruncated

        boolean isTruncated​()
        Return true if the output has been truncated due to exceeding any maximum length specified in settings.
        Returns:
        true if the output has been truncated
        Since:
        3.7