App::MessageDispatcher - Interface for sending/receiving (possibly) async messages
use App; $context = App->context(); $messaging = $context->service("MessageDispatcher"); # or ... $messaging = $context->messaging(); ($status, $ticket) = $messaging->send( recipient => $recipient, message => $message ); $message = $messaging->receive(); $message = $messaging->receive( sender => $sender, ); $message = $messaging->receive( ticket => $ticket, );
A MessageDispatcher service is a means by which data can be sent asynchronously (or synchronously) to a recipient and responses can be received.
Because the possibility exists for the messaging channel to be asynchronous, code that uses a MessageDispatcher service must code for the most complicated case (asynchronous).
The following classes might be a part of the MessageDispatcher Class Group.
Class: App::MessageDispatcher
Class: App::MessageDispatcher::Mail
Class: App::MessageDispatcher::SOAP
Class: App::MessageDispatcher::Stem
Class: App::MessageDispatcher::Spread
Class: App::MessageDispatcher::Jabber
Class: App::MessageDispatcher::PVM
Class: App::MessageDispatcher::MPI
A MessageDispatcher service is a means by which data can be sent synchronously or asynchronously to a recipient and responses can be received.
* Throws: App::Exception::MessageDispatcher * Since: 0.01
...
The constructor is inherited from App::Service.
App::Service
* Signature: ($status, $ticket) = $messaging->send(%named); * Param: recipient string * Param: message binary * Return: $status integer * Return: $ticket string * Throws: App::Exception::MessageDispatcher * Since: 0.01 Sample Usage: ($status, $ticket) = $messaging->send( recipient => "stephen.adkins\@officevision.com", message => "Hello.", );
* Signature: $message = $messaging->receive(); * Signature: $message = $messaging->receive(%named); * Param: sender string * Param: ticket string * Return: $message binary * Throws: App::Exception::MessageDispatcher * Since: 0.01 Sample Usage: # receive next available message $message = $messaging->receive(); # receive next message from sender $message = $messaging->receive( sender => "stephen.adkins\@officevision.com", ); # receive message associated with ticket $message = $messaging->receive( ticket => "XP305-3jks37sl.f299d", );
Returns 'MessageDispatcher'.
* Signature: $service_type = App::MessageDispatcher->service_type(); * Param: void * Return: $service_type string * Since: 0.01 $service_type = $mdisp->service_type();
* Author: Stephen Adkins <stephen.adkins@officevision.com> * License: This is free software. It is licensed under the same terms as Perl itself.
App::Context, App::Service
App::Context
To install App::Context, copy and paste the appropriate command in to your terminal.
cpanm
cpanm App::Context
CPAN shell
perl -MCPAN -e shell install App::Context
For more information on module installation, please visit the detailed CPAN module installation guide.