O CacheControl especifica se um cache de adaptador de repositório deve ser limpo antes de uma operação ser executada e o modo de limpeza do cache.
É possível passar o CacheControl para os métodos get(), search() e update() da interface de programação do aplicativo (API). O adaptador LDAP usa CacheControl para limpar seu cache; os outros adaptadores prontos para uso ignoram o CacheControl por não possuírem cache. Caso esteja usando um adaptador customizado, é possível implementar sua própria manipulação para limpeza de cache usando CacheControl.
O objeto de dados CacheControl consiste no seguinte atributo:
A definição de esquema XML para o objeto de dados CacheControl é mostrada aqui:
<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>
O exemplo a seguir mostra um objeto de dados 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>