public interface JsonWriter extends CloseableSE
object
または array
構造を出力ソースに書き込みます。 クラス Json
には、出力ソース(OutputStream
SE および Writer
SE)からライターを作成するためのメソッドが含まれています。
次の例は、空の JSON オブジェクトを書き込む方法を示しています。
JsonWriter jsonWriter = Json.createWriter(...);
jsonWriter.writeObject(Json.createObjectBuilder().build());
jsonWriter.close();
クラス JsonWriterFactory
には、JsonWriter
インスタンスを作成するためのメソッドも含まれています。ファクトリインスタンスを使用して、同じ構成で複数のライターインスタンスを作成できます。これは、複数のインスタンスを作成するための推奨する方法です。次の例に使用例を示します。
JsonWriterFactory factory = Json.createWriterFactory(config);
JsonWriter writer1 = factory.createWriter(...);
JsonWriter writer2 = factory.createWriter(...);
修飾子と型 | メソッドと説明 |
---|---|
void | close() |
void | write(JsonStructure value) |
default void | write(JsonValue value) 指定された JsonValue を出力ソースに書き込みます。 |
void | writeArray(JsonArray array) 指定した JSON array を出力ソースに書き込みます。 |
void | writeObject(JsonObject object) 指定した JSON object を出力ソースに書き込みます。 |
void writeArray(JsonArray array)
array
を出力ソースに書き込みます。このメソッドは、ライターインスタンスに対して 1 回だけ呼び出す必要があります。array
- 出力ソースに書き込まれる JSON 配列 JsonException
- I/O エラーのために指定された JSON オブジェクトを書き込めない場合 (IOException は JsonException の原因となる)IllegalStateExceptionSE
- writeArray、writeObject、write、close メソッドがすでに呼び出されている場合 void writeObject(JsonObject object)
object
を出力ソースに書き込みます。このメソッドは、ライターインスタンスに対して 1 回だけ呼び出す必要があります。object
- 出力ソースに書き込まれる JSON オブジェクト JsonException
- I/O エラーのために指定された JSON オブジェクトを書き込めない場合 (IOException は JsonException の原因となる)IllegalStateExceptionSE
- writeArray、writeObject、write、close メソッドがすでに呼び出されている場合 void write(JsonStructure value)
value
- 出力ソースに書き込まれる JSON 配列またはオブジェクト JsonException
- I/O エラーのために指定された JSON オブジェクトを書き込めない場合 (IOException は JsonException の原因となる)IllegalStateExceptionSE
- writeArray、writeObject、write、close メソッドがすでに呼び出されている場合 default void write(JsonValue value)
JsonValue
を出力ソースに書き込みます。メソッドは、書き込みインスタンスに対して 1 回だけ呼び出す必要があります。value
- 出力ソースに書き込まれる JsonValue
JsonException
- I/O エラーのために指定された JSON オブジェクトを書き込めない場合 (IOException は JsonException の原因となる)IllegalStateExceptionSE
- writeArray、writeObject、write、close メソッドがすでに呼び出されている場合 void close()
AutoCloseableSE
の closeSE
CloseableSE
の closeSE
Copyright © 2019 Eclipse Foundation.
Use is subject to license terms.