Enum Class SiaVersion

Method Details

• values

  public static SiaVersion[] values()

  Returns an array containing the constants of this enum class, in the order they are declared.

  Returns:

  an array containing the constants of this enum class, in the order they are declared

• valueOf

  public static SiaVersion valueOf(String name)

  Returns the enum constant of this class with the specified name. The string must match exactly an identifier used to declare an enum constant in this class. (Extraneous whitespace characters are not permitted.)

  Parameters:

  name - the name of the enum constant to be returned.

  Returns:

  the enum constant with the specified name

  Throws:

  IllegalArgumentException - if this enum class has no constant with the specified name

  NullPointerException - if the argument is null

• getMajorVersion

  public int getMajorVersion()

  Returns the major version number.

  Returns:

  major version number

• getDocumentUrl

  public String getDocumentUrl()

  Returns the URL of the standards document defining this version.

  Returns:

  document URL

• getStandardId

  public Ivoid getStandardId()

  Returns the StandardsRegExt identifier associated with this version of the SIA standard.

  Returns:

  standardId

• usesUcd1

  public boolean usesUcd1()

  Returns true if query responses use the UCD1 standard, false if they use the UCD1+ standard.

  Returns:

  true for UCD1, false for UCD1+

• executeQuery

  public abstract uk.ac.starlink.table.StarTable executeQuery(String serviceUrl, double ra, double dec, double size, SiaFormatOption format, uk.ac.starlink.table.StarTableFactory factory, uk.ac.starlink.util.ContentCoding coding) throws IOException

  Performs an SIA positional query. The exact geometry of the query is not defined here, but the size parameter defines an angular extent such as the width of a rectangular region or a diameter (not radius) of a cone.

  Parameters:

  serviceUrl - base URL for SIA service query resource

  ra - central right ascension position in degrees

  dec - central declination position in degrees

  size - extent of query in degrees

  format - required format for query result records returned

  factory - table factory

  coding - content coding for communications

  Returns:

  table giving query result

  Throws:

  IOException

• toString

  public String toString()

  Overrides:

  toString in class Enum<SiaVersion>

• forInterface

  public static SiaVersion forInterface(RegCapabilityInterface intf)

  Returns the version object appropriate for use with a given capability interface.

  Parameters:

  intf - interface

  Returns:

  SIA version used by interface; not null, a best guess is used if necessary