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  -  POE::COMPONENT::CLIENT::HTTP::REQUEST (3)

.ds Aq ’

NAME

POE::Component::Client::HTTP::Request - an HTTP request class

CONTENTS

VERSION

version 0.948

SYNOPSIS



  # Used internally by POE::Component::Client::HTTP



DESCRIPTION

POE::Component::Client::HTTP::Request encapsulates the state of requests POE::Component::Client::HTTP requests throughout their life cycles. There turns out to be a lot of state to manage.

CONSTRUCTOR

    new NAMED_PARAMETERS

Create a POE::Component::Client::HTTP object to manage a request. The constructor takes several named parameters:
Request => HTTP_REQUEST A POE::Component::Client::HTTP::Request object encapsulates a plain HTTP::Request. Required.
Factory => POE_COMPONENT_CLIENT_HTTP_REQUESTFACTORY The request may create additional requests during its lifetime, for example when following redirects. The Factory parameter specifies the POE::Component::Client::HTTP::RequestFactory that may be used to create them. Required.
Postback => RESPONSE_POSTBACK POE::Component::Client::HTTP creates a postback that will be used to send responses to the requesting session. Required.
Progress => PROGRESS_POSTBACK Sets the progress notification if the user has requested progress events. Optional.
Proxy Sets the proxy used for this request, if requested by the user. Optional.

METHODS

    ID

Return the request’s unique ID.

    return_response

Sends a response back to the user’s session. Called by POE::Component::Client::HTTP when a complete response has arrived.

    add_eof

Called by POE::Component::Client::HTTP to indicate EOF has arrived.

    add_content PARSED_DATA

Called by POE::Component::Client::HTTP to add content data to an incrementally built response. If PARSED_DATA is an object, it is treated like an HTTP::Headers object and its headers are assimilated into the response being built by the request. Otherwise the PARSED_DATA is appended to the response’s content.

    timer TIMER

Accessor to manipulate the request’s timeout timer. Sets the request’s timer if TIMER is specified, otherwise merely fetches the one currently associated with the request.

    create_timer TIMEOUT

Creates and sets a timer for this request. TIMEOUT is the number of seconds this request may live.

    remove_timeout

Turn off the timer associated with this request, and discard it.

    postback POSTBACK

Accessor to manipulate the postback associated with this request. Sets the postback if POSTBACK is defined, otherwise merely fetches it.

    does_redirect SOMETHING

FIXME - Not sure what this accessor does.

    check_redirect

Check whether the last response is a redirect, the request is permitted to follow redirects, and the maximum number of redirects has not been met. Initiate a redirect if all conditions are favorable.

    send_to_wheel

Transmit the request to the socket associated with this request.

    wheel

An accessor to return the wheel associated with this request.

    error ERROR_CODE, ERROR_MESSAGE

Generate an error response, and post it back to the user’s session.

    connect_error CONNECT_FAILURE_MESSAGE

Generate a connection error response, and post it back to the user’s session.

    host

Return the host this request is attempting to work with.

    port

Return the port this request is attempting to work with.

    scheme

Return the scheme for this request.

SEE ALSO

POE::Component::Client::HTTP POE

BUGS

None are currently known.

AUTHOR & COPYRIGHTS

POE::Component::Client::HTTP::Request is
o Copyright 2004-2005 Martijn van Beers
o Copyright 2006 Rocco Caputo
All rights are reserved. POE::Component::Client::HTTP::Request is free software; you may redistribute it and/or modify it under the same terms as Perl itself.

CONTRIBUTORS

Your name could be here.

CONTACT

Rocco may be contacted by e-mail via <mailto:rcaputo@cpan.org>, and Martijn may be contacted by email via <mailto:martijn@cpan.org>.

The preferred way to report bugs or requests is through RT though. See <http://rt.cpan.org/NoAuth/Bugs.html?Dist=POE-Component-Client-HTTP> or mail <mailto:bug-POE-Component-Client-HTTP@rt.cpan.org>

For questions, try the POE mailing list (poe@perl.org)

Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 POE::COMPONENT::CLIENT::HTTP::REQUEST (3) 2013-05-06

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