NAME
    Apache2::DirBasedHandler - Directory based Location Handler helper

VERSION
    version 0.01

SYNOPSIS
    package My::Thingy

    use strict use Apache2::DirBasedHandler our @ISA =
    qw(Apache2::DirBasedHandler); use Apache2::Const -compile =>
    qw(:common);

    sub index { my $self = shift; my ($r,$uri_args,$args) = @_;

        if (@$uri_args) {
            return Apache2::Const::NOT_FOUND;
        }

        return (
            Apache2::Const::OK,
            qq[this is the index],
            qq[text/plain; charset=utf-8]
        );
    }

    sub super_page { my $self = shift; my ($r,$uri_args,$args) = @_;

        return (
            Apache2::Const::OK,
            qq[this is $location/super and all it's contents],
            qq[text/plain; charset=utf-8]
        );
    }

    sub super_dooper_page { my $self = shift; my ($r,$uri_args,$args) = @_;

        return (
            Apache2::Const::OK,
            qq[this is $location/super/dooper and all it's contents],
            qq[text/plain; charset=utf-8]
        );
    }

    1;

DESCRIPTION
    This module is designed to allow people to more quickly implement uri to
    function style handlers

  handler
    the uri is cut up into bits, then the first argument is used to
    determine what page the user is after, so a function is called based on
    that argument. The rest of the uri, the request object, and all our
    template crap are then passed into that function. If there is no uri, a
    base function called index_page is called (which you really want to
    subclass)

  init
    The init function is used to stuff other things into the page function
    calls. it should probably return a hash reference to be the most useful.

  parse_uri
    takes an Apache::RequestRec (or derived) object, and returns a reference
    to an array of all the non-slash parts of the uri. It strips repeated
    slashes in the same manner that they would be stripped if you do a
    request for static content

  index
    index is the function called when someone requests the absolute root of
    the location you are talking about