NAME

Astro::Catalog::Transport::WebService - A base class for WebService queries

SYNOPSIS

  use base qw/Astro::Catalog::Transport::WebService/;

DESCRIPTION

This class forms a base class for all the WebService based query classes in the "Astro::Catalog" distribution (eg "Astro::Catalog::Query::Sesame").

METHODS

Constructor

new

Create a new instance from a hash of options

    $q = new Astro::Catalog::Transport::WebService(
        Coords    => new Astro::Coords(),
        Radius    => $radius,
        Bright    => $magbright,
        Faint     => $magfaint,
        Sort      => $sort_type,
        Number    => $number_out);

returns a reference to an query object. Must only called from sub-classed constructors.

RA and Dec are also allowed but are deprecated (since with only RA/Dec the coordinates must always be supplied as J2000 space-separated sexagesimal format).

querydb

Unlike "Astro::Transport::REST" a default "querydb()" method is not provided by this base class, each sub-class must provide its own implemetation.

proxy

Return (or set) the current proxy for the catalog request.

    $usno->proxy('http://wwwcache.ex.ac.uk:8080/');
    $proxy_url = $usno->proxy();

urn

Return the current remote urn for the query

    $host = $q->urn();

Can also be used to set the urn.

endpoint

Return the current endpoint for the query

    $host = $q->endpoint();
    $q->endpoint('http://www.blah.org:8080');

Can also be used to set the endpoint. If the endpoint is a wsdl file the SOAP::Lite object will automagically be configured to use the correct URN, e.g.

   $q->endpoint('http://cdsws.u-strasbg.fr/axis/Sesame.jws?wsdl');

General Methods

configure

Configures the object, takes an options hash as an argument

    $q->configure(%options);

Does nothing if the array is not supplied.