NAME

XAS::Lib::Stomp::Parse - Create a STOMP Frame From a Buffer

SYNOPSIS

  use XAS::Lib::Stomp::Parser;

  my $parser = XAS::Lib::Stomp::Parser->new(
    -target  => '1.0',
  );

  while (my $buffer = read()) {

     if (my $frame = $parser->parse($buffer)) {

         # do something...

     }

  }

DESCRIPTION

This module creates STOMP frames from a buffer. STOMP is the Streaming Text Orientated Messaging Protocol (or the Protocol Briefly Known as TTMP and Represented by the symbol :ttmp). It's a simple and easy to implement protocol for working with Message Orientated Middleware from any language. This module supports v1.0, v1.1 and v1.2 frames with limited interoperability between the frame types.

A STOMP frame consists of a command, a series of headers and a body.

METHODS

new

Creates a new parser. It can take the following parameters:

-target

Specify a STOMP protocol version number. It currently supports 1.0, 1.1 and 1.2, defaulting to 1.0.

get_pending

Returns the contents of the internal buffer.

SEE ALSO

XAS

For more information on the STOMP protocol, please refer to: http://stomp.github.io/ .

AUTHOR

Kevin L. Esteb, <kevin@kesteb.us>

COPYRIGHT AND LICENSE

Copyright (C) 2014 Kevin L. Esteb

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.8 or, at your option, any later version of Perl 5 you may have available.

See http://dev.perl.org/licenses/ for more information.