Package uk.ac.starlink.vo
Class Vosi11TapMetaReader
java.lang.Object
uk.ac.starlink.vo.Vosi11TapMetaReader
- All Implemented Interfaces:
TapMetaReader
TapMetaReader that works with the VOSI-1.1 scalable /tables endpoint.
It should work correctly with VOSI 1.1 services and also with VOSI 1.0
services and services (like, at time of writing, TAPVizieR)
that declare themselves as VOSI 1.0 but refuse to emit table details
for the full tables list.
Services may return tables without column and foreign key metadata
(table elements have no column children). If such a table is retrieved,
the detailed metadata may be obtained from a child URL /tables/(table-name).
The service may accept a detail
parameter for the /tables URL,
with possible values min
or max
(that is /tables?detail=min
or /tables?detail=max
)
to give it a non-binding hint about whether detail is returned
in child tables.
- Since:
- 16 Feb 2016
- Author:
- Mark Taylor
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionstatic enum
Enumeration for detail-preference mode of table metadata queries. -
Constructor Summary
ConstructorsConstructorDescriptionVosi11TapMetaReader
(URL tablesetUrl, MetaNameFixer fixer, uk.ac.starlink.util.ContentCoding coding, Vosi11TapMetaReader.DetailMode detailMode) Constructor. -
Method Summary
Modifier and TypeMethodDescriptiongetMeans()
Returns a textual indication of the method or protocol this reader uses to acquire TAP metadata.Returns a textual indication of where the metadata is coming from, typically a URL.readColumns
(TableMeta table) Acquires metadata about columns in a given table from a TAP service.readForeignKeys
(TableMeta table) Acquires metadata about foreign keys in a given table from a TAP service.Acquires metadata about schemas in a TAP service.readTables
(SchemaMeta schema) Acquires metadata about tables in a given schema from a TAP service.
-
Constructor Details
-
Vosi11TapMetaReader
public Vosi11TapMetaReader(URL tablesetUrl, MetaNameFixer fixer, uk.ac.starlink.util.ContentCoding coding, Vosi11TapMetaReader.DetailMode detailMode) Constructor.- Parameters:
tablesetUrl
- URL of VOSI1.1-like TAP tableset servicefixer
- object that fixes up syntactically incorrect table/column names; if null no fixing is done; has no effect for compliant VODataService documentscoding
- configures HTTP content-codingdetailMode
- detail mode
-
-
Method Details
-
getMeans
Description copied from interface:TapMetaReader
Returns a textual indication of the method or protocol this reader uses to acquire TAP metadata.- Specified by:
getMeans
in interfaceTapMetaReader
- Returns:
- short description of metadata acquisition method
-
getSource
Description copied from interface:TapMetaReader
Returns a textual indication of where the metadata is coming from, typically a URL.- Specified by:
getSource
in interfaceTapMetaReader
- Returns:
- address of metadata
-
readSchemas
Description copied from interface:TapMetaReader
Acquires metadata about schemas in a TAP service.May be slow.
- Specified by:
readSchemas
in interfaceTapMetaReader
- Returns:
- schema metadata array
- Throws:
IOException
-
readTables
Description copied from interface:TapMetaReader
Acquires metadata about tables in a given schema from a TAP service.May be slow. May throw UnsupportedOperationException if not needed.
- Specified by:
readTables
in interfaceTapMetaReader
- Parameters:
schema
- schema containing tables; not altered by call- Returns:
- table metadata array
- Throws:
UnsupportedOperationException
- always
-
readColumns
Description copied from interface:TapMetaReader
Acquires metadata about columns in a given table from a TAP service.May be slow. May throw UnsupportedOperationException if not needed.
- Specified by:
readColumns
in interfaceTapMetaReader
- Parameters:
table
- table containing columns; not altered by call- Returns:
- column metadata array
- Throws:
IOException
-
readForeignKeys
Description copied from interface:TapMetaReader
Acquires metadata about foreign keys in a given table from a TAP service.May be slow. May throw UnsupportedOperationException if not needed.
- Specified by:
readForeignKeys
in interfaceTapMetaReader
- Parameters:
table
- table containing columns; not altered by call- Returns:
- foreign key metadata array
- Throws:
IOException
-