JsonWriter Classe

Definição

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

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

Herança

Object

JavaObject

Object

JsonWriter

Atributos

RegisterAttribute

Implementações

IJavaObject IJavaPeerable ICloseable IDisposable

Comentários

Grava um valor codificado em JSON (RFC 4627) em um fluxo, um token por vez. O fluxo inclui valores literais (cadeias de caracteres, números, boolianos e nulos), bem como delimitadores de início e término de objetos e matrizes.

<h3>Codificação JSON</h3> Para codificar seus dados como JSON, crie um novo JsonWriter. Cada documento JSON deve conter uma matriz ou objeto de nível superior. Chame métodos no gravador enquanto você percorre o conteúdo da estrutura, aninhando matrizes e objetos conforme necessário: <ul><li>Para escrever <matrizes> fortes</fortes>, primeira chamada#beginArray(). Escreva cada um dos elementos da matriz com os métodos apropriados #value ou aninhando outras matrizes e objetos. Por fim, feche a matriz usando #endArray(). <li>Para escrever <objetos> fortes</fortes>, primeira chamada#beginObject(). Escreva cada uma das propriedades do objeto alternando chamadas #name com o valor da propriedade. Escreva valores de propriedade com o método apropriado #value ou aninhando outros objetos ou matrizes. Por fim, feche o objeto usando #endObject(). </ul>

<h3>Exemplo</h3> Suponha que gostaríamos de codificar um fluxo de mensagens, como o seguinte:

{@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
                }
              }
            ]}

Esse código codifica a estrutura acima:

{@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 um pode ser usado para gravar um único fluxo JSON. As instâncias dessa classe não são thread-safe. Chamadas que resultariam em uma cadeia de caracteres JSON malformada falharão com um IllegalStateException.

Java documentação para android.util.JsonWriter.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.