Una regla de correspondencia espec�fica c�mo deben corresponderse los valores de los atributos para las operaciones de comparaci�n, ordenaci�n y substring. Dos ejemplos de reglas de correspondencia son la regla de ordenaci�n de correspondencia exacta de may�sculas y min�sculas para strings basados en el idioma Ingl�s y la correspondencia de igualdad sin importar las may�sculas para el Directory String.
En el �rbol de esquema, el nombre "MatchingRule" est� unido a un contexto plano que contiene objetos DirContext que representan definiciones de reglas de correspondencia en el esquema. Por ejemplo, si un directorio soporta la regla de igualdad "caseExactMatch", entonces el contexto "MatchingRule" tendr� una uni�n con el nombre "caseExactMatch" que est� unida a un objeto DirContext. Cada objeto del contexto "MatchingRule" tiene los atributos obligatorios y opcionales mostrados en la siguiente tabla:
|
Nota:
Muchos servidores no publican sus reglas de correspondencia. Incluso entre aquellos que lo hacen, algunos podr�an no publicar "todas" sus reglas. |
| Identificador de Atributo | Descripci�n del Valor del Atributo |
|---|---|
| NUMERICOID (obligatorio) | Identificador de Objeto �nico (OID) |
| NAME | Nombre de la regla de correspondencia |
| DESC | Descripci�n de la regla de correspondencia |
| SYNTAX | OID num�rico de la s�ntaxis a la que se aplica esta regla. |
| OBSOLETE | "true" si est� obsoleto; "false" o ausente si no lo est�. |
Estos atributos corresponden con la definici�n de "MatchingRuleDescription" de la RFC 2252. Todos los valores de atributos est�n representados por la clase java.lang.String.
�Recuperar el Esquema de una Definici�n de Regla de Correspondencia
Para recuperar el objeto esquema de una regla de correspondencia, la buscamos en el �rbol de esquema. Por ejemplo, podemos obtener el objeto esquema que representa la regla "caseExactOrderingMatch-en" usando el siguiente c�digo:
// Get the schema tree root
DirContext schema = ctx.getSchema("");
// Get the schema object for the matching rule
DirContext mrSchema =
(DirContext)schema.lookup("MatchingRule/caseExactOrderingMatch-en");
Si obtenemos los atributos del objeto esquemamrSchema, veremos lo siguiente:
SYNTAX: 1.3.6.1.4.1.1466.115.121.1.15 NAME: caseExactOrderingMatch-en NUMERICOID: 2.16.840.1.113730.3.3.2.11.3 DESC: en
|
Nota:
Este ejemplo s�lo funciona con los servidores de directorios que publican sus reglas de correspondencia, como el Netscape Directory Server v4.1. |
No s�lo podemos usar lookup() para recuperar objetos esquema del �rbol de esquema, tambi�n podemos usar m�todos como list() o search().
�Crear, Modificar o Actualizar Definiciones de Reglas de Correspondencia
Crear, borrar o modificar din�micamene reglas de correspondencia no tiene sentido. La mayor�a de los servidores soportan un conjunto fijo de reglas de correspondencia. El cambio program�tico de este conjunto de reglas normalmente no est� soportado.