この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。
英語に切り替える

JSON クラス

Apex オブジェクトを JSON 形式で逐次化するメソッドと、このクラスの serialize メソッドを使用して、逐次化された JSON コンテンツを並列化するメソッドがあります。

名前空間

System

使用方法

System.JSON クラスのメソッドを使用して、Apex オブジェクトの JSON の逐次化と並列化の往復処理を実行します。

JSON のメソッド

JSON のメソッドは次のとおりです。すべてのメソッドが静的です。

createGenerator(prettyPrint)

新しい JSON ジェネレータを返します。

署名

public static System.JSONGenerator createGenerator(Boolean prettyPrint)

パラメータ

prettyPrint
型: Boolean
JSON ジェネレータが、JSON コンテンツをインデントされた見栄えのよい印刷形式で作成するかどうかを指定します。インデントされたコンテンツを作成するには、true を設定します。

戻り値

型: System.JSONGenerator

createParser(jsonString)

新しい JSON パーサーを返します。

署名

public static System.JSONParser createParser(String jsonString)

パラメータ

jsonString
型: String
解析する JSON コンテンツです。

戻り値

型: System.JSONParser

deserialize(jsonString, apexType)

指定された JSON 文字列を Apex オブジェクトの指定された型に並列化します。

署名

public static Object deserialize(String jsonString, System.Type apexType)

パラメータ

jsonString
型: String
並列化する JSON コンテンツです。
apexType
型: System.Type
このメソッドが JSON コンテンツの並列化後に作成するオブジェクトの Apex 型です。

戻り値

型: Object

使用方法

JSON コンテンツに、System.Type 引数に存在しない属性 (存在しない項目やオブジェクトなど) が含まれている場合、一定の状況で並列化に失敗します。Salesforce API バージョン 34.0 以前を使用して JSON コンテンツをカスタムオブジェクトまたは sObject に並列化すると、無関係な属性が渡されたときにこのメソッドが実行時例外を発生させます。JSON コンテンツを API の全バージョンの Apex クラスまたは API バージョン 35.0 以降のオブジェクトに並列化したときは、例外が発生しません。例外が発生しない場合、このメソッドは無関係な属性を無視して、残りの JSON コンテンツを解析します。

次の例では、Decimal 値を並列化します。

deserializeStrict(jsonString, apexType)

指定された JSON 文字列を Apex オブジェクトの指定された型に並列化します。

署名

public static Object deserializeStrict(String jsonString, System.Type apexType)

パラメータ

jsonString
型: String
並列化する JSON コンテンツです。
apexType
型: System.Type
このメソッドが JSON コンテンツの並列化後に作成するオブジェクトの Apex 型です。

戻り値

型: Object

使用方法

JSON 文字列内のすべての属性は、指定された型に存在する必要があります。JSON コンテンツに、System.Type 引数に存在しない属性 (存在しない項目やオブジェクトなど) が含まれている場合、一定の状況で並列化に失敗します。無関係な属性のある JSON コンテンツを Apex クラスに並列化すると、API のどのバージョンでもこのメソッドが例外を発生させます。ただし、このメソッドを使用して JSON コンテンツをカスタムオブジェクトまたは sObject に並列化する場合は、例外が発生しません。

次の例は、JSON 文字列を Car クラスで表されるユーザ定義型のオブジェクト (この例で定義) に並列化します。

deserializeUntyped(jsonString)

指定された JSON 文字列をプリミティブデータ型のコレクションに並列化します。

署名

public static Object deserializeUntyped(String jsonString)

パラメータ

jsonString
型: String
並列化する JSON コンテンツです。

戻り値

型: Object

次の例では、アプライアンスオブジェクトの JSON 表現を、プリミティブデータ型が含まれるマップと、さらにプリミティブ型のコレクショ��に並列化します。その後、並列化された値を検証します。

serialize(objectToSerialize)

Apex オブジェクトを JSON コンテンツに逐次化します。

署名

public static String serialize(Object objectToSerialize)

パラメータ

objectToSerialize
型: Object
逐次化する Apex オブジェクトです。

戻り値

型: String

次の例では、新しい Datetime 値を逐次化します。

serialize(objectToSerialize, suppressApexObjectNulls)

Apex オブジェクトを JSON コンテンツに逐次化するときに null 値を抑制します。

署名

public static String serialize(Object objectToSerialize, Boolean suppressApexObjectNulls)

パラメータ

objectToSerialize
型: Object
逐次化する Apex オブジェクトです。
suppressApexObjectNulls
型: Boolean
true の場合、JSON オブジェクトを逐次化する前に null 値を削除します。

戻り値

型: String

使用方法

このメソッドを使用して、Apex オブジェクトを JSON コンテンツに逐次化するときに null 値を抑制するかどうかを指定できます。

serializePretty(objectToSerialize)

Apex オブジェクトを JSON コンテンツに逐次化し、見栄えのよい印刷形式を使用してインデントされたコンテンツを生成します。

署名

public static String serializePretty(Object objectToSerialize)

パラメータ

objectToSerialize
型: Object
逐次化する Apex オブジェクトです。

戻り値

型: String

serializePretty(objectToSerialize, suppressApexObjectNulls)

Apex オブジェクトを JSON コンテンツに逐次化するときに null 値を抑制し、見栄えのよい印刷形式を使用してインデントされたコンテンツを生成します。

署名

public static String serializePretty(Object objectToSerialize, Boolean suppressApexObjectNulls)

パラメータ

objectToSerialize
型: Object
逐次化する Apex オブジェクトです。
suppressApexObjectNulls
型: Boolean
true の場合、JSON オブジェクトを逐次化する前に null 値を削除します。

戻り値

型: String