www.LinuxHowtos.org howtos, tips&tricks and tutorials for linux

from small one page howto to huge articles all in one place

Other .linuxhowtos.org sites:toolsntoys.linuxhowtos.org
gentoo.linuxhowtos.org

poll results

Last additions:

using iotop to find disk usage hogs

words:

887

views:

20251

userrating:

average rating: 3.4 (205 votes) (1=very good 6=terrible)

May 25th. 2007:

Words

486

Views

36026

why adblockers are bad

Workaround and fixes for the current Core Dump Handling vulnerability affected kernels

words:

161

views:

20991

userrating:

average rating: 1.0 (50 votes) (1=very good 6=terrible)

April, 26th. 2006:

Words

Views

16061

New subdomain: toolsntoys.linuxhowtos.org

You are here: manpages

HTTP::Proxy::HeaderFilter

Section: User Contributed Perl Documentation (3)
Updated: 2010-03-30
Index Return to Main Contents

NAME

HTTP::Proxy::HeaderFilter - A base class for HTTP message header filters

SYNOPSIS

    package MyFilter;

    use base qw( HTTP::Proxy::HeaderFilter );

    # changes the User-Agent header in all requests
    # this filter must be pushed on the request stack
    sub filter {
        my ( $self, $headers, $message ) = @_;

        $message->headers->header( User_Agent => 'MyFilter/1.0' );
    }

    1;

DESCRIPTION

The HTTP::Proxy::HeaderFilter class is used to create filters for HTTP request/response headers.

Creating a HeaderFilter

A HeaderFilter is just a derived class that implements some methods called by the proxy. Of all the methods presented below, only "filter()" must be defined in the derived class.

filter()

The signature of the filter() method is the following:

    sub filter { my ( $self, $headers, $message) = @_; ... }

where $self is the filter object, $headers is a HTTP::Headers object, and $message is either a HTTP::Request or a HTTP::Response object.

The $headers HTTP::Headers object is the one that will be sent to the client (if the filter is on the response stack) or origin server (if the filter is on the request stack). If $headers is modified by the filter, the modified headers will be sent to the client or server.

The init() method (if it exists) is called by the new() constructeur to perform all initisalisation tasks. It's called once in the filter lifetime.

A HTTP::Proxy::HeaderFilter object is a blessed hash, and the base class reserves only hash keys that start with "_hphf".

new()

The constructor is defined for all subclasses. Initialisation tasks (if any) for subclasses should be done in the "init()" method (see below).

init()

This method is called by the "new()" constructeur to perform all initisalisation tasks. It's called once in the filter lifetime.

It receives all the parameters passed to "new()".

Standard HeaderFilters

Standard HTTP::Proxy::HeaderFilter classes are lowercase.

The following HeaderFilters are included in the HTTP::Proxy distribution:

simple: This class lets you create a simple header filter from a code reference.
standard: This is the filter that provides standard headers handling for HTTP::Proxy. It is loaded automatically by HTTP::Proxy.

Please read each filter's documentation for more details about their use.

USEFUL METHODS FOR SUBCLASSES

Some methods are available to filters, so that they can eventually use the little knowledge they might have of HTTP::Proxy's internals. They mostly are accessors.