NAME

"Protocol::CassandraCQL::Frame" - a byte buffer storing the content of a CQL message frame

DESCRIPTION

This class provides wire-protocol encoding and decoding support for constructing and parsing Cassandra CQL message frames. An object represents a buffer during construction or parsing.

To construct a message frame, create a new empty object and use the "pack_*" methods to append data to it, before eventually obtaining the actual frame bytes using "bytes". Each "pack_*" method returns the frame object, allowing them to be easily chained:

 my $bytes = Protocol::CassandraCQL::Frame->new
    ->pack_short( 123 )
    ->pack_int( 45678 )
    ->pack_string( "here is the data" )
    ->bytes;

To parse a message frame, create a new object from the bytes in the message, and use the "unpack_*" methods to consume the values from it.

 my $frame = Protocol::CassandraCQL::Frame->new( $bytes );
 my $s   = $frame->unpack_short;
 my $i   = $frame->unpack_int;
 my $str = $frame->unpack_string;

CONSTRUCTOR

$frame = Protocol::CassandraCQL::Frame->new( $bytes )

Returns a new frame buffer, optionally initialised with the given byte string.

METHODS

AUTHOR

Paul Evans <leonerd@leonerd.org.uk>

NAME

DESCRIPTION

CONSTRUCTOR

$frame = Protocol::CassandraCQL::Frame->new( $bytes )

METHODS

$bytes = $frame->bytes

$frame->pack_byte( $v )

$v = $frame->unpack_byte

$frame->pack_short( $v )

$v = $frame->unpack_short

$frame->pack_int( $v )

$v = $frame->unpack_int

$frame->pack_string( $v )

$v = $frame->unpack_string

$frame->pack_lstring( $v )

$v = $frame->unpack_lstring

$frame->pack_uuid( $v )

$v = $frame->unpack_uuid

$frame->pack_string_list( $v )

$v = $frame->unpack_string_list

$frame->pack_bytes( $v )

$v = $frame->unpack_bytes

$frame->pack_short_bytes( $v )

$v = $frame->unpack_short_bytes

$frame->pack_inet( $v )

$v = $frame->unpack_inet

$frame->pack_string_map( $v )

$v = $frame->unpack_string_map

$frame->pack_string_multimap( $v )

$v = $frame->unpack_string_multimap

SPONSORS

AUTHOR