GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  NET::AMQP (3)

.ds Aq ’

NAME

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

CONTENTS

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>
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 NET::AMQP (3) 2016-04-03

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.