NAME
    Message::Passing::STOMP - input and output messages to STOMP.

SYNOPSIS
        # Terminal 1:
        $ message-pass --input STDIN --output STOMP --output_options \
            '{"destination":"/queue/foo","hostname":"localhost","port":"6163","username":"guest","password":"guest"}'
        {"data":{"some":"data"},"@metadata":"value"}

        # Terminal 2:
        $ message-pass --output STDOUT --input STOMP --input_options \
            '{"destination":"/queue/foo","hostname":"localhost","port":"6163","username":"guest","password":"guest"}'
        {"data":{"some":"data"},"@metadata":"value"}

DESCRIPTION
    An STOMP <http://stomp.github.com/> transport for Message::Passing.

    STOMP <http://stomp.github.com/> is a simple and well supported
    messaging protocol, with clients in many languages.

    This is a simple adaptor to allow you to send or receive STOMP messages

QUEUES AND TOPICS
    STOMP does not specify the semantics for message destinations or
    subscriptions (other than that they are a string), however most common
    STOMP servers (including ActiveMQ and RabbitMQ) expect a string matching
    /queue/name or /topic/name.

    Messages published to a destination prefixed by /queue/ are queued up,
    until a subscriber connects, at which point they are delivered. If
    multiple subscribers connect then the messages are distributed between
    the subscribers (i.e. each subscriber sees a portion of the messages).

    Messages published to a destination prefixed by /topic/ are copied to
    all connected subscribers, however if there are no subscribers
    currently, they are discarded, rather than being queued up.

STOMP SERVERS
    There are a number of message brokers which will communicate with STOMP
    clients, the main ones being:

  RabbitMQ
    RabbitMQ <http://www.rabbitmq.com/> has a STOMP plugin
    <http://www.rabbitmq.com/stomp.html>.

  ActiveMQ
    ActiveMQ <http://activemq.apache.org/> has a STOMP plugin
    <http://activemq.apache.org/stomp.html>.

SEE ALSO
    <http://stomp.github.com/> - STOMP protocol documentation
    Message::Passing::Output::STOMP
    Message::Passing::Input::STOMP
    Message::Passing
    AnyEvent::STOMP

AUTHOR
    Tomas (t0m) Doran <bobtfish@bobtfish.net>

COPYRIGHT
    Copyright The above mentioned AUTHOR 2012.

LICENSE
    GNU Affero General Public License, Version 3

    If you feel this is too restrictive to be able to use this software,
    please talk to us as we'd be willing to consider re-licensing under less
    restrictive terms.