poe::filter::httpchunk(3pm) [debian man page]
POE::Filter::HTTPChunk(3pm) User Contributed Perl Documentation POE::Filter::HTTPChunk(3pm) my $TEXT = qr/[^[:cntrl:]]/o; my $qdtext = qr/[^[:cntrl:]"]/o; #<any TEXT except <">> my $quoted_pair = qr/\[[:ascii:]]/o; my $quoted_string = qr/"(?:$qdtext|$quoted_pair)"/o; my $separators = "[^()<>@,;:\"/[]?={} "; my $notoken = qr/(?:[[:cntrl:]$separators]/o; my $chunk_ext_name = $token; my $chunk_ext_val = qr/(?:$token|$quoted_string)/o; my $chunk_extension = qr/(?:;$chunk_ext_name(?:$chunk_ext_val)?)/o; sub put { die "not implemented yet"; } NAME
POE::Filter::HTTPChunk - Non-blocking incremental HTTP chunk parser. VERSION
version 0.947 SYNOPSIS
# Not a complete program. use POE::Filter::HTTPChunk; use POE::Wheel::ReadWrite; sub setup_io { $_[HEAP]->{io_wheel} = POE::Wheel::ReadWrite->new( Filter => POE::Filter::HTTPChunk->new(), # See POE::Wheel::ReadWrite for other required parameters. ); } DESCRIPTION
This filter parses HTTP chunks from a data stream. It's used by POE::Component::Client::HTTP to do the bulk of the low-level HTTP parsing. CONSTRUCTOR
new "new" takes no parameters and returns a shiny new POE::Filter::HTTPChunk object ready to use. METHODS
POE::Filter::HTTPChunk supports the following methods. Most of them adhere to the standard POE::Filter API. The documentation for POE::Filter explains the API in more detail. get_one_start ARRAYREF Accept an arrayref containing zero or more raw data chunks. They are added to the filter's input buffer. The filter will attempt to parse that data when get_one() is called. $filter_httpchunk->get_one_start(@stream_data); get_one Parse a single HTTP chunk from the filter's input buffer. Data is entered into the buffer by the get_one_start() method. Returns an arrayref containing zero or one parsed HTTP chunk. $ret_arrayref = $filter_httpchunk->get_one(); get_pending Returns an arrayref of stream data currently pending parsing. It's used to seamlessly transfer unparsed data between an old and a new filter when a wheel's filter is changed. $pending_arrayref = $filter_httpchunk->get_pending(); SEE ALSO
POE::Filter, POE. BUGS
None are known at this time. AUTHOR &; COPYRIGHTS POE::Filter::HTTPChunk is... o Copyright 2005-2006 Martijn van Beers o Copyright 2006 Rocco Caputo All rights are reserved. POE::Filter::HTTPChunk is free software; you may redistribute it and/or modify it under the same terms as Perl itself. 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.2 2012-06-03 POE::Filter::HTTPChunk(3pm)
Check Out this Related Man Page
POE::Component::Client::HTTP::Request(3pm) User Contributed Perl Documentation POE::Component::Client::HTTP::Request(3pm) NAME
POE::Component::Client::HTTP::Request - an HTTP request class VERSION
version 0.947 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 <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.2 2012-06-03 POE::Component::Client::HTTP::Request(3pm)