147 words

retrieve(pc, useFetchPlan) - JDO PersistenceManager's method

Method
javax.jdo.PersistenceManager
void retrieve(
  Object pc,
  boolean useFetchPlan
)

Retrieve field values of an instance from the store. This tells the PersistenceManager that the application intends to use the instance, and its field values must be retrieved.

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.

Parameters:
pc - the instance
useFetchPlan - whether to use the current fetch plan to determine which fields to load and which instances to retrieve.
Since:
JDO 2.0

This documentation page is derived (with some adjustments) from the JDO 2.2 API
and is available under the terms of the Apache License, v. 2.0.