Class JsonValue

  • All Implemented Interfaces:
    java.io.Serializable

    public final class JsonValue
    extends JsonValueBase
    implements java.io.Serializable
    Maps values other than JObject and JArray in JSON standards to primitive value types.
    See Also:
    Serialized Form
    • Constructor Summary

      Constructors 
      Constructor Description
      JsonValue​(boolean value)
      Creates an instance of JsonValue of type JsonDataType.Boolean.
      JsonValue​(byte value)
      Creates an instance of JsonValue of type JsonDataType.Number.
      JsonValue​(double value)
      Creates an instance of JsonValue of type JsonDataType.Number.
      JsonValue​(float value)
      Creates an instance of JsonValue of type JsonDataType.Number.
      JsonValue​(int value)
      Creates an instance of JsonValue of type JsonDataType.Number.
      JsonValue​(long value)
      Creates an instance of JsonValue of type JsonDataType.Number.
      JsonValue​(short value)
      Creates an instance of JsonValue of type JsonDataType.Number.
      JsonValue​(java.lang.Object value)
      Creates an instance of JsonValue with the specified object and type set to JsonDataType.Object.
      JsonValue​(java.lang.String value)
      Creates an instance of JsonValue of type JsonDataType.String.
      JsonValue​(java.math.BigDecimal value)
      Creates an instance of JsonValue of type JsonDataType.Number.
      JsonValue​(java.util.Date value)
      Creates an instance of JsonValue of type JsonDataType.String.
    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      boolean equals​(java.lang.Object obj)
      Indicates whether some other object is "equal to" this one.
      int hashCode()
      Returns a hash code value for the object.
      boolean toBoolean()
      Attempts to convert JsonValue to boolean.
      byte toByte()
      Attempts to convert JsonValue to byte.
      java.util.Date toDate()
      Attempts to convert JsonValue to DateTime with standard format and culture.
      java.math.BigDecimal toDecimal()
      Attempts to convert JsonValue to decimal.
      double toDouble()
      Attempts to convert JsonValue to double.
      float toFloat()
      Attempts to convert JsonValue to float.
      short toInt16()
      Attempts to convert JsonValue to short.
      int toInt32()
      Attempts to convert JsonValue to int.
      long toInt64()
      Attempts to convert JsonValue to int 64.
      java.lang.String toString()
      Returns a string representation of the object.
      java.lang.String toStringValue()
      Attempts to convert JsonValue to string.
      • Methods inherited from class java.lang.Object

        getClass, notify, notifyAll, wait, wait, wait
    • Constructor Detail

      • JsonValue

        public JsonValue​(java.lang.Object value)
        Creates an instance of JsonValue with the specified object and type set to JsonDataType.Object.
        Parameters:
        value - The object being used as JsonValue.
      • JsonValue

        public JsonValue​(boolean value)
        Creates an instance of JsonValue of type JsonDataType.Boolean.
        Parameters:
        value - The boolean value to be set as JsonValue.
      • JsonValue

        public JsonValue​(byte value)
        Creates an instance of JsonValue of type JsonDataType.Number.
        Parameters:
        value - The byte value to be set as JsonValue.
      • JsonValue

        public JsonValue​(short value)
        Creates an instance of JsonValue of type JsonDataType.Number.
        Parameters:
        value - The short value to be set as JsonValue.
      • JsonValue

        public JsonValue​(int value)
        Creates an instance of JsonValue of type JsonDataType.Number.
        Parameters:
        value - The int value to be set as JsonValue.
      • JsonValue

        public JsonValue​(long value)
        Creates an instance of JsonValue of type JsonDataType.Number.
        Parameters:
        value - The long value to be set as JsonValue.
      • JsonValue

        public JsonValue​(float value)
        Creates an instance of JsonValue of type JsonDataType.Number.
        Parameters:
        value - The float value to be set as JsonValue.
      • JsonValue

        public JsonValue​(java.math.BigDecimal value)
        Creates an instance of JsonValue of type JsonDataType.Number.
        Parameters:
        value - The BigDecimal value to be set as JsonValue.
      • JsonValue

        public JsonValue​(double value)
        Creates an instance of JsonValue of type JsonDataType.Number.
        Parameters:
        value - The double value to be set as JsonValue.
      • JsonValue

        public JsonValue​(java.util.Date value)
        Creates an instance of JsonValue of type JsonDataType.String.
        Parameters:
        value - The Date value to be set as JsonValue.
      • JsonValue

        public JsonValue​(java.lang.String value)
        Creates an instance of JsonValue of type JsonDataType.String.
        Parameters:
        value - The String value to be set as JsonValue.
    • Method Detail

      • toBoolean

        public boolean toBoolean()
        Attempts to convert JsonValue to boolean.
        Returns:
        Converted boolean value.
      • toByte

        public byte toByte()
        Attempts to convert JsonValue to byte.
        Returns:
        Converted byte value.
      • toInt16

        public short toInt16()
        Attempts to convert JsonValue to short.
        Returns:
        Converted short value.
      • toInt32

        public int toInt32()
        Attempts to convert JsonValue to int.
        Returns:
        Converted int value.
      • toInt64

        public long toInt64()
        Attempts to convert JsonValue to int 64.
        Returns:
        Converted long value.
      • toFloat

        public float toFloat()
        Attempts to convert JsonValue to float.
        Returns:
        Converted float value.
      • toDouble

        public double toDouble()
        Attempts to convert JsonValue to double.
        Returns:
        Converted double value.
      • toDecimal

        public java.math.BigDecimal toDecimal()
        Attempts to convert JsonValue to decimal.
        Returns:
        Converted decimal value.
      • toDate

        public java.util.Date toDate()
                              throws java.text.ParseException
        Attempts to convert JsonValue to DateTime with standard format and culture.
        Returns:
        Converted DateTime value.
        Throws:
        java.text.ParseException
      • toStringValue

        public java.lang.String toStringValue()
        Attempts to convert JsonValue to string.
        Returns:
        Converted string value.
      • equals

        public boolean equals​(java.lang.Object obj)
        Indicates whether some other object is "equal to" this one.

        The equals method implements an equivalence relation on non-null object references:

        • It is reflexive: for any non-null reference value x, x.equals(x) should return true.
        • It is symmetric: for any non-null reference values x and y, x.equals(y) should return true if and only if y.equals(x) returns true.
        • It is transitive: for any non-null reference values x, y, and z, if x.equals(y) returns true and y.equals(z) returns true, then x.equals(z) should return true.
        • It is consistent: for any non-null reference values x and y, multiple invocations of x.equals(y) consistently return true or consistently return false, provided no information used in equals comparisons on the objects is modified.
        • For any non-null reference value x, x.equals(null) should return false.

        The equals method for class Object implements the most discriminating possible equivalence relation on objects; that is, for any non-null reference values x and y, this method returns true if and only if x and y refer to the same object (x == y has the value true).

        Note that it is generally necessary to override the hashCode method whenever this method is overridden, so as to maintain the general contract for the hashCode method, which states that equal objects must have equal hash codes.

        Overrides:
        equals in class java.lang.Object
        Parameters:
        obj - the reference object with which to compare.
        Returns:
        true if this object is the same as the obj argument; false otherwise.
        See Also:
        hashCode(), HashMap
      • toString

        public java.lang.String toString()
        Returns a string representation of the object. In general, the toString method returns a string that "textually represents" this object. The result should be a concise but informative representation that is easy for a person to read. It is recommended that all subclasses override this method.

        The toString method for class Object returns a string consisting of the name of the class of which the object is an instance, the at-sign character `@', and the unsigned hexadecimal representation of the hash code of the object. In other words, this method returns a string equal to the value of:

         getClass().getName() + '@' + Integer.toHexString(hashCode())
         
        Overrides:
        toString in class java.lang.Object
        Returns:
        A string representation of the object.
      • hashCode

        public int hashCode()
        Returns a hash code value for the object. This method is supported for the benefit of hash tables such as those provided by HashMap.

        The general contract of hashCode is:

        • Whenever it is invoked on the same object more than once during an execution of a Java application, the hashCode method must consistently return the same integer, provided no information used in equals comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application.
        • If two objects are equal according to the equals(Object) method, then calling the hashCode method on each of the two objects must produce the same integer result.
        • It is not required that if two objects are unequal according to the Object.equals(java.lang.Object) method, then calling the hashCode method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables.

        As much as is reasonably practical, the hashCode method defined by class Object does return distinct integers for distinct objects. (The hashCode may or may not be implemented as some function of an object's memory address at some point in time.)

        Overrides:
        hashCode in class java.lang.Object
        Returns:
        a hash code value for this object.
        See Also:
        Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)