RegistryQuery
public class RegTapRegistryQuery extends java.lang.Object implements RegistryQuery
Modifier and Type | Field | Description |
---|---|---|
static uk.ac.starlink.table.ValueInfo |
ADQL_INFO |
Description of metadata item describing query text.
|
static java.lang.String |
AIP_REG |
TAP endpoint for GAVO registry hosted at AIP.
|
static java.lang.String |
ARI_REG |
TAP endpoint for GAVO registry hosted at ARI Heidelberg.
|
static java.lang.String |
EUROVO_REG |
TAP endpoint for Euro-VO registry, currently hosted at ESAC.
|
static java.lang.String |
GAVO_REG |
TAP endpoint for high-availablity GAVO registry (DNS pointer).
|
static java.lang.String |
INAF_REG |
TAP endpoint for INAF registry (not sure if this is permanent).
|
static java.lang.String |
PARIS_REG |
TAP endpoint for registry hosted at ObsPM, synced with GAVO.
|
static java.lang.String[] |
REGISTRIES |
List of known registry TAP endpoints.
|
static uk.ac.starlink.table.ValueInfo |
REGISTRY_INFO |
Description of metadata item describing registry location.
|
static java.lang.String |
STSCI_REG |
TAP endpoint for STScI/VAO registry.
|
Constructor | Description |
---|---|
RegTapRegistryQuery(EndpointSet tapEndpointSet,
java.lang.String standardId,
java.lang.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.
|
Modifier and Type | Method | Description |
---|---|---|
static java.lang.String |
getAdqlCondition(ResourceField field,
java.lang.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.
|
uk.ac.starlink.table.DescribedValue[] |
getMetadata() |
Returns a set of DescribedValue objects which characterise this query.
|
java.util.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. |
java.net.URL |
getRegistry() |
Returns the registry URL.
|
static java.lang.String[] |
getSearchableRegistries(EndpointSet regtapEndpointSet) |
Queries a given registry for searchable registries suitable for
use with this class.
|
java.lang.String |
getText() |
Returns the query text.
|
public static final java.lang.String GAVO_REG
public static final java.lang.String ARI_REG
public static final java.lang.String AIP_REG
public static final java.lang.String PARIS_REG
public static final java.lang.String EUROVO_REG
public static final java.lang.String STSCI_REG
public static final java.lang.String INAF_REG
public static final java.lang.String[] REGISTRIES
public static final uk.ac.starlink.table.ValueInfo REGISTRY_INFO
public static final uk.ac.starlink.table.ValueInfo ADQL_INFO
public RegTapRegistryQuery(EndpointSet tapEndpointSet, java.lang.String standardId, java.lang.String adqlWhere)
adqlWhere
text has to be written
with some knowledge of the internals of this class, for instance
what columns are available.tapEndpointSet
- TAP endpoints 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 restrictionpublic uk.ac.starlink.table.DescribedValue[] getMetadata()
RegistryQuery
StarTable
resulting from the execution
of this query.getMetadata
in interface RegistryQuery
public java.net.URL getRegistry()
RegistryQuery
getRegistry
in interface RegistryQuery
public java.lang.String getText()
RegistryQuery
getText
in interface RegistryQuery
public RegResource[] getQueryResources() throws java.io.IOException
RegistryQuery
RegResource
s.getQueryResources
in interface RegistryQuery
java.io.IOException
public java.util.Iterator<RegResource> getQueryIterator() throws java.io.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
sjava.io.IOException
public static java.lang.String getAdqlCondition(ResourceField field, java.lang.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 againstpublic static java.lang.String[] getSearchableRegistries(EndpointSet regtapEndpointSet) throws java.io.IOException
regtapEndpointSet
- TAP endpoints for bootstrap
relational registryjava.io.IOException
Copyright © 2018 Central Laboratory of the Research Councils. All Rights Reserved.