Una aplicación JNDI usa la propiedad de entorno Context.REFERRAL ("java.naming.referral") para indicar al proveedor de servicio cómo manejar las remisiones. La siguiente tabla muestra los valores definidos para esta propiedad. Si no se configura, el valor por defecto es ignorar las remisiones.

Configuración	Descripción
ignore	Ignora las remisiones
follow	Sigue automáticamente las remisiones
throw	Lanza una ReferralException por cada remision

Al contrario que los alias, que son siempre ignorados por operaciones LDAP que actualizan el directorio, la propiedad Context.REFERRAL afecta a todas las operaciones. Puedes ver una explicación sobre cómo actualizar remisiones en la lección Crear y Actualizar Remisiones.

Esta referencia afecta tanto a las "referral" de respuestas de error como a las referencias de continuación.

El control Manage Referral (draft-ietf-ldapext-namedref-00.txt) le dice al servidor LDAP que devuelva las entradas de remisión como entradas ordinarias (en lugar de devolver "referral" de respuestas de error o referencias de continuación). Si estamos usando el LDAP v3 y hemos configurado Context.REFERRAL como "ignore", el proveedor de servicio lDAP enviará automáticamente este control junto con la solicitud. Si estamos usando el LDAP v2, el control no se enviará porque no es aplicable en este protocolo. Cuando configuramos Context.REFERRAL a cualquier otro valor, el control no será envíado sin importar la versión de protocolo. Cuando se actualizan entradas de remisión, siempre deberíamos suar "ignore".

Cuando el proveedor de servicio recibe una remisión sin importar que Context.REFERRAL esté seleccionado como "ignore", lanzará una PartialResultException para indicar que se podrían obtener más resultados si se siguiera la remisión. En este caso, el servidor no soporta el control Manage Referral y soporta las remisiones actualizadas de alguna otra forma.

Las referencias de continuación pueden mezclarse con resultados de búsquedas devueltos por una operación "search" LDAP. Por ejemplo, cuando se busca un directorio, el servidor podría devolver varios resultados, además de unas pocas referencias de continuación que muestran donde obtener más resultados. Estos resultados y referencias podrían estar mezclados a nivel de protocolo. Cuando la propiedad Context.REFERRAL se configura como "follow", el proveedor de servicio LDAP primero procesa todas las entradas normales, antes de seguir la referencias de continuación. Cuando esta propiedad se configura como "throw", primero se devuelven en la enumeración todas las entradas normales, antes de lanzar la ReferralException.

Por el contrario, una respuesta de error "referral" es procesada inmediatamente cuando Context.REFERRAL se configura como "follow" o como "throw".

Los ejemplos de esta sección se comunican con un nuevo servidor cuyo directorio contiene remisiones al servidor original de este tutorial. Se asume que el servidor original se está ejecutado en el puerto 389 de la máquina local, y el nuevo servidor en el puerto 489 de la misma máquina.

Se han configurado estas tres remisones desde el nuevo servidor (puerto 489) hasta el servidor original (puerto 389).

El contexto inicial usado en los ejemplos de esta lección se inicializa usando las siguientes propiedades de entorno:

Al contrario que el resto de los ejemplos de este tutorial, el número de puerto es 489 en lugar de 389.