NAME
AxKit::XSP::Global - Application global variables tag library for AxKit eXtensible Server Pages.
SYNOPSIS
Add the global: namespace to your XSP <xsp:page> tag:
<xsp:page
language="Perl"
xmlns:xsp="http://apache.org/xsp/core/v1"
xmlns:global="http://www.creITve.de/2002/XSP/Session"
>Add this taglib to AxKit (via httpd.conf or .htaccess):
AxAddXSPTaglib AxKit::XSP::GlobalDESCRIPTION
The XSP globals taglib provides basic application global variable operations to XSP similar to the Cocoon2 Session taglib specification. The global variables provided by this taglib have limited persistance. They may get removed on server restarts or storage cleanups. Don't use them for persistent data which belongs into some kind of tatabase. Example uses: tracking of logged in users (The Auth taglib does that), accumulating daily statistics, changing global application state for limited time.
This taglib works in conjunction with Apache::AxKit::Plugin::Session, which does all the hard work. There are several configuration variants available, see the man page for details.
Tag Reference
All tags returning a value look at the attribute 'as' to determine the type of result. If it equals 'node', the result gets placed inside an XML node with a name like the original tag minus 'get-'. Any other value results in a behaviour similar to putting <xsp:expr> around the string representation of the output, which means that usually the right thing happens.
Tags that return a list create multiple XML nodes (for 'as="node"') or a concatenation of the values without any separator.
Tags that use their contents as input should only get text nodes (including <xsp:expr>-style tags). Attribute nodes as mentioned in the description may be used, of course.
All tags ignore leading and trailing white space.
<global:get-attribute>
This tag retrieves an attribute value. It accepts either an attribute or child node called 'name'. The value passed as 'name' determines the key to retrieve data from the global storage.
<global:set-attribute>
This tag sets an attribute value. It accepts either an attribute or child node called 'name'. The value passed in 'name' determines the key to store the contents of this tag into the global storage.
<global:get-creation-time>
Returns the time the current storage got created. This can happen after server restarts or after 'hot' storage cleanups. For this tag, the "as" attribute has two more values: 'long' (default) returns the time as seconds since 1970-01-01, 00:00 UTC; 'string' returns a textual representation of the date and time.
<global:remove-attribute>
Removes an attribute from the global storage. It accepts either an attribute or child node called 'name' which indicates which attribute to remove.
BUGS
This software has beta quality. Use with care and contact the author if any problems occur.
AUTHOR
Jörg Walter <jwalt@cpan.org>
COPYRIGHT
Copyright (c) 2002 Jörg Walter. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
SEE ALSO
AxKit, Apache::Session, Apache::AxKit::Plugin::Session, AxKit::XSP::Auth, AxKit::XSP::Session, Cocoon2 Session Logicsheet http://xml.apache.org/cocoon2/userdocs/xsp/session.html
1 POD Error
The following errors were encountered while parsing the POD:
- Around line 140:
Non-ASCII character seen before =encoding in 'Jörg'. Assuming CP1252