| <!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.6.0_01) on Tue Mar 18 12:43:12 PDT 2008 --> |
| <META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> |
| <TITLE> |
| PersistenceManager (JDO2 API Legacy 2.1) |
| </TITLE> |
| |
| <META NAME="date" CONTENT="2008-03-18"> |
| |
| <LINK REL ="stylesheet" TYPE="text/css" HREF="../../stylesheet.css" TITLE="Style"> |
| |
| <SCRIPT type="text/javascript"> |
| function windowTitle() |
| { |
| if (location.href.indexOf('is-external=true') == -1) { |
| parent.document.title="PersistenceManager (JDO2 API Legacy 2.1)"; |
| } |
| } |
| </SCRIPT> |
| <NOSCRIPT> |
| </NOSCRIPT> |
| |
| </HEAD> |
| |
| <BODY BGCOLOR="white" onload="windowTitle();"> |
| <HR> |
| |
| |
| <!-- ========= 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> </TD> |
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD> |
| <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD> |
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/PersistenceManager.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD> |
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD> |
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD> |
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD> |
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD> |
| </TR> |
| </TABLE> |
| </TD> |
| <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM> |
| </EM> |
| </TD> |
| </TR> |
| |
| <TR> |
| <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> |
| <A HREF="../../javax/jdo/JDOUserException.html" title="class in javax.jdo"><B>PREV CLASS</B></A> |
| <A HREF="../../javax/jdo/PersistenceManagerFactory.html" title="interface in javax.jdo"><B>NEXT CLASS</B></A></FONT></TD> |
| <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> |
| <A HREF="../../index.html?javax/jdo/PersistenceManager.html" target="_top"><B>FRAMES</B></A> |
| <A HREF="PersistenceManager.html" target="_top"><B>NO FRAMES</B></A> |
| <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: NESTED | FIELD | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD> |
| <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> |
| DETAIL: FIELD | CONSTR | <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"> |
| javax.jdo</FONT> |
| <BR> |
| Interface PersistenceManager</H2> |
| <HR> |
| <DL> |
| <DT><PRE>public interface <B>PersistenceManager</B></DL> |
| </PRE> |
| |
| <P> |
| <code>PersistenceManager</code> is the primary interface for JDO-aware |
| application components. It is the factory for <code>Query</code> and |
| <code>Transaction</code> instances, and contains methods to manage the |
| life cycle of <code>PersistenceCapable</code> instances. |
| |
| <P>A <code>PersistenceManager</code> is obtained from the |
| <A HREF="../../javax/jdo/PersistenceManagerFactory.html" title="interface in javax.jdo"><CODE>PersistenceManagerFactory</CODE></A> |
| (recommended) or by construction. |
| <P> |
| |
| <P> |
| <DL> |
| <DT><B>Version:</B></DT> |
| <DD>2.1</DD> |
| </DL> |
| <HR> |
| |
| <P> |
| |
| <!-- ========== 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> void</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#addInstanceLifecycleListener(javax.jdo.listener.InstanceLifecycleListener, java.lang.Class[])">addInstanceLifecycleListener</A></B>(<A HREF="../../javax/jdo/listener/InstanceLifecycleListener.html" title="interface in javax.jdo.listener">InstanceLifecycleListener</A> listener, |
| java.lang.Class[] classes)</CODE> |
| |
| <BR> |
| Adds the listener instance to the list of lifecycle event |
| listeners.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> void</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#checkConsistency()">checkConsistency</A></B>()</CODE> |
| |
| <BR> |
| Validates the <code>PersistenceManager</code> cache with the |
| datastore.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> void</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#close()">close</A></B>()</CODE> |
| |
| <BR> |
| Close this <code>PersistenceManager</code> so that no further requests |
| may be made on it.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> <A HREF="../../javax/jdo/Transaction.html" title="interface in javax.jdo">Transaction</A></CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#currentTransaction()">currentTransaction</A></B>()</CODE> |
| |
| <BR> |
| Return the <code>Transaction</code> instance associated with a |
| <code>PersistenceManager</code>.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> void</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#deletePersistent(java.lang.Object)">deletePersistent</A></B>(java.lang.Object pc)</CODE> |
| |
| <BR> |
| Delete the persistent instance from the data store.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> void</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#deletePersistentAll(java.util.Collection)">deletePersistentAll</A></B>(java.util.Collection pcs)</CODE> |
| |
| <BR> |
| Delete a <code>Collection</code> of instances from the data store.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> void</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#deletePersistentAll(java.lang.Object[])">deletePersistentAll</A></B>(java.lang.Object[] pcs)</CODE> |
| |
| <BR> |
| Delete an array of instances from the data store.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> java.lang.Object</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#detachCopy(java.lang.Object)">detachCopy</A></B>(java.lang.Object pc)</CODE> |
| |
| <BR> |
| Detach the specified instance from the <code>PersistenceManager</code>.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> java.util.Collection</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#detachCopyAll(java.util.Collection)">detachCopyAll</A></B>(java.util.Collection pcs)</CODE> |
| |
| <BR> |
| Detach the specified instances from the <code>PersistenceManager</code>.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> java.lang.Object[]</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#detachCopyAll(java.lang.Object[])">detachCopyAll</A></B>(java.lang.Object[] pcs)</CODE> |
| |
| <BR> |
| Detach the specified instances from the <code>PersistenceManager</code>.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> void</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#evict(java.lang.Object)">evict</A></B>(java.lang.Object pc)</CODE> |
| |
| <BR> |
| Mark an instance as no longer needed in the cache.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> void</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#evictAll()">evictAll</A></B>()</CODE> |
| |
| <BR> |
| Mark all persistent-nontransactional instances as no longer needed |
| in the cache.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> void</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#evictAll(boolean, java.lang.Class)">evictAll</A></B>(boolean subclasses, |
| java.lang.Class pcClass)</CODE> |
| |
| <BR> |
| Mark the parameter instances as no longer needed in the cache.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> void</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#evictAll(java.util.Collection)">evictAll</A></B>(java.util.Collection pcs)</CODE> |
| |
| <BR> |
| Mark a <code>Collection</code> of instances as no longer needed in the |
| cache.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> void</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#evictAll(java.lang.Object[])">evictAll</A></B>(java.lang.Object[] pcs)</CODE> |
| |
| <BR> |
| Mark an array of instances as no longer needed in the cache.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> void</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#flush()">flush</A></B>()</CODE> |
| |
| <BR> |
| Flushes all dirty, new, and deleted instances to the data |
| store.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> boolean</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#getCopyOnAttach()">getCopyOnAttach</A></B>()</CODE> |
| |
| <BR> |
| Gets the copyOnAttach setting.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> <A HREF="../../javax/jdo/datastore/JDOConnection.html" title="interface in javax.jdo.datastore">JDOConnection</A></CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#getDataStoreConnection()">getDataStoreConnection</A></B>()</CODE> |
| |
| <BR> |
| If this method is called while a datastore transaction is |
| active, the object returned will be enlisted in the current |
| transaction.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> boolean</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#getDetachAllOnCommit()">getDetachAllOnCommit</A></B>()</CODE> |
| |
| <BR> |
| Gets the detachAllOnCommit setting.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> <A HREF="../../javax/jdo/Extent.html" title="interface in javax.jdo">Extent</A></CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#getExtent(java.lang.Class)">getExtent</A></B>(java.lang.Class persistenceCapableClass)</CODE> |
| |
| <BR> |
| Equivalent to <code>getExtent (persistenceCapableClass, |
| true)</code>.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> <A HREF="../../javax/jdo/Extent.html" title="interface in javax.jdo">Extent</A></CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#getExtent(java.lang.Class, boolean)">getExtent</A></B>(java.lang.Class persistenceCapableClass, |
| boolean subclasses)</CODE> |
| |
| <BR> |
| The <code>PersistenceManager</code> manages a collection of instances in |
| the data store based on the class of the instances.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> <A HREF="../../javax/jdo/FetchPlan.html" title="interface in javax.jdo">FetchPlan</A></CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#getFetchPlan()">getFetchPlan</A></B>()</CODE> |
| |
| <BR> |
| Returns the <code>FetchPlan</code> used by this |
| <code>PersistenceManager</code>.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> boolean</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#getIgnoreCache()">getIgnoreCache</A></B>()</CODE> |
| |
| <BR> |
| Get the ignoreCache setting for queries.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> java.util.Set</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#getManagedObjects()">getManagedObjects</A></B>()</CODE> |
| |
| <BR> |
| Get the objects managed by this persistence manager.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> java.util.Set</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#getManagedObjects(java.lang.Class[])">getManagedObjects</A></B>(java.lang.Class[] classes)</CODE> |
| |
| <BR> |
| Get the objects managed by this persistence manager being instances of |
| the specified classes.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> boolean</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#getMultithreaded()">getMultithreaded</A></B>()</CODE> |
| |
| <BR> |
| Get the current Multithreaded flag for this |
| <code>PersistenceManager</code>.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> java.lang.Object</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#getObjectById(java.lang.Class, java.lang.Object)">getObjectById</A></B>(java.lang.Class cls, |
| java.lang.Object key)</CODE> |
| |
| <BR> |
| Looks up the instance of the given type with the given key.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> java.lang.Object</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#getObjectById(java.lang.Object)">getObjectById</A></B>(java.lang.Object oid)</CODE> |
| |
| <BR> |
| Looks up the instance corresponding to the specified oid.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> java.lang.Object</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#getObjectById(java.lang.Object, boolean)">getObjectById</A></B>(java.lang.Object oid, |
| boolean validate)</CODE> |
| |
| <BR> |
| This method locates a persistent instance in the cache of instances |
| managed by this <code>PersistenceManager</code>.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> java.lang.Object</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#getObjectId(java.lang.Object)">getObjectId</A></B>(java.lang.Object pc)</CODE> |
| |
| <BR> |
| The ObjectId returned by this method represents the JDO identity of |
| the instance.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> java.lang.Class</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#getObjectIdClass(java.lang.Class)">getObjectIdClass</A></B>(java.lang.Class cls)</CODE> |
| |
| <BR> |
| Return the <code>Class</code> that implements the JDO Identity for the |
| specified <code>PersistenceCapable</code> class.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> java.lang.Object[]</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#getObjectsById(boolean, java.lang.Object[])">getObjectsById</A></B>(boolean validate, |
| java.lang.Object[] oids)</CODE> |
| |
| <BR> |
| Return the objects with the given oids.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> java.util.Collection</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#getObjectsById(java.util.Collection)">getObjectsById</A></B>(java.util.Collection oids)</CODE> |
| |
| <BR> |
| Return the objects with the given oids.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> java.util.Collection</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#getObjectsById(java.util.Collection, boolean)">getObjectsById</A></B>(java.util.Collection oids, |
| boolean validate)</CODE> |
| |
| <BR> |
| Return the objects with the given oids.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> java.lang.Object[]</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#getObjectsById(java.lang.Object[])">getObjectsById</A></B>(java.lang.Object[] oids)</CODE> |
| |
| <BR> |
| Return the objects with the given oids.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> java.lang.Object[]</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#getObjectsById(java.lang.Object[], boolean)">getObjectsById</A></B>(java.lang.Object[] oids, |
| boolean validate)</CODE> |
| |
| <BR> |
| <B>Deprecated.</B> <I></I> </TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> <A HREF="../../javax/jdo/PersistenceManagerFactory.html" title="interface in javax.jdo">PersistenceManagerFactory</A></CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#getPersistenceManagerFactory()">getPersistenceManagerFactory</A></B>()</CODE> |
| |
| <BR> |
| This method returns the <code>PersistenceManagerFactory</code> used to |
| create this <code>PersistenceManager</code>.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> <A HREF="../../javax/jdo/datastore/Sequence.html" title="interface in javax.jdo.datastore">Sequence</A></CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#getSequence(java.lang.String)">getSequence</A></B>(java.lang.String name)</CODE> |
| |
| <BR> |
| Returns the sequence identified by <code>name</code>.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> java.util.Date</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#getServerDate()">getServerDate</A></B>()</CODE> |
| |
| <BR> |
| Get the Date as seen by the server.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> java.lang.Object</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#getTransactionalObjectId(java.lang.Object)">getTransactionalObjectId</A></B>(java.lang.Object pc)</CODE> |
| |
| <BR> |
| The ObjectId returned by this method represents the JDO identity of |
| the instance.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> java.lang.Object</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#getUserObject()">getUserObject</A></B>()</CODE> |
| |
| <BR> |
| The application can manage the <code>PersistenceManager</code> instances |
| more easily by having an application object associated with each |
| <code>PersistenceManager</code> instance.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> java.lang.Object</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#getUserObject(java.lang.Object)">getUserObject</A></B>(java.lang.Object key)</CODE> |
| |
| <BR> |
| Get the value for the specified key from the map of user objects.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> boolean</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#isClosed()">isClosed</A></B>()</CODE> |
| |
| <BR> |
| A <code>PersistenceManager</code> instance can be used until it is |
| closed.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> void</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#makeNontransactional(java.lang.Object)">makeNontransactional</A></B>(java.lang.Object pc)</CODE> |
| |
| <BR> |
| Make an instance non-transactional after commit.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> void</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#makeNontransactionalAll(java.util.Collection)">makeNontransactionalAll</A></B>(java.util.Collection pcs)</CODE> |
| |
| <BR> |
| Make a <code>Collection</code> of instances non-transactional after |
| commit.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> void</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#makeNontransactionalAll(java.lang.Object[])">makeNontransactionalAll</A></B>(java.lang.Object[] pcs)</CODE> |
| |
| <BR> |
| Make an array of instances non-transactional after commit.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> java.lang.Object</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#makePersistent(java.lang.Object)">makePersistent</A></B>(java.lang.Object pc)</CODE> |
| |
| <BR> |
| Make the parameter instance persistent in this |
| <code>PersistenceManager</code>.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> java.util.Collection</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#makePersistentAll(java.util.Collection)">makePersistentAll</A></B>(java.util.Collection pcs)</CODE> |
| |
| <BR> |
| Make a <code>Collection</code> of instances persistent.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> java.lang.Object[]</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#makePersistentAll(java.lang.Object[])">makePersistentAll</A></B>(java.lang.Object[] pcs)</CODE> |
| |
| <BR> |
| Make an array of instances persistent.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> void</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#makeTransactional(java.lang.Object)">makeTransactional</A></B>(java.lang.Object pc)</CODE> |
| |
| <BR> |
| Make an instance subject to transactional boundaries.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> void</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#makeTransactionalAll(java.util.Collection)">makeTransactionalAll</A></B>(java.util.Collection pcs)</CODE> |
| |
| <BR> |
| Make a <code>Collection</code> of instances subject to transactional |
| boundaries.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> void</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#makeTransactionalAll(java.lang.Object[])">makeTransactionalAll</A></B>(java.lang.Object[] pcs)</CODE> |
| |
| <BR> |
| Make an array of instances subject to transactional boundaries.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> void</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#makeTransient(java.lang.Object)">makeTransient</A></B>(java.lang.Object pc)</CODE> |
| |
| <BR> |
| Make an instance transient, removing it from management by this |
| <code>PersistenceManager</code>.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> void</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#makeTransient(java.lang.Object, boolean)">makeTransient</A></B>(java.lang.Object pc, |
| boolean useFetchPlan)</CODE> |
| |
| <BR> |
| Make an instance transient, removing it from management by this |
| <code>PersistenceManager</code>.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> void</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#makeTransientAll(boolean, java.lang.Object[])">makeTransientAll</A></B>(boolean useFetchPlan, |
| java.lang.Object[] pcs)</CODE> |
| |
| <BR> |
| Make instances transient, removing them from management |
| by this <code>PersistenceManager</code>.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> void</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#makeTransientAll(java.util.Collection)">makeTransientAll</A></B>(java.util.Collection pcs)</CODE> |
| |
| <BR> |
| Make a <code>Collection</code> of instances transient, removing them |
| from management by this <code>PersistenceManager</code>.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> void</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#makeTransientAll(java.util.Collection, boolean)">makeTransientAll</A></B>(java.util.Collection pcs, |
| boolean useFetchPlan)</CODE> |
| |
| <BR> |
| Make instances transient, removing them from management |
| by this <code>PersistenceManager</code>.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> void</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#makeTransientAll(java.lang.Object[])">makeTransientAll</A></B>(java.lang.Object[] pcs)</CODE> |
| |
| <BR> |
| Make an array of instances transient, removing them from management by |
| this <code>PersistenceManager</code>.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> void</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#makeTransientAll(java.lang.Object[], boolean)">makeTransientAll</A></B>(java.lang.Object[] pcs, |
| boolean useFetchPlan)</CODE> |
| |
| <BR> |
| <B>Deprecated.</B> <I></I> </TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> java.lang.Object</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#newInstance(java.lang.Class)">newInstance</A></B>(java.lang.Class pcClass)</CODE> |
| |
| <BR> |
| Creates an instance of a persistence-capable interface, |
| or of a concrete or abstract class.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> <A HREF="../../javax/jdo/Query.html" title="interface in javax.jdo">Query</A></CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#newNamedQuery(java.lang.Class, java.lang.String)">newNamedQuery</A></B>(java.lang.Class cls, |
| java.lang.String queryName)</CODE> |
| |
| <BR> |
| Create a new <code>Query</code> with the given candidate class |
| from a named query.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> java.lang.Object</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#newObjectIdInstance(java.lang.Class, java.lang.Object)">newObjectIdInstance</A></B>(java.lang.Class pcClass, |
| java.lang.Object key)</CODE> |
| |
| <BR> |
| This method returns an object id instance corresponding to the pcClass |
| and key arguments.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> <A HREF="../../javax/jdo/Query.html" title="interface in javax.jdo">Query</A></CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#newQuery()">newQuery</A></B>()</CODE> |
| |
| <BR> |
| Create a new <code>Query</code> with no elements.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> <A HREF="../../javax/jdo/Query.html" title="interface in javax.jdo">Query</A></CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#newQuery(java.lang.Class)">newQuery</A></B>(java.lang.Class cls)</CODE> |
| |
| <BR> |
| Create a new <code>Query</code> specifying the <code>Class</code> of the |
| candidate instances.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> <A HREF="../../javax/jdo/Query.html" title="interface in javax.jdo">Query</A></CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#newQuery(java.lang.Class, java.util.Collection)">newQuery</A></B>(java.lang.Class cls, |
| java.util.Collection cln)</CODE> |
| |
| <BR> |
| Create a new <code>Query</code> with the candidate <code>Class</code> |
| and <code>Collection</code>.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> <A HREF="../../javax/jdo/Query.html" title="interface in javax.jdo">Query</A></CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#newQuery(java.lang.Class, java.util.Collection, java.lang.String)">newQuery</A></B>(java.lang.Class cls, |
| java.util.Collection cln, |
| java.lang.String filter)</CODE> |
| |
| <BR> |
| Create a new <code>Query</code> with the <code>Class</code> of the |
| candidate instances, |
| candidate <code>Collection</code>, and filter.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> <A HREF="../../javax/jdo/Query.html" title="interface in javax.jdo">Query</A></CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#newQuery(java.lang.Class, java.lang.String)">newQuery</A></B>(java.lang.Class cls, |
| java.lang.String filter)</CODE> |
| |
| <BR> |
| Create a new <code>Query</code> with the <code>Class</code> of the |
| candidate instances and filter.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> <A HREF="../../javax/jdo/Query.html" title="interface in javax.jdo">Query</A></CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#newQuery(javax.jdo.Extent)">newQuery</A></B>(<A HREF="../../javax/jdo/Extent.html" title="interface in javax.jdo">Extent</A> cln)</CODE> |
| |
| <BR> |
| Create a new <code>Query</code> with the <code>Class</code> of the |
| candidate instances and candidate <code>Extent</code>.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> <A HREF="../../javax/jdo/Query.html" title="interface in javax.jdo">Query</A></CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#newQuery(javax.jdo.Extent, java.lang.String)">newQuery</A></B>(<A HREF="../../javax/jdo/Extent.html" title="interface in javax.jdo">Extent</A> cln, |
| java.lang.String filter)</CODE> |
| |
| <BR> |
| Create a new <code>Query</code> with the |
| candidate <code>Extent</code> and filter; the class |
| is taken from the <code>Extent</code>.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> <A HREF="../../javax/jdo/Query.html" title="interface in javax.jdo">Query</A></CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#newQuery(java.lang.Object)">newQuery</A></B>(java.lang.Object compiled)</CODE> |
| |
| <BR> |
| Create a new <code>Query</code> using elements from another |
| <code>Query</code>.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> <A HREF="../../javax/jdo/Query.html" title="interface in javax.jdo">Query</A></CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#newQuery(java.lang.String)">newQuery</A></B>(java.lang.String query)</CODE> |
| |
| <BR> |
| Create a Construct a new query instance using the specified String |
| as the single-string representation of the query.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> <A HREF="../../javax/jdo/Query.html" title="interface in javax.jdo">Query</A></CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#newQuery(java.lang.String, java.lang.Object)">newQuery</A></B>(java.lang.String language, |
| java.lang.Object query)</CODE> |
| |
| <BR> |
| Create a new <code>Query</code> using the specified language.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> java.lang.Object</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#putUserObject(java.lang.Object, java.lang.Object)">putUserObject</A></B>(java.lang.Object key, |
| java.lang.Object val)</CODE> |
| |
| <BR> |
| Put the specified key-value pair into the map of user objects.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> void</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#refresh(java.lang.Object)">refresh</A></B>(java.lang.Object pc)</CODE> |
| |
| <BR> |
| Refresh the state of the instance from the data store.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> void</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#refreshAll()">refreshAll</A></B>()</CODE> |
| |
| <BR> |
| Refresh the state of all applicable instances from the data store.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> void</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#refreshAll(java.util.Collection)">refreshAll</A></B>(java.util.Collection pcs)</CODE> |
| |
| <BR> |
| Refresh the state of a <code>Collection</code> of instances from the |
| data store.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> void</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#refreshAll(javax.jdo.JDOException)">refreshAll</A></B>(<A HREF="../../javax/jdo/JDOException.html" title="class in javax.jdo">JDOException</A> jdoe)</CODE> |
| |
| <BR> |
| Refreshes all instances in the exception that failed verification.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> void</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#refreshAll(java.lang.Object[])">refreshAll</A></B>(java.lang.Object[] pcs)</CODE> |
| |
| <BR> |
| Refresh the state of an array of instances from the data store.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> void</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#removeInstanceLifecycleListener(javax.jdo.listener.InstanceLifecycleListener)">removeInstanceLifecycleListener</A></B>(<A HREF="../../javax/jdo/listener/InstanceLifecycleListener.html" title="interface in javax.jdo.listener">InstanceLifecycleListener</A> listener)</CODE> |
| |
| <BR> |
| Removes the listener instance from the list of lifecycle event listeners.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> java.lang.Object</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#removeUserObject(java.lang.Object)">removeUserObject</A></B>(java.lang.Object key)</CODE> |
| |
| <BR> |
| Remove the specified key and its value from the map of user objects.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> void</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#retrieve(java.lang.Object)">retrieve</A></B>(java.lang.Object pc)</CODE> |
| |
| <BR> |
| Retrieve field values of an instance from the store.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> void</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#retrieve(java.lang.Object, boolean)">retrieve</A></B>(java.lang.Object pc, |
| boolean useFetchPlan)</CODE> |
| |
| <BR> |
| Retrieve field values of an instance from the store.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> void</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#retrieveAll(boolean, java.lang.Object[])">retrieveAll</A></B>(boolean useFetchPlan, |
| java.lang.Object[] pcs)</CODE> |
| |
| <BR> |
| Retrieve field values of instances from the store.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> void</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#retrieveAll(java.util.Collection)">retrieveAll</A></B>(java.util.Collection pcs)</CODE> |
| |
| <BR> |
| Retrieve field values of instances from the store.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> void</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#retrieveAll(java.util.Collection, boolean)">retrieveAll</A></B>(java.util.Collection pcs, |
| boolean useFetchPlan)</CODE> |
| |
| <BR> |
| Retrieve field values of instances from the store.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> void</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#retrieveAll(java.lang.Object[])">retrieveAll</A></B>(java.lang.Object[] pcs)</CODE> |
| |
| <BR> |
| Retrieve field values of instances from the store.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> void</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#retrieveAll(java.lang.Object[], boolean)">retrieveAll</A></B>(java.lang.Object[] pcs, |
| boolean useFetchPlan)</CODE> |
| |
| <BR> |
| <B>Deprecated.</B> <I></I> </TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> void</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#setCopyOnAttach(boolean)">setCopyOnAttach</A></B>(boolean flag)</CODE> |
| |
| <BR> |
| Sets the copyOnAttach setting.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> void</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#setDetachAllOnCommit(boolean)">setDetachAllOnCommit</A></B>(boolean flag)</CODE> |
| |
| <BR> |
| Sets the detachAllOnCommit setting.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> void</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#setIgnoreCache(boolean)">setIgnoreCache</A></B>(boolean flag)</CODE> |
| |
| <BR> |
| Set the ignoreCache parameter for queries.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> void</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#setMultithreaded(boolean)">setMultithreaded</A></B>(boolean flag)</CODE> |
| |
| <BR> |
| Set the Multithreaded flag for this <code>PersistenceManager</code>.</TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> |
| <CODE> void</CODE></FONT></TD> |
| <TD><CODE><B><A HREF="../../javax/jdo/PersistenceManager.html#setUserObject(java.lang.Object)">setUserObject</A></B>(java.lang.Object o)</CODE> |
| |
| <BR> |
| The application can manage the <code>PersistenceManager</code> instances |
| more easily by having an application object associated with each |
| <code>PersistenceManager</code> instance.</TD> |
| </TR> |
| </TABLE> |
| |
| <P> |
| |
| <!-- ============ 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="isClosed()"><!-- --></A><H3> |
| isClosed</H3> |
| <PRE> |
| boolean <B>isClosed</B>()</PRE> |
| <DL> |
| <DD>A <code>PersistenceManager</code> instance can be used until it is |
| closed. |
| <P> |
| <DD><DL> |
| |
| <DT><B>Returns:</B><DD><code>true</code> if this <code>PersistenceManager</code> has |
| been closed.<DT><B>See Also:</B><DD><A HREF="../../javax/jdo/PersistenceManager.html#close()"><CODE>close()</CODE></A></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="close()"><!-- --></A><H3> |
| close</H3> |
| <PRE> |
| void <B>close</B>()</PRE> |
| <DL> |
| <DD>Close this <code>PersistenceManager</code> so that no further requests |
| may be made on it. A <code>PersistenceManager</code> instance can be |
| used only until it is closed. |
| |
| <P>Closing a <code>PersistenceManager</code> might release it to the pool |
| of available <code>PersistenceManager</code>s, or might be garbage |
| collected, at the option of the JDO implementation. Before being used |
| again to satisfy a <code>getPersistenceManager()</code> request, the |
| default values for options will be restored to their values as specified |
| in the <code>PersistenceManagerFactory</code>. |
| |
| <P>This method closes the <code>PersistenceManager</code>. |
| <P> |
| <DD><DL> |
| </DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="currentTransaction()"><!-- --></A><H3> |
| currentTransaction</H3> |
| <PRE> |
| <A HREF="../../javax/jdo/Transaction.html" title="interface in javax.jdo">Transaction</A> <B>currentTransaction</B>()</PRE> |
| <DL> |
| <DD>Return the <code>Transaction</code> instance associated with a |
| <code>PersistenceManager</code>. There is one <code>Transaction</code> |
| instance associated with each <code>PersistenceManager</code> instance. |
| The <code>Transaction</code> instance supports options as well as |
| transaction completion requests. |
| <P> |
| <DD><DL> |
| |
| <DT><B>Returns:</B><DD>the <code>Transaction</code> associated with this |
| <code>PersistenceManager</code>.</DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="evict(java.lang.Object)"><!-- --></A><H3> |
| evict</H3> |
| <PRE> |
| void <B>evict</B>(java.lang.Object pc)</PRE> |
| <DL> |
| <DD>Mark an instance as no longer needed in the cache. Eviction is normally |
| done automatically by the <code>PersistenceManager</code> at transaction |
| completion. This method allows the application to explicitly provide a |
| hint to the <code>PersistenceManager</code> that the instance is no |
| longer needed in the cache. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>pc</CODE> - the instance to evict from the cache.</DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="evictAll(java.lang.Object[])"><!-- --></A><H3> |
| evictAll</H3> |
| <PRE> |
| void <B>evictAll</B>(java.lang.Object[] pcs)</PRE> |
| <DL> |
| <DD>Mark an array of instances as no longer needed in the cache. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>pcs</CODE> - the array of instances to evict from the cache.<DT><B>See Also:</B><DD><A HREF="../../javax/jdo/PersistenceManager.html#evict(java.lang.Object)"><CODE>evict(Object pc)</CODE></A></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="evictAll(java.util.Collection)"><!-- --></A><H3> |
| evictAll</H3> |
| <PRE> |
| void <B>evictAll</B>(java.util.Collection pcs)</PRE> |
| <DL> |
| <DD>Mark a <code>Collection</code> of instances as no longer needed in the |
| cache. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>pcs</CODE> - the <code>Collection</code> of instances to evict from the |
| cache.<DT><B>See Also:</B><DD><A HREF="../../javax/jdo/PersistenceManager.html#evict(java.lang.Object)"><CODE>evict(Object pc)</CODE></A></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="evictAll(boolean, java.lang.Class)"><!-- --></A><H3> |
| evictAll</H3> |
| <PRE> |
| void <B>evictAll</B>(boolean subclasses, |
| java.lang.Class pcClass)</PRE> |
| <DL> |
| <DD>Mark the parameter instances as no longer needed in the cache. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>pcClass</CODE> - the class of instances to evict<DD><CODE>subclasses</CODE> - if true, mark instances of subclasses also<DT><B>Since:</B></DT> |
| <DD>2.1</DD> |
| </DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="evictAll()"><!-- --></A><H3> |
| evictAll</H3> |
| <PRE> |
| void <B>evictAll</B>()</PRE> |
| <DL> |
| <DD>Mark all persistent-nontransactional instances as no longer needed |
| in the cache. It transitions |
| all persistent-nontransactional instances to hollow. Transactional |
| instances are subject to eviction based on the RetainValues setting. |
| <P> |
| <DD><DL> |
| <DT><B>See Also:</B><DD><A HREF="../../javax/jdo/PersistenceManager.html#evict(java.lang.Object)"><CODE>evict(Object pc)</CODE></A></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="refresh(java.lang.Object)"><!-- --></A><H3> |
| refresh</H3> |
| <PRE> |
| void <B>refresh</B>(java.lang.Object pc)</PRE> |
| <DL> |
| <DD>Refresh the state of the instance from the data store. |
| |
| <P>In an optimistic transaction, the state of instances in the cache |
| might not match the state in the data store. This method is used to |
| reload the state of the instance from the data store so that a subsequent |
| commit is more likely to succeed. |
| <P>Outside a transaction, this method will refresh nontransactional |
| state. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>pc</CODE> - the instance to refresh.</DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="refreshAll(java.lang.Object[])"><!-- --></A><H3> |
| refreshAll</H3> |
| <PRE> |
| void <B>refreshAll</B>(java.lang.Object[] pcs)</PRE> |
| <DL> |
| <DD>Refresh the state of an array of instances from the data store. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>pcs</CODE> - the array of instances to refresh.<DT><B>See Also:</B><DD><A HREF="../../javax/jdo/PersistenceManager.html#refresh(java.lang.Object)"><CODE>refresh(Object pc)</CODE></A></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="refreshAll(java.util.Collection)"><!-- --></A><H3> |
| refreshAll</H3> |
| <PRE> |
| void <B>refreshAll</B>(java.util.Collection pcs)</PRE> |
| <DL> |
| <DD>Refresh the state of a <code>Collection</code> of instances from the |
| data store. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>pcs</CODE> - the <code>Collection</code> of instances to refresh.<DT><B>See Also:</B><DD><A HREF="../../javax/jdo/PersistenceManager.html#refresh(java.lang.Object)"><CODE>refresh(Object pc)</CODE></A></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="refreshAll()"><!-- --></A><H3> |
| refreshAll</H3> |
| <PRE> |
| void <B>refreshAll</B>()</PRE> |
| <DL> |
| <DD>Refresh the state of all applicable instances from the data store. |
| <P>If called with an active transaction, all transactional instances |
| will be refreshed. If called outside an active transaction, all |
| nontransactional instances will be refreshed. |
| <P> |
| <DD><DL> |
| <DT><B>See Also:</B><DD><A HREF="../../javax/jdo/PersistenceManager.html#refresh(java.lang.Object)"><CODE>refresh(Object pc)</CODE></A></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="refreshAll(javax.jdo.JDOException)"><!-- --></A><H3> |
| refreshAll</H3> |
| <PRE> |
| void <B>refreshAll</B>(<A HREF="../../javax/jdo/JDOException.html" title="class in javax.jdo">JDOException</A> jdoe)</PRE> |
| <DL> |
| <DD>Refreshes all instances in the exception that failed verification. |
| <P> |
| <DD><DL> |
| <DT><B>Since:</B></DT> |
| <DD>2.0</DD> |
| </DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="newQuery()"><!-- --></A><H3> |
| newQuery</H3> |
| <PRE> |
| <A HREF="../../javax/jdo/Query.html" title="interface in javax.jdo">Query</A> <B>newQuery</B>()</PRE> |
| <DL> |
| <DD>Create a new <code>Query</code> with no elements. |
| <P> |
| <DD><DL> |
| |
| <DT><B>Returns:</B><DD>the new <code>Query</code>.</DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="newQuery(java.lang.Object)"><!-- --></A><H3> |
| newQuery</H3> |
| <PRE> |
| <A HREF="../../javax/jdo/Query.html" title="interface in javax.jdo">Query</A> <B>newQuery</B>(java.lang.Object compiled)</PRE> |
| <DL> |
| <DD>Create a new <code>Query</code> using elements from another |
| <code>Query</code>. The other <code>Query</code> must have been created |
| by the same JDO implementation. It might be active in a different |
| <code>PersistenceManager</code> or might have been serialized and |
| restored. |
| <P>All of the settings of the other <code>Query</code> are copied to this |
| <code>Query</code>, except for the candidate <code>Collection</code> or |
| <code>Extent</code>. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>compiled</CODE> - another <code>Query</code> from the same JDO |
| implementation |
| <DT><B>Returns:</B><DD>the new <code>Query</code></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="newQuery(java.lang.String)"><!-- --></A><H3> |
| newQuery</H3> |
| <PRE> |
| <A HREF="../../javax/jdo/Query.html" title="interface in javax.jdo">Query</A> <B>newQuery</B>(java.lang.String query)</PRE> |
| <DL> |
| <DD>Create a Construct a new query instance using the specified String |
| as the single-string representation of the query. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>query</CODE> - the single-string query |
| <DT><B>Returns:</B><DD>the new <code>Query</code><DT><B>Since:</B></DT> |
| <DD>2.0</DD> |
| </DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="newQuery(java.lang.String, java.lang.Object)"><!-- --></A><H3> |
| newQuery</H3> |
| <PRE> |
| <A HREF="../../javax/jdo/Query.html" title="interface in javax.jdo">Query</A> <B>newQuery</B>(java.lang.String language, |
| java.lang.Object query)</PRE> |
| <DL> |
| <DD>Create a new <code>Query</code> using the specified language. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>language</CODE> - the language of the query parameter<DD><CODE>query</CODE> - the query, which is of a form determined by the language |
| <DT><B>Returns:</B><DD>the new <code>Query</code></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="newQuery(java.lang.Class)"><!-- --></A><H3> |
| newQuery</H3> |
| <PRE> |
| <A HREF="../../javax/jdo/Query.html" title="interface in javax.jdo">Query</A> <B>newQuery</B>(java.lang.Class cls)</PRE> |
| <DL> |
| <DD>Create a new <code>Query</code> specifying the <code>Class</code> of the |
| candidate instances. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>cls</CODE> - the <code>Class</code> of the candidate instances |
| <DT><B>Returns:</B><DD>the new <code>Query</code></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="newQuery(javax.jdo.Extent)"><!-- --></A><H3> |
| newQuery</H3> |
| <PRE> |
| <A HREF="../../javax/jdo/Query.html" title="interface in javax.jdo">Query</A> <B>newQuery</B>(<A HREF="../../javax/jdo/Extent.html" title="interface in javax.jdo">Extent</A> cln)</PRE> |
| <DL> |
| <DD>Create a new <code>Query</code> with the <code>Class</code> of the |
| candidate instances and candidate <code>Extent</code>. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>cln</CODE> - the <code>Extent</code> of candidate instances |
| <DT><B>Returns:</B><DD>the new <code>Query</code></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="newQuery(java.lang.Class, java.util.Collection)"><!-- --></A><H3> |
| newQuery</H3> |
| <PRE> |
| <A HREF="../../javax/jdo/Query.html" title="interface in javax.jdo">Query</A> <B>newQuery</B>(java.lang.Class cls, |
| java.util.Collection cln)</PRE> |
| <DL> |
| <DD>Create a new <code>Query</code> with the candidate <code>Class</code> |
| and <code>Collection</code>. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>cls</CODE> - the <code>Class</code> of results<DD><CODE>cln</CODE> - the <code>Collection</code> of candidate instances |
| <DT><B>Returns:</B><DD>the new <code>Query</code></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="newQuery(java.lang.Class, java.lang.String)"><!-- --></A><H3> |
| newQuery</H3> |
| <PRE> |
| <A HREF="../../javax/jdo/Query.html" title="interface in javax.jdo">Query</A> <B>newQuery</B>(java.lang.Class cls, |
| java.lang.String filter)</PRE> |
| <DL> |
| <DD>Create a new <code>Query</code> with the <code>Class</code> of the |
| candidate instances and filter. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>cls</CODE> - the <code>Class</code> of results<DD><CODE>filter</CODE> - the filter for candidate instances |
| <DT><B>Returns:</B><DD>the new <code>Query</code></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="newQuery(java.lang.Class, java.util.Collection, java.lang.String)"><!-- --></A><H3> |
| newQuery</H3> |
| <PRE> |
| <A HREF="../../javax/jdo/Query.html" title="interface in javax.jdo">Query</A> <B>newQuery</B>(java.lang.Class cls, |
| java.util.Collection cln, |
| java.lang.String filter)</PRE> |
| <DL> |
| <DD>Create a new <code>Query</code> with the <code>Class</code> of the |
| candidate instances, |
| candidate <code>Collection</code>, and filter. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>cls</CODE> - the <code>Class</code> of candidate instances<DD><CODE>cln</CODE> - the <code>Collection</code> of candidate instances<DD><CODE>filter</CODE> - the filter for candidate instances |
| <DT><B>Returns:</B><DD>the new <code>Query</code></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="newQuery(javax.jdo.Extent, java.lang.String)"><!-- --></A><H3> |
| newQuery</H3> |
| <PRE> |
| <A HREF="../../javax/jdo/Query.html" title="interface in javax.jdo">Query</A> <B>newQuery</B>(<A HREF="../../javax/jdo/Extent.html" title="interface in javax.jdo">Extent</A> cln, |
| java.lang.String filter)</PRE> |
| <DL> |
| <DD>Create a new <code>Query</code> with the |
| candidate <code>Extent</code> and filter; the class |
| is taken from the <code>Extent</code>. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>cln</CODE> - the <code>Extent</code> of candidate instances<DD><CODE>filter</CODE> - the filter for candidate instances |
| <DT><B>Returns:</B><DD>the new <code>Query</code></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="newNamedQuery(java.lang.Class, java.lang.String)"><!-- --></A><H3> |
| newNamedQuery</H3> |
| <PRE> |
| <A HREF="../../javax/jdo/Query.html" title="interface in javax.jdo">Query</A> <B>newNamedQuery</B>(java.lang.Class cls, |
| java.lang.String queryName)</PRE> |
| <DL> |
| <DD>Create a new <code>Query</code> with the given candidate class |
| from a named query. The query name given must be the name of a |
| query defined in metadata. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>cls</CODE> - the <code>Class</code> of candidate instances<DD><CODE>queryName</CODE> - the name of the query to look up in metadata |
| <DT><B>Returns:</B><DD>the new <code>Query</code></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="getExtent(java.lang.Class, boolean)"><!-- --></A><H3> |
| getExtent</H3> |
| <PRE> |
| <A HREF="../../javax/jdo/Extent.html" title="interface in javax.jdo">Extent</A> <B>getExtent</B>(java.lang.Class persistenceCapableClass, |
| boolean subclasses)</PRE> |
| <DL> |
| <DD>The <code>PersistenceManager</code> manages a collection of instances in |
| the data store based on the class of the instances. This method returns |
| an <code>Extent</code> of instances in the data store that might be |
| iterated or given to a <code>Query</code>. The <code>Extent</code> |
| itself might not reference any instances, but only hold the class name |
| and an indicator as to whether subclasses are included in the |
| <code>Extent</code>. |
| <P>Note that the <code>Extent</code> might be very large. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>persistenceCapableClass</CODE> - <code>Class</code> of instances<DD><CODE>subclasses</CODE> - whether to include instances of subclasses |
| <DT><B>Returns:</B><DD>an <code>Extent</code> of the specified <code>Class</code><DT><B>See Also:</B><DD><A HREF="../../javax/jdo/Query.html" title="interface in javax.jdo"><CODE>Query</CODE></A></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="getExtent(java.lang.Class)"><!-- --></A><H3> |
| getExtent</H3> |
| <PRE> |
| <A HREF="../../javax/jdo/Extent.html" title="interface in javax.jdo">Extent</A> <B>getExtent</B>(java.lang.Class persistenceCapableClass)</PRE> |
| <DL> |
| <DD>Equivalent to <code>getExtent (persistenceCapableClass, |
| true)</code>. |
| <P> |
| <DD><DL> |
| <DT><B>Since:</B></DT> |
| <DD>2.0</DD> |
| <DT><B>See Also:</B><DD><A HREF="../../javax/jdo/PersistenceManager.html#getExtent(java.lang.Class, boolean)"><CODE>getExtent(Class,boolean)</CODE></A></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="getObjectById(java.lang.Object, boolean)"><!-- --></A><H3> |
| getObjectById</H3> |
| <PRE> |
| java.lang.Object <B>getObjectById</B>(java.lang.Object oid, |
| boolean validate)</PRE> |
| <DL> |
| <DD>This method locates a persistent instance in the cache of instances |
| managed by this <code>PersistenceManager</code>. |
| The <code>getObjectById</code> method attempts |
| to find an instance in the cache with the specified JDO identity. |
| The <code>oid</code> parameter object might have been returned by an |
| earlier call to <code>getObjectId</code> or |
| <code>getTransactionalObjectId</code>, or might have been constructed by |
| the application. |
| <P>If the <code>PersistenceManager</code> is unable to resolve the |
| <code>oid</code> parameter to an ObjectId instance, then it throws a |
| <code>JDOUserException</code>. |
| <P>If the <code>validate</code> flag is <code>false</code>, and there is |
| already an instance in the cache with the same JDO identity as the |
| <code>oid</code> parameter, then this method returns it. There is no |
| change made to the state of the returned instance. |
| <P>If there is not an instance already in the cache with the same JDO |
| identity as the <code>oid</code> parameter, then this method creates an |
| instance with the specified JDO identity and returns it. If there is no |
| transaction in progress, the returned instance will be hollow or |
| persistent-nontransactional, at the choice of the implementation. |
| <P>If there is a transaction in progress, the returned instance will |
| be hollow, persistent-nontransactional, or persistent-clean, at the |
| choice of the implementation. |
| <P>It is an implementation decision whether to access the data store, |
| if required to determine the exact class. This will be the case of |
| inheritance, where multiple <code>PersistenceCapable</code> classes share |
| the same ObjectId class. |
| <P>If the validate flag is <code>false</code>, and the instance does not |
| exist in the data store, then this method might not fail. It is an |
| implementation choice whether to fail immediately with a |
| <code>JDOObjectNotFoundException</code>. But a subsequent access |
| of the fields of the |
| instance will throw a <code>JDOObjectNotFoundException</code> |
| if the instance does not |
| exist at that time. Further, if a relationship is established to this |
| instance, then the transaction in which the association was made will |
| fail. |
| <P>If the <code>validate</code> flag is <code>true</code>, and there is |
| already a transactional instance in the cache with the same JDO identity |
| as the <code>oid</code> parameter, then this method returns it. There is |
| no change made to the state of the returned instance. |
| <P>If there is an instance already in the cache with the same JDO |
| identity as the <code>oid</code> parameter, but the instance is not |
| transactional, then it must be verified in the data store. If the |
| instance does not exist in the datastore, then a |
| <code>JDOObjectNotFoundException</code> is thrown. |
| <P>If there is not an instance already in the cache with the same JDO |
| identity as the <code>oid</code> parameter, then this method creates an |
| instance with the specified JDO identity, verifies that it exists in the |
| data store, and returns it. If there is no transaction in progress, the |
| returned instance will be hollow or persistent-nontransactional, |
| at the choice of the implementation. |
| <P>If there is a data store transaction in progress, the returned |
| instance will be persistent-clean. |
| If there is an optimistic transaction in progress, the returned |
| instance will be persistent-nontransactional. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>oid</CODE> - an ObjectId<DD><CODE>validate</CODE> - if the existence of the instance is to be validated |
| <DT><B>Returns:</B><DD>the <code>PersistenceCapable</code> instance with the specified |
| ObjectId<DT><B>See Also:</B><DD><A HREF="../../javax/jdo/PersistenceManager.html#getObjectId(java.lang.Object)"><CODE>getObjectId(Object pc)</CODE></A>, |
| <A HREF="../../javax/jdo/PersistenceManager.html#getTransactionalObjectId(java.lang.Object)"><CODE>getTransactionalObjectId(Object pc)</CODE></A></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="getObjectById(java.lang.Class, java.lang.Object)"><!-- --></A><H3> |
| getObjectById</H3> |
| <PRE> |
| java.lang.Object <B>getObjectById</B>(java.lang.Class cls, |
| java.lang.Object key)</PRE> |
| <DL> |
| <DD>Looks up the instance of the given type with the given key. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>cls</CODE> - The type of object to load<DD><CODE>key</CODE> - either the string representation of the object id, or |
| an object representation of a single field identity key |
| <DT><B>Returns:</B><DD>the corresponding persistent instance<DT><B>Since:</B></DT> |
| <DD>2.0</DD> |
| </DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="getObjectById(java.lang.Object)"><!-- --></A><H3> |
| getObjectById</H3> |
| <PRE> |
| java.lang.Object <B>getObjectById</B>(java.lang.Object oid)</PRE> |
| <DL> |
| <DD>Looks up the instance corresponding to the specified oid. This is |
| equivalent to <code>getObjectById(oid, true); |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>oid</CODE> - The object id of the object to load |
| <DT><B>Returns:</B><DD>the corresponding persistent instance</DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="getObjectId(java.lang.Object)"><!-- --></A><H3> |
| getObjectId</H3> |
| <PRE> |
| java.lang.Object <B>getObjectId</B>(java.lang.Object pc)</PRE> |
| <DL> |
| <DD>The ObjectId returned by this method represents the JDO identity of |
| the instance. The ObjectId is a copy (clone) of the internal state |
| of the instance, and changing it does not affect the JDO identity of |
| the instance. |
| <P>The <code>getObjectId</code> method returns an ObjectId instance that |
| represents the object identity of the specified JDO instance. The |
| identity is guaranteed to be unique only in the context of the JDO |
| <code>PersistenceManager</code> that created the identity, and only for |
| two types of JDO Identity: those that are managed by the application, and |
| those that are managed by the data store. |
| <P>If the object identity is being changed in the transaction, by the |
| application modifying one or more of the application key fields, |
| then this method returns the identity as of the beginning of the |
| transaction. The value returned by <code>getObjectId</code> will be |
| different following <code>afterCompletion</code> processing for |
| successful transactions. <P>Within a transaction, the ObjectId returned |
| will compare equal to the ObjectId returned by only one among all JDO |
| instances associated with the <code>PersistenceManager</code> regardless |
| of the type of ObjectId. |
| <P>The ObjectId does not necessarily contain any internal state of the |
| instance, nor is it necessarily an instance of the class used to |
| manage identity internally. Therefore, if the application makes a |
| change to the ObjectId instance returned by this method, there is |
| no effect on the instance from which the ObjectId was obtained. |
| <P>The <code>getObjectById</code> method can be used between instances of |
| <code>PersistenceManager</code> of different JDO vendors only for |
| instances of persistence capable classes using application-managed |
| (primary key) JDO identity. If it is used for instances of classes using |
| datastore identity, the method might succeed, but there are no guarantees |
| that the parameter and return instances are related in any way. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>pc</CODE> - the <code>PersistenceCapable</code> instance |
| <DT><B>Returns:</B><DD>the ObjectId of the instance<DT><B>See Also:</B><DD><A HREF="../../javax/jdo/PersistenceManager.html#getTransactionalObjectId(java.lang.Object)"><CODE>getTransactionalObjectId(Object pc)</CODE></A>, |
| <A HREF="../../javax/jdo/PersistenceManager.html#getObjectById(java.lang.Object, boolean)"><CODE>getObjectById(Object oid, boolean validate)</CODE></A></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="getTransactionalObjectId(java.lang.Object)"><!-- --></A><H3> |
| getTransactionalObjectId</H3> |
| <PRE> |
| java.lang.Object <B>getTransactionalObjectId</B>(java.lang.Object pc)</PRE> |
| <DL> |
| <DD>The ObjectId returned by this method represents the JDO identity of |
| the instance. The ObjectId is a copy (clone) of the internal state |
| of the instance, and changing it does not affect the JDO identity of |
| the instance. |
| <P>If the object identity is being changed in the transaction, by the |
| application modifying one or more of the application key fields, |
| then this method returns the current identity in the transaction. |
| <P>If there is no transaction in progress, or if none of the key fields |
| is being modified, then this method will return the same value as |
| <code>getObjectId</code>. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>pc</CODE> - a <code>PersistenceCapable</code> instance |
| <DT><B>Returns:</B><DD>the ObjectId of the instance<DT><B>See Also:</B><DD><A HREF="../../javax/jdo/PersistenceManager.html#getObjectId(java.lang.Object)"><CODE>getObjectId(Object pc)</CODE></A>, |
| <A HREF="../../javax/jdo/PersistenceManager.html#getObjectById(java.lang.Object, boolean)"><CODE>getObjectById(Object oid, boolean validate)</CODE></A></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="newObjectIdInstance(java.lang.Class, java.lang.Object)"><!-- --></A><H3> |
| newObjectIdInstance</H3> |
| <PRE> |
| java.lang.Object <B>newObjectIdInstance</B>(java.lang.Class pcClass, |
| java.lang.Object key)</PRE> |
| <DL> |
| <DD>This method returns an object id instance corresponding to the pcClass |
| and key arguments. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>pcClass</CODE> - the <code>Class</code> of the persistence-capable instance<DD><CODE>key</CODE> - for single-field identity, the parameter for the |
| constructor; for non-single-field application identity, the result |
| of toString() on the object id instance. |
| <DT><B>Returns:</B><DD>an instance of the object identity class</DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="getObjectsById(java.util.Collection, boolean)"><!-- --></A><H3> |
| getObjectsById</H3> |
| <PRE> |
| java.util.Collection <B>getObjectsById</B>(java.util.Collection oids, |
| boolean validate)</PRE> |
| <DL> |
| <DD>Return the objects with the given oids. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>oids</CODE> - the oids of the objects to return<DD><CODE>validate</CODE> - if true, the existance of the objects in |
| the datastore will be validated. |
| <DT><B>Returns:</B><DD>the objects that were looked up, in the |
| same order as the oids parameter.<DT><B>Since:</B></DT> |
| <DD>2.0</DD> |
| <DT><B>See Also:</B><DD><A HREF="../../javax/jdo/PersistenceManager.html#getObjectById(java.lang.Object, boolean)"><CODE>getObjectById(Object,boolean)</CODE></A></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="getObjectsById(java.util.Collection)"><!-- --></A><H3> |
| getObjectsById</H3> |
| <PRE> |
| java.util.Collection <B>getObjectsById</B>(java.util.Collection oids)</PRE> |
| <DL> |
| <DD>Return the objects with the given oids. This method is equivalent |
| to calling <A HREF="../../javax/jdo/PersistenceManager.html#getObjectsById(java.util.Collection, boolean)"><CODE>getObjectsById(Collection, boolean)</CODE></A> |
| with the validate flag true. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>oids</CODE> - the oids of the objects to return |
| <DT><B>Returns:</B><DD>the objects that were looked up, in the |
| same order as the oids parameter.<DT><B>Since:</B></DT> |
| <DD>2.0</DD> |
| <DT><B>See Also:</B><DD><A HREF="../../javax/jdo/PersistenceManager.html#getObjectsById(java.util.Collection, boolean)"><CODE>getObjectsById(Collection,boolean)</CODE></A></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="getObjectsById(java.lang.Object[], boolean)"><!-- --></A><H3> |
| getObjectsById</H3> |
| <PRE> |
| java.lang.Object[] <B>getObjectsById</B>(java.lang.Object[] oids, |
| boolean validate)</PRE> |
| <DL> |
| <DD><B>Deprecated.</B> <I></I> |
| <P> |
| <DD>Return the objects with the given oids. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>oids</CODE> - the oids of the objects to return<DD><CODE>validate</CODE> - if true, the existance of the objects in |
| the datastore will be validated. |
| <DT><B>Returns:</B><DD>the objects that were looked up, in the |
| same order as the oids parameter.<DT><B>Since:</B></DT> |
| <DD>2.0</DD> |
| <DT><B>See Also:</B><DD><A HREF="../../javax/jdo/PersistenceManager.html#getObjectById(java.lang.Object, boolean)"><CODE>getObjectById(Object,boolean)</CODE></A>, |
| <A HREF="../../javax/jdo/PersistenceManager.html#getObjectsById(boolean, java.lang.Object[])"><CODE>getObjectsById(boolean,Object[])</CODE></A></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="getObjectsById(boolean, java.lang.Object[])"><!-- --></A><H3> |
| getObjectsById</H3> |
| <PRE> |
| java.lang.Object[] <B>getObjectsById</B>(boolean validate, |
| java.lang.Object[] oids)</PRE> |
| <DL> |
| <DD>Return the objects with the given oids. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>oids</CODE> - the oids of the objects to return<DD><CODE>validate</CODE> - if true, the existance of the objects in |
| the datastore will be validated. |
| <DT><B>Returns:</B><DD>the objects that were looked up, in the |
| same order as the oids parameter.<DT><B>Since:</B></DT> |
| <DD>2.1</DD> |
| <DT><B>See Also:</B><DD><A HREF="../../javax/jdo/PersistenceManager.html#getObjectById(java.lang.Object, boolean)"><CODE>getObjectById(Object,boolean)</CODE></A></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="getObjectsById(java.lang.Object[])"><!-- --></A><H3> |
| getObjectsById</H3> |
| <PRE> |
| java.lang.Object[] <B>getObjectsById</B>(java.lang.Object[] oids)</PRE> |
| <DL> |
| <DD>Return the objects with the given oids. This method is equivalent |
| to calling <A HREF="../../javax/jdo/PersistenceManager.html#getObjectsById(java.lang.Object[], boolean)"><CODE>getObjectsById(Object[],boolean)</CODE></A> |
| with the validate flag true. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>oids</CODE> - the oids of the objects to return |
| <DT><B>Returns:</B><DD>the objects that were looked up, in the |
| same order as the oids parameter.<DT><B>Since:</B></DT> |
| <DD>2.0</DD> |
| <DT><B>See Also:</B><DD><A HREF="../../javax/jdo/PersistenceManager.html#getObjectsById(java.lang.Object[], boolean)"><CODE>getObjectsById(Object[],boolean)</CODE></A></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="makePersistent(java.lang.Object)"><!-- --></A><H3> |
| makePersistent</H3> |
| <PRE> |
| java.lang.Object <B>makePersistent</B>(java.lang.Object pc)</PRE> |
| <DL> |
| <DD>Make the parameter instance persistent in this |
| <code>PersistenceManager</code>. |
| This method makes transient instances persistent and applies detached |
| instance changes to the cache. It must be called in the context of |
| an active transaction, or a JDOUserException is thrown. For a transient |
| instance, it assigns an object identity to the instance and transitions |
| it to persistent-new. Any transient instances reachable from this |
| instance via persistent fields of this instance become provisionally |
| persistent, transitively. That is, they behave as persistent-new |
| instances (return true to isPersistent, isNew, and isDirty). |
| But at commit time, the reachability algorithm is run again, |
| and instances made provisionally persistent that are not then |
| reachable from persistent instances will revert to transient. |
| <P>During makePersistent of transient instances, the create life cycle |
| listener is called. |
| <P>For detached instances, it locates or instantiates a persistent |
| instance with the same JDO identity as the detached instance, |
| and merges the persistent state of the detached instance into the |
| persistent instance. Only the state of persistent fields is merged. |
| If non-persistent state needs to be copied, the application should |
| use the jdoPostAttach callback or the postAttach lifecycle event |
| listener. Any references to the detached instances from instances |
| in the closure of the parameter instances are modified to refer to |
| the corresponding persistent instance instead of to the |
| detached instance. |
| <P>During attachment of detached instances, the attach callbacks |
| and attach life cycle listeners are called. |
| <P>During application of changes of the detached state, if the JDO |
| implementation can determine that there were no changes made during |
| detachment, then the implementation is not required to mark the |
| corresponding instance dirty. If it cannot determine if changes |
| were made, then it must mark the instance dirty. |
| No consistency checking is done during makePersistent of detached |
| instances. If consistency checking is required by the application, |
| then flush or checkConsistency should be called after attaching the |
| instances. |
| <P>These methods have no effect on parameter persistent instances |
| already managed by this PersistenceManager. They will throw a |
| JDOUserException if the parameter instance is managed by a |
| different PersistenceManager. |
| If an instance is of a class whose identity type (application, |
| datastore, or none) is not supported by the JDO implementation, |
| then a JDOUserException will be thrown for that instance. |
| The return value for parameter instances in the transient or persistent |
| states is the same as the parameter value. The return value for |
| parameter instances in the detached state is the persistent instance |
| corresponding to the detached instance. |
| The return values for makePersistentAll methods correspond by position |
| to the parameter instances. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>pc</CODE> - an instance of a <code>Class</code> that is persistent |
| capable. |
| <DT><B>Returns:</B><DD>the parameter instance for parameters in the transient or |
| persistent state, or the corresponding persistent instance |
| for detached parameter instances</DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="makePersistentAll(java.lang.Object[])"><!-- --></A><H3> |
| makePersistentAll</H3> |
| <PRE> |
| java.lang.Object[] <B>makePersistentAll</B>(java.lang.Object[] pcs)</PRE> |
| <DL> |
| <DD>Make an array of instances persistent. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>pcs</CODE> - an array of instances |
| <DT><B>Returns:</B><DD>the parameter instances for parameters in the transient or |
| persistent state, or the corresponding persistent instance |
| for detached parameter instances, in the same order as in the |
| parameter array<DT><B>See Also:</B><DD><A HREF="../../javax/jdo/PersistenceManager.html#makePersistent(java.lang.Object)"><CODE>makePersistent(Object pc)</CODE></A></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="makePersistentAll(java.util.Collection)"><!-- --></A><H3> |
| makePersistentAll</H3> |
| <PRE> |
| java.util.Collection <B>makePersistentAll</B>(java.util.Collection pcs)</PRE> |
| <DL> |
| <DD>Make a <code>Collection</code> of instances persistent. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>pcs</CODE> - a <code>Collection</code> of instances |
| <DT><B>Returns:</B><DD>the parameter instance for parameters in the transient or |
| persistent state, or the corresponding persistent instance |
| for detached parameter instances, with an iteration in the same order |
| as in the parameter Collection<DT><B>See Also:</B><DD><A HREF="../../javax/jdo/PersistenceManager.html#makePersistent(java.lang.Object)"><CODE>makePersistent(Object pc)</CODE></A></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="deletePersistent(java.lang.Object)"><!-- --></A><H3> |
| deletePersistent</H3> |
| <PRE> |
| void <B>deletePersistent</B>(java.lang.Object pc)</PRE> |
| <DL> |
| <DD>Delete the persistent instance from the data store. |
| This method must be called in an active transaction. |
| The data store object will be removed at commit. |
| Unlike <code>makePersistent</code>, which makes the closure of the |
| instance persistent, the closure of the instance is not deleted from the |
| data store. This method has no effect if the instance is already deleted |
| in the current transaction. |
| This method throws <code>JDOUserException</code> if the instance is |
| transient or is managed by another <code>PersistenceManager</code>. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>pc</CODE> - a persistent instance</DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="deletePersistentAll(java.lang.Object[])"><!-- --></A><H3> |
| deletePersistentAll</H3> |
| <PRE> |
| void <B>deletePersistentAll</B>(java.lang.Object[] pcs)</PRE> |
| <DL> |
| <DD>Delete an array of instances from the data store. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>pcs</CODE> - a <code>Collection</code> of persistent instances<DT><B>See Also:</B><DD><A HREF="../../javax/jdo/PersistenceManager.html#deletePersistent(java.lang.Object)"><CODE>deletePersistent(Object pc)</CODE></A></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="deletePersistentAll(java.util.Collection)"><!-- --></A><H3> |
| deletePersistentAll</H3> |
| <PRE> |
| void <B>deletePersistentAll</B>(java.util.Collection pcs)</PRE> |
| <DL> |
| <DD>Delete a <code>Collection</code> of instances from the data store. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>pcs</CODE> - a <code>Collection</code> of persistent instances<DT><B>See Also:</B><DD><A HREF="../../javax/jdo/PersistenceManager.html#deletePersistent(java.lang.Object)"><CODE>deletePersistent(Object pc)</CODE></A></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="makeTransient(java.lang.Object)"><!-- --></A><H3> |
| makeTransient</H3> |
| <PRE> |
| void <B>makeTransient</B>(java.lang.Object pc)</PRE> |
| <DL> |
| <DD>Make an instance transient, removing it from management by this |
| <code>PersistenceManager</code>. |
| |
| <P>The instance loses its JDO identity and it is no longer associated |
| with any <code>PersistenceManager</code>. The state of fields is |
| preserved unchanged. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>pc</CODE> - the instance to make transient.</DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="makeTransientAll(java.lang.Object[])"><!-- --></A><H3> |
| makeTransientAll</H3> |
| <PRE> |
| void <B>makeTransientAll</B>(java.lang.Object[] pcs)</PRE> |
| <DL> |
| <DD>Make an array of instances transient, removing them from management by |
| this <code>PersistenceManager</code>. |
| |
| <P>The instances lose their JDO identity and they are no longer |
| associated with any <code>PersistenceManager</code>. The state of fields |
| is preserved unchanged. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>pcs</CODE> - the instances to make transient.</DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="makeTransientAll(java.util.Collection)"><!-- --></A><H3> |
| makeTransientAll</H3> |
| <PRE> |
| void <B>makeTransientAll</B>(java.util.Collection pcs)</PRE> |
| <DL> |
| <DD>Make a <code>Collection</code> of instances transient, removing them |
| from management by this <code>PersistenceManager</code>. |
| |
| <P>The instances lose their JDO identity and they are no longer |
| associated with any <code>PersistenceManager</code>. The state of fields |
| is preserved unchanged. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>pcs</CODE> - the instances to make transient.</DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="makeTransient(java.lang.Object, boolean)"><!-- --></A><H3> |
| makeTransient</H3> |
| <PRE> |
| void <B>makeTransient</B>(java.lang.Object pc, |
| boolean useFetchPlan)</PRE> |
| <DL> |
| <DD>Make an instance transient, removing it from management by this |
| <code>PersistenceManager</code>. If the useFetchPlan parameter is |
| false, this method behaves exactly as makeTransient(Object pc). |
| <P>The affected instance(s) lose their JDO identity and are no longer |
| associated with any <code>PersistenceManager</code>. The state |
| of fields is unchanged. |
| <P>If the useFetchPlan parameter is true, then the current FetchPlan |
| is applied to the pc parameter, as if detachCopy(Object) had been |
| called. After the graph of instances is loaded, the instances |
| reachable via loaded fields is made transient. The state of fields |
| in the affected instances is as specified by the FetchPlan. |
| <P>Unlike detachCopy, the instances are not detached; there is no |
| detachment information in the instances. |
| <P>The instances to be made transient do not need to |
| implement the javax.jdo.spi.Detachable interface. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>pc</CODE> - the root instance to make transient.<DD><CODE>useFetchPlan</CODE> - whether to use the current fetch plan to determine |
| which fields to load and which instances to make transient<DT><B>Since:</B></DT> |
| <DD>2.0</DD> |
| </DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="makeTransientAll(java.lang.Object[], boolean)"><!-- --></A><H3> |
| makeTransientAll</H3> |
| <PRE> |
| void <B>makeTransientAll</B>(java.lang.Object[] pcs, |
| boolean useFetchPlan)</PRE> |
| <DL> |
| <DD><B>Deprecated.</B> <I></I> |
| <P> |
| <DD>Make instances transient, removing them from management |
| by this <code>PersistenceManager</code>. If the useFetchPlan parameter |
| is false, this method behaves exactly as makeTransientAll(Object[] pcs). |
| <P>The affected instance(s) lose their JDO identity and are no longer |
| associated with any <code>PersistenceManager</code>. The state |
| of fields is unchanged. |
| <P>If the useFetchPlan parameter is true, then the current FetchPlan |
| is applied to the pcs parameters and the entire graph of instances |
| reachable via loaded fields is made transient. The state of fields |
| in the affected instances is as specified by the FetchPlan. |
| <P>Unlike detachCopy, the instances are not detached; there is no |
| detachment information in the instances. |
| <P>The instances to be made transient do not need to |
| implement the javax.jdo.spi.Detachable interface. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>pcs</CODE> - the root instances to make transient.<DD><CODE>useFetchPlan</CODE> - whether to use the current fetch plan to determine |
| which fields to load and which instances to make transient<DT><B>Since:</B></DT> |
| <DD>2.0</DD> |
| <DT><B>See Also:</B><DD><A HREF="../../javax/jdo/PersistenceManager.html#makeTransientAll(boolean, java.lang.Object[])"><CODE>makeTransientAll(boolean,Object[])</CODE></A></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="makeTransientAll(boolean, java.lang.Object[])"><!-- --></A><H3> |
| makeTransientAll</H3> |
| <PRE> |
| void <B>makeTransientAll</B>(boolean useFetchPlan, |
| java.lang.Object[] pcs)</PRE> |
| <DL> |
| <DD>Make instances transient, removing them from management |
| by this <code>PersistenceManager</code>. If the useFetchPlan parameter |
| is false, this method behaves exactly as makeTransientAll(Object[] pcs). |
| <P>The affected instance(s) lose their JDO identity and are no longer |
| associated with any <code>PersistenceManager</code>. The state |
| of fields is unchanged. |
| <P>If the useFetchPlan parameter is true, then the current FetchPlan |
| is applied to the pcs parameters and the entire graph of instances |
| reachable via loaded fields is made transient. The state of fields |
| in the affected instances is as specified by the FetchPlan. |
| <P>Unlike detachCopy, the instances are not detached; there is no |
| detachment information in the instances. |
| <P>The instances to be made transient do not need to |
| implement the javax.jdo.spi.Detachable interface. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>pcs</CODE> - the root instances to make transient.<DD><CODE>useFetchPlan</CODE> - whether to use the current fetch plan to determine |
| which fields to load and which instances to make transient<DT><B>Since:</B></DT> |
| <DD>2.1</DD> |
| </DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="makeTransientAll(java.util.Collection, boolean)"><!-- --></A><H3> |
| makeTransientAll</H3> |
| <PRE> |
| void <B>makeTransientAll</B>(java.util.Collection pcs, |
| boolean useFetchPlan)</PRE> |
| <DL> |
| <DD>Make instances transient, removing them from management |
| by this <code>PersistenceManager</code>. If the useFetchPlan parameter |
| is false, this method behaves exactly as |
| makeTransientAll(Collection pcs). |
| <P>The affected instance(s) lose their JDO identity and are no longer |
| associated with any <code>PersistenceManager</code>. The state |
| of fields is unchanged. |
| <P>If the useFetchPlan parameter is true, then the current FetchPlan |
| is applied to the pcs parameters and the entire graph of instances |
| reachable via loaded fields is made transient. The state of fields |
| in the affected instances is as specified by the FetchPlan. |
| <P>Unlike detachCopy, the instances are not detached; there is no |
| detachment information in the instances. |
| <P>The instances to be made transient do not need to |
| implement the javax.jdo.spi.Detachable interface. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>pcs</CODE> - the root instances to make transient.<DD><CODE>useFetchPlan</CODE> - whether to use the current fetch plan to determine |
| which fields to load and which instances to make transient<DT><B>Since:</B></DT> |
| <DD>2.0</DD> |
| </DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="makeTransactional(java.lang.Object)"><!-- --></A><H3> |
| makeTransactional</H3> |
| <PRE> |
| void <B>makeTransactional</B>(java.lang.Object pc)</PRE> |
| <DL> |
| <DD>Make an instance subject to transactional boundaries. |
| |
| <P>Transient instances normally do not observe transaction boundaries. |
| This method makes transient instances sensitive to transaction |
| completion. If an instance is modified in a transaction, and the |
| transaction rolls back, the state of the instance is restored to the |
| state before the first change in the transaction. |
| |
| <P>For persistent instances read in optimistic transactions, this method |
| allows the application to make the state of the instance part of the |
| transactional state. At transaction commit, the state of the instance in |
| the cache is compared to the state of the instance in the data store. If |
| they are not the same, then an exception is thrown. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>pc</CODE> - the instance to make transactional.</DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="makeTransactionalAll(java.lang.Object[])"><!-- --></A><H3> |
| makeTransactionalAll</H3> |
| <PRE> |
| void <B>makeTransactionalAll</B>(java.lang.Object[] pcs)</PRE> |
| <DL> |
| <DD>Make an array of instances subject to transactional boundaries. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>pcs</CODE> - the array of instances to make transactional.<DT><B>See Also:</B><DD><A HREF="../../javax/jdo/PersistenceManager.html#makeTransactional(java.lang.Object)"><CODE>makeTransactional(Object pc)</CODE></A></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="makeTransactionalAll(java.util.Collection)"><!-- --></A><H3> |
| makeTransactionalAll</H3> |
| <PRE> |
| void <B>makeTransactionalAll</B>(java.util.Collection pcs)</PRE> |
| <DL> |
| <DD>Make a <code>Collection</code> of instances subject to transactional |
| boundaries. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>pcs</CODE> - the <code>Collection</code> of instances to make |
| transactional.<DT><B>See Also:</B><DD><A HREF="../../javax/jdo/PersistenceManager.html#makeTransactional(java.lang.Object)"><CODE>makeTransactional(Object pc)</CODE></A></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="makeNontransactional(java.lang.Object)"><!-- --></A><H3> |
| makeNontransactional</H3> |
| <PRE> |
| void <B>makeNontransactional</B>(java.lang.Object pc)</PRE> |
| <DL> |
| <DD>Make an instance non-transactional after commit. |
| |
| <P>Normally, at transaction completion, instances are evicted from the |
| cache. This method allows an application to identify an instance as |
| not being evicted from the cache at transaction completion. Instead, |
| the instance remains in the cache with nontransactional state. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>pc</CODE> - the instance to make nontransactional.</DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="makeNontransactionalAll(java.lang.Object[])"><!-- --></A><H3> |
| makeNontransactionalAll</H3> |
| <PRE> |
| void <B>makeNontransactionalAll</B>(java.lang.Object[] pcs)</PRE> |
| <DL> |
| <DD>Make an array of instances non-transactional after commit. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>pcs</CODE> - the array of instances to make nontransactional.<DT><B>See Also:</B><DD><A HREF="../../javax/jdo/PersistenceManager.html#makeNontransactional(java.lang.Object)"><CODE>makeNontransactional(Object pc)</CODE></A></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="makeNontransactionalAll(java.util.Collection)"><!-- --></A><H3> |
| makeNontransactionalAll</H3> |
| <PRE> |
| void <B>makeNontransactionalAll</B>(java.util.Collection pcs)</PRE> |
| <DL> |
| <DD>Make a <code>Collection</code> of instances non-transactional after |
| commit. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>pcs</CODE> - the <code>Collection</code> of instances to make |
| nontransactional.<DT><B>See Also:</B><DD><A HREF="../../javax/jdo/PersistenceManager.html#makeNontransactional(java.lang.Object)"><CODE>makeNontransactional(Object pc)</CODE></A></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="retrieve(java.lang.Object)"><!-- --></A><H3> |
| retrieve</H3> |
| <PRE> |
| void <B>retrieve</B>(java.lang.Object pc)</PRE> |
| <DL> |
| <DD>Retrieve field values of an instance from the store. This tells |
| the <code>PersistenceManager</code> that the application intends to use |
| the instance, and its field values must be retrieved. |
| <P>The <code>PersistenceManager</code> might use policy information about |
| the class to retrieve associated instances. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>pc</CODE> - the instance</DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="retrieve(java.lang.Object, boolean)"><!-- --></A><H3> |
| retrieve</H3> |
| <PRE> |
| void <B>retrieve</B>(java.lang.Object pc, |
| boolean useFetchPlan)</PRE> |
| <DL> |
| <DD>Retrieve field values of an instance from the store. This tells |
| the <code>PersistenceManager</code> that the application intends to use |
| the instance, and its field values must be retrieved. |
| <P>If the useFetchPlan parameter is false, this method behaves exactly |
| as the corresponding method without the useFetchPlan parameter. |
| If the useFetchPlan parameter is true, and the fetch plan has not been |
| modified from its default setting, all fields in the current fetch plan |
| are fetched, and other fields might be fetched lazily by the |
| implementation. If the useFetchPlan parameter is true, and the fetch |
| plan has been changed from its default setting, then the fields |
| specified by the fetch plan are loaded, along with related instances |
| specified by the fetch plan. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>pc</CODE> - the instance<DD><CODE>useFetchPlan</CODE> - whether to use the current fetch plan to determine |
| which fields to load and which instances to retrieve.<DT><B>Since:</B></DT> |
| <DD>2.0</DD> |
| </DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="retrieveAll(java.util.Collection)"><!-- --></A><H3> |
| retrieveAll</H3> |
| <PRE> |
| void <B>retrieveAll</B>(java.util.Collection pcs)</PRE> |
| <DL> |
| <DD>Retrieve field values of instances from the store. This tells |
| the <code>PersistenceManager</code> that the application intends to use |
| the instances, and all field values must be retrieved. |
| <P>The <code>PersistenceManager</code> might use policy information about |
| the class to retrieve associated instances. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>pcs</CODE> - the instances</DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="retrieveAll(java.util.Collection, boolean)"><!-- --></A><H3> |
| retrieveAll</H3> |
| <PRE> |
| void <B>retrieveAll</B>(java.util.Collection pcs, |
| boolean useFetchPlan)</PRE> |
| <DL> |
| <DD>Retrieve field values of instances from the store. This tells |
| the <code>PersistenceManager</code> that the application intends to use |
| the instances, and their field values should be retrieved. The fields |
| in the current fetch group must be retrieved, and the implementation |
| might retrieve more fields than the current fetch group. |
| <P>If the useFetchPlan parameter is false, this method behaves exactly |
| as the corresponding method without the useFetchPlan parameter. |
| If the useFetchPlan parameter is true, and the fetch plan has not been |
| modified from its default setting, all fields in the current fetch plan |
| are fetched, and other fields might be fetched lazily by the |
| implementation. If the useFetchPlan parameter is true, and the fetch |
| plan has been changed from its default setting, then the fields |
| specified by the fetch plan are loaded, along with related instances |
| specified by the fetch plan. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>pcs</CODE> - the instances<DD><CODE>useFetchPlan</CODE> - whether to use the current fetch plan to determine |
| which fields to load and which instances to retrieve.<DT><B>Since:</B></DT> |
| <DD>1.0.1</DD> |
| </DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="retrieveAll(java.lang.Object[])"><!-- --></A><H3> |
| retrieveAll</H3> |
| <PRE> |
| void <B>retrieveAll</B>(java.lang.Object[] pcs)</PRE> |
| <DL> |
| <DD>Retrieve field values of instances from the store. This tells |
| the <code>PersistenceManager</code> that the application intends to use |
| the instances, and all field values must be retrieved. |
| <P>The <code>PersistenceManager</code> might use policy information about |
| the class to retrieve associated instances. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>pcs</CODE> - the instances</DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="retrieveAll(java.lang.Object[], boolean)"><!-- --></A><H3> |
| retrieveAll</H3> |
| <PRE> |
| void <B>retrieveAll</B>(java.lang.Object[] pcs, |
| boolean useFetchPlan)</PRE> |
| <DL> |
| <DD><B>Deprecated.</B> <I></I> |
| <P> |
| <DD>Retrieve field values of instances from the store. This tells |
| the <code>PersistenceManager</code> that the application intends to use |
| the instances, and their field values should be retrieved. The fields |
| in the current fetch group must be retrieved, and the implementation |
| might retrieve more fields than the current fetch group. |
| <P>If the useFetchPlan parameter is false, this method behaves exactly |
| as the corresponding method without the useFetchPlan parameter. |
| If the useFetchPlan parameter is true, and the fetch plan has not been |
| modified from its default setting, all fields in the current fetch plan |
| are fetched, and other fields might be fetched lazily by the |
| implementation. If the useFetchPlan parameter is true, and the fetch |
| plan has been changed from its default setting, then the fields |
| specified by the fetch plan are loaded, along with related instances |
| specified by the fetch plan. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>pcs</CODE> - the instances<DD><CODE>useFetchPlan</CODE> - whether to use the current fetch plan to determine |
| which fields to load and which instances to retrieve.<DT><B>Since:</B></DT> |
| <DD>1.0.1</DD> |
| <DT><B>See Also:</B><DD><A HREF="../../javax/jdo/PersistenceManager.html#retrieveAll(boolean, java.lang.Object[])"><CODE>retrieveAll(boolean,Object[])</CODE></A></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="retrieveAll(boolean, java.lang.Object[])"><!-- --></A><H3> |
| retrieveAll</H3> |
| <PRE> |
| void <B>retrieveAll</B>(boolean useFetchPlan, |
| java.lang.Object[] pcs)</PRE> |
| <DL> |
| <DD>Retrieve field values of instances from the store. This tells |
| the <code>PersistenceManager</code> that the application intends to use |
| the instances, and their field values should be retrieved. The fields |
| in the current fetch group must be retrieved, and the implementation |
| might retrieve more fields than the current fetch group. |
| <P>If the useFetchPlan parameter is false, this method behaves exactly |
| as the corresponding method without the useFetchPlan parameter. |
| If the useFetchPlan parameter is true, and the fetch plan has not been |
| modified from its default setting, all fields in the current fetch plan |
| are fetched, and other fields might be fetched lazily by the |
| implementation. If the useFetchPlan parameter is true, and the fetch |
| plan has been changed from its default setting, then the fields |
| specified by the fetch plan are loaded, along with related instances |
| specified by the fetch plan. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>pcs</CODE> - the instances<DD><CODE>useFetchPlan</CODE> - whether to use the current fetch plan to determine |
| which fields to load and which instances to retrieve.<DT><B>Since:</B></DT> |
| <DD>2.1</DD> |
| </DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="setUserObject(java.lang.Object)"><!-- --></A><H3> |
| setUserObject</H3> |
| <PRE> |
| void <B>setUserObject</B>(java.lang.Object o)</PRE> |
| <DL> |
| <DD>The application can manage the <code>PersistenceManager</code> instances |
| more easily by having an application object associated with each |
| <code>PersistenceManager</code> instance. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>o</CODE> - the user instance to be remembered by the |
| <code>PersistenceManager</code><DT><B>See Also:</B><DD><A HREF="../../javax/jdo/PersistenceManager.html#getUserObject()"><CODE>getUserObject()</CODE></A></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="getUserObject()"><!-- --></A><H3> |
| getUserObject</H3> |
| <PRE> |
| java.lang.Object <B>getUserObject</B>()</PRE> |
| <DL> |
| <DD>The application can manage the <code>PersistenceManager</code> instances |
| more easily by having an application object associated with each |
| <code>PersistenceManager</code> instance. |
| <P> |
| <DD><DL> |
| |
| <DT><B>Returns:</B><DD>the user object associated with this |
| <code>PersistenceManager</code><DT><B>See Also:</B><DD><A HREF="../../javax/jdo/PersistenceManager.html#setUserObject(java.lang.Object)"><CODE>setUserObject(java.lang.Object)</CODE></A></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="getPersistenceManagerFactory()"><!-- --></A><H3> |
| getPersistenceManagerFactory</H3> |
| <PRE> |
| <A HREF="../../javax/jdo/PersistenceManagerFactory.html" title="interface in javax.jdo">PersistenceManagerFactory</A> <B>getPersistenceManagerFactory</B>()</PRE> |
| <DL> |
| <DD>This method returns the <code>PersistenceManagerFactory</code> used to |
| create this <code>PersistenceManager</code>. |
| <P> |
| <DD><DL> |
| |
| <DT><B>Returns:</B><DD>the <code>PersistenceManagerFactory</code> that created |
| this <code>PersistenceManager</code></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="getObjectIdClass(java.lang.Class)"><!-- --></A><H3> |
| getObjectIdClass</H3> |
| <PRE> |
| java.lang.Class <B>getObjectIdClass</B>(java.lang.Class cls)</PRE> |
| <DL> |
| <DD>Return the <code>Class</code> that implements the JDO Identity for the |
| specified <code>PersistenceCapable</code> class. The application can use |
| the returned <code>Class</code> to construct a JDO Identity instance for |
| application identity <code>PersistenceCapable</code> classes. This JDO |
| Identity instance can then be used to get an instance of the |
| <code>PersistenceCapable</code> class for use in the application. |
| |
| <P>In order for the application to construct an instance of the ObjectId |
| class it needs to know the class being used by the JDO implementation. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>cls</CODE> - the <code>PersistenceCapable Class</code> |
| <DT><B>Returns:</B><DD>the <code>Class</code> of the ObjectId of the parameter<DT><B>See Also:</B><DD><A HREF="../../javax/jdo/PersistenceManager.html#getObjectById(java.lang.Object, boolean)"><CODE>getObjectById(java.lang.Object, boolean)</CODE></A></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="setMultithreaded(boolean)"><!-- --></A><H3> |
| setMultithreaded</H3> |
| <PRE> |
| void <B>setMultithreaded</B>(boolean flag)</PRE> |
| <DL> |
| <DD>Set the Multithreaded flag for this <code>PersistenceManager</code>. |
| Applications that use multiple threads to invoke methods or access fields |
| from instances managed by this <code>PersistenceManager</code> must set |
| this flag to <code>true</code>. |
| Instances managed by this <code>PersistenceManager</code> include |
| persistent or transactional instances of <code>PersistenceCapable</code> |
| classes, as well as helper instances such as <code>Query</code>, |
| <code>Transaction</code>, or <code>Extent</code>. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>flag</CODE> - the Multithreaded setting.</DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="getMultithreaded()"><!-- --></A><H3> |
| getMultithreaded</H3> |
| <PRE> |
| boolean <B>getMultithreaded</B>()</PRE> |
| <DL> |
| <DD>Get the current Multithreaded flag for this |
| <code>PersistenceManager</code>. |
| <P> |
| <DD><DL> |
| |
| <DT><B>Returns:</B><DD>the Multithreaded setting.<DT><B>See Also:</B><DD><A HREF="../../javax/jdo/PersistenceManager.html#setMultithreaded(boolean)"><CODE>setMultithreaded(boolean)</CODE></A></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="setIgnoreCache(boolean)"><!-- --></A><H3> |
| setIgnoreCache</H3> |
| <PRE> |
| void <B>setIgnoreCache</B>(boolean flag)</PRE> |
| <DL> |
| <DD>Set the ignoreCache parameter for queries. |
| |
| <P>IgnoreCache set to <code>true</code> specifies that for all |
| <code>Query</code> instances created by this |
| <code>PersistenceManager</code>, the default is the cache should be |
| ignored for queries. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>flag</CODE> - the ignoreCache setting.</DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="getIgnoreCache()"><!-- --></A><H3> |
| getIgnoreCache</H3> |
| <PRE> |
| boolean <B>getIgnoreCache</B>()</PRE> |
| <DL> |
| <DD>Get the ignoreCache setting for queries. |
| |
| <P>IgnoreCache set to <code>true</code> specifies that for all |
| <code>Query</code> instances created by this |
| <code>PersistenceManager</code>, the default is the cache should be |
| ignored for queries. |
| <P> |
| <DD><DL> |
| |
| <DT><B>Returns:</B><DD>the ignoreCache setting.</DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="getDetachAllOnCommit()"><!-- --></A><H3> |
| getDetachAllOnCommit</H3> |
| <PRE> |
| boolean <B>getDetachAllOnCommit</B>()</PRE> |
| <DL> |
| <DD>Gets the detachAllOnCommit setting. |
| <P> |
| <DD><DL> |
| |
| <DT><B>Returns:</B><DD>the detachAllOnCommit setting.<DT><B>Since:</B></DT> |
| <DD>2.0</DD> |
| <DT><B>See Also:</B><DD><A HREF="../../javax/jdo/PersistenceManager.html#setDetachAllOnCommit(boolean)"><CODE>setDetachAllOnCommit(boolean)</CODE></A></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="setDetachAllOnCommit(boolean)"><!-- --></A><H3> |
| setDetachAllOnCommit</H3> |
| <PRE> |
| void <B>setDetachAllOnCommit</B>(boolean flag)</PRE> |
| <DL> |
| <DD>Sets the detachAllOnCommit setting. |
| |
| <P>DetachAllOnCommit set to <code>false</code> specifies that the |
| state of persistent instances in the cache after commit is defined |
| by the <code>retainValues</code> flag. With this flag set to true, |
| during beforeCompletion all cached instances are prepared for |
| detachment according to the fetch plan in effect at commit. Loading |
| fields and unloading fields required by the fetch plan is done after |
| calling the user's <code>beforeCompletion</code> callback. During |
| <code>afterCompletion</code>, before calling the user's |
| <code>afterCompletion</code> callback, all detachable persistent |
| instances in the cache transition to detached; non-detachable |
| persistent instances transition to transient; and detachable |
| instances can be serialized as detached instances. Transient |
| transactional instances are unaffected by this flag. |
| <P> |
| <DD><DL> |
| <DT><B>Since:</B></DT> |
| <DD>2.0</DD> |
| <DT><B>See Also:</B><DD><A HREF="../../javax/jdo/PersistenceManager.html#getDetachAllOnCommit()"><CODE>getDetachAllOnCommit()</CODE></A></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="getCopyOnAttach()"><!-- --></A><H3> |
| getCopyOnAttach</H3> |
| <PRE> |
| boolean <B>getCopyOnAttach</B>()</PRE> |
| <DL> |
| <DD>Gets the copyOnAttach setting. |
| <P> |
| <DD><DL> |
| |
| <DT><B>Returns:</B><DD>the copyOnAttach setting.<DT><B>Since:</B></DT> |
| <DD>2.1</DD> |
| <DT><B>See Also:</B><DD><A HREF="../../javax/jdo/PersistenceManager.html#setCopyOnAttach(boolean)"><CODE>setCopyOnAttach(boolean)</CODE></A></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="setCopyOnAttach(boolean)"><!-- --></A><H3> |
| setCopyOnAttach</H3> |
| <PRE> |
| void <B>setCopyOnAttach</B>(boolean flag)</PRE> |
| <DL> |
| <DD>Sets the copyOnAttach setting. |
| |
| <P>CopyOnAttach set to <code>true</code> specifies that during |
| makePersistent, copies are made of detached parameter instances. |
| With this flag set to <code>false</code>, detached parameter |
| instances are attached directly and change their state from |
| detached-clean to persistent-clean or from detached-dirty to |
| persistent-dirty. |
| <P> |
| <DD><DL> |
| <DT><B>Since:</B></DT> |
| <DD>2.1</DD> |
| <DT><B>See Also:</B><DD><A HREF="../../javax/jdo/PersistenceManager.html#getCopyOnAttach()"><CODE>getCopyOnAttach()</CODE></A></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="detachCopy(java.lang.Object)"><!-- --></A><H3> |
| detachCopy</H3> |
| <PRE> |
| java.lang.Object <B>detachCopy</B>(java.lang.Object pc)</PRE> |
| <DL> |
| <DD>Detach the specified instance from the <code>PersistenceManager</code>. |
| The flags for detachment (DETACH_LOAD_FIELDS and DETACH_UNLOAD_FIELDS) |
| and the active fetch groups determine the scope of fetching for the |
| graph of instances reachable from the pc parameter. The state of fields |
| in the affected instances is as specified by the FetchPlan. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>pc</CODE> - the instance to detach |
| <DT><B>Returns:</B><DD>the detached instance<DT><B>Since:</B></DT> |
| <DD>2.0</DD> |
| <DT><B>See Also:</B><DD><A HREF="../../javax/jdo/PersistenceManager.html#detachCopyAll(java.lang.Object[])"><CODE>detachCopyAll(Object[])</CODE></A></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="detachCopyAll(java.util.Collection)"><!-- --></A><H3> |
| detachCopyAll</H3> |
| <PRE> |
| java.util.Collection <B>detachCopyAll</B>(java.util.Collection pcs)</PRE> |
| <DL> |
| <DD>Detach the specified instances from the <code>PersistenceManager</code>. |
| The flags for detachment (DETACH_LOAD_FIELDS and DETACH_UNLOAD_FIELDS) |
| and the active fetch groups determine the scope of fetching for the |
| graph of instances reachable from the pcs parameter. The state of fields |
| in the affected instances is as specified by the FetchPlan. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>pcs</CODE> - the instances to detach |
| <DT><B>Returns:</B><DD>the detached instances<DT><B>Since:</B></DT> |
| <DD>2.0</DD> |
| <DT><B>See Also:</B><DD><A HREF="../../javax/jdo/PersistenceManager.html#detachCopyAll(java.lang.Object[])"><CODE>detachCopyAll(Object[])</CODE></A></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="detachCopyAll(java.lang.Object[])"><!-- --></A><H3> |
| detachCopyAll</H3> |
| <PRE> |
| java.lang.Object[] <B>detachCopyAll</B>(java.lang.Object[] pcs)</PRE> |
| <DL> |
| <DD>Detach the specified instances from the <code>PersistenceManager</code>. |
| The flags for detachment (DETACH_LOAD_FIELDS and DETACH_UNLOAD_FIELDS) |
| and the active fetch groups determine the scope of fetching for the |
| graph of instances reachable from the pcs parameter. The state of fields |
| in the affected instances is as specified by the FetchPlan. |
| The objects returned can be manipulated and re-attached with |
| <A HREF="../../javax/jdo/PersistenceManager.html#makePersistentAll(java.lang.Object[])"><CODE>makePersistentAll(Object[])</CODE></A>. |
| The detached instances will be |
| unmanaged copies of the specified parameters, and are suitable |
| for serialization and manipulation outside of a JDO |
| environment. When detaching instances, only fields in the |
| current <A HREF="../../javax/jdo/FetchPlan.html" title="interface in javax.jdo"><CODE>FetchPlan</CODE></A> will be traversed. Thus, to detach a |
| graph of objects, relations to other persistent instances must |
| either be in the <code>default-fetch-group</code>, or in the |
| current custom <A HREF="../../javax/jdo/FetchPlan.html" title="interface in javax.jdo"><CODE>FetchPlan</CODE></A>. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>pcs</CODE> - the instances to detach |
| <DT><B>Returns:</B><DD>the detached instances |
| <DT><B>Throws:</B> |
| <DD><CODE><A HREF="../../javax/jdo/JDOUserException.html" title="class in javax.jdo">JDOUserException</A></CODE> - if any of the instances to be detached do not |
| implement the javax.jdo.spi.Detachable interface.<DT><B>Since:</B></DT> |
| <DD>2.0</DD> |
| <DT><B>See Also:</B><DD><A HREF="../../javax/jdo/PersistenceManager.html#makePersistentAll(java.lang.Object[])"><CODE>makePersistentAll(Object[])</CODE></A>, |
| <A HREF="../../javax/jdo/PersistenceManager.html#getFetchPlan()"><CODE>getFetchPlan()</CODE></A></DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="putUserObject(java.lang.Object, java.lang.Object)"><!-- --></A><H3> |
| putUserObject</H3> |
| <PRE> |
| java.lang.Object <B>putUserObject</B>(java.lang.Object key, |
| java.lang.Object val)</PRE> |
| <DL> |
| <DD>Put the specified key-value pair into the map of user objects. |
| <P> |
| <DD><DL> |
| <DT><B>Since:</B></DT> |
| <DD>2.0</DD> |
| </DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="getUserObject(java.lang.Object)"><!-- --></A><H3> |
| getUserObject</H3> |
| <PRE> |
| java.lang.Object <B>getUserObject</B>(java.lang.Object key)</PRE> |
| <DL> |
| <DD>Get the value for the specified key from the map of user objects. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>key</CODE> - the key of the object to be returned |
| <DT><B>Returns:</B><DD>the object<DT><B>Since:</B></DT> |
| <DD>2.0</DD> |
| </DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="removeUserObject(java.lang.Object)"><!-- --></A><H3> |
| removeUserObject</H3> |
| <PRE> |
| java.lang.Object <B>removeUserObject</B>(java.lang.Object key)</PRE> |
| <DL> |
| <DD>Remove the specified key and its value from the map of user objects. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>key</CODE> - the key of the object to be removed<DT><B>Since:</B></DT> |
| <DD>2.0</DD> |
| </DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="flush()"><!-- --></A><H3> |
| flush</H3> |
| <PRE> |
| void <B>flush</B>()</PRE> |
| <DL> |
| <DD>Flushes all dirty, new, and deleted instances to the data |
| store. It has no effect if a transaction is not active. |
| <p>If a datastore transaction is active, this method |
| synchronizes the cache with the datastore and reports any |
| exceptions.</p> |
| <p>If an optimistic transaction is active, this method obtains |
| a datastore connection, synchronizes the cache with the |
| datastore using this connection and reports any |
| exceptions. The connection obtained by this method is held |
| until the end of the transaction.</p> |
| <p>If exceptions occur during flush, the implementation will |
| set the current transaction's <code>RollbackOnly</code> flag |
| (see <A HREF="../../javax/jdo/Transaction.html#setRollbackOnly()"><CODE>Transaction.setRollbackOnly()</CODE></A>).</p> |
| <P> |
| <DD><DL> |
| <DT><B>Since:</B></DT> |
| <DD>2.0</DD> |
| </DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="checkConsistency()"><!-- --></A><H3> |
| checkConsistency</H3> |
| <PRE> |
| void <B>checkConsistency</B>()</PRE> |
| <DL> |
| <DD>Validates the <code>PersistenceManager</code> cache with the |
| datastore. This method has no effect if a transaction is not |
| active. |
| <p>If a datastore transaction is active, this method verifies |
| the consistency of instances in the cache against the |
| datastore. An implementation might flush instances as if |
| <A HREF="../../javax/jdo/PersistenceManager.html#flush()"><CODE>flush()</CODE></A> were called, but it is not required to do |
| so.</p> |
| <p>If an optimistic transaction is active, this method obtains |
| a datastore connection and verifies the consistency of the |
| instances in the cache against the datastore. If any |
| inconsistencies are detected, a <A HREF="../../javax/jdo/JDOOptimisticVerificationException.html" title="class in javax.jdo"><CODE>JDOOptimisticVerificationException</CODE></A> is thrown. This exception |
| contains a nested <A HREF="../../javax/jdo/JDOOptimisticVerificationException.html" title="class in javax.jdo"><CODE>JDOOptimisticVerificationException</CODE></A> |
| for each object that failed the consistency check. No |
| datastore resources acquired during the execution of this |
| method are held beyond the scope of this method.</p> |
| <P> |
| <DD><DL> |
| <DT><B>Since:</B></DT> |
| <DD>2.0</DD> |
| </DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="getFetchPlan()"><!-- --></A><H3> |
| getFetchPlan</H3> |
| <PRE> |
| <A HREF="../../javax/jdo/FetchPlan.html" title="interface in javax.jdo">FetchPlan</A> <B>getFetchPlan</B>()</PRE> |
| <DL> |
| <DD>Returns the <code>FetchPlan</code> used by this |
| <code>PersistenceManager</code>. |
| <P> |
| <DD><DL> |
| |
| <DT><B>Returns:</B><DD>the FetchPlan<DT><B>Since:</B></DT> |
| <DD>2.0</DD> |
| </DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="newInstance(java.lang.Class)"><!-- --></A><H3> |
| newInstance</H3> |
| <PRE> |
| java.lang.Object <B>newInstance</B>(java.lang.Class pcClass)</PRE> |
| <DL> |
| <DD>Creates an instance of a persistence-capable interface, |
| or of a concrete or abstract class. |
| The returned instance is transient. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>pcClass</CODE> - Must be a persistence-capable interface, |
| or a concrete or abstract class that is declared in the metadata. |
| <DT><B>Returns:</B><DD>the created instance<DT><B>Since:</B></DT> |
| <DD>2.0</DD> |
| </DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="getSequence(java.lang.String)"><!-- --></A><H3> |
| getSequence</H3> |
| <PRE> |
| <A HREF="../../javax/jdo/datastore/Sequence.html" title="interface in javax.jdo.datastore">Sequence</A> <B>getSequence</B>(java.lang.String name)</PRE> |
| <DL> |
| <DD>Returns the sequence identified by <code>name</code>. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>name</CODE> - the name of the Sequence |
| <DT><B>Returns:</B><DD>the Sequence<DT><B>Since:</B></DT> |
| <DD>2.0</DD> |
| </DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="getDataStoreConnection()"><!-- --></A><H3> |
| getDataStoreConnection</H3> |
| <PRE> |
| <A HREF="../../javax/jdo/datastore/JDOConnection.html" title="interface in javax.jdo.datastore">JDOConnection</A> <B>getDataStoreConnection</B>()</PRE> |
| <DL> |
| <DD>If this method is called while a datastore transaction is |
| active, the object returned will be enlisted in the current |
| transaction. If called in an optimistic transaction or outside |
| an active transaction, the object returned will not be |
| enlisted in any transaction. |
| <P> |
| <DD><DL> |
| |
| <DT><B>Returns:</B><DD>the JDOConnection instance<DT><B>Since:</B></DT> |
| <DD>2.0</DD> |
| </DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="addInstanceLifecycleListener(javax.jdo.listener.InstanceLifecycleListener, java.lang.Class[])"><!-- --></A><H3> |
| addInstanceLifecycleListener</H3> |
| <PRE> |
| void <B>addInstanceLifecycleListener</B>(<A HREF="../../javax/jdo/listener/InstanceLifecycleListener.html" title="interface in javax.jdo.listener">InstanceLifecycleListener</A> listener, |
| java.lang.Class[] classes)</PRE> |
| <DL> |
| <DD>Adds the listener instance to the list of lifecycle event |
| listeners. The <code>classes</code> parameter identifies all |
| of the classes of interest. If the <code>classes</code> |
| parameter is specified as <code>null</code>, events for all |
| persistent classes and interfaces will be sent to |
| <code>listenerInstance</code>. |
| <p>The listenerInstance will be called for each event for which it |
| implements the corresponding listenerInstance interface.</p> |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>listener</CODE> - the lifecycle listener<DD><CODE>classes</CODE> - the classes of interest to the listener<DT><B>Since:</B></DT> |
| <DD>2.0</DD> |
| </DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="removeInstanceLifecycleListener(javax.jdo.listener.InstanceLifecycleListener)"><!-- --></A><H3> |
| removeInstanceLifecycleListener</H3> |
| <PRE> |
| void <B>removeInstanceLifecycleListener</B>(<A HREF="../../javax/jdo/listener/InstanceLifecycleListener.html" title="interface in javax.jdo.listener">InstanceLifecycleListener</A> listener)</PRE> |
| <DL> |
| <DD>Removes the listener instance from the list of lifecycle event listeners. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>listener</CODE> - the listener instance to be removed<DT><B>Since:</B></DT> |
| <DD>2.0</DD> |
| </DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="getServerDate()"><!-- --></A><H3> |
| getServerDate</H3> |
| <PRE> |
| java.util.Date <B>getServerDate</B>()</PRE> |
| <DL> |
| <DD>Get the Date as seen by the server. |
| Clients using this method can order their operations according to |
| a single time source. Implementations use the setting of the |
| server time zone to prepare a Date instance that represents |
| UTC time on the server. |
| <P> |
| <DD><DL> |
| |
| <DT><B>Returns:</B><DD>a Date instance corresponding to the UTC Date |
| as seen by the server<DT><B>Since:</B></DT> |
| <DD>2.1</DD> |
| </DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="getManagedObjects()"><!-- --></A><H3> |
| getManagedObjects</H3> |
| <PRE> |
| java.util.Set <B>getManagedObjects</B>()</PRE> |
| <DL> |
| <DD>Get the objects managed by this persistence manager. |
| <P> |
| <DD><DL> |
| |
| <DT><B>Returns:</B><DD>the objects<DT><B>Since:</B></DT> |
| <DD>2.1</DD> |
| </DL> |
| </DD> |
| </DL> |
| <HR> |
| |
| <A NAME="getManagedObjects(java.lang.Class[])"><!-- --></A><H3> |
| getManagedObjects</H3> |
| <PRE> |
| java.util.Set <B>getManagedObjects</B>(java.lang.Class[] classes)</PRE> |
| <DL> |
| <DD>Get the objects managed by this persistence manager being instances of |
| the specified classes. |
| <P> |
| <DD><DL> |
| <DT><B>Parameters:</B><DD><CODE>classes</CODE> - The classes of objects that we are interested in |
| <DT><B>Returns:</B><DD>the objects<DT><B>Since:</B></DT> |
| <DD>2.1</DD> |
| </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> </TD> |
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD> |
| <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD> |
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/PersistenceManager.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD> |
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD> |
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD> |
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD> |
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD> |
| </TR> |
| </TABLE> |
| </TD> |
| <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM> |
| </EM> |
| </TD> |
| </TR> |
| |
| <TR> |
| <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> |
| <A HREF="../../javax/jdo/JDOUserException.html" title="class in javax.jdo"><B>PREV CLASS</B></A> |
| <A HREF="../../javax/jdo/PersistenceManagerFactory.html" title="interface in javax.jdo"><B>NEXT CLASS</B></A></FONT></TD> |
| <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> |
| <A HREF="../../index.html?javax/jdo/PersistenceManager.html" target="_top"><B>FRAMES</B></A> |
| <A HREF="PersistenceManager.html" target="_top"><B>NO FRAMES</B></A> |
| <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: NESTED | FIELD | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD> |
| <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> |
| DETAIL: FIELD | CONSTR | <A HREF="#method_detail">METHOD</A></FONT></TD> |
| </TR> |
| </TABLE> |
| <A NAME="skip-navbar_bottom"></A> |
| <!-- ======== END OF BOTTOM NAVBAR ======= --> |
| |
| <HR> |
| Copyright © 2005-2008 Apache Software Foundation. All Rights Reserved. |
| </BODY> |
| </HTML> |