OpenFrame::Cookies - An abstract cookie class


OpenFrame documentation  | view source Contained in the OpenFrame distribution.

Index


NAME

Top

OpenFrame::Cookies - An abstract cookie class

SYNOPSIS

Top

  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

Top

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

Top

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

Top

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


OpenFrame documentation  | view source Contained in the OpenFrame distribution.