cache::memcached::managed::multi(3pm) [debian man page]

Cache::Memcached::Managed::Multi(3pm)			User Contributed Perl Documentation		     Cache::Memcached::Managed::Multi(3pm)

NAME

       Cache::Memcached::Managed::Multi - multiple Cache::Memcache::Managed objects

SYNOPSIS

	use Cache::Memcached::Managed::Multi;

	my $multi = Cache::Memcached::Managed::Multi->new( @managed );

DESCRIPTION

       Provides the same API as Cache::Memcached::Managed, but applies all methods called to all of the objects specified, except for new and
       objects.

CONTEXT

       All methods are called on all of the Cache::Memcached::Managed objects in the same context (list, scalar or void) in which the method is
       called on the Cache::Memcached::Managed::Multi object.  The return value differs in format depending on the context also:

       scalar
	  my $listref = $multi->method;
	  print "Result: @{$listref}
";

	 When called in scalar context, a list ref with scalar values is returned in the same order in which the objects are used (which is
	 determined by the order in which they were supplied with new and returned by objects..

       list
	  my @listref = $multi->method;
	  print "Result $_: @{$listref[$_]}
" foreach 0..$#listref;

	 When called in list context, a list of list references is returned in the same order in which the objects are used (which is determined
	 by the order in which they were supplied with new and returned by objects.

       void
	  $multi->method;

	 When called in void context, nothing is returned (not strangely enough ;-).

SPECIFIC CLASS METHODS

       There is only one specific class method.

   new
	my $multi = Cache::Memcached::Managed::Multi->new( @managed );

       Create an object containing multiple Cache::Memcached::Managed objects.	Returns the instantiated object.

SPECIFIC INSTANCE METHODS

   objects
	my @managed = $multi->objects;

       Returns the list of instantiated Cache::Memcached::Managed objects that the object is a proxy for.

AUTHOR

	Elizabeth Mattijsen

COPYRIGHT

       (C) 2005 - 2006 BOOKINGS (C) 2007 BOOKING.COM

       This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by
       the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

       This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.

       You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation,
       Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.

perl v5.14.2							    2012-05-24				     Cache::Memcached::Managed::Multi(3pm)

Data::ObjectDriver::Driver::Cache::Apache(3pm)		User Contributed Perl Documentation	    Data::ObjectDriver::Driver::Cache::Apache(3pm)

NAME

       Data::ObjectDriver::Driver::Cache::Apache - object driver for caching objects in Apache's request space

SYNOPSIS

	   package MyObject;
	   use base qw( Data::ObjectDriver::BaseObject );

	   __PACKAGE__->install_properties({
	       ...
	       driver => Data::ObjectDriver::Driver::Cache::Apache->new(
		   fallback => Data::ObjectDriver::Driver::Cache::Memcached->new(
		       cache	=> Cache::Memcached->new({ servers => @MEMCACHED_SERVERS }),
		       fallback => Data::ObjectDriver::Driver::DBI->new( @$DBI_INFO ),
		   ),
	       ),
	       ...
	   });

	   1;

DESCRIPTION

       Data::ObjectDriver::Driver::Cache::Apache provides automatic caching of retrieved objects in the per-request memory space of your Apache
       mod_perl processes, when used in conjunction with your actual object driver. It can be used to provide even faster results over memcached
       when requesting objects that have already been requested during the same request by some other part of your application, at the cost of the
       memory necessary to store the objects.

       If your models can be used in an Apache mod_perl application as well as another context such as a command line shell, consider replacing
       the Apache layer of your caching with a "Data::ObjectDriver::Driver::Cache::RAM" layer when Apache is not available. See
       Data::ObjectDriver::Driver::Cache::Apache.

USAGE

       o   Data::ObjectDriver::Driver::Cache::Apache->new(%params)

	   Required members of %params are:

	   o   "fallback"

	       The "Data::ObjectDriver" object driver from which to request objects that are not found in the Apache process cache.

DIAGNOSTICS

       The Apache driver provides integration with the "Data::ObjectDriver" debug and profiling systems. As these systems are designed around SQL
       queries, synthetic queries are logged to represent caching operations. The operations generated by this driver are:

       o   "APACHECACHE_GET ?"

	   Retrieve an object. The argument is the cache key for the requested object.

       o   "APACHECACHE_ADD ?,?"

	   Add an object to the cache. The arguments are the cache key for the object and the flattened representation of the object to cache.

       o   "APACHECACHE_SET ?,?"

	   Put an object in the cache. The arguments are the cache key for the object and the flattened representation of the object to cache.

       o   "APACHECACHE_DELETE ?"

	   Remove an object from the cache. The argument is the cache key for the object to invalidate.

SEE ALSO

       Apache, Apache2::RequestUtil

LICENSE

       Data::ObjectDriver is free software; you may redistribute it and/or modify it under the same terms as Perl itself.

AUTHOR &; COPYRIGHT
       Except where otherwise noted, Data::ObjectDriver is Copyright 2005-2006 Six Apart, cpan@sixapart.com. All rights reserved.

perl v5.12.4							    2011-08-29			    Data::ObjectDriver::Driver::Cache::Apache(3pm)