Esta secci�n especifica aquellos aspectos del API JAXR que tratan con las consultas de registros para allar entradas de registro (metadada) o �tems de repositorio (contenido). Los interfaces de control de consultas est�n dise�ados para ser usados por cualquier usuario del registro no privilegiado, normalmente a trav�s de un cliente JAXR especializado, como un Navegador de Registro o un agente web inteligente (asistente digital).
|
[Nota]
Los aspectos de seguridad sobre el control de consultas se explican en el cap�tulo Arquitectura de Serguridad. |
El API proporciona un interface QueryManager com�n, as� como dos subinterfaces especializados:
- Interface BusinessQueryManager
- Interface SQLQueryManager
�Interface BusinessQueryManager
El interface BusinessQueryManager proporciona un API simple de nivel de negocios que proporciona la habilidad de consultar por los interfaces de alto nivel m�s importantes en el modelo de informaci�n. Estos interfaces de alto nivel incluyen:
- Interface Organization
- Interface Service
- Interface ServiceBinding
- Interface Concept
Capacidad Nivel: 0
Se requiere que ese interface sea implementado por todos los proveedores JAXR.
| Sumario de M�todos | � |
|---|---|
findConceptsByName(java.util.Collection namePatterns,
LexicalQualifier lexicalQualifier,
SortQualifier sortQualifier) |
Busca todos los Concepts que corresponden con cualquiera de los namePatterns especificados. |
findOrganizationsByClassificationConcepts(java.util.Collection
classificationConcepts,
SortQualifier sortQualifier) |
Busca todas las Organizations que corresponden con todos los Concepts de clasificaci�n especificados. |
findOrganizationsByExternalIdentifiers(java.util.Collection
externalIdentifiers,
SortQualifier sortQualifier) |
Busca todas las Organizations que corresponden con cualquiera de los externalIdentifiers especificados. |
findOrganizationsByExternalLink(java.util.Collection externalLinks, SortQualifier sortQualifier) |
Busca todas las Organizations que sean anotadas por cualquiera de los externalLinks especificados. |
findOrganizationsByName(java.util.Collection namePatterns,
LexicalQualifier lexicalQualifier,
SortQualifier sortQualifier) |
Busca todas las Organizations que correspondan con cualquiera de los namePatterns especificados. |
findOrganizationsBySpecificationConcepts(java.util.Collection
specificationConcepts,
SortQualifier sortQualifier) |
Busca todas las Organizations que correspondan con todas las especificaciones de Concepts especificadas. |
findRootConceptsByName(java.util.Collection namePatterns,
LexicalQualifier lexicalQualifier,
SortQualifier sortQualifier) |
Busca todos los Concepts ra�z que correspondan con cualquier namePatterns especificado. |
findServiceBindingsByName(java.util.Collection namePatterns, Key serviceKey, LexicalQualifier lexicalQualifier, SortQualifier sortQualifier) |
Busca todos los ServiceBindings que correspondan con cualquiera de los namePatterns especificados. |
findServiceBindingsBySpecificationConcepts(java.util.Collection specificationConcepts, Key serviceKey, SortQualifier sortQualifier) |
Busca todos los ServiceBindings que correspondan con todas las especificaciones de Concepts especificadas. |
findServicesByClassificationConcepts(java.util.Collection class
ificationConcepts, Key orgKey,
SortQualifier sortQualifier) |
Busca todos los Services que correspondan con todas las especificaciones de Concepts especificadas. |
findServicesByName(java.util.Collection namePatterns, Key orgKey, LexicalQualifier LexicalQualifier, SortQualifier sortQualifier) |
Busca todos los Services que correspondan con cualquier namePatterns especificado. |
findServicesBySpecificationConcepts(java.util.Collection specif
icationConcepts, Key orgKey,
SortQualifier sortQualifier) |
Busca todos los Services que correspondan con todas las especificaciones de Concepts especificadas. |
�M�todos Find
El interface BusinessQueryManager define un conjunto de m�todos find, uno por cada interface clave y una combinaci�n de criterios de b�squeda. Cada m�todo find puede devolver varios objetos del tipo asociado al m�todo que correspondan con los criterios de b�squeda especificados.
Cualificadores L�xicos
Los m�todos find que realizan correspondencias String
basadas en patrones toman un par�metro LexicalQualifier. El cliente podr�a utilizar un
cualificador l�xico para especificar las preferencias de correspondencia l�xica (por ejemplo, correspondencia o no de
las may�sculas y min�sculas).
Cualificadores de Ordenaci�n
Todos los m�todos find toman un par�metro SortQualifier.
El cliente podr�a usar un cualificador de ordenaci�n para especificar preferencias de ordenaci�n para el resultado del
meodo find (por ejemplo, ordenar por el nombre en orden ascendente). Un cualificador
de ordenaci�n especifica el orden de ordenaci�n ascendente o descendente, as� como el campo de ordenaci�n. Realmente
un campo de ordenaci�n s�lo podr�a por el nombre o el sello de la fecha.
Par�metros de Colecci�n
Cualquier par�metro Collection que sean Collections de
objetos son colecciones homog�neas de objetos del tipo apropiado. Si la colecci�n contiene un objeto cuyo tipo no
es el adecuado, la implementaci�n debe lanzar una UnexpectedObjectException.
Interface FindException
Esta excepci�n se usa en el caso de un fallo o un �xito parcial durante una operaci�n find.
Se devolver� una Collection de ejemplares de esta excepci�n en el
BulkResponse para una llamada al m�todo find si se
encuentra una FindExceptions.
�Interface SQLQueryManager
El interface SQLQueryManager proporciona un API gen�rico m�s flexible que proporciona la habilidad de realizar consultas SQL.
Como proporciona m�s funcionalidades usando menos m�todos que el BusinessQueryManager, �ste API podr�a parecer un poco menos obvio para algunos.
Capacidad Nivel: 1
Se requiere que este interface sea implementado por todos lo proveedores JAXR de nivel de capacidad 1 o superiores.
| Sumario de M�todos | � |
|---|---|
submitQuery(java.lang.String sqlQuery) |
Env�a una Consulta SQL. |
�S�ntaxis de Consulta SQL
La s�ntaxis para la consulta SQL est� definida por el uso estilizado de un subconjunto apropiado de sentencias SELECT de nivel Entry de SQL definido por ISO/IEC 9075:1992, Database Language SQL [SQL], y extendido para incluir rutinas SQL (tambi�n conocidas como procedimientos almacenados) y especificadas en ISO/IEC 9075-4 [SQL-PSM].
�Uni�n de la S�ntaxis de Consulta SQL al Modelo de Informaci�n
Las consultas SQL est�n definidas bas�ndose en la s�ntaxis de consulta definida en [RIM] y el esquema relacional que es un algoritmo de uni�n para el modelo de informaci�n.
�Resultado de Consulta SQL
El m�todo executeQuery devuelve un BulkResponse que contiene una Collection homog�nea de objetos. El tipo de los objetos est� definido por la cla�sula FROM de la consulta. Por ejemplo "SELECT from Organization WHERE" devuelve una Collection de ejemplares de Organization.