NAME
HTML::StickyQuery - add sticky QUERY_STRING
SYNOPSIS
use HTML::StickyQuery;
# create an object
my $s = HTML::StickyQuery->new(
regexp => '\.cgi$',
abs => 0,
keep_original => 1,
);
print $s->sticky(
file => 'foo.html',
param => { SESSIONID => 'xxx' }
);
or
my $q = CGI->new;
print $s->sticky(
file => 'foo.html',
param => $q,
sticky_keys => [qw(SESSIONID)]
);
DESCRIPTION
this module is a sub class of the HTML::Parser manpage. parse HTML
document and add QUERY_STRING to href attributes. Handy for maintaining
state without cookie or something, transparently.
if you want to use sticky CGI data via FORM. it is better to use the
HTML::FillInForm manpage.
CONSTRUCTOR
new(%option)
constructor of HTML::StickyQuery object. the options are below.
abs add QUERY_STRING to absolute URI or not. (default: 0)
override this option is obsolete. please use keep_original option.
keep_original
keep original QUERY_STRING or not. (default: 1) when this
option is false. all old QUERY_STRING is removed.
regexp regular expression of affected URI. (default: *none*)
METHODS
sticky(%options)
parse HTML and add QUERY_STRING. return HTML document. the options
are below.
file specify the HTML file.
scalarref
specify the HTML document as scalarref.
arrayref specify the HTML document as arrayref.
param QUERY_STRING data. as hashref or object which implements *param*
method. (eg. CGI, Apache::Request)
sticky_keys
specify sticky data keys as arrayref. any keys which are not in
this list are ignored. if not specified, all keys are kept.
EXAMPLES
KEEP SESSION ID
typical example of CGI application using session.
use the Apache::Session>,L
Session Test
COUNT:
countup