data::objectdriver::profiler(3pm) [debian man page]

Data::ObjectDriver::Profiler(3pm)			User Contributed Perl Documentation			 Data::ObjectDriver::Profiler(3pm)

NAME

       Data::ObjectDriver::Profiler - Query profiling

SYNOPSIS

	   my $profiler = Data::ObjectDriver->profiler;

	   my $stats = $profiler->statistics;
	   my $total = $stats->{'DBI:total_queries'};

	   my $log = $profiler->query_log;

	   $profiler->reset;

USAGE

   $Data::ObjectDriver::PROFILE
       To turn on profiling, set $Data::ObjectDriver::PROFILE to a true value.	Alternatively, you can set the DOD_PROFILE environment variable to
       a true value before starting your application.

   Data::ObjectDriver->profiler
       Profiling is global to Data::ObjectDriver, so the Profiler object is a global instance variable. To get it, call
       Data::ObjectDriver->profiler, which returns a Data::ObjectDriver::Profiler object.

   $profiler->statistics
       Returns a hash reference of statistics about the queries that have been executed.

   $profiler->query_log
       Returns a reference to an array of SQL queries as they were handed off to DBI. This means that placeholder variables are not substituted,
       so you'll end up with queries in the query log like "SELECT title, difficulty FROM recipe WHERE recipe_id = ?".

   $profiler->query_frequency
       Returns a reference to a hash containing, as keys, all of the SQL statements in the query log, where the value for each of the keys is a
       number representing the number of times the query was executed.

   $profiler->reset
       Resets the statistics and the query log.

   $profiler->total_queries
       Returns the total number of queries currently logged in the profiler.

   $profiler->report_queries_by_type
       Returns a string containing a pretty report of information about the current number of each type of query in the profiler (e.g. "SELECT",
       "INSERT").

   $profiler->report_query_frequency
       Returns a string containing a pretty report of information about the current query frequency information in the profiler.

perl v5.12.4							    2011-08-29					 Data::ObjectDriver::Profiler(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)