com.unboundid.util.json

Class JSONBoolean

java.lang.Object

com.unboundid.util.json.JSONValue

com.unboundid.util.json.JSONBoolean

All Implemented Interfaces:

java.io.Serializable, java.lang.Comparable<JSONValue>

@NotMutable
 @ThreadSafety(level=COMPLETELY_THREADSAFE)
public final class JSONBoolean
extends JSONValue

This class provides an implementation of a JSON value that represents a Java Boolean. The string representation of the JSON Boolean true value is true, and the string representation of the JSON Boolean false value is false. These values are not surrounded by quotation marks, and they must be entirely lowercase.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static JSONBoolean	FALSE A pre-allocated object that represents a value of false.
static JSONBoolean	TRUE A pre-allocated object that represents a value of true.

Constructor Summary

Constructors

Constructor and Description
JSONBoolean(boolean booleanValue) Creates a new JSON value capable of representing a Boolean value of either true or false.

Method Summary

Modifier and Type	Method and Description
void	appendToJSONBuffer(JSONBuffer buffer) Appends this value to the provided JSON buffer.
void	appendToJSONBuffer(java.lang.String fieldName, JSONBuffer buffer) Appends a field with the given name and this value to the provided JSON buffer.
boolean	booleanValue() Retrieves the Java boolean value for this JSON value.
boolean	equals(JSONValue v, boolean ignoreFieldNameCase, boolean ignoreValueCase, boolean ignoreArrayOrder) Indicates whether this JSON value is considered equal to the provided JSON value, subject to the specified constraints.
boolean	equals(java.lang.Object o) Indicates whether the provided object is equal to this JSON value.
int	hashCode() Retrieves a hash code for this JSON value.
java.lang.String	toNormalizedString() Retrieves a normalized string representation of this Boolean value as it should appear in a JSON object.
java.lang.String	toNormalizedString(boolean ignoreFieldNameCase, boolean ignoreValueCase, boolean ignoreArrayOrder) Retrieves a normalized string representation of this Boolean value as it should appear in a JSON object.
void	toNormalizedString(java.lang.StringBuilder buffer) Appends a normalized string representation of this Boolean value as it should appear in a JSON object to the provided buffer.
void	toNormalizedString(java.lang.StringBuilder buffer, boolean ignoreFieldNameCase, boolean ignoreValueCase, boolean ignoreArrayOrder) Appends a normalized string representation of this Boolean value as it should appear in a JSON object to the provided buffer.
JSONBoolean	toNormalizedValue(boolean ignoreFieldNameCase, boolean ignoreValueCase, boolean ignoreArrayOrder) Retrieves a normalized representation of this value using the provided settings.
java.lang.String	toSingleLineString() Retrieves a single-line string representation of this Boolean value as it should appear in a JSON object.
void	toSingleLineString(java.lang.StringBuilder buffer) Appends a single-line string representation of this Boolean value as it should appear in a JSON object to the provided buffer.
java.lang.String	toString() Retrieves a string representation of this Boolean value as it should appear in a JSON object.
void	toString(java.lang.StringBuilder buffer) Appends a string representation of this Boolean value as it should appear in a JSON object to the provided buffer.

Methods inherited from class com.unboundid.util.json.JSONValue

compareTo

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

FALSE

@NotNull
public static final JSONBoolean FALSE

A pre-allocated object that represents a value of false.

TRUE

@NotNull
public static final JSONBoolean TRUE

A pre-allocated object that represents a value of true.

Constructor Detail

JSONBoolean

public JSONBoolean(boolean booleanValue)

Creates a new JSON value capable of representing a Boolean value of either true or false.

Parameters:

booleanValue - The Boolean value for this JSON value.

Method Detail

booleanValue

public boolean booleanValue()

Retrieves the Java boolean value for this JSON value.

Returns:

The Java boolean value for this JSON value.

hashCode

public int hashCode()

Retrieves a hash code for this JSON value.

Specified by:

hashCode in class JSONValue

Returns:

The hash code for this JSON value.

equals

public boolean equals(@Nullable
                      java.lang.Object o)

Indicates whether the provided object is equal to this JSON value.

Specified by:

equals in class JSONValue

Parameters:

o - The object to compare against this JSON value.

Returns:

true if the provided object is considered equal to this JSON value, or false if not.

equals

public boolean equals(@NotNull
                      JSONValue v,
                      boolean ignoreFieldNameCase,
                      boolean ignoreValueCase,
                      boolean ignoreArrayOrder)

Indicates whether this JSON value is considered equal to the provided JSON value, subject to the specified constraints. Note that not all constraints will apply to all data types.

Specified by:

equals in class JSONValue

Parameters:

v - The JSON value for which to make the determination. It must not be null.

ignoreFieldNameCase - Indicates whether to ignore differences in the capitalization of JSON field names.

ignoreValueCase - Indicates whether to ignore differences in the capitalization of JSON values that represent strings.

ignoreArrayOrder - Indicates whether to ignore differences in the order of elements in JSON arrays.

Returns:

true if this JSON value is considered equal to the provided JSON value (subject to the specified constraints), or false if not.

toString

@NotNull
public java.lang.String toString()

Retrieves a string representation of this Boolean value as it should appear in a JSON object. If the Boolean value is true, then the string representation will be "true" (without the surrounding quotes). If the Boolean value is false, then the string representation will be "false" (again, without the quotes).

Specified by:

toString in class JSONValue

Returns:

A string representation of this Boolean value as it should appear in a JSON object.

toString

public void toString(@NotNull
                     java.lang.StringBuilder buffer)

