NAME

Net::SPDY::Framer - SPDY protocol implementation

ALPHA WARNING

Please read carefully: This is an ALPHA stage software. In particular this means that even though it probably won't kill your cat, re-elect George W. Bush nor install Solaris 11 Express edition to your hard drive, it is in active development, functionality is missing and no APIs are stable.

See TODO file in the distribution to learn about missing and planned functionality. You are more than welcome to join the development and submit patches with fixes or enhancements. Bug reports are probably not very useful at this point.

SYNOPSIS

  use Net::SPDY::Framer;
  
  my $framer = new Net::SPDY::Framer ({
      compressor => new Net::SPDY::Compressor,
      socket => $socket,
  });
  
  $framer->write_ping(data => 'chuj');
  while (my %frame = $framer->read_frame) {
    last if $frame{control} and $frame{type} eq Net::SPDY::Framer::PING;
  }

DESCRIPTION

Net::SPDY::Framer provides SPDY protocol access on top of a network socket. It serializes and deserializes packets as they are, without implementing any other logic. For session management, see Net::SPDY::Session.

CONSTANTS

For the actual values refer to the protocol specification.

Frame types

SYN_STREAM, SYN_REPLY, RST_STREAM, SETTINGS, PING, GOAWAY, HEADERS, WINDOW_UPDATE, CREDENTIAL.

Flags

FLAG_FIN, FLAG_UNIDIRECTIONAL.

PROPERTIES

compressor

Net::SPDY::Compressor object representing the Zlib streams (one in each direction) used by the framer.

socket

IO::Handle instance that is used for actual network communication.

METHODS

new { socket => SOCKET, compressor => COMPRESSOR }

Creates a new framer instance. You need to create and pass both the socket for the network communication and the compressor instance.

SEE ALSO

• https://developers.google.com/speed/spdy/ -- SPDY project web site

• http://www.chromium.org/spdy/spdy-protocol/spdy-protocol-draft3 -- Protocol specification

• Net::SPDY::Session -- SPDY session implementation

• Net::SPDY::Compressor -- SPDY header compression

CONTRIBUTING

Source code for Net::SPDY is kept in a public GIT repository. Visit https://github.com/lkundrak/net-spdy.

Bugs reports and feature enhancement requests are tracked at https://rt.cpan.org/Public/Dist/Display.html?Name=Net::SPDY.

COPYRIGHT

Copyright 2012, Lubomir Rintel

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

AUTHOR

Lubomir Rintel lkundrak@v3.sk