mirror of https://github.com/apache/openjpa.git
Add code comments
git-svn-id: https://svn.apache.org/repos/asf/openjpa/trunk@1133602 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
parent
5cceefda8e
commit
14816f465b
|
@ -22,7 +22,9 @@ import org.apache.openjpa.kernel.Broker;
|
|||
import org.apache.openjpa.slice.jdbc.TargetFetchConfiguration;
|
||||
|
||||
/**
|
||||
* Extension to Broker to allow access to virtual data store.
|
||||
* Extension to Broker to allow access to {@link DistributedStoreManager virtual data store}.
|
||||
* The broker manages a single persistence context like a normal {@link Broker}, but the
|
||||
* context holds data from multiple databases.
|
||||
*
|
||||
* @author Pinaki Poddar
|
||||
*
|
||||
|
|
|
@ -26,10 +26,18 @@ import org.apache.openjpa.conf.OpenJPAConfiguration;
|
|||
* A configuration for multiple data stores, each referred as <em>slice</em>.
|
||||
* This configuration allows each underlying slice be configured with its
|
||||
* own specific configuration properties such as JDBC Driver or connection
|
||||
* user/password etc. <br>
|
||||
* This configuration also extends by adding a {@link DistributionPolicy
|
||||
* DistributionPolicy} that governs how new instances be distributed
|
||||
* user/password etc.
|
||||
* <br>
|
||||
* This configuration also extends by several policy plugins. A policy plugin
|
||||
* is an user implementation of a specific policy interface. A policy implementation
|
||||
* is invoked by Slice runtime.
|
||||
* <br>
|
||||
* Slice recognizes following policies
|
||||
* <LI> {@link DistributionPolicy Distribution Policy} governs how new instances be distributed
|
||||
* among the slices.
|
||||
* <LI> {@link ReplicationPolicy Replication Policy} maintains the same instance in multiple slices.
|
||||
* <LI> {@link QueryTargetPolicy Query Target Policy} narrows the slices for a query execution.
|
||||
* <LI> {@link FinderTargetPolicy Finder Target Policy} narrows the slices for primary key based lookup
|
||||
*
|
||||
* @author Pinaki Poddar
|
||||
*
|
||||
|
|
|
@ -23,6 +23,13 @@ import java.util.Map;
|
|||
import org.apache.openjpa.kernel.StoreManager;
|
||||
import org.apache.openjpa.slice.jdbc.SliceStoreManager;
|
||||
|
||||
/**
|
||||
* A specialized {@link StoreManager Store Manager} that encapsulates multiple concrete Store Managers
|
||||
* using Distributed Template (or Composite) Design Pattern.
|
||||
*
|
||||
* @author Pinaki Poddar
|
||||
*
|
||||
*/
|
||||
public interface DistributedStoreManager extends StoreManager {
|
||||
/**
|
||||
* Adds the given slice with the given properties. This newly added slice
|
||||
|
|
Loading…
Reference in New Issue