Objetos de datos CacheControl

CacheControl especifica si se debe borrar la memoria caché del adaptador de depósito antes de que se lleve a cabo una operación y se aplique la modalidad de borrar la memoria caché.

Puede pasar CacheControl a los métodos get(), search() y update() de la interfaz de programación de aplicaciones (API). El adaptador LDAP utiliza CacheControl para borrar su memoria caché; los demás adaptadores predefinidos pasan por alto CacheControl porque no tienen memoria caché. Si utiliza un adaptador personalizado, puede implementar su propia gestión de borrado de la memoria caché mediante CacheControl.

El objeto de datos CacheControl consta del atributo siguiente:

mode
Especifique la modalidad de borrado de la memoria caché del adaptador de depósito antes de que se especifique una operación.
Los valores válidos son:
  • clearEntity: borre la memoria caché para la entidad especificada. Este valor no tiene ningún efecto en el método search().
  • clearAll: borra toda la información almacenada en la memoria caché del adaptador.
Los valores no son sensibles a las mayúsculas y minúsculas. Este valor no tiene ningún valor predeterminado. Si no especifica un valor o especifica un valor que no sea clearEntity o clearAll, aparece un mensaje de error.
Cómo evitar el problema: El uso frecuente de este parámetro para borrar la memoria caché puede disminuir el rendimiento. Cuando se borra la memoria caché, la operación siguiente tendrá que obtener los detalles del repositorio y actualizar la memoria caché con estos datos recién recuperados. El impacto en el rendimiento es mayor si se utiliza la modalidad clearAll, ya que invalida toda la memoria caché y la operación posterior tarda más en completarse.

Definición de esquema XML

A continuación se muestra la definición de esquema XML para el objeto de datos CacheControl:

<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>

Objetos de datos de ejemplo

En el ejemplo siguiente se muestra un objeto de datos 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>


Condiciones de uso | Comentarios