• Parámetros y Valores de Retorno
• Los Parámeteros son Propiedad del LLamador
• Los Parámetros son Sólo Válidos Durante la Llamada
• Los Valores de Retorno son Propiedad del Llamador

Parámetros y Valores de Retorno

Cuando escribimos un proveedor de servicio, debemos tener en mente ciertas reglas sobre cómo tratar los parámetros de entrada y los valores de retorno. Estas reglas no sólo afectan a la corrección del proveedor de servicio y por último a la corrección del programa que lo usa, sino que también tienen implicaciones de seguridad. Estas reglas se aplican a llamadas a métodos sobre el interface Context y sus subinterfaces y se explican en las siguientes páginas.

 Los Parámeteros son Propiedad del LLamador

Cuando un proveedor de servicio acepta un parámetro del llamador como parte de una llamada a método, no debe modificar los contenidos del parámetro. Supongamos que un proveedor de servicio recibe un java.util.Hashtable como un parámetro de entorno. El no debe añadir, borrar o modificar ningún ítem del Hashtable. Si el proveedor debe usar una versión modificada del Hashtable (por ejemplo, borrando cualquier propiedad relacionada con la seguridad), debe hacer esto sólo después de clonar el Hashtable.

En otro ejemplo, cuando el proveedor obtiene un parámetro Name, no debe añadir, borrar o modificar ningún componente del nombre.

 Los Parámetros son Sólo Válidos Durante la Llamada

Un proveedor de servicio no debe manetener punteros a parámetros más allá de la llamada a método. Si el proveedor de servicio debe retener cierta información pasada en los parámetros, debe clonar o copiar la información a variables accesibles localmente.

Por ejemplo, si un llamador invoca a LdapContext.setRequestControls() con un valor no-null Control[], el proveedor de servicio debería copiar el array antes de volver de la llamada. Después de la llamada, cualquier cambio que el llamador haga en su array no debería afectar al proveedor de servicio y viceversa.

 Los Valores de Retorno son Propiedad del Llamador

Cuando un proveedor de servicio devuelve un objeto al llamador, debería darle la propiedad del objeto. Entonces el llamador es libre de hacer cambios en el objeto devuelto, y dichos cambios no deberían afectar al proveedor de servicio.

Por ejemplo, si dos llamadores invocan a LdapContext.getRequestControls(), entonces el Control[] que recibe cada uno es su propia copia. Cada llamador puede manipular ese resultado sin afectar al otro llamador. De forma similar, si dos llamadores invocan a Context.getEnvironment(), entonces el java.util.Hashtable que recibe cada uno puede ser manipulado independientemente sin que el otro llamador se vea afectado.

Para soportar este comportamiento, el proveedor de servicio normalmente necesita clonar un resultado mutable (que puede ser devuelto a varios llamadores) antes de devolverlo.