NAME

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

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).

REVISION

$Id: WebService.pm,v 1.4 2003/08/03 06:18:35 timj Exp $

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.