JsonWriter Klasse

Referenz

Definition

Namespace:: Android.Util

Assembly:: Mono.Android.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Schreibt einen JSON-codierten Wert (RFC 4627) nacheinander in einen Stream.

[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-codierten Wert (RFC 4627) nacheinander in einen Stream. Der Stream enthält sowohl Literalwerte (Zeichenfolgen, Zahlen, Boolesche Und NULL-Werte) als auch die Anfangs- und Endtrennzeichen von Objekten und Arrays.

<h3-Codierung>von JSON</h3> Um Ihre Daten als JSON zu codieren, erstellen Sie eine neue 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, und schachteln Sie Arrays und Objekte nach Bedarf: <ul<>li>Rufen Sie zuerst #beginArray()auf, um starke>Arrays</strong> zu schreiben<. Schreiben Sie jedes Arrayelement mit den entsprechenden #value Methoden oder durch Verschachteln anderer Arrays und Objekte. Schließen Sie schließlich das Array mit #endArray(). <li>Um starke>Objekte</strong> zu schreiben<, rufen Sie zuerst auf#beginObject(). Schreiben Sie alle Eigenschaften des Objekts, indem Sie abwechselnd aufruft #name mit dem Wert der Eigenschaft. Schreiben Von Eigenschaftswerten mit der entsprechenden #value Methode oder durch Verschachteln anderer Objekte oder Arrays. Schließen Sie schließlich das -Objekt mithilfe von #endObject(). </ul>

<h3>Beispiel</h3> Angenommen, wir möchten einen Nachrichtenstrom wie die 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 obige 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 verwendet werden, um einen einzelnen JSON-Stream zu schreiben. Instanzen dieser Klasse sind nicht threadsicher. Aufrufe, die zu einer falsch formatierten JSON-Zeichenfolge führen, schlagen mit einem fehl IllegalStateException.

Java-Dokumentation für android.util.JsonWriter.

Teile dieser Seite sind Änderungen, die auf Arbeiten basieren, die vom Android Open Source Project erstellt und freigegeben wurden und gemäß den In Attribution License beschriebenen Begriffen verwendet werden.

Konstruktoren

JsonWriter(Writer)

Erstellt eine neue instance, die einen JSON-codierten Stream in schreibtout.

Eigenschaften

Class	Gibt die Laufzeitklasse dieses `Object`zurück. (Geerbt von Object)
Handle	Das Handle für die zugrunde liegende Android-instance. (Geerbt von Object)
JniIdentityHashCode	Schreibt einen JSON-codierten Wert (RFC 4627) nacheinander in einen Stream. (Geerbt von Object)
JniPeerMembers	Schreibt einen JSON-codierten Wert (RFC 4627) nacheinander in einen Stream.
Lenient	Gibt true zurück, wenn dieser Writer über gelockerte Syntaxregeln verfügt. Oder: Konfigurieren Sie diesen Writer, um seine Syntaxregeln zu lockern.
PeerReference	Schreibt einen JSON-codierten Wert (RFC 4627) nacheinander in einen Stream. (Geerbt von Object)
ThresholdClass	Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen. (Geerbt von Object)
ThresholdType	Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen. (Geerbt von Object)

Methoden

BeginArray()	Beginnt mit der Codierung eines neuen Arrays.
BeginArrayAsync()	Schreibt einen JSON-codierten Wert (RFC 4627) nacheinander in einen Stream.
BeginObject()	Beginnt mit der Codierung eines neuen Objekts.
BeginObjectAsync()	Schreibt einen JSON-codierten Wert (RFC 4627) nacheinander in einen Stream.
Clone()	Erstellt und gibt eine Kopie dieses Objekts zurück. (Geerbt von Object)
Close()	Leert und schließt diesen Writer und die zugrunde liegende `Writer`.
Dispose()	Schreibt einen JSON-codierten Wert (RFC 4627) nacheinander in einen Stream. (Geerbt von Object)
Dispose(Boolean)	Schreibt einen JSON-codierten Wert (RFC 4627) nacheinander in einen Stream. (Geerbt von Object)
EndArray()	Beendet die Codierung des aktuellen Arrays.
EndArrayAsync()	Schreibt einen JSON-codierten Wert (RFC 4627) nacheinander in einen Stream.
EndObject()	Beendet die Codierung des aktuellen Objekts.
EndObjectAsync()	Schreibt einen JSON-codierten Wert (RFC 4627) nacheinander in einen Stream.
Equals(Object)	Gibt an, ob ein anderes Objekt "gleich" diesem objekt ist. (Geerbt von Object)
Flush()	Stellt sicher, dass alle gepufferten Daten in den zugrunde liegenden `Writer` geschrieben werden und dieser Writer geleert wird.
FlushAsync()	Schreibt einen JSON-codierten Wert (RFC 4627) nacheinander in einen Stream.
GetHashCode()	Gibt einen Hashcodewert für das Objekt zurück. (Geerbt von Object)
JavaFinalize()	Wird vom Garbage Collector für ein Objekt aufgerufen, wenn die Garbage Collection feststellt, dass keine Verweise mehr auf das Objekt vorhanden sind. (Geerbt von Object)
Name(String)	Codiert den Eigenschaftennamen.
NameAsync(String)	Schreibt einen JSON-codierten Wert (RFC 4627) nacheinander in einen Stream.
Notify()	Aktiviert einen einzelnen Thread, der auf den Monitor dieses Objekts wartet. (Geerbt von Object)
NotifyAll()	Aktiviert alle Threads, die auf den Monitor dieses Objekts warten. (Geerbt von Object)
NullValue()	Codiert `null`.
NullValueAsync()	Schreibt einen JSON-codierten Wert (RFC 4627) nacheinander in einen Stream.
SetHandle(IntPtr, JniHandleOwnership)	Legt die Handle-Eigenschaft fest. (Geerbt von Object)
SetIndent(String)	Legt die Einzugszeichenfolge fest, die für jede Ebene des Einzugs im codierten Dokument wiederholt werden soll.
ToArray<T>()	Schreibt einen JSON-codierten Wert (RFC 4627) nacheinander in einen Stream. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolgendarstellung des Objekts zurück. (Geerbt von Object)
UnregisterFromRuntime()	Schreibt einen JSON-codierten Wert (RFC 4627) nacheinander in einen Stream. (Geerbt von Object)
Value(Boolean)	Codiert `value`.
Value(Double)	Codiert `value`.
Value(Int64)	Codiert `value`.
Value(Number)	Codiert `value`.
Value(String)	Codiert `value`.
ValueAsync(Boolean)	Schreibt einen JSON-codierten Wert (RFC 4627) nacheinander in einen Stream.
ValueAsync(Double)	Schreibt einen JSON-codierten Wert (RFC 4627) nacheinander in einen Stream.
ValueAsync(Int64)	Schreibt einen JSON-codierten Wert (RFC 4627) nacheinander in einen Stream.
ValueAsync(Number)	Schreibt einen JSON-codierten Wert (RFC 4627) nacheinander in einen Stream.
ValueAsync(String)	Schreibt einen JSON-codierten Wert (RFC 4627) nacheinander in einen Stream.
Wait()	Bewirkt, dass der aktuelle Thread wartet, bis er aktiviert ist, in der Regel durch <>Benachrichtigung</em> oder <em>interrupted</em>. (Geerbt von Object)
Wait(Int64)	Bewirkt, dass der aktuelle Thread wartet, bis er aktiviert ist, in der Regel durch>< Benachrichtigung</em> oder <em>interrupted</em>, oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object)
Wait(Int64, Int32)	Bewirkt, dass der aktuelle Thread wartet, bis er aktiviert ist, in der Regel durch>< Benachrichtigung</em> oder <em>interrupted</em>, oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

