JsonWriter Clase

Definición

[Android.Runtime.Register("android/util/JsonWriter", DoNotGenerateAcw=true)]
public sealed class JsonWriter : Java.Lang.Object, IDisposable, Java.Interop.IJavaPeerable, Java.IO.ICloseable

[<Android.Runtime.Register("android/util/JsonWriter", DoNotGenerateAcw=true)>]
type JsonWriter = class
    inherit Object
    interface ICloseable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Herencia

Object

Object

JsonWriter

Atributos

RegisterAttribute

Implementaciones

IJavaObject IJavaPeerable ICloseable IDisposable

Comentarios

Escribe un valor codificado en JSON (RFC 4627) en una secuencia, un token cada vez. La secuencia incluye valores literales (cadenas, números, valores booleanos y null), así como los delimitadores iniciales y finales de objetos y matrices.

<h3>Codificación JSON</h3> Para codificar los datos como JSON, cree un nuevo JsonWriter. Cada documento JSON debe contener una matriz o objeto de nivel superior. Llame a métodos en el sistema de escritura mientras recorre el contenido de la estructura, anidar matrices y objetos según sea necesario: ul>li Para escribir <matrices< fuertes>o fuertes>, llame primero a #beginArray().><< Escriba cada uno de los elementos de la matriz con los métodos adecuados #value o anidando otras matrices y objetos. Por último, cierre la matriz mediante #endArray(). <li>Para escribir <objetos seguros>o< fuertes>, llame primero a #beginObject(). Escriba cada una de las propiedades del objeto alternando llamadas a #name con el valor de la propiedad. Escriba valores de propiedad con el método adecuado #value o anidando otros objetos o matrices. Por último, cierre el objeto mediante #endObject(). </ul>

<h3>Ejemplo</h3> Supongamos que nos gustaría codificar una secuencia de mensajes como los siguientes:

{@code
            [
              {
                "id": 912345678901,
                "text": "How do I write JSON on Android?",
                "geo": null,
                "user": {
                  "name": "android_newb",
                  "followers_count": 41
                 }
              },
              {
                "id": 912345678902,
                "text": "@android_newb just use android.util.JsonWriter!",
                "geo": [50.454722, -104.606667],
                "user": {
                  "name": "jesse",
                  "followers_count": 2
                }
              }
            ]}

Este código codifica la estructura anterior:

{@code
              public void writeJsonStream(OutputStream out, List<Message> messages) throws IOException {
                JsonWriter writer = new JsonWriter(new OutputStreamWriter(out, "UTF-8"));
                writer.setIndent("  ");
                writeMessagesArray(writer, messages);
                writer.close();
              }

              public void writeMessagesArray(JsonWriter writer, List<Message> messages) throws IOException {
                writer.beginArray();
                for (Message message : messages) {
                  writeMessage(writer, message);
                }
                writer.endArray();
              }

              public void writeMessage(JsonWriter writer, Message message) throws IOException {
                writer.beginObject();
                writer.name("id").value(message.getId());
                writer.name("text").value(message.getText());
                if (message.getGeo() != null) {
                  writer.name("geo");
                  writeDoublesArray(writer, message.getGeo());
                } else {
                  writer.name("geo").nullValue();
                }
                writer.name("user");
                writeUser(writer, message.getUser());
                writer.endObject();
              }

              public void writeUser(JsonWriter writer, User user) throws IOException {
                writer.beginObject();
                writer.name("name").value(user.getName());
                writer.name("followers_count").value(user.getFollowersCount());
                writer.endObject();
              }

              public void writeDoublesArray(JsonWriter writer, List<Double> doubles) throws IOException {
                writer.beginArray();
                for (Double value : doubles) {
                  writer.value(value);
                }
                writer.endArray();
              }}

Cada JsonWriter uno se puede usar para escribir una sola secuencia JSON. Las instancias de esta clase no son seguras para subprocesos. Las llamadas que generarían un error en una cadena JSON con formato incorrecto producirán un error IllegalStateException.

Java documentación para android.util.JsonWriter.

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.