The eSTAR Project

Catalogue SOAP Service

From EStar

As well as the REST service we also offer catalogue retrieval over a SOAP web service. Example access code for Search servlet:

  #!/usr/local/bin/perl
  
  use SOAP::Lite;

  my $soap = new SOAP::Lite();
  $soap->uri('http://estar9.astro.ex.ac.uk/Search'); 
  $soap->proxy('http://estar9.astro.ex.ac.uk/search/cgi-bin/service.cgi');
  
  my $ra      = undef;
  my $dec     = undef;
  my $name    = "EX Hya";
  my $radius  = 5;
  my $equinox = "J2000";
  my $catalog = "USNOA2";
  my $format  = "Cluster";  
    
  my $result;
  eval { $result = $soap->search( $ra, $dec, $name, $radius, 
                                  $equinox, $catalog, $format); };
  if ( $@ ) {
     print "Error: $@";
     exit;   
  }
  
  if ( $result->fault() ) {
  
    print "Fault Code  : " . $result->faultcode() ."\n";
    print "Fault String: " . $result->faultstring() ."\n";
    
  } else {
  
    # print returned catalogue to standard output
    print $result->result();
  }
  
  exit;  

The SOAP service will automatically query the CDS Sesame service to resolve target names before making a cone search query using the returned R.A. and Dec. on the requested catalogue. Errors will raise a SOAP Exception which will be returned to the client code. If you have any questions about the SOAP catalogue brokering service please feel free to contact Alasdair Allan for more information.