alzabo::runtime::uniquerowcache(3pm) [debian man page]

Alzabo::Runtime::UniqueRowCache(3pm)			User Contributed Perl Documentation		      Alzabo::Runtime::UniqueRowCache(3pm)

NAME

       Alzabo::Runtime::UniqueRowCache - Implements a row cache for Alzabo

SYNOPSIS

	 use Alzabo::Runtime::UniqueRowCache;

	 Alzabo::Runtime::UniqueRowCache->clear();

DESCRIPTION

       This is a very simple caching mechanism for "Alzabo::Runtime::Row" objects that tries to ensure that for there is never more than one row
       object in memory for a given database row.

       To use it, simply load it.

       It can be foiled through the use of "Storable" or other "deep magic" cloning code, like in the "Clone" module.

       The cache is a simple hash kept in memory.  If you use this module, you are responsible for clearing the cache as needed.  The only time it
       is cleared automatically is when a table update or delete is performed, in which case all cached rows for that table are cleared.

       In a persistent environment like mod_perl, you should clear the cache on a regular basis in order to prevent the cache from getting out of
       sync with the database.	A good way to do this is to clear it at the start of every request.

METHODS

       All methods provided are class methods.

       * clear
	   This clears the entire cache

       * clear_table( $table_object )
	   Given a table object, this method clears all the cached rows from that table.

       * row_in_cache( $table_name, $row_id )
	   Given a table name and a row id, as returned by the "Alzabo::Runtime::Row->id_as_string" method, this method returns the matching row
	   from the cache, if it exists.  Otherwise it returns undef.

       * delete_from_cache( $table_name, $row_id )
	   Given a table name and a row id, as returned by the "Alzabo::Runtime::Row->id_as_string" method, this method returns the matching row
	   from the cache.

       * write_to_cache( $row_object )
	   Given a row object, this method stores it in the cache.

AVOIDING THE CACHE

       If you want to not cache a row, then you can pass the "no_cache" parameter to any table or schema method that creates a new row object or a
       cursor, such as "Alzabo::Runtime::Table->insert()", "Alzabo::Runtime::Table->rows_where()".

AUTHOR

       Dave Rolsky, <autarch@urth.org>

perl v5.8.8							    2007-12-23				      Alzabo::Runtime::UniqueRowCache(3pm)

Check Out this Related Man Page

Alzabo::Runtime::InsertHandle(3pm)			User Contributed Perl Documentation			Alzabo::Runtime::InsertHandle(3pm)

NAME

       Alzabo::Runtime::InsertHandle - A handle representing an insert

SYNOPSIS

	my $handle =
	    $table->insert_handle
		( columns => [ $table->columns( 'name', 'job' ) ] );

	my $faye_row =
	    $handle->insert( values =>
			     { name => 'Faye',
			       job => 'HK Pop Chanteuse' } );

	my $guesch_row =
	    $handle->insert( values =>
			     { name => 'Guesch',
			       job => 'French Chanteuse and Dancer' } );

DESCRIPTION

       This object is analogous to a DBI statement handle, and can be used to insert multiple rows into a table more efficiently than repeatedly
       calling "Alzabo::Runtime::Table->insert()".

METHODS

       Objects of this class provide one public method:

       insert

       This method is used to insert a new row into a table.

       It accepts the following parameters:

       * values
	   This should be a hash reference containing the values to be inserted into the table.

	   If no value is given for a primary key column and the column is "sequenced" then the primary key will be auto-generated.

	   If values are not provided for other columns which were given when "Alzabo::Runtime::Table->insert_handle" was called, this method
	   first checks to see if a value was provided for the column when "Alzabo::Runtime::Table->insert_handle" was called.	If none was pro-
	   vided, then the column's default value is used.

	   If column values were passed to "Alzabo::Runtime::Table->insert_handle", then these can be overridden by values passed to this method.

	   It is not possible to override column values that were given as SQL functions when "Alzabo::Runtime::Table->insert_handle" was called.

       This method returns a new "Alzabo::Runtime::Row" object.

       Throws: "Alzabo::Exception::Logic", "Alzabo::Exception::Params"

perl v5.8.8							    2007-12-23					Alzabo::Runtime::InsertHandle(3pm)

Linux and UNIX Man Pages

alzabo::runtime::uniquerowcache(3pm) [debian man page]

Check Out this Related Man Page