JsonWriter Klasse

Definition

[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

Vererbung

Object

Object

JsonWriter

Attribute

RegisterAttribute

Implementiert

IJavaObject IJavaPeerable ICloseable IDisposable

Hinweise

Schreibt einen JSON(RFC 4627)-codierten Wert in einen Datenstrom, jeweils ein Token. Der Datenstrom enthält sowohl Literalwerte (Zeichenfolgen, Zahlen, Booleans und Nullen) als auch die Anfangs- und Endtrennzeichen von Objekten und Arrays.

<h3>Encoding JSON</h3> To encode your data as JSON, create a new JsonWriter. Jedes JSON-Dokument muss ein Array oder Objekt der obersten Ebene enthalten. Rufen Sie Methoden für den Writer auf, während Sie den Inhalt der Struktur durchlaufen, Arrays und Objekte nach Bedarf verschachteln: <ul<>li>To write <strong>arrays</strong>, first call #beginArray(). Schreiben Sie die einzelnen Elemente des Arrays mit den entsprechenden #value Methoden oder durch Schachteln anderer Arrays und Objekte. Schließen Sie schließlich das Array mithilfe von #endArray(). <li>To write <strong>objects</strong>, first call #beginObject(). Schreiben Sie die eigenschaften jedes Objekts durch abwechselnde Aufrufe #name mit dem Wert der Eigenschaft. Schreiben Sie Eigenschaftswerte mit der entsprechenden #value Methode oder durch Schachteln anderer Objekte oder Arrays. Schließen Sie schließlich das Objekt mithilfe von #endObject(). </ul>

<h3>Example</h3> Angenommen, wir möchten einen Datenstrom von Nachrichten wie den folgenden codieren:

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

Dieser Code codiert die oben genannte Struktur:

{@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();
              }}

Jeder JsonWriter kann zum Schreiben eines einzelnen JSON-Datenstroms verwendet werden. Instanzen dieser Klasse sind nicht threadsicher. Aufrufe, die zu einer falsch formatierten JSON-Zeichenfolge führen würden, schlagen mit einer IllegalStateException.

Java Dokumentation für android.util.JsonWriter.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.