CacheControl は、操作を実行する前にリポジトリー・アダプターのキャッシュをクリアするかどうか、 およびキャッシュをクリアするモードを指定します。
CacheControl は、アプリケーション・プログラミング・インターフェース (API) の get()、search()、update() の各メソッドに渡すことができます。 LDAP アダプターは、CacheControl を使用してそのキャッシュをクリアします。 その他のすぐに使用可能なアダプターは、キャッシュを持たないため CacheControl を無視します。 カスタム・アダプターを使用すると、CacheControl を使用して、キャッシュをクリアするための独自の処理を実装することができます。
CacheControl データ・オブジェクトは、以下の属性で構成されています。
次に、CacheControl データ・オブジェクトの XML スキーマ定義を示します。
<xsd:complexType name="CacheControl">
<xsd:complexContent>
<xsd:extension base="Control">
<xsd:sequence>
<xsd:element name="mode" type="xsd:string" />
</xsd:sequence>
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
以下の例は、CacheControl データ・オブジェクトを示しています。
<wim:Root>
<wim:entities xsi:type="wim:PersonAccount">
<wim:identifier uniqueName="cn=testUser1,dc=yourco,dc=com"/>
</wim:entities>
<wim:controls xsi:type="wim:CacheControl">
<wim:mode>clearEntity</wim:mode>
</wim:controls>
<wim:controls xsi:type="wim:PropertyControl">
<wim:properties>sn</wim:properties>
</wim:controls>
</wim:Root>