Appends a string representation of this Boolean value as it should appear in a JSON object to the provided buffer. If the Boolean value is true, then the string representation will be "true" (without the surrounding quotes). If the Boolean value is false, then the string representation will be "false" (again, without the quotes).

Specified by:

toString in class JSONValue

Parameters:

buffer - The buffer to which the information should be appended.

toSingleLineString

@NotNull
public java.lang.String toSingleLineString()

Retrieves a single-line string representation of this Boolean value as it should appear in a JSON object. If the Boolean value is true, then the string representation will be "true" (without the surrounding quotes). If the Boolean value is false, then the string representation will be "false" (again, without the quotes).

Specified by:

toSingleLineString in class JSONValue

Returns:

A single-line string representation of this Boolean value as it should appear in a JSON object.

toSingleLineString

public void toSingleLineString(@NotNull
                               java.lang.StringBuilder buffer)

Appends a single-line string representation of this Boolean value as it should appear in a JSON object to the provided buffer. If the Boolean value is true, then the string representation will be "true" (without the surrounding quotes). If the Boolean value is false, then the string representation will be "false" (again, without the quotes).

Specified by:

toSingleLineString in class JSONValue

Parameters:

buffer - The buffer to which the information should be appended.

toNormalizedString

@NotNull
public java.lang.String toNormalizedString()

Retrieves a normalized string representation of this Boolean value as it should appear in a JSON object. If the Boolean value is true, then the string representation will be "true" (without the surrounding quotes). If the Boolean value is false, then the string representation will be "false" (again, without the quotes).

Specified by:

toNormalizedString in class JSONValue

Returns:

A normalized string representation of this Boolean value as it should appear in a JSON object.

toNormalizedString

public void toNormalizedString(@NotNull
                               java.lang.StringBuilder buffer)

Appends a normalized string representation of this Boolean value as it should appear in a JSON object to the provided buffer. If the Boolean value is true, then the string representation will be "true" (without the surrounding quotes). If the Boolean value is false, then the string representation will be "false" (again, without the quotes).

Specified by:

toNormalizedString in class JSONValue

Parameters:

buffer - The buffer to which the information should be appended.

toNormalizedString

@NotNull
public java.lang.String toNormalizedString(boolean ignoreFieldNameCase,
                                                    boolean ignoreValueCase,
                                                    boolean ignoreArrayOrder)

Retrieves a normalized string representation of this Boolean value as it should appear in a JSON object. If the Boolean value is true, then the string representation will be "true" (without the surrounding quotes). If the Boolean value is false, then the string representation will be "false" (again, without the quotes).

Specified by:

toNormalizedString in class JSONValue

Parameters:

ignoreFieldNameCase - Indicates whether field names should be treated in a case-sensitive (if false) or case-insensitive (if true) manner.

ignoreValueCase - Indicates whether string field values should be treated in a case-sensitive (if false) or case-insensitive (if true) manner.

ignoreArrayOrder - Indicates whether the order of elements in an array should be considered significant (if false) or insignificant (if true).

Returns:

A normalized string representation of this Boolean value as it should appear in a JSON object.

toNormalizedString

public void toNormalizedString(@NotNull
                               java.lang.StringBuilder buffer,
                               boolean ignoreFieldNameCase,
                               boolean ignoreValueCase,
                               boolean ignoreArrayOrder)

Appends a normalized string representation of this Boolean value as it should appear in a JSON object to the provided buffer. If the Boolean value is true, then the string representation will be "true" (without the surrounding quotes). If the Boolean value is false, then the string representation will be "false" (again, without the quotes).

Specified by:

toNormalizedString in class JSONValue

Parameters:

buffer - The buffer to which the information should be appended.

ignoreFieldNameCase - Indicates whether field names should be treated in a case-sensitive (if false) or case-insensitive (if true) manner.

ignoreValueCase - Indicates whether string field values should be treated in a case-sensitive (if false) or case-insensitive (if true) manner.

ignoreArrayOrder - Indicates whether the order of elements in an array should be considered significant (if false) or insignificant (if true).

toNormalizedValue

@NotNull
public JSONBoolean toNormalizedValue(boolean ignoreFieldNameCase,
                                              boolean ignoreValueCase,
                                              boolean ignoreArrayOrder)

Retrieves a normalized representation of this value using the provided settings.

Specified by:

toNormalizedValue in class JSONValue

Parameters:

ignoreFieldNameCase - Indicates whether field names should be treated in a case-sensitive (if false) or case-insensitive (if true) manner.

ignoreValueCase - Indicates whether string field values should be treated in a case-sensitive (if false) or case-insensitive (if true) manner.

ignoreArrayOrder - Indicates whether the order of elements in an array should be considered significant (if false) or insignificant (if true).

Returns:

A normalized representation of this value using the provided settings.

appendToJSONBuffer

public void appendToJSONBuffer(@NotNull
                               JSONBuffer buffer)

Appends this value to the provided JSON buffer. This will not include a field name, so it should only be used for Boolean value elements in an array.

Specified by:

appendToJSONBuffer in class JSONValue

Parameters:

buffer - The JSON buffer to which this value should be appended.

appendToJSONBuffer

public void appendToJSONBuffer(@NotNull
                               java.lang.String fieldName,
                               @NotNull
                               JSONBuffer buffer)

Appends a field with the given name and this value to the provided JSON buffer.

Specified by:

appendToJSONBuffer in class JSONValue

Parameters:

fieldName - The name to use for the field.

buffer - The JSON buffer to which this value should be appended.