blob: bb666bf5905ead0a2933f241d00c50da032f6815 [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!--NewPage-->
<HTML>
<HEAD>
<!-- Generated by javadoc (build 1.5.0_06) on Wed Jul 19 14:45:43 EDT 2006 -->
<TITLE>
DataRowStore (Apache Cayenne API Documentation - v.2.0-incubating-SNAPSHOT)
</TITLE>
<META NAME="keywords" CONTENT="org.apache.cayenne.access.DataRowStore class">
<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../apache-javadoc.css" TITLE="Style">
<SCRIPT type="text/javascript">
function windowTitle()
{
parent.document.title="DataRowStore (Apache Cayenne API Documentation - v.2.0-incubating-SNAPSHOT)";
}
</SCRIPT>
<NOSCRIPT>
</NOSCRIPT>
</HEAD>
<BODY BGCOLOR="white" onload="windowTitle();">
<!-- ========= START OF TOP NAVBAR ======= -->
<A NAME="navbar_top"><!-- --></A>
<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_top_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
<TR ALIGN="center" VALIGN="top">
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-files/index-1.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
</TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>
<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="../../../../org/apache/cayenne/access/DataPortDelegate.html" title="interface in org.apache.cayenne.access"><B>PREV CLASS</B></A>&nbsp;
&nbsp;<A HREF="../../../../org/apache/cayenne/access/DbGenerator.html" title="class in org.apache.cayenne.access"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../../index.html?org/apache/cayenne/access/DataRowStore.html" target="_top"><B>FRAMES</B></A> &nbsp;
&nbsp;<A HREF="DataRowStore.html" target="_top"><B>NO FRAMES</B></A> &nbsp;
&nbsp;<SCRIPT type="text/javascript">
<!--
if(window==top) {
document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>');
}
//-->
</SCRIPT>
<NOSCRIPT>
<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>
</NOSCRIPT>
</FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;<A HREF="#field_summary">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL:&nbsp;<A HREF="#field_detail">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<A NAME="skip-navbar_top"></A>
<!-- ========= END OF TOP NAVBAR ========= -->
<HR>
<!-- ======== START OF CLASS DATA ======== -->
<H2>
<FONT SIZE="-1">
org.apache.cayenne.access</FONT>
<BR>
Class DataRowStore</H2>
<PRE>
java.lang.Object
<IMG SRC="../../../../resources/inherit.gif" ALT="extended by "><B>org.apache.cayenne.access.DataRowStore</B>
</PRE>
<DL>
<DT><B>All Implemented Interfaces:</B> <DD>java.io.Serializable</DD>
</DL>
<HR>
<DL>
<DT><PRE>public class <B>DataRowStore</B><DT>extends java.lang.Object<DT>implements java.io.Serializable</DL>
</PRE>
<P>
A fixed size cache of DataRows keyed by ObjectId.
<p>
<strong>Synchronization Note: </strong> DataRowStore synchronizes most operations on
its own instance.
</p>
<P>
<P>
<DL>
<DT><B>Since:</B></DT>
<DD>1.1</DD>
<DT><B>Author:</B></DT>
<DD>Andrei Adamchik</DD>
<DT><B>See Also:</B><DD><A HREF="../../../../serialized-form.html#org.apache.cayenne.access.DataRowStore">Serialized Form</A></DL>
<HR>
<P>
<!-- =========== FIELD SUMMARY =========== -->
<A NAME="field_summary"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
<B>Field Summary</B></FONT></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;java.lang.String</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/cayenne/access/DataRowStore.html#EVENT_BRIDGE_FACTORY_DEFAULT">EVENT_BRIDGE_FACTORY_DEFAULT</A></B></CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;java.lang.String</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/cayenne/access/DataRowStore.html#EVENT_BRIDGE_FACTORY_PROPERTY">EVENT_BRIDGE_FACTORY_PROPERTY</A></B></CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>protected &nbsp;<A HREF="../../../../org/apache/cayenne/event/EventManager.html" title="class in org.apache.cayenne.event">EventManager</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/cayenne/access/DataRowStore.html#eventManager">eventManager</A></B></CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>protected &nbsp;<A HREF="../../../../org/apache/cayenne/event/EventSubject.html" title="class in org.apache.cayenne.event">EventSubject</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/cayenne/access/DataRowStore.html#eventSubject">eventSubject</A></B></CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>protected &nbsp;java.lang.String</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/cayenne/access/DataRowStore.html#name">name</A></B></CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>protected &nbsp;boolean</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/cayenne/access/DataRowStore.html#notifyingRemoteListeners">notifyingRemoteListeners</A></B></CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;boolean</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/cayenne/access/DataRowStore.html#REMOTE_NOTIFICATION_DEFAULT">REMOTE_NOTIFICATION_DEFAULT</A></B></CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;java.lang.String</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/cayenne/access/DataRowStore.html#REMOTE_NOTIFICATION_PROPERTY">REMOTE_NOTIFICATION_PROPERTY</A></B></CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>protected &nbsp;<A HREF="../../../../org/apache/cayenne/event/EventBridge.html" title="class in org.apache.cayenne.event">EventBridge</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/cayenne/access/DataRowStore.html#remoteNotificationsHandler">remoteNotificationsHandler</A></B></CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/cayenne/access/DataRowStore.html#SNAPSHOT_CACHE_SIZE_DEFAULT">SNAPSHOT_CACHE_SIZE_DEFAULT</A></B></CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;java.lang.String</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/cayenne/access/DataRowStore.html#SNAPSHOT_CACHE_SIZE_PROPERTY">SNAPSHOT_CACHE_SIZE_PROPERTY</A></B></CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;long</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/cayenne/access/DataRowStore.html#SNAPSHOT_EXPIRATION_DEFAULT">SNAPSHOT_EXPIRATION_DEFAULT</A></B></CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;java.lang.String</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/cayenne/access/DataRowStore.html#SNAPSHOT_EXPIRATION_PROPERTY">SNAPSHOT_EXPIRATION_PROPERTY</A></B></CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>protected &nbsp;org.apache.commons.collections.map.LRUMap</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/cayenne/access/DataRowStore.html#snapshotLists">snapshotLists</A></B></CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>protected &nbsp;org.apache.commons.collections.map.LRUMap</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/cayenne/access/DataRowStore.html#snapshots">snapshots</A></B></CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
</TR>
</TABLE>
&nbsp;
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
<A NAME="constructor_summary"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
<B>Constructor Summary</B></FONT></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><B><A HREF="../../../../org/apache/cayenne/access/DataRowStore.html#DataRowStore(java.lang.String)">DataRowStore</A></B>(java.lang.String&nbsp;name)</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Creates new named DataRowStore with default configuration.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><B><A HREF="../../../../org/apache/cayenne/access/DataRowStore.html#DataRowStore(java.lang.String, java.util.Map)">DataRowStore</A></B>(java.lang.String&nbsp;name,
java.util.Map&nbsp;properties)</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Creates new DataRowStore with a specified name and a set of properties.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><B><A HREF="../../../../org/apache/cayenne/access/DataRowStore.html#DataRowStore(java.lang.String, java.util.Map, org.apache.cayenne.event.EventManager)">DataRowStore</A></B>(java.lang.String&nbsp;name,
java.util.Map&nbsp;properties,
<A HREF="../../../../org/apache/cayenne/event/EventManager.html" title="class in org.apache.cayenne.event">EventManager</A>&nbsp;eventManager)</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Creates new DataRowStore with a specified name and a set of properties.</TD>
</TR>
</TABLE>
&nbsp;
<!-- ========== METHOD SUMMARY =========== -->
<A NAME="method_summary"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
<B>Method Summary</B></FONT></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/cayenne/access/DataRowStore.html#cacheSnapshots(java.lang.String, java.util.List)">cacheSnapshots</A></B>(java.lang.String&nbsp;key,
java.util.List&nbsp;snapshots)</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Registers a list of snapshots with internal cache, using a String key.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/cayenne/access/DataRowStore.html#clear()">clear</A></B>()</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Expires and removes all stored snapshots without sending any notification events.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/cayenne/access/DataRowStore.html#forgetSnapshot(org.apache.cayenne.ObjectId)">forgetSnapshot</A></B>(<A HREF="../../../../org/apache/cayenne/ObjectId.html" title="class in org.apache.cayenne">ObjectId</A>&nbsp;id)</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Evicts a snapshot from cache without generating any SnapshotEvents.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;<A HREF="../../../../org/apache/cayenne/DataRow.html" title="class in org.apache.cayenne">DataRow</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/cayenne/access/DataRowStore.html#getCachedSnapshot(org.apache.cayenne.ObjectId)">getCachedSnapshot</A></B>(<A HREF="../../../../org/apache/cayenne/ObjectId.html" title="class in org.apache.cayenne">ObjectId</A>&nbsp;oid)</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns cached snapshot or null if no snapshot is currently cached for the given
ObjectId.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;java.util.List</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/cayenne/access/DataRowStore.html#getCachedSnapshots(java.lang.String)">getCachedSnapshots</A></B>(java.lang.String&nbsp;key)</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns a list of previously cached snapshots.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;<A HREF="../../../../org/apache/cayenne/event/EventManager.html" title="class in org.apache.cayenne.event">EventManager</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/cayenne/access/DataRowStore.html#getEventManager()">getEventManager</A></B>()</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns an EventManager associated with this DataRowStore.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;java.lang.String</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/cayenne/access/DataRowStore.html#getName()">getName</A></B>()</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the name of this DataRowStore.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;<A HREF="../../../../org/apache/cayenne/DataRow.html" title="class in org.apache.cayenne">DataRow</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/cayenne/access/DataRowStore.html#getSnapshot(org.apache.cayenne.ObjectId, org.apache.cayenne.access.QueryEngine)">getSnapshot</A></B>(<A HREF="../../../../org/apache/cayenne/ObjectId.html" title="class in org.apache.cayenne">ObjectId</A>&nbsp;oid,
<A HREF="../../../../org/apache/cayenne/access/QueryEngine.html" title="interface in org.apache.cayenne.access">QueryEngine</A>&nbsp;engine)</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<B>Deprecated.</B>&nbsp;<I>since 1.2 unused, as DataRowStore no longer performs queries on its
own.</I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;<A HREF="../../../../org/apache/cayenne/event/EventSubject.html" title="class in org.apache.cayenne.event">EventSubject</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/cayenne/access/DataRowStore.html#getSnapshotEventSubject()">getSnapshotEventSubject</A></B>()</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns EventSubject used by this SnapshotCache to notify of snapshot changes.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>protected &nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/cayenne/access/DataRowStore.html#initWithProperties(java.util.Map)">initWithProperties</A></B>(java.util.Map&nbsp;properties)</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;boolean</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/cayenne/access/DataRowStore.html#isNotifyingRemoteListeners()">isNotifyingRemoteListeners</A></B>()</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/cayenne/access/DataRowStore.html#maximumSize()">maximumSize</A></B>()</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns maximum allowed cache size.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/cayenne/access/DataRowStore.html#processRemoteEvent(org.apache.cayenne.access.event.SnapshotEvent)">processRemoteEvent</A></B>(<A HREF="../../../../org/apache/cayenne/access/event/SnapshotEvent.html" title="class in org.apache.cayenne.access.event">SnapshotEvent</A>&nbsp;event)</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Handles remote events received via EventBridge.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/cayenne/access/DataRowStore.html#processSnapshotChanges(java.lang.Object, java.util.Map, java.util.Collection, java.util.Collection)">processSnapshotChanges</A></B>(java.lang.Object&nbsp;source,
java.util.Map&nbsp;updatedSnapshots,
java.util.Collection&nbsp;deletedSnapshotIds,
java.util.Collection&nbsp;indirectlyModifiedIds)</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<B>Deprecated.</B>&nbsp;<I></I>&nbsp;</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/cayenne/access/DataRowStore.html#processSnapshotChanges(java.lang.Object, java.util.Map, java.util.Collection, java.util.Collection, java.util.Collection)">processSnapshotChanges</A></B>(java.lang.Object&nbsp;postedBy,
java.util.Map&nbsp;updatedSnapshots,
java.util.Collection&nbsp;deletedSnapshotIds,
java.util.Collection&nbsp;invalidatedSnapshotIds,
java.util.Collection&nbsp;indirectlyModifiedIds)</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Processes changes made to snapshots.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/cayenne/access/DataRowStore.html#setEventManager(org.apache.cayenne.event.EventManager)">setEventManager</A></B>(<A HREF="../../../../org/apache/cayenne/event/EventManager.html" title="class in org.apache.cayenne.event">EventManager</A>&nbsp;eventManager)</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets an EventManager associated with this DataRowStore.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/cayenne/access/DataRowStore.html#setName(java.lang.String)">setName</A></B>(java.lang.String&nbsp;name)</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets the name of this DataRowStore.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/cayenne/access/DataRowStore.html#setNotifyingRemoteListeners(boolean)">setNotifyingRemoteListeners</A></B>(boolean&nbsp;notifyingRemoteListeners)</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/cayenne/access/DataRowStore.html#shutdown()">shutdown</A></B>()</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Shuts down any remote notification connections, and clears internal cache.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/cayenne/access/DataRowStore.html#size()">size</A></B>()</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns current cache size.</TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TH ALIGN="left"><B>Methods inherited from class java.lang.Object</B></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE>clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait</CODE></TD>
</TR>
</TABLE>
&nbsp;
<P>
<!-- ============ FIELD DETAIL =========== -->
<A NAME="field_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
<B>Field Detail</B></FONT></TH>
</TR>
</TABLE>
<A NAME="SNAPSHOT_EXPIRATION_PROPERTY"><!-- --></A><H3>
SNAPSHOT_EXPIRATION_PROPERTY</H3>
<PRE>
public static final java.lang.String <B>SNAPSHOT_EXPIRATION_PROPERTY</B></PRE>
<DL>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../../constant-values.html#org.apache.cayenne.access.DataRowStore.SNAPSHOT_EXPIRATION_PROPERTY">Constant Field Values</A></DL>
</DL>
<HR>
<A NAME="SNAPSHOT_CACHE_SIZE_PROPERTY"><!-- --></A><H3>
SNAPSHOT_CACHE_SIZE_PROPERTY</H3>
<PRE>
public static final java.lang.String <B>SNAPSHOT_CACHE_SIZE_PROPERTY</B></PRE>
<DL>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../../constant-values.html#org.apache.cayenne.access.DataRowStore.SNAPSHOT_CACHE_SIZE_PROPERTY">Constant Field Values</A></DL>
</DL>
<HR>
<A NAME="REMOTE_NOTIFICATION_PROPERTY"><!-- --></A><H3>
REMOTE_NOTIFICATION_PROPERTY</H3>
<PRE>
public static final java.lang.String <B>REMOTE_NOTIFICATION_PROPERTY</B></PRE>
<DL>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../../constant-values.html#org.apache.cayenne.access.DataRowStore.REMOTE_NOTIFICATION_PROPERTY">Constant Field Values</A></DL>
</DL>
<HR>
<A NAME="EVENT_BRIDGE_FACTORY_PROPERTY"><!-- --></A><H3>
EVENT_BRIDGE_FACTORY_PROPERTY</H3>
<PRE>
public static final java.lang.String <B>EVENT_BRIDGE_FACTORY_PROPERTY</B></PRE>
<DL>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../../constant-values.html#org.apache.cayenne.access.DataRowStore.EVENT_BRIDGE_FACTORY_PROPERTY">Constant Field Values</A></DL>
</DL>
<HR>
<A NAME="SNAPSHOT_EXPIRATION_DEFAULT"><!-- --></A><H3>
SNAPSHOT_EXPIRATION_DEFAULT</H3>
<PRE>
public static final long <B>SNAPSHOT_EXPIRATION_DEFAULT</B></PRE>
<DL>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../../constant-values.html#org.apache.cayenne.access.DataRowStore.SNAPSHOT_EXPIRATION_DEFAULT">Constant Field Values</A></DL>
</DL>
<HR>
<A NAME="SNAPSHOT_CACHE_SIZE_DEFAULT"><!-- --></A><H3>
SNAPSHOT_CACHE_SIZE_DEFAULT</H3>
<PRE>
public static final int <B>SNAPSHOT_CACHE_SIZE_DEFAULT</B></PRE>
<DL>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../../constant-values.html#org.apache.cayenne.access.DataRowStore.SNAPSHOT_CACHE_SIZE_DEFAULT">Constant Field Values</A></DL>
</DL>
<HR>
<A NAME="REMOTE_NOTIFICATION_DEFAULT"><!-- --></A><H3>
REMOTE_NOTIFICATION_DEFAULT</H3>
<PRE>
public static final boolean <B>REMOTE_NOTIFICATION_DEFAULT</B></PRE>
<DL>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../../constant-values.html#org.apache.cayenne.access.DataRowStore.REMOTE_NOTIFICATION_DEFAULT">Constant Field Values</A></DL>
</DL>
<HR>
<A NAME="EVENT_BRIDGE_FACTORY_DEFAULT"><!-- --></A><H3>
EVENT_BRIDGE_FACTORY_DEFAULT</H3>
<PRE>
public static final java.lang.String <B>EVENT_BRIDGE_FACTORY_DEFAULT</B></PRE>
<DL>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../../constant-values.html#org.apache.cayenne.access.DataRowStore.EVENT_BRIDGE_FACTORY_DEFAULT">Constant Field Values</A></DL>
</DL>
<HR>
<A NAME="name"><!-- --></A><H3>
name</H3>
<PRE>
protected java.lang.String <B>name</B></PRE>
<DL>
<DL>
</DL>
</DL>
<HR>
<A NAME="snapshots"><!-- --></A><H3>
snapshots</H3>
<PRE>
protected org.apache.commons.collections.map.LRUMap <B>snapshots</B></PRE>
<DL>
<DL>
</DL>
</DL>
<HR>
<A NAME="snapshotLists"><!-- --></A><H3>
snapshotLists</H3>
<PRE>
protected org.apache.commons.collections.map.LRUMap <B>snapshotLists</B></PRE>
<DL>
<DL>
</DL>
</DL>
<HR>
<A NAME="notifyingRemoteListeners"><!-- --></A><H3>
notifyingRemoteListeners</H3>
<PRE>
protected boolean <B>notifyingRemoteListeners</B></PRE>
<DL>
<DL>
</DL>
</DL>
<HR>
<A NAME="eventManager"><!-- --></A><H3>
eventManager</H3>
<PRE>
protected transient <A HREF="../../../../org/apache/cayenne/event/EventManager.html" title="class in org.apache.cayenne.event">EventManager</A> <B>eventManager</B></PRE>
<DL>
<DL>
</DL>
</DL>
<HR>
<A NAME="remoteNotificationsHandler"><!-- --></A><H3>
remoteNotificationsHandler</H3>
<PRE>
protected transient <A HREF="../../../../org/apache/cayenne/event/EventBridge.html" title="class in org.apache.cayenne.event">EventBridge</A> <B>remoteNotificationsHandler</B></PRE>
<DL>
<DL>
</DL>
</DL>
<HR>
<A NAME="eventSubject"><!-- --></A><H3>
eventSubject</H3>
<PRE>
protected transient <A HREF="../../../../org/apache/cayenne/event/EventSubject.html" title="class in org.apache.cayenne.event">EventSubject</A> <B>eventSubject</B></PRE>
<DL>
<DL>
</DL>
</DL>
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<A NAME="constructor_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
<B>Constructor Detail</B></FONT></TH>
</TR>
</TABLE>
<A NAME="DataRowStore(java.lang.String)"><!-- --></A><H3>
DataRowStore</H3>
<PRE>
public <B>DataRowStore</B>(java.lang.String&nbsp;name)</PRE>
<DL>
<DD>Creates new named DataRowStore with default configuration.
<P>
</DL>
<HR>
<A NAME="DataRowStore(java.lang.String, java.util.Map)"><!-- --></A><H3>
DataRowStore</H3>
<PRE>
public <B>DataRowStore</B>(java.lang.String&nbsp;name,
java.util.Map&nbsp;properties)</PRE>
<DL>
<DD>Creates new DataRowStore with a specified name and a set of properties. If no
properties are defined, default values are used.
<P>
<DL>
<DT><B>Parameters:</B><DD><CODE>name</CODE> - DataRowStore name. Used to idenitfy this DataRowStore in events, etc.
Can't be null.<DD><CODE>properties</CODE> - Properties map used to configure DataRowStore parameters. Can be
null.</DL>
</DL>
<HR>
<A NAME="DataRowStore(java.lang.String, java.util.Map, org.apache.cayenne.event.EventManager)"><!-- --></A><H3>
DataRowStore</H3>
<PRE>
public <B>DataRowStore</B>(java.lang.String&nbsp;name,
java.util.Map&nbsp;properties,
<A HREF="../../../../org/apache/cayenne/event/EventManager.html" title="class in org.apache.cayenne.event">EventManager</A>&nbsp;eventManager)</PRE>
<DL>
<DD>Creates new DataRowStore with a specified name and a set of properties. If no
properties are defined, default values are used.
<P>
<DL>
<DT><B>Parameters:</B><DD><CODE>name</CODE> - DataRowStore name. Used to idenitfy this DataRowStore in events, etc.
Can't be null.<DD><CODE>properties</CODE> - Properties map used to configure DataRowStore parameters. Can be
null.<DD><CODE>eventManager</CODE> - EventManager that should be used for posting and receiving
events.<DT><B>Since:</B></DT>
<DD>1.2</DD>
</DL>
</DL>
<!-- ============ METHOD DETAIL ========== -->
<A NAME="method_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
<B>Method Detail</B></FONT></TH>
</TR>
</TABLE>
<A NAME="initWithProperties(java.util.Map)"><!-- --></A><H3>
initWithProperties</H3>
<PRE>
protected void <B>initWithProperties</B>(java.util.Map&nbsp;properties)</PRE>
<DL>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>
<A NAME="size()"><!-- --></A><H3>
size</H3>
<PRE>
public int <B>size</B>()</PRE>
<DL>
<DD>Returns current cache size.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>
<A NAME="maximumSize()"><!-- --></A><H3>
maximumSize</H3>
<PRE>
public int <B>maximumSize</B>()</PRE>
<DL>
<DD>Returns maximum allowed cache size.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>
<A NAME="shutdown()"><!-- --></A><H3>
shutdown</H3>
<PRE>
public void <B>shutdown</B>()</PRE>
<DL>
<DD>Shuts down any remote notification connections, and clears internal cache.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>
<A NAME="getName()"><!-- --></A><H3>
getName</H3>
<PRE>
public java.lang.String <B>getName</B>()</PRE>
<DL>
<DD>Returns the name of this DataRowStore. Name allows to create EventSubjects for
event notifications addressed to or sent from this DataRowStore.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>
<A NAME="setName(java.lang.String)"><!-- --></A><H3>
setName</H3>
<PRE>
public void <B>setName</B>(java.lang.String&nbsp;name)</PRE>
<DL>
<DD>Sets the name of this DataRowStore. Name allows to create EventSubjects for event
notifications addressed to or sent from this DataRowStore.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>
<A NAME="getEventManager()"><!-- --></A><H3>
getEventManager</H3>
<PRE>
public <A HREF="../../../../org/apache/cayenne/event/EventManager.html" title="class in org.apache.cayenne.event">EventManager</A> <B>getEventManager</B>()</PRE>
<DL>
<DD>Returns an EventManager associated with this DataRowStore.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Since:</B></DT>
<DD>1.2</DD>
</DL>
</DD>
</DL>
<HR>
<A NAME="setEventManager(org.apache.cayenne.event.EventManager)"><!-- --></A><H3>
setEventManager</H3>
<PRE>
public void <B>setEventManager</B>(<A HREF="../../../../org/apache/cayenne/event/EventManager.html" title="class in org.apache.cayenne.event">EventManager</A>&nbsp;eventManager)</PRE>
<DL>
<DD>Sets an EventManager associated with this DataRowStore.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Since:</B></DT>
<DD>1.2</DD>
</DL>
</DD>
</DL>
<HR>
<A NAME="getCachedSnapshot(org.apache.cayenne.ObjectId)"><!-- --></A><H3>
getCachedSnapshot</H3>
<PRE>
public <A HREF="../../../../org/apache/cayenne/DataRow.html" title="class in org.apache.cayenne">DataRow</A> <B>getCachedSnapshot</B>(<A HREF="../../../../org/apache/cayenne/ObjectId.html" title="class in org.apache.cayenne">ObjectId</A>&nbsp;oid)</PRE>
<DL>
<DD>Returns cached snapshot or null if no snapshot is currently cached for the given
ObjectId.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>
<A NAME="getSnapshot(org.apache.cayenne.ObjectId, org.apache.cayenne.access.QueryEngine)"><!-- --></A><H3>
getSnapshot</H3>
<PRE>
public <A HREF="../../../../org/apache/cayenne/DataRow.html" title="class in org.apache.cayenne">DataRow</A> <B>getSnapshot</B>(<A HREF="../../../../org/apache/cayenne/ObjectId.html" title="class in org.apache.cayenne">ObjectId</A>&nbsp;oid,
<A HREF="../../../../org/apache/cayenne/access/QueryEngine.html" title="interface in org.apache.cayenne.access">QueryEngine</A>&nbsp;engine)</PRE>
<DL>
<DD><B>Deprecated.</B>&nbsp;<I>since 1.2 unused, as DataRowStore no longer performs queries on its
own.</I>
<P>
<DD>Returns a snapshot for ObjectId. If snapshot is currently cached, it is returned.
If not, a provided QueryEngine is used to fetch it from the database. If there is
no database row for a given id, null is returned.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>
<A NAME="cacheSnapshots(java.lang.String, java.util.List)"><!-- --></A><H3>
cacheSnapshots</H3>
<PRE>
public void <B>cacheSnapshots</B>(java.lang.String&nbsp;key,
java.util.List&nbsp;snapshots)</PRE>
<DL>
<DD>Registers a list of snapshots with internal cache, using a String key.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>
<A NAME="getCachedSnapshots(java.lang.String)"><!-- --></A><H3>
getCachedSnapshots</H3>
<PRE>
public java.util.List <B>getCachedSnapshots</B>(java.lang.String&nbsp;key)</PRE>
<DL>
<DD>Returns a list of previously cached snapshots.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>
<A NAME="getSnapshotEventSubject()"><!-- --></A><H3>
getSnapshotEventSubject</H3>
<PRE>
public <A HREF="../../../../org/apache/cayenne/event/EventSubject.html" title="class in org.apache.cayenne.event">EventSubject</A> <B>getSnapshotEventSubject</B>()</PRE>
<DL>
<DD>Returns EventSubject used by this SnapshotCache to notify of snapshot changes.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>
<A NAME="clear()"><!-- --></A><H3>
clear</H3>
<PRE>
public void <B>clear</B>()</PRE>
<DL>
<DD>Expires and removes all stored snapshots without sending any notification events.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>
<A NAME="forgetSnapshot(org.apache.cayenne.ObjectId)"><!-- --></A><H3>
forgetSnapshot</H3>
<PRE>
public void <B>forgetSnapshot</B>(<A HREF="../../../../org/apache/cayenne/ObjectId.html" title="class in org.apache.cayenne">ObjectId</A>&nbsp;id)</PRE>
<DL>
<DD>Evicts a snapshot from cache without generating any SnapshotEvents.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>
<A NAME="processRemoteEvent(org.apache.cayenne.access.event.SnapshotEvent)"><!-- --></A><H3>
processRemoteEvent</H3>
<PRE>
public void <B>processRemoteEvent</B>(<A HREF="../../../../org/apache/cayenne/access/event/SnapshotEvent.html" title="class in org.apache.cayenne.access.event">SnapshotEvent</A>&nbsp;event)</PRE>
<DL>
<DD>Handles remote events received via EventBridge. Performs needed snapshot updates,
and then resends the event to local listeners.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>
<A NAME="processSnapshotChanges(java.lang.Object, java.util.Map, java.util.Collection, java.util.Collection)"><!-- --></A><H3>
processSnapshotChanges</H3>
<PRE>
public void <B>processSnapshotChanges</B>(java.lang.Object&nbsp;source,
java.util.Map&nbsp;updatedSnapshots,
java.util.Collection&nbsp;deletedSnapshotIds,
java.util.Collection&nbsp;indirectlyModifiedIds)</PRE>
<DL>
<DD><B>Deprecated.</B>&nbsp;<I></I>
<P>
<DD>Processes changes made to snapshots. Modifies internal cache state, and then sends
the event to all listeners. Source of these changes is usually an ObjectStore.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>
<A NAME="processSnapshotChanges(java.lang.Object, java.util.Map, java.util.Collection, java.util.Collection, java.util.Collection)"><!-- --></A><H3>
processSnapshotChanges</H3>
<PRE>
public void <B>processSnapshotChanges</B>(java.lang.Object&nbsp;postedBy,
java.util.Map&nbsp;updatedSnapshots,
java.util.Collection&nbsp;deletedSnapshotIds,
java.util.Collection&nbsp;invalidatedSnapshotIds,
java.util.Collection&nbsp;indirectlyModifiedIds)</PRE>
<DL>
<DD>Processes changes made to snapshots. Modifies internal cache state, and then sends
the event to all listeners. Source of these changes is usually an ObjectStore.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>
<A NAME="isNotifyingRemoteListeners()"><!-- --></A><H3>
isNotifyingRemoteListeners</H3>
<PRE>
public boolean <B>isNotifyingRemoteListeners</B>()</PRE>
<DL>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>
<A NAME="setNotifyingRemoteListeners(boolean)"><!-- --></A><H3>
setNotifyingRemoteListeners</H3>
<PRE>
public void <B>setNotifyingRemoteListeners</B>(boolean&nbsp;notifyingRemoteListeners)</PRE>
<DL>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<!-- ========= END OF CLASS DATA ========= -->
<HR>
<!-- ======= START OF BOTTOM NAVBAR ====== -->
<A NAME="navbar_bottom"><!-- --></A>
<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
<TR ALIGN="center" VALIGN="top">
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-files/index-1.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
</TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>
<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="../../../../org/apache/cayenne/access/DataPortDelegate.html" title="interface in org.apache.cayenne.access"><B>PREV CLASS</B></A>&nbsp;
&nbsp;<A HREF="../../../../org/apache/cayenne/access/DbGenerator.html" title="class in org.apache.cayenne.access"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../../index.html?org/apache/cayenne/access/DataRowStore.html" target="_top"><B>FRAMES</B></A> &nbsp;
&nbsp;<A HREF="DataRowStore.html" target="_top"><B>NO FRAMES</B></A> &nbsp;
&nbsp;<SCRIPT type="text/javascript">
<!--
if(window==top) {
document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>');
}
//-->
</SCRIPT>
<NOSCRIPT>
<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>
</NOSCRIPT>
</FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;<A HREF="#field_summary">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL:&nbsp;<A HREF="#field_detail">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<A NAME="skip-navbar_bottom"></A>
<!-- ======== END OF BOTTOM NAVBAR ======= -->
<HR>
<i>Copyright &#169; 2001-2006 <a href=
"http://apache.org" target="_top">Apache.org</a> All Rights Reserved.</i>
</BODY>
</HTML>