Package uk.ac.starlink.vo
Class Ri1RegistryQuery
java.lang.Object
uk.ac.starlink.vo.Ri1RegistryQuery
- All Implemented Interfaces:
RegistryQuery
RegistryQuery implementation using the SOAP Registry Interface 1.0
mechanism.
- Since:
- 4 Jan 2005
- Author:
- Mark Taylor (Starlink)
- See Also:
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final String
Endpoint for primary AstroGrid registry.static final String
Endpoint for secondary AstroGrid registry.static final String
Endpoint for Euro-VO registry.static int
Default maximum number of registry entries retrieved at once.static final String[]
List of likely registries.static final uk.ac.starlink.table.ValueInfo
Description of metadata item describing registry location.static final uk.ac.starlink.table.ValueInfo
Description of metadata item describing query text.static final String
Endpoint for VAO registry. -
Constructor Summary
ConstructorsConstructorDescriptionRi1RegistryQuery
(String endpoint, String text) Constructs a new query object from a registry URL and a query.Ri1RegistryQuery
(uk.ac.starlink.registry.SoapClient soapClient, String text) Constructs a new query object from a SOAP client and a query. -
Method Summary
Modifier and TypeMethodDescriptionstatic String
getAdqlWhere
(Capability cap) Returns an ADQL 1.0 WHERE clause which can be used to search for capabilities of the given type in the registry.uk.ac.starlink.table.DescribedValue[]
Returns a set of DescribedValue objects which characterise this query.Executes the query described by this object and returns an Iterator overRegResource
objects.Executes the query described by this object and returns the result as an array ofRegResource
s.Returns the registry URL.static String[]
getSearchableRegistries
(String regUrl) Searches the given registry access URL to find a list of full searchable registry access URLs.getText()
Returns the query text.toString()
-
Field Details
-
RECORD_BUFFER_SIZE
public static int RECORD_BUFFER_SIZEDefault maximum number of registry entries retrieved at once. Increasing this number may improve performance, but beware: registry records can be large, and setting it high (even 100) can easily exhaust default heap memory with a single buffers-worth. This may be a consequence of poor memory usage in the registry classes or SOAP, or it may be fundamental - not sure. -
REGISTRY_INFO
public static final uk.ac.starlink.table.ValueInfo REGISTRY_INFODescription of metadata item describing registry location. -
TEXT_INFO
public static final uk.ac.starlink.table.ValueInfo TEXT_INFODescription of metadata item describing query text. -
AG_REG
Endpoint for primary AstroGrid registry. -
AG_REG2
Endpoint for secondary AstroGrid registry. -
VAO_REG
Endpoint for VAO registry. -
EUROVO_REG
Endpoint for Euro-VO registry. -
REGISTRIES
List of likely registries.
-
-
Constructor Details
-
Ri1RegistryQuery
Constructs a new query object from a SOAP client and a query.- Parameters:
soapClient
- SOAP clienttext
- ADQL WHERE clause for the registry query
-
Ri1RegistryQuery
Constructs a new query object from a registry URL and a query.- Parameters:
endpoint
- registry endpoint URLtext
- ADQL WHERE clause for the registry query
-
-
Method Details
-
getQueryIterator
Description copied from interface:RegistryQuery
Executes the query described by this object and returns an Iterator overRegResource
objects. Note that the iterator'snext
method may throw the unchecked exceptionRegistryQueryException
with a cause indicating the underlying error in case of a registry access problem.- Specified by:
getQueryIterator
in interfaceRegistryQuery
- Returns:
- iterator over
RegResource
s - Throws:
IOException
-
getQueryResources
Description copied from interface:RegistryQuery
Executes the query described by this object and returns the result as an array ofRegResource
s.- Specified by:
getQueryResources
in interfaceRegistryQuery
- Returns:
- resource list
- Throws:
IOException
-
getText
Description copied from interface:RegistryQuery
Returns the query text.- Specified by:
getText
in interfaceRegistryQuery
- Returns:
- query
-
getRegistry
Description copied from interface:RegistryQuery
Returns the registry URL.- Specified by:
getRegistry
in interfaceRegistryQuery
- Returns:
- url
-
getMetadata
public uk.ac.starlink.table.DescribedValue[] getMetadata()Description copied from interface:RegistryQuery
Returns a set of DescribedValue objects which characterise this query. These would be suitable for use in the parameter list of aStarTable
resulting from the execution of this query.- Specified by:
getMetadata
in interfaceRegistryQuery
-
getSearchableRegistries
Searches the given registry access URL to find a list of full searchable registry access URLs.- Parameters:
regUrl
- registry to start with- Returns:
- array of registries which can be searched
- Throws:
IOException
-
toString
-
getAdqlWhere
Returns an ADQL 1.0 WHERE clause which can be used to search for capabilities of the given type in the registry. The WHERE token is not included- Parameters:
cap
- standard capability- Returns:
- ADQL search query
-