POE::Component::BlogCloud - Client interface to blo.gs streaming cloud server


POE-Component-BlogCloud documentation  | view source Contained in the POE-Component-BlogCloud distribution.

Index


NAME

Top

POE::Component::BlogCloud - Client interface to blo.gs streaming cloud server

SYNOPSIS

Top

    use POE qw( Component::BlogCloud );
    POE::Component::BlogCloud->spawn(
        ReceivedUpdate => sub {
            my($update) = $_[ ARG0 ];
            ## $update is a POE::Component::BlogCloud::Update object.
        },
    );

DESCRIPTION

Top

POE::Component::BlogCloud is a client interface to the blo.gs streaming cloud server, described at http://blo.gs/cloud.php. It's built using the POE framework for Perl, allowing you to build an event-based application that receives weblog updates, then acts upon them.

USAGE

Top

POE::Component::BlogCloud->spawn( %arg )

* ReceivedUpdate

The callback to execute when an update from the streaming server is received. ARG0 contains a POE::Component::BlogCloud::Update that represents the update information.

This argument is required.

* AutoReconnect

If the client is disconnected from the streaming server because of an error, it can be told to automatically try to reconnect by setting AutoReconnect to 1.

This argument is optional, and if not specified defaults to 0, meaning that the client will not automatically reconnect.

* RemoteAddress

The address of the streaming server to connect to.

This argument is optional, and if not specified defaults to ping.blo.gs.

* RemotePort

The port where the streaming server is running.

This argument is optional, and if not specified defaults to 9999.

CAVEATS

Top

The specification for the streaming server indicates that gzip compression will be turned on at some point, at which point an update to this module will be needed.

In addition, the blo.gs server does sometimes seem to get "stuck" and stop sending updates, which will be indicated by the client hanging waiting for an update. There's not much that can be done about this from the client side.

LICENSE

Top

POE::Component::BlogCloud is free software; you may redistribute it and/or modify it under the same terms as Perl itself.

AUTHOR & COPYRIGHT

Top


POE-Component-BlogCloud documentation  | view source Contained in the POE-Component-BlogCloud distribution.