IJavaPeerable.Disposed()	Schreibt einen JSON-codierten Wert (RFC 4627) nacheinander in einen Stream. (Geerbt von Object)
IJavaPeerable.DisposeUnlessReferenced()	Schreibt einen JSON-codierten Wert (RFC 4627) nacheinander in einen Stream. (Geerbt von Object)
IJavaPeerable.Finalized()	Schreibt einen JSON-codierten Wert (RFC 4627) nacheinander in einen Stream. (Geerbt von Object)
IJavaPeerable.JniManagedPeerState	Schreibt einen JSON-codierten Wert (RFC 4627) nacheinander in einen Stream. (Geerbt von Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Schreibt einen JSON-codierten Wert (RFC 4627) nacheinander in einen Stream. (Geerbt von Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Schreibt einen JSON-codierten Wert (RFC 4627) nacheinander in einen Stream. (Geerbt von Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Schreibt einen JSON-codierten Wert (RFC 4627) nacheinander in einen Stream. (Geerbt von Object)

Erweiterungsmethoden

JavaCast<TResult>(IJavaObject)	Führt eine Typkonvertierung mit Überprüfung der Android-Laufzeit aus.
JavaCast<TResult>(IJavaObject)	Schreibt einen JSON-codierten Wert (RFC 4627) nacheinander in einen Stream.
GetJniTypeName(IJavaPeerable)	Schreibt einen JSON-codierten Wert (RFC 4627) nacheinander in einen Stream.

Gilt für: