OpenFrame::Cookies.3pm

Langue: en

Autres versions - même langue

Version: 2004-08-05 (fedora - 01/12/10)

Section: 3 (Bibliothèques de fonctions)

NAME

OpenFrame::Cookies - An abstract cookie class

SYNOPSIS

   use OpenFrame;
   my $cookies = OpenFrame::Cookies->new();
   $cookies->set("animal" => "parrot");
   my $colour = $cookies->get("colour")->value;
   $cookies->delete("colour");
   my %cookies = $cookies->get_all();
 
 

DESCRIPTION

"OpenFrame::Cookies" represents cookies inside OpenFrame. Cookies in OpenFrame represent some kind of storage option on the requesting side.

Cookies are a general mechanism which server side connections can use to both store and retrieve information on the client side of the connection. The addition of a simple, persistent, client-side state significantly extends the capabilities of Web-based client/server applications. "OpenFrame::Cookies" is an abstract cookie class for OpenFrame which can represent cookies no matter how they really come to exist outside OpenFrame (such as CGI or Apache cookie objects).

METHODS

new()

The new() method creates a new "OpenFrame::Cookies" object. These can hold multiple cookies (although they must have unique names) inside the cookie tin.
   my $cookies = OpenFrame::Cookies->new();
 
 

set()

The set() method adds an entry:
   $cookies->set("animal" => "parrot");
 
 

get()

The get() method returns a cookie (a "OpenFrame::Cookie" object) given its name:
   my $colour = $cookies->get("colour")->value;
 
 

delete()

The delete() method removes a cookie element given its name:
   $cookies->delete("colour");
 
 

get_all()

The get_all() method returns a hash of all the cookies:
   my %cookies = $cookies->get_all();
 
 

AUTHOR

James Duncan <jduncan@fotango.com>, Leon Brocard <leon@fotango.com>