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

       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.

       None are currently known.

newNAMED_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.

       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)

perl v5.36.0                                       2022-11-19              POE::Component...::HTTP::Request(3pm)

       Your name could be here.

       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.

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_contentPARSED_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.

   timerTIMER
       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_timerTIMEOUT
       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.

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

   does_redirectSOMETHING
       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.

   close_connection
       Each active request object contains an internal connection.  This method closes it.

   send_to_wheel
       Transmit the request to the socket associated with this request.

   wheel
       An accessor to return the wheel associated with this request.

   errorERROR_CODE,ERROR_MESSAGE
       Generate an error response, and post it back to the user's session.

   connect_errorCONNECT_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.

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

       POE::Component::Client::HTTP POE

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

       version 0.949