Sintaxis de ubicación

Cada recurso tiene una ubicación que lo identifica de forma exclusiva en un momento determinado.

En el caso de un recurso basado en archivos, la ubicación se expresa en forma de nombre de vía de acceso del archivo. En el caso de un recurso del lado del servidor, la ubicación contiene la información necesaria para encontrar el objeto (por ejemplo, un identificador de base de datos en una VOB).

La ubicación del recurso es necesaria para leer o grabar el contenido del recurso o para leer o grabar propiedades en un servidor.

Objetos de ubicación:

El objeto StpLocation representa una dirección de recurso; como tal, se puede utilizar para construir un proxy de recursos (mediante uno de los métodos de fábrica de proxy de recursos del proveedor). Como norma general, el tipo de proxy Resource construido a partir de una ubicación debe ser el mismo que el recurso al que hace referencia la ubicación. Sin embargo, el tipo de recurso al que hace referencia la ubicación no siempre se determina a partir de la especificación de dirección únicamente. Como resultado, esta regla no siempre puede cumplirse en el momento en que se construye un proxy.

Todos los recursos tienen un formulario de ubicación estable que se puede utilizar para almacenar identidades de recurso en el cliente entre sesiones de cliente. Es posible que esta ubicación estable no sea la ubicación utilizada para crear el recurso. El servidor crea esta ubicación estable para el usuario cuando crea el recurso. Esta ubicación siempre se encuentra disponible como propiedad fija del recurso. El objeto StpLocation proporciona métodos para obtener la representación de serie para una ubicación y para analizar dicha serie en una ubicación.

Una instancia StpLocation representa una especificación de ubicación que se ha analizado en sus campos de componente. Un número de formatos o esquemas diferentes se utiliza para expresar la ubicación de varios recursos en forma de serie. Estos esquemas constan de uno o varios de los campos siguientes: dominio, nombre de repositorio, espacio de nombres y nombre de objeto. El campo de espacio de nombres determina el esquema que se va a utilizar.

La interfaz StpLocation proporciona métodos para analizar una especificación de ubicación en sus partes constituyentes. Mediante los métodos disponibles, los clientes de la API de Rational CM pueden examinar especificaciones de ubicación proporcionadas por el usuario para determinar si son apropiadas para el contexto en que se van a utilizar. A partir de este análisis, un cliente puede proporcionar las partes de la especificación de ubicación que el usuario omite si el contexto define dichas partes que faltan de forma inequívoca.

El método StpProvider.stpLocation() facilita este proceso rellenando un esquema de serie de ubicación ausente a partir del parámetro Espacio de nombres y rellenando un repositorio ausente desde el repositorio predeterminado identificado para el proveedor por el cliente. Consulte el método StpProvider.setDefaultRepository de la información del Javadoc.

En el caso de operaciones que requieren un artefacto de sistema de archivos específico de usuario, es suficiente con utilizar un nombre de vía de acceso de sistema de archivos que lleve a un área de archivo de espacio de trabajo. En el caso de operaciones que requieran un objeto especificado por usuario de otro tipo (como, por ejemplo, una actividad, un proyecto o un registro), utilice una sintaxis que especifique el formato general y especificación completa de una serie de ubicación que identifique un objeto por el nombre:
<dominio>.<espacio de nombres>:<nombre-objeto>@<nombre-repositorio>
En el ejemplo siguiente, queda implícito el uso del dominio predeterminado:
"secuencia:misecuencia@proyectos" 
Es posible que el software que entienda las especificaciones de ubicación permita omitir varios campos. Por ejemplo:

La interfaz StpProvider incluye métodos para la creación de una StpLocation en formatos como USER_FRIENDLY_LOCATION y STABLE_LOCATION con los métodos userFriendlySelector y stableSelector. La interfaz StpResource incluye los métodos getStableLocation y getUserFriendlyLocation que devuelven los valores de las propiedades STABLE_LOCATION y USER_FRIENDLY_LOCATION definidas por el proxy. Si el cliente necesita una ubicación en un formato específico, deberá solicitar la propiedad de recurso que corresponda a dicho formato y no utilizar StpLocation.stpLocation().


Comentarios