/ 
Dancer-Plugin-Stomp-1.0100
River stage zero No dependents
/ Dancer::Plugin::Stomp

NAME

Dancer::Plugin::Stomp - A Dancer plugin for talking to STOMP message brokers.

VERSION

version 1.0100

SYNOPSIS

use Dancer;
use Dancer::Plugin::Stomp;

post '/messages' => sub {
    stomp_send { destination => '/queue/foo', body => request->body };
};

dance;

DESCRIPTION

The goal of this module is to make it as easy as possible to interact with a STOMP message broker. STOMP stands for Simple (or Streaming) Text Orientated Messaging Protocol. It is a simple and standard protocol for messaging systems. See http://stomp.github.com for more details about the protocol.

KEYWORDS

stomp_send

stomp_send \%data
stomp_send name => \%data

This is a convenience function that handles connection details for you. It sends your message using the default configured client. If you have only one client configured, it is your default one. If you have multiple clients configured, the one named default will be used. Doing this

stomp_send { destination => '/queue/foo', body => 'hello' };

is the same as:

stomp->connect(login => $login, passcode => $passcode);
stomp->send(destination => '/queue/foo', body => 'hello');
stomp->disconnect();

If you have multiple clients configured, you can distinguish between them by providing the name of the client as the first argument, followed by the data as the second argument:

stomp_send foo => { destination => '/queue/foo', body => 'hello' };

stomp

my $stomp = stomp
my $stomp = stomp $name

This simply returns a Net::STOMP::Client object. You are responsible for connecting and disconnecting. When no arguments are given, it returns a handle to the default configured client. You may provide a name if you have multiple clients configured.

CONFIGURATION

Configuration at a minimum requires a name and a host. The following example defines one client named default.

plugins:
  Stomp:
    default:
      host: foo.com

Multiple clients can also be configured:

plugins:
  Stomp:
    default:
      host: foo.com
    bar:
      host: bar.com
      port: 61613
      login: bob
      passcode: secret

The available configuration options for a client are:

host - Required

This is the location of the STOMP server. It can be an ip address or a hostname.

port - Optional, Default: 61613
login - Optional
passcode - Optional

SEE ALSO

Net::STOMP::Client, POE::Component::MessageQueue, http://stomp.github.com

AUTHOR

Naveed Massjouni <naveedm9@gmail.com>

COPYRIGHT AND LICENSE

This software is copyright (c) 2011 by Naveed Massjouni.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.