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.