Class JsonPrimitive

java.lang.Object
com.google.gson.JsonElement
com.google.gson.JsonPrimitive

public final class JsonPrimitive extends JsonElement
A class representing a Json primitive value. A primitive value is either a String, a Java primitive, or a Java primitive wrapper type.
Author:
Inderjeet Singh, Joel Leitch
  • Constructor Details

    • JsonPrimitive

      public JsonPrimitive(Boolean bool)
      Create a primitive containing a boolean value.
      Parameters:
      bool - the value to create the primitive with.
    • JsonPrimitive

      public JsonPrimitive(Number number)
      Create a primitive containing a Number.
      Parameters:
      number - the value to create the primitive with.
    • JsonPrimitive

      public JsonPrimitive(String string)
      Create a primitive containing a String value.
      Parameters:
      string - the value to create the primitive with.
    • JsonPrimitive

      public JsonPrimitive(Character c)
      Create a primitive containing a character. The character is turned into a one character String since Json only supports String.
      Parameters:
      c - the value to create the primitive with.
  • Method Details

    • deepCopy

      public JsonPrimitive deepCopy()
      Returns the same value as primitives are immutable.
      Specified by:
      deepCopy in class JsonElement
      Since:
      2.8.2
    • isBoolean

      public boolean isBoolean()
      Check whether this primitive contains a boolean value.
      Returns:
      true if this primitive contains a boolean value, false otherwise.
    • getAsBoolean

      public boolean getAsBoolean()
      convenience method to get this element as a boolean value.
      Overrides:
      getAsBoolean in class JsonElement
      Returns:
      get this element as a primitive boolean value.
    • isNumber

      public boolean isNumber()
      Check whether this primitive contains a Number.
      Returns:
      true if this primitive contains a Number, false otherwise.
    • getAsNumber

      public Number getAsNumber()
      convenience method to get this element as a Number.
      Overrides:
      getAsNumber in class JsonElement
      Returns:
      get this element as a Number.
      Throws:
      NumberFormatException - if the value contained is not a valid Number.
    • isString

      public boolean isString()
      Check whether this primitive contains a String value.
      Returns:
      true if this primitive contains a String value, false otherwise.
    • getAsString

      public String getAsString()
      convenience method to get this element as a String.
      Overrides:
      getAsString in class JsonElement
      Returns:
      get this element as a String.
    • getAsDouble

      public double getAsDouble()
      convenience method to get this element as a primitive double.
      Overrides:
      getAsDouble in class JsonElement
      Returns:
      get this element as a primitive double.
      Throws:
      NumberFormatException - if the value contained is not a valid double.
    • getAsBigDecimal

      public BigDecimal getAsBigDecimal()
      convenience method to get this element as a BigDecimal.
      Overrides:
      getAsBigDecimal in class JsonElement
      Returns:
      get this element as a BigDecimal.
      Throws:
      NumberFormatException - if the value contained is not a valid BigDecimal.
    • getAsBigInteger

      public BigInteger getAsBigInteger()
      convenience method to get this element as a BigInteger.
      Overrides:
      getAsBigInteger in class JsonElement
      Returns:
      get this element as a BigInteger.
      Throws:
      NumberFormatException - if the value contained is not a valid BigInteger.
    • getAsFloat

      public float getAsFloat()
      convenience method to get this element as a float.
      Overrides:
      getAsFloat in class JsonElement
      Returns:
      get this element as a float.
      Throws:
      NumberFormatException - if the value contained is not a valid float.
    • getAsLong

      public long getAsLong()
      convenience method to get this element as a primitive long.
      Overrides:
      getAsLong in class JsonElement
      Returns:
      get this element as a primitive long.
      Throws:
      NumberFormatException - if the value contained is not a valid long.
    • getAsShort

      public short getAsShort()
      convenience method to get this element as a primitive short.
      Overrides:
      getAsShort in class JsonElement
      Returns:
      get this element as a primitive short.
      Throws:
      NumberFormatException - if the value contained is not a valid short value.
    • getAsInt

      public int getAsInt()
      convenience method to get this element as a primitive integer.
      Overrides:
      getAsInt in class JsonElement
      Returns:
      get this element as a primitive integer.
      Throws:
      NumberFormatException - if the value contained is not a valid integer.
    • getAsByte

      public byte getAsByte()
      Description copied from class: JsonElement
      convenience method to get this element as a primitive byte value.
      Overrides:
      getAsByte in class JsonElement
      Returns:
      get this element as a primitive byte value.
    • getAsCharacter

      public char getAsCharacter()
      Description copied from class: JsonElement
      convenience method to get the first character of this element as a string or the first character of this array's first element as a string.
      Overrides:
      getAsCharacter in class JsonElement
      Returns:
      the first character of the string.
    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Object
    • equals

      public boolean equals(Object obj)
      Overrides:
      equals in class Object