All Downloads are FREE. Search and download functionalities are using the official Maven repository.

keycloakjar.com.google.gson.ToNumberStrategy Maven / Gradle / Ivy

There is a newer version: 7.22.0
Show newest version
/*
 * Copyright (C) 2021 Google Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package com.google.gson;

import java.io.IOException;

import com.google.gson.stream.JsonReader;

/**
 * A strategy that is used to control how numbers should be deserialized for {@link Object} and {@link Number}
 * when a concrete type of the deserialized number is unknown in advance. By default, Gson uses the following
 * deserialization strategies:
 *
 * 
    *
  • {@link Double} values are returned for JSON numbers if the deserialization type is declared as * {@code Object}, see {@link ToNumberPolicy#DOUBLE};
  • *
  • Lazily parsed number values are returned if the deserialization type is declared as {@code Number}, * see {@link ToNumberPolicy#LAZILY_PARSED_NUMBER}.
  • *
* *

For historical reasons, Gson does not support deserialization of arbitrary-length numbers for * {@code Object} and {@code Number} by default, potentially causing precision loss. However, * RFC 8259 permits this: * *

 *   This specification allows implementations to set limits on the range
 *   and precision of numbers accepted.  Since software that implements
 *   IEEE 754 binary64 (double precision) numbers [IEEE754] is generally
 *   available and widely used, good interoperability can be achieved by
 *   implementations that expect no more precision or range than these
 *   provide, in the sense that implementations will approximate JSON
 *   numbers within the expected precision.  A JSON number such as 1E400
 *   or 3.141592653589793238462643383279 may indicate potential
 *   interoperability problems, since it suggests that the software that
 *   created it expects receiving software to have greater capabilities
 *   for numeric magnitude and precision than is widely available.
 * 
* *

To overcome the precision loss, use for example {@link ToNumberPolicy#LONG_OR_DOUBLE} or * {@link ToNumberPolicy#BIG_DECIMAL}.

* * @see ToNumberPolicy * @see GsonBuilder#setObjectToNumberStrategy(ToNumberStrategy) * @see GsonBuilder#setNumberToNumberStrategy(ToNumberStrategy) */ public interface ToNumberStrategy { /** * Reads a number from the given JSON reader. A strategy is supposed to read a single value from the * reader, and the read value is guaranteed never to be {@code null}. * * @param in JSON reader to read a number from * @return number read from the JSON reader. */ public Number readNumber(JsonReader in) throws IOException; }




© 2015 - 2024 Weber Informatics LLC | Privacy Policy