Jump to: navigation, search

Difference between revisions of "Talk:EclipseLink/UserGuide/JPA/Advanced JPA Development/Data Partitioning"

Line 43: Line 43:
  
 
As of build v20100819-r8063, I still don't see any of these APIs in the online Javadoc at http://www.eclipse.org/eclipselink/api/2.2/index.html. Is there a reason for that? When will it appear?
 
As of build v20100819-r8063, I still don't see any of these APIs in the online Javadoc at http://www.eclipse.org/eclipselink/api/2.2/index.html. Is there a reason for that? When will it appear?
 +
 +
[3]
 +
 +
In the spec, at the very end of the Functionality section, there is this: "Fail-over..."
 +
 +
What needs to be said about failover?
 +
 +
[4]
 +
 +
The spec gives an example of an orm.xml file but only has a bullet item for persistence.xml. Should there be an example for persistence.xml, too?

Revision as of 12:00, 26 January 2011

Questions about this documentation (by Ben Gelernter, tech writer):

[1]

The partitioning policies in the spec at http://wiki.eclipse.org/EclipseLink/DesignDocs/328937 don't seem to match the partitioning policies in the Javadoc (from the zip download) at zip/eclipselink-2.2.0.v20110114-r8831/eclipselink/eclipselink-javadocs/org/eclipse/persistence/descriptors/partitioning/package-summary.html.

This draft (1/26/11) is based on the Javadoc. Is that correct? That is, this doc should follow the Javadoc, not the spec on this matter, correct?

The differences are:

  • CustomPartitioningPolicy and PinnedPartitioningPolicy are in the Javadoc, but not in the spec.
  • There are alternative names given for the policies in the spec, under the Functionality section. Shall I assume the names in the Javadoc are correct and the alternative names in the spec should be ignored? Or are they referring to some other kind of entity?

The following table sums up the differences:

Spec under "Functionality" Spec under "API" Javadoc
not listed not listed CustomPartitioningPolicy
not listed FieldPartitioningPolicy same as API in spec
HashPartitionPolicy HashPartitioningPolicy same as API in spec
not listed PartitioningPolicy same as API in spec
RoundRobinPolicy RoundRobinPartitioningPolicy same as API in spec
RangePartitionPolicy RangePartitioningPolicy same as API in spec
ReplicationPolicy ReplicationPartitioningPolicy same as API in spec
UnionPartitionPolicy UnionPartitioningPolicy same as API in spec
ValuePartitionPolicy ValuePartitioningPolicy same as API in spec


[2]

As of build v20100819-r8063, I still don't see any of these APIs in the online Javadoc at http://www.eclipse.org/eclipselink/api/2.2/index.html. Is there a reason for that? When will it appear?

[3]

In the spec, at the very end of the Functionality section, there is this: "Fail-over..."

What needs to be said about failover?

[4]

The spec gives an example of an orm.xml file but only has a bullet item for persistence.xml. Should there be an example for persistence.xml, too?