/usr/share/perl5/Net/AMQP/Frame.pm is in libnet-amqp-perl 0.06~dfsg-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 | package Net::AMQP::Frame;
=head1 NAME
Net::AMQP::Frame - AMQP wire-level Frame object
=cut
use strict;
use warnings;
use base qw(Class::Data::Inheritable Class::Accessor::Fast);
use Net::AMQP::Common qw(:all);
use Carp;
BEGIN {
__PACKAGE__->mk_classdata('type_id');
__PACKAGE__->mk_accessors(qw(
channel
size
payload
));
}
# Use all the subclasses
use Net::AMQP::Frame::Method;
use Net::AMQP::Frame::Header;
use Net::AMQP::Frame::Body;
use Net::AMQP::Frame::OOBMethod;
use Net::AMQP::Frame::OOBHeader;
use Net::AMQP::Frame::OOBBody;
use Net::AMQP::Frame::Trace;
use Net::AMQP::Frame::Heartbeat;
=head1 CLASS METHODS
=head2 new
Takes an arbitrary list of key/value pairs and casts it into this class. Nothing special here.
=cut
sub new {
my ($class, %self) = @_;
return bless \%self, $class;
}
=head2 factory
Net::AMQP::Frame->factory(
type_id => 1,
channel => 1,
payload => '',
);
Will attempt to identify a L<Net::AMQP::Frame> subclass for further parsing, and will croak on failure. Returns a L<Net::AMQP::Frame> subclass object.
=cut
sub factory {
my ($class, %args) = @_;
unless (exists $args{type_id}) { croak "Mandatory parameter 'type_id' missing in call to Net::AMQP::Frame::factory"; }
unless (exists $args{channel}) { croak "Mandatory parameter 'channel' missing in call to Net::AMQP::Frame::factory"; }
unless (exists $args{payload}) { croak "Mandatory parameter 'payload' missing in call to Net::AMQP::Frame::factory"; }
unless (keys %args == 3) { croak "Invalid parameter passed in call to Net::AMQP::Frame::factory"; }
my $subclass;
if ($args{type_id} == 1) {
$subclass = 'Method';
}
elsif ($args{type_id} == 2) {
$subclass = 'Header';
}
elsif ($args{type_id} == 3) {
$subclass = 'Body';
}
elsif ($args{type_id} == 8) {
$subclass = 'Heartbeat';
}
else {
croak "Unknown type_id $args{type_id}";
}
$subclass = 'Net::AMQP::Frame::' . $subclass;
my $object = bless \%args, $subclass;
$object->parse_payload();
return $object;
}
=head1 OBJECT METHODS
=head2 Field accessors
Each subclass extends these accessors, but they share in common the following:
=over 4
=item I<type_id>
=item I<channel>
=item I<size>
=item I<payload>
=back
=head2 parse_payload
Performs the parsing of the 'payload' binary data.
=head2 to_raw_payload
Returns the binary data the represents this frame's payload.
=head2 to_raw_frame
Returns a raw binary string representing this frame on the wire.
=cut
sub to_raw_frame {
my $self = shift;
my $class = ref $self;
if (! defined $self->channel) {
$self->channel(0);
}
return pack('Cn', $self->type_id, $self->channel)
. pack_long_string($self->to_raw_payload())
. pack('C', 206);
}
=head2 type_string
Returns a string that uniquely represents this frame type, such as 'Method Basic.Consume', 'Header Basic' or 'Body'
=cut
sub type_string {
my $self = shift;
my ($type) = ref($self) =~ m{::([^:]+)$};
my $subtype;
if ($self->can('method_frame')) {
($subtype) = ref($self->method_frame) =~ m{^Net::AMQP::Protocol::(.+)$};
my ($class, $method) = split /::/, $subtype;
$subtype = join '.', $class, $method;
}
elsif ($self->can('header_frame')) {
($subtype) = ref($self->header_frame) =~ m{^Net::AMQP::Protocol::(.+)::ContentHeader$};
}
return $type . ($subtype ? " $subtype" : '');
}
=head1 SEE ALSO
L<Net::AMQP>
=head1 COPYRIGHT
Copyright (c) 2009 Eric Waters and XMission LLC (http://www.xmission.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.
=head1 AUTHOR
Eric Waters <ewaters@gmail.com>
=cut
1;
|