GSON JsonElement.getAsString vs JsonElement.toString?

Suppose que vous faites allusion à JsonElement:

getAsString()

méthode pratique pour obtenir cet élément comme une chaîne de valeur.

Cette méthode accède et renvoie une propriété de l'élément, c'est à dire la valeur de l'élément en tant que java String objet.

toString()

Retourne une Chaîne de caractères de la représentation de cet élément.

Cette méthode est la "norme" java toString méthode, c'est à dire renvoie une lisible par l'homme de la représentation de l'élément lui-même.

Pour une meilleure compréhension, laissez-moi vous donner un exemple:

import com.google.gson.JsonElement;
import com.google.gson.JsonObject;
import com.google.gson.JsonPrimitive;

public class GsonTest {

    public static void main(String[] args) {
        JsonElement jsonElement = new JsonPrimitive("foo");

        System.out.println(jsonElement.toString());
        System.out.println(jsonElement.getAsString());

        jsonElement = new JsonPrimitive(42);

        System.out.println(jsonElement.toString());
        System.out.println(jsonElement.getAsString());

        jsonElement = new JsonPrimitive(true);

        System.out.println(jsonElement.toString());
        System.out.println(jsonElement.getAsString());

        jsonElement = new JsonObject();
        ((JsonObject) jsonElement).addProperty("foo", "bar");
        ((JsonObject) jsonElement).addProperty("foo2", 42);

        System.out.println(jsonElement.toString());
        System.out.println(jsonElement.getAsString());
    }
}

De sortie:

"foo"
foo
42
42
true
true
{"foo":"bar","foo2":42}
Exception in thread "main" java.lang.UnsupportedOperationException: JsonObject
    at com.google.gson.JsonElement.getAsString(JsonElement.java:185)

Comme vous pouvez le voir, la sortie est, dans certains cas, tout à fait semblable (ou même égal à égal), mais il diffère dans certains autres cas. getAsString() est définie uniquement pour les types primitifs (et des tableaux contenant qu'un seul élément primitif) et lève une exception si elle est appelée par exemple sur un objet. toString() fonctionne sur tous les types de JsonElement.

Maintenant quand devez-vous utiliser la méthode?

• Si vous voulez imprimer les informations de débogage, utilisez toString()
• Si vous savez que vous avez affaire à un type primitif et que vous souhaitez afficher ou écrire la valeur de quelque part, de l'utilisation getAsString()
• Si vous ne connaissez pas le type ou si vous voulez travail avec la valeur (c'est à dire faire les calculs), ne pas utiliser. Au lieu de vérifier le type de l'élément et utilisez la méthode appropriée.