JsonWriter クラス

定義

[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

継承

Object

Object

JsonWriter

属性

RegisterAttribute

実装

IJavaObject IJavaPeerable ICloseable IDisposable

注釈

JSON (RFC 4627) でエンコードされた値を、一度に 1 つのトークンでストリームに書き込みます。 ストリームには、リテラル値 (文字列、数値、ブール値、null) と、オブジェクトと配列の開始区切り記号と終了区切り記号の両方が含まれます。

<h3>Encoding JSON</h3> データを JSON としてエンコードするには、新しい JsonWriterを作成します。 各 JSON ドキュメントには、最上位レベルの配列またはオブジェクトが 1 つ含まれている必要があります。 必要に応じて、構造体の内容を記述するときにライターでメソッドを呼び出し、必要に応じて配列とオブジェクトを入れ子にします。<ul><li><strong>arrays</strong> を記述するには、最初に#beginArray()を呼び出します。 適切な #value メソッドを使用するか、他の配列とオブジェクトを入れ子にして、配列の各要素を書き込みます。 最後に、 #endArray()を使用して配列を閉じます。 <li><strong>objects</strong> を書き込むには、最初に #beginObject() を呼び出します。 プロパティの値を持つ #name の呼び出しを交互に呼び出して、各オブジェクトのプロパティを書き込みます。 適切な #value メソッドを使用するか、他のオブジェクトまたは配列を入れ子にして、プロパティ値を書き込みます。 最後に、 #endObject()を使用してオブジェクトを閉じます。 </ul>

<h3>Example</h3> 次のようなメッセージのストリームをエンコードするとします。

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

このコードは、上記の構造をエンコードします。

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

各 JsonWriter を使用して、1 つの JSON ストリームを書き込む場合があります。 このクラスのインスタンスはスレッド セーフではありません。 形式が正しくない JSON 文字列になる呼び出しは、 IllegalStateExceptionで失敗します。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。