NAME

MOSES::MOBY::Async - A module for interacting with HTTP POST WSRF asynchronous services

SYNOPSIS

use MOSES::MOBY::Async;

DESCRIPTION

This module is the main module used by asynchronous HTTP POST biomoby services. In most situations, it would be incorrect for you to instantiate a reference to this module.

AUTHORS

Edward Kawas (edward.kawas [at] gmail [dot] com)

ACCESSIBLE ATTRIBUTES

Details are in MOSES::MOBY::Base. Here just a list of them (additionally to the attributes from the parent classes)

The following are constants that refer to faults.

none are exported

RESOURCE_UNKNOWN_FAULT

RESOURCE_UNAVAILABLE_FAULT

RESOURCE_NOT_DESTROYED_FAULT

INVALID_RESOURCE_PROPERTY_QNAME_FAULT

Name       :    submit
Function   :    submits an asynchronous job
Usage      :    $async->submit($obj, $id, $job, $in_package, $out_package);
Args       :    $obj         - a child of MOSES::MOBY::Service::ServiceBase
                $id 	      - a scalar string representing the service invocation id
                $job         - a MOSES::MOBY::Job, representing the current job 
                $in_package  - a MOSES::MOBY::Package, representing the incoming message 
                $out_package - a MOSES::MOBY::Package, representing the outgoing message

Name       :    destroy
Function   :    destroys an asynchronous job
Usage      :    $async->destroy($header, $data);
Args       :    $header - a string of XML representing the moby-wsrf header 
                $data 	 - a string of XML representing the WSRF destroy resource call.

Name       :    result
Function   :    obtains the result of an asynchronous job
Usage      :    $async->result($header, $data);
Args       :    $header - a string of XML representing the moby-wsrf header 
                $data 	 - a string of XML representing the WSRF result call.

Name       :    poll
Function   :    polls the status of an asynchronous job
Usage      :    $async->poll($header, $data);
Args       :    $header - a string of XML representing the moby-wsrf header 
                $data 	 - a string of XML representing the WSRF poll resource status call.

Name       :    create_epr
Function   :    creates an endpoint reference for the given CGI object
Usage      :    $async->create_epr($cgi);
Args       :    $cgi - a CGI variable

Name       :    create_fault
Function   :    creates a WSRF resource fault
Usage      :    $async->create_fault($fault_type, $url);
Args       :    $fault_type - one of C<RESOURCE_UNKNOWN_FAULT>, C<RESOURCE_UNAVAILABLE_FAULT>, C<RESOURCE_NOT_DESTROYED_FAULT> or C<INVALID_RESOURCE_PROPERTY_QNAME_FAULT> 
                $url 	     - the service url
                $desc		 - an optional message to include in the fault.