uk.ac.starlink.splat.vo
Class SplatRegistryQuery

java.lang.Object
  uk.ac.starlink.splat.vo.SplatRegistryQuery

All Implemented Interfaces:

uk.ac.starlink.vo.RegistryQuery

public class SplatRegistryQuery
extends Object
implements uk.ac.starlink.vo.RegistryQuery

Registry Query implementation that uses TAP to access a Relational Registry.

Since:

11 Apr 2014

See Also:

IVOA Registry Relational Schema

Field Summary

static uk.ac.starlink.table.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 uk.ac.starlink.table.ValueInfo	REGISTRY_INFO Description of metadata item describing registry location.
static String	REGTAP
static uk.ac.starlink.table.ValueInfo	REGTYPE_INFO Description of metadata item describing registry location.
static String[]	REGTYPES possible registry types
static String	RI1

Constructor Summary

SplatRegistryQuery(String regurl, String protocol)
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

uk.ac.starlink.table.DescribedValue[]	getMetadata()
Iterator	getQueryIterator()
uk.ac.starlink.vo.RegResource[]	getQueryResources()
URL	getRegistry()
static String[]	getSearchableRegistries(String regUrl) Queries a given registry for searchable registries suitable for use with this class.
String	getText()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

RI1

public static final String RI1

See Also:

Constant Field Values

REGTAP

public static final String REGTAP

See Also:

Constant Field Values

REGTYPES

public static final String[] REGTYPES

possible registry types

GAVO_REG

public static final String GAVO_REG

TAP endpoint for high-availablity GAVO registry (DNS pointer).

See Also:

Constant Field Values

ARI_REG

public static final String ARI_REG

TAP endpoint for GAVO registry hosted at ARI Heidelberg.

See Also:

Constant Field Values

AIP_REG

public static final String AIP_REG

TAP endpoint for GAVO registry hosted at AIP.

See Also:

Constant Field Values

INAF_REG

public static final String INAF_REG

TAP endpoint for INAF registry (not sure if this is permanent).

See Also:

Constant Field Values

REGISTRIES

public static final String[] REGISTRIES

List of known registry TAP endpoints.

REGTYPE_INFO

public static final uk.ac.starlink.table.ValueInfo REGTYPE_INFO

Description of metadata item describing registry location.

REGISTRY_INFO

public static final uk.ac.starlink.table.ValueInfo REGISTRY_INFO

Description of metadata item describing registry location.

ADQL_INFO

public static final uk.ac.starlink.table.ValueInfo ADQL_INFO

Description of metadata item describing query text.

Constructor Detail

SplatRegistryQuery

public SplatRegistryQuery(String regurl,
                          String protocol)

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. The supplied adqlWhere text has to be written with some knowledge of the internals of this class, for instance what columns are available.

Parameters:

tapurl - TAP endpoint for service hosting relational registry

standardId - required value of RR standard_id field, or null if not resricted by service

adqlWhere - text to be ANDed with existing ADQL WHERE clause, or null for no further restriction

Method Detail

getMetadata

public uk.ac.starlink.table.DescribedValue[] getMetadata()

Specified by:

getMetadata in interface uk.ac.starlink.vo.RegistryQuery

getRegistry

public URL getRegistry()

Specified by:

getRegistry in interface uk.ac.starlink.vo.RegistryQuery

getText

public String getText()

Specified by:

getText in interface uk.ac.starlink.vo.RegistryQuery

getQueryResources

public uk.ac.starlink.vo.RegResource[] getQueryResources()
                                                  throws IOException

Specified by:

getQueryResources in interface uk.ac.starlink.vo.RegistryQuery

Throws:

IOException

getQueryIterator

public Iterator getQueryIterator()
                          throws IOException

Specified by:

getQueryIterator in interface uk.ac.starlink.vo.RegistryQuery

Throws:

IOException

getSearchableRegistries

public static String[] getSearchableRegistries(String regUrl)
                                        throws IOException

Queries a given registry for searchable registries suitable for use with this class.

Parameters:

regUrl - TAP endpoint for bootstrap relational registry

Returns:

list of TAP endpoints for found relational registries

Throws:

IOException