javax.json

Interface JsonNumber

Table des matières
  • All Superinterfaces:
    JsonValue

    public interface JsonNumber
extends JsonValue
    An immutable JSON number value.

    Implementations may use a BigDecimal object to store the numeric value internally. The BigDecimal object can be constructed from the following types: int, long, BigInteger, double, and String. Some of the method semantics in this class are defined using the BigDecimal semantics.

    Author:
    Jitendra Kotamraju

    • Method Detail

      • isIntegral

        boolean isIntegral()
        Returns true if this JSON number is a integral number. This method semantics are defined using bigDecimalValue().scale(). If the scale is zero, then it is considered integral type. This integral type information can be used to invoke an appropriate accessor method to obtain a numeric value as in the following example: 
         
 JsonNumber num = ...
 if (num.isIntegral()) {
     num.longValue();     // or other methods to get integral value
 } else {
     num.doubleValue();   // or other methods to get decimal number value
 }
        Returns:
        true if this number is a integral number, otherwise false

      • intValue

        int intValue()
        Returns this JSON number as an int. Note that this conversion can lose information about the overall magnitude and precision of the number value as well as return a result with the opposite sign.
        Returns:
        an int representation of the JSON number
        See Also:
        BigDecimal.intValue()

      • intValueExact

        int intValueExact()
        Returns this JSON number as an int.
        Returns:
        an int representation of the JSON number
        Throws:
        ArithmeticException - if the number has a nonzero fractional part or if it does not fit in an int
        See Also:
        BigDecimal.intValueExact()

      • longValue

        long longValue()
        Returns this JSON number as a long. Note that this conversion can lose information about the overall magnitude and precision of the number value as well as return a result with the opposite sign.
        Returns:
        a long representation of the JSON number.
        See Also:
        BigDecimal.longValue()

      • longValueExact

        long longValueExact()
        Returns this JSON number as a long.
        Returns:
        a long representation of the JSON number
        Throws:
        ArithmeticException - if the number has a non-zero fractional part or if it does not fit in a long
        See Also:
        BigDecimal.longValueExact()

      • bigIntegerValue

        BigInteger bigIntegerValue()
        Returns this JSON number as a BigInteger object. This is a a convenience method for bigDecimalValue().toBigInteger(). Note that this conversion can lose information about the overall magnitude and precision of the number value as well as return a result with the opposite sign.
        Returns:
        a BigInteger representation of the JSON number.
        See Also:
        BigDecimal.toBigInteger()

      • doubleValue

        double doubleValue()
        Returns this JSON number as a double. This is a a convenience method for bigDecimalValue().doubleValue(). Note that this conversion can lose information about the overall magnitude and precision of the number value as well as return a result with the opposite sign.
        Returns:
        a double representation of the JSON number
        See Also:
        BigDecimal.doubleValue()

      • bigDecimalValue

        BigDecimal bigDecimalValue()
        Returns this JSON number as a BigDecimal object.
        Returns:
        a BigDecimal representation of the JSON number

      • equals

        boolean equals(Object obj)
        Compares the specified object with this JsonNumber object for equality. Returns true if and only if the type of the specified object is also JsonNumber and their bigDecimalValue() objects are equal
        Overrides:
        equals in class Object
        Parameters:
        obj - the object to be compared for equality with this JsonNumber
        Returns:
        true if the specified object is equal to this JsonNumber

      • hashCode

        int hashCode()
        Returns the hash code value for this JsonNumber object. The hash code of a JsonNumber object is defined as the hash code of its bigDecimalValue() object.
        Overrides:
        hashCode in class Object
        Returns:
        the hash code value for this JsonNumber object

Traduction non disponible

Les API Java ne sont pas encore traduites en français sur l'infobrol. Seule la version anglaise est disponible pour l'instant.

Version en cache

21/08/2025 15:05:09 Cette version de la page est en cache (à la date du 21/08/2025 15:05:09) afin d'accélérer le traitement.
Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la version plus récente de la page.

Document créé le 11/06/2005, dernière modification le 18/08/2025
Source du document imprimé : https://www.gaudry.be/java-api-javaee-rf-javax/json/JsonNumber.html

L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.

Références

  1. Consulter le document html Langue du document :fr Manuel PHP : https://docs.oracle.com, JsonNumber (Java(TM) EE 7 Specification APIs)

Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.