Package uk.ac.starlink.vo

Class TableSetTapMetaReader

java.lang.Object
uk.ac.starlink.vo.TableSetTapMetaReader
All Implemented Interfaces:
TapMetaReader
public class TableSetTapMetaReader extends Object implements TapMetaReader
TapMetaReader implementation that reads data from a vs:TableSet document. This can be found at the /tables endpoint of a TAP service.

All of the available information is read by readSchemas(), so the other read* methods never need be called, and will throw UnsupportedOperationExceptions.

Since:
18 Mar 2015
Author:
Mark Taylor
See Also:

  • Constructor Details

    • TableSetTapMetaReader

      public TableSetTapMetaReader(URL tablesetUrl, MetaNameFixer fixer, uk.ac.starlink.util.ContentCoding coding)
      Constructor.
      Parameters:
      tablesetUrl - URL of some document containing VOSITables <schema> elements
      fixer - object that fixes up syntactically incorrect table/column names; if null no fixing is done; has no effect for compliant VODataService documents
      coding - configures HTTP compression

  • Method Details

    • readSchemas

      public SchemaMeta[] readSchemas() throws IOException
      Description copied from interface: TapMetaReader
      Acquires metadata about schemas in a TAP service.

      May be slow.

      Specified by:
      readSchemas in interface TapMetaReader
      Returns:
      schema metadata array
      Throws:
      IOException

    • readTables

      public TableMeta[] readTables(SchemaMeta schema)
      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 interface TapMetaReader
      Parameters:
      schema - schema containing tables; not altered by call
      Returns:
      table metadata array
      Throws:
      UnsupportedOperationException - always

    • readColumns

      public ColumnMeta[] readColumns(TableMeta table)
      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 interface TapMetaReader
      Parameters:
      table - table containing columns; not altered by call
      Returns:
      column metadata array
      Throws:
      UnsupportedOperationException - always

    • readForeignKeys

      public ForeignMeta[] readForeignKeys(TableMeta table)
      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 interface TapMetaReader
      Parameters:
      table - table containing columns; not altered by call
      Returns:
      foreign key metadata array
      Throws:
      UnsupportedOperationException - always

    • getSource

      public String getSource()
      Description copied from interface: TapMetaReader
      Returns a textual indication of where the metadata is coming from, typically a URL.
      Specified by:
      getSource in interface TapMetaReader
      Returns:
      address of metadata

    • getMeans

      public String 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 interface TapMetaReader
      Returns:
      short description of metadata acquisition method