NAME

    Net::AMQP - Advanced Message Queue Protocol (de)serialization and
    representation

SYNOPSIS

      use Net::AMQP;
    
      Net::AMQP::Protocol->load_xml_spec('amqp0-8.xml');
    
      ...
    
      my @frames = Net::AMQP->parse_raw_frames(\$input);
      
      ...
    
      foreach my $frame (@frames) {
          if ($frame->can('method_frame') && $frame->method_frame->isa('Net::AMQP::Protocol::Connection::Start')) {
              my $output = Net::AMQP::Frame::Method->new(
                  channel => 0,
                  method_frame => Net::AMQP::Protocol::Connection::StartOk->new(
                      client_properties => { ... },
                      mechanism         => 'AMQPLAIN',
                      locale            => 'en_US',
                      response          => {
                          LOGIN    => 'guest',
                          PASSWORD => 'guest',
                      },
                  ),
              );
              print OUT $output->to_raw_frame();
          }
      }

DESCRIPTION

    This module implements the frame (de)serialization and representation
    of the Advanced Message Queue Protocol (http://www.amqp.org/). It is to
    be used in conjunction with client or server software that does the
    actual TCP/IP communication.

CLASS METHODS

 parse_raw_frames

      Net::AMQP->parse_raw_frames(\$binary_payload)

    Given a scalar reference to a binary string, return a list of
    Net::AMQP::Frame objects, consuming the data in the string. Croaks on
    invalid input.

SEE ALSO

    Net::AMQP::Value, Net::RabbitMQ, AnyEvent::RabbitMQ, Net::RabbitFoot,
    POE::Component::Client::AMQP

AMQP VERSIONS

    AMQP 0-8 is fully supported.

    AMQP 0-9, 0-9-1, and 0-10 are usably supported. There are
    interoperability issues with table encodings because the standard
    disagrees with the dialects of major implementations (RabbitMQ and
    Qpid). For now, Net::AMQP limits itself to universally agreed table
    elements. See http://www.rabbitmq.com/amqp-0-9-1-errata.html for
    details.

    AMQP 1.0 has not been tested.

TODO

    Address the dialect problem, either via modified spec files that
    completely control the wire protocol, or by programmatic request. The
    former has precedent (viz "qpid.amqp0-8.xml" in spec), but could cause
    a combinatorial explosion as more brokers and versions are added. The
    latter adds interface complexity.

QUOTES

    "All problems in computer science can be solved by another level of
    indirection." -- David Wheeler's observation

    "...except for the problem of too many layers of indirection." --
    Kevlin Henney's corollary

COPYRIGHT

    Copyright (c) 2009 Eric Waters and XMission LLC
    (http://www.xmission.com/). Copyright (c) 2012, 2013 Chip Salzenberg
    and Topsy Labs (http://labs.topsy.com/). All rights reserved.

    This program is free software; you can redistribute it and/or modify it
    under the same terms as Perl itself. The full text of the license can
    be found in the LICENSE file included with this module.

AUTHOR

    Eric Waters <ewaters@gmail.com>