Lines Matching refs:to
22 sub will_modify { 1 } # by default, we expect the filter to modify data
48 The L<HTTP::Proxy::BodyFilter> class is used to create filters for
68 where C<$self> is the filter object, C<$dataref> is a reference to the chunk
70 C<$message> is a reference to either a L<HTTP::Request> or a L<HTTP::Response>
71 object, and C<$protocol> is a reference to the L<LWP::Protocol> protocol object.
77 C<$buffer> is a reference to a buffer where some of the unprocessed data
79 a buffer to store data for a later use> for details). Thanks to the
82 It is possible to access the headers of the message with
84 that was sent to the client
89 Since C<$dataref> is a I<reference> to the data string, the referent
103 This method is called by the C<new()> constructeur to perform all
106 It receives all the parameters passed to C<new()>.
110 Some filters might require initialisation before they are able to handle
112 will call it before sending data to the C<filter()> method.
128 will call it after it has finished sending data to the C<filter()> method.
144 =head2 Using a buffer to store data for a later use
152 It would be extremely complicated and error-prone to let each filter
154 handles this too. The proxy passes to each filter, each time it is called,
155 a reference to an empty string (C<$buffer> in the above signature) that
156 the filter can use to store some data for next run.
159 store any data, because this is the very last run, needed to gather
162 It is recommended to store as little data as possible in the buffer,
163 so as to avoid (badly) reproducing what L<HTTP::Proxy::BodyFilter::complete>
166 In particular, you have to remember that all the data that remains in
168 server will be sent back to your filter in one big piece.
173 which need to have the whole message body to work. It's enabled simply by
177 on to the following filter once the full message body has been received.
210 Store the message body to a file.
215 some actions to be taken only when the full page has been received
230 Some methods are available to filters, so that they can eventually use
238 Gets a reference to the L<HTTP::Proxy> objects that owns the filter.
239 This gives access to some of the proxy methods.