|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectuk.ac.starlink.vo.RegTapRegistryQuery
public class RegTapRegistryQuery
Registry Query implementation that uses TAP to access a Relational Registry.
Field Summary | |
---|---|
static ValueInfo |
ADQL_INFO
Description of metadata item describing query text. |
static String |
AIP_REG
TAP endpoint for GAVO registry hosted at AIP. |
static String |
ARI_REG
TAP endpoint for GAVO registry hosted at ARI Heidelberg. |
static String |
GAVO_REG
TAP endpoint for high-availablity GAVO registry (DNS pointer). |
static String |
INAF_REG
TAP endpoint for INAF registry (not sure if this is permanent). |
static String[] |
REGISTRIES
List of known registry TAP endpoints. |
static ValueInfo |
REGISTRY_INFO
Description of metadata item describing registry location. |
Constructor Summary | |
---|---|
RegTapRegistryQuery(String tapurl,
String standardId,
String adqlWhere)
Constructs a query which will return RegResource lists for registry resource records with two optional restrictions: (a) restricted to a given service type, and (b) restricted by some free-form ADQL. |
Method Summary | |
---|---|
static String |
getAdqlCondition(ResourceField field,
String keyword)
Returns text that can be used as part of a WHERE clause to supply to this class that tests for a keyword in a given RR field. |
DescribedValue[] |
getMetadata()
Returns a set of DescribedValue objects which characterise this query. |
Iterator<RegResource> |
getQueryIterator()
Executes the query described by this object and returns an Iterator over RegResource objects. |
RegResource[] |
getQueryResources()
Executes the query described by this object and returns the result as an array of RegResource s. |
URL |
getRegistry()
Returns the registry URL. |
static String[] |
getSearchableRegistries(String regUrl)
Queries a given registry for searchable registries suitable for use with this class. |
String |
getText()
Returns the query text. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
public static final String GAVO_REG
public static final String ARI_REG
public static final String AIP_REG
public static final String INAF_REG
public static final String[] REGISTRIES
public static final ValueInfo REGISTRY_INFO
public static final ValueInfo ADQL_INFO
Constructor Detail |
---|
public RegTapRegistryQuery(String tapurl, String standardId, String adqlWhere)
adqlWhere
text has to be written
with some knowledge of the internals of this class, for instance
what columns are available.
tapurl
- TAP endpoint for service hosting relational registrystandardId
- required value of RR standard_id
field,
or null if not resricted by serviceadqlWhere
- text to be ANDed with existing ADQL WHERE clause,
or null for no further restrictionMethod Detail |
---|
public DescribedValue[] getMetadata()
RegistryQuery
StarTable
resulting from the execution
of this query.
getMetadata
in interface RegistryQuery
public URL getRegistry()
RegistryQuery
getRegistry
in interface RegistryQuery
public String getText()
RegistryQuery
getText
in interface RegistryQuery
public RegResource[] getQueryResources() throws IOException
RegistryQuery
RegResource
s.
getQueryResources
in interface RegistryQuery
IOException
public Iterator<RegResource> getQueryIterator() throws IOException
RegistryQuery
RegResource
objects.
Note that the iterator's next
method may throw the
unchecked exception
RegistryQueryException
with a cause
indicating the underlying error in case of a registry access problem.
getQueryIterator
in interface RegistryQuery
RegResource
s
IOException
public static String getAdqlCondition(ResourceField field, String keyword)
Note that this code currently works by identifying known ResourceFields, so unknown ResourceFields will return null.
field
- field whose content is to be testedkeyword
- value to test against
public static String[] getSearchableRegistries(String regUrl) throws IOException
regUrl
- TAP endpoint for bootstrap relational registry
IOException
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |