Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   31170 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

POE::Component::ClientUserTContributedPOE::Component::Client::HTTP::Request(3)

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

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

       · Copyright 2004-2005 Martijn van Beers

       · 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
       <http://rt.cpan.org/NoAuth/Bugs.html?Dist=POE-Component-Client-HTTP> or
       mail mailto:bug-POE-Component-Client-HTTP@rt.cpan.org <mailto:bug-POE-
       Component-Client-HTTP@rt.cpan.org>

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

perl v5.14.1			  2010POE::Component::Client::HTTP::Request(3)

Vote for polarhome