Apex 開発者ガイド
jNewer Version Available
ConnectApi バージョニングと同等性チェック
ConnectApi クラスのバージョニングは、他の Apex クラスとは異なる特定のルールに従います。
ConnectApi クラスのバージョニングは次のルールに従います。
- ConnectApi メソッドコールは、そのメソッドコールが含まれるクラスのバージョンのコンテキスト内で実行されます。バージョンの使用は、Chatter REST API URL の /vXX.X セクションと似ています。
- 各 ConnectApi 出力オブジェクトは getBuildVersion メソッドを公開します。このメソッドは、出力オブジェクトを作成したメソッドが呼び出されたバージョンを返します。
- 入力オブジェクトを操作するとき、Apex でアクセスできるのは、それを囲む Apex クラスのバージョンでサポートされるプロパティのみです。
- ConnectApi メソッドに渡される入力オブジェクトには、そのメソッドを実行する Apex クラスのバージョンでサポートされる、null 以外のプロパティのみが含まれる場合があります。入力オブジェクトにバージョン不適合のプロパティが含まれていると、例外が発生します。
- toString メソッドの出力は、オブジェクトを操作するコードのバージョンでサポートされているプロパティのみを返します。出力オブジェクトの場合、返されるプロパティもビルドのバージョンでサポートされている必要があります。
- Apex REST、JSON.serialize、および @RemoteAction の逐次化には、バージョンに適合するプロパティのみが含まれます。
- Apex REST、JSON.deserialize、および @RemoteAction の並列化は、バージョン不適合のプロパティを拒否します。
- 列挙はバージョン対応していません。列挙値は、すべての API バージョンで返されます。クライアントは理解しない値を適切に処理する必要があります。
ConnectApi クラスの同等性チェックは次のルールに従います。
- 入力オブジェクト — プロパティが比較されます。
- 出力オブジェクト — プロパティとビルドのバージョンが比較されます。たとえば、2 つのオブジェクトの同じプロパティが同じ値で、ビルドのバージョンが異なる場合、オブジェクトは同等ではありません。ビルドのバージョンを取得するには、getBuildVersion をコールします。