Add methods to PersistenceManager and PersistenceManagerFactory to allow a user to get the current time and date from the server. Allow the PersistenceManagerFactory to be configured statically with TimeZone and Locale in case the information is not available from the server itself.
Clarify 18.15.8 that the ordering field should be managed by the implementation, not by the user.
Remove the "serialized" attribute from 18.15.8 since the ordering column is not serialized.
Add property CopyOnAttach to PersistenceManager and PersistenceManagerFactory. With the property set to true, makes a copy of the detached instance on makePersistent. If the property is set to false, it attaches the detached instance itself.
Add ObjectState enum and convenience methods in JDOHelper to return the ObjectState of an instance.
Add method void evictAll (boolean subclasses, Class pcClass) to PersistenceManager. This allows to evict instances for a particluar class. Change signatures of DataStoreCache methods pinAll, unpinAll, and evictAll from (Class pcClass, boolean subclasses) to (boolean subclasses, Class pcClass) to accommodate adding methods that change the pcClass parameter from Class to Class....
Clarify the behavior of method evictAll if the parameter is a persistent interface. This comment also applies to the DataStoreCache interface method void evictAll (Class pcClass, boolean subclasses).
Require that the implementation not hold a strong reference to flushed dirty instances, allowing these instances to be garbage collected.
Change signatures of PersistenceManager methods that take Object[] as an argument to take Object... as an argument. These signatures are source and binary compatible with existing programs. Where the Object... parameter would not be the last parameter, deprecate the method and reorder the parameters so Object... is last.
In 5.4.1, Compound Identity should be updated to reflect that for key fields of reference types, the type of the key field is the reference type in the class but the oid of the reference type in the oid class.
In Table 2: State Transitions, the transition for a transient-dirty instance during commit with DetachAllOnCommit = true should be to transient-clean. Also, state changes need to be added for detach methods and serialization.
In 5.5.8 and 5.5.9, detachCopy should be removed from the list of methods that throw exceptions if applied to detached-clean or detached-dirty instances.
In 6.4.3, change "Portable JDO applications must not depend on whether instances of these classes are treated as SCOs or FCOs. " to "Portable JDO applications must not depend on SCO or FCO uniquing behavior, nor on the storage mechanism in the datastore. Portable applications may use the same instance of these classes as field values in any persistence-capable class instance."
In section 7.5, change "If the class is abstract, null is returned." to "If the class is abstract, JDOFatalInternalException is thrown".
In section 7.5, add public byte fetchByteField(int fieldNumber); to ObjectIdFieldSupplier.
In section 7.5, add public byte storeByteField(int fieldNumber, byte value); to ObjectIdFieldConsumer.
In Chapter 8, add after class JDOHelper {
In Chapter 8, add a convenience method that returns a PersistenceManager proxy that can be used in web and ejb containers to dynamically bind to the transaction-associated PersistenceManager.
In Chapter 9, add section on managing date formatting for ObjectIdentity constructors.
In 9.4, add method to retrieve persistence-capable classes that have been registered.
In 9.5, add method to verify that the class is authorized to be a state manager.
In 9.5, add method to register multiple state manager classes.
In Chapter 11, add properties for configuring PersistenceManagerFactory that are consistent with JPA specification of TransactionType and Persistence Unit Name.
In Chapter 12, specify the behavior of PersistenceManager if it extends Serializable and writeObject is called.
In 12.6.6, clarify that a JDOUserException will be thrown when invoking newInstance: if a class is not persistence-capable, or does not declare a public no-args constructor; if an interface is not persistence-capable or declares methods that are not defined as persistent properties; if an abstract class is not persistence-capable or declares abstract methods that are not defined as persistent properties.
In 12.6.8, section heading Explicit Detach, the sentence "If the parameter instance is detached, then JDOUserException is thrown. " should be removed.
In 12.6.8, add a note that serialization for storage using the serialized, serialized-element, serialized-key, or serialized-value metadata attributes does not create a detached instance.
In 12.6.8, clarify the behavior of instances during serialization both with and without an active transaction.
In 12.7.5, change public int setMaxFetchDepth(); to public int getMaxFetchDepth();
In 12.7.5, specify that getFetchGroups returns a read-only copy of the active Fetch Groups.
In 12.7.6, p. 127, change "A recursion-depth of 0 will fetch the whole graph of instances reachable from this field." to "A recursion-depth of -1 will fetch the whole graph of instances reachable from this field."
In 12.7.6 p. 129, change fetch-depth to recursion-depth in the example.
In 14, add subqueries to permit e.g. select from Employee where this.salary > (select avg(salary) from Employee)
In 14.6.2 p. 159, the sectionheading "Methods" is not marked as a sectionheading.
Add to 14.6.9: Projected SCOs are never owned, projected FCOs are always managed. Modifying unowned SCOs never has an effect on the database. Modifying FCOs no matter how you get them always has an effect if the tx commits.
In 15.3, p. 187, the third paragraph, beginning "The field on the other side" and ending "in the next transaction", is duplicated and will be removed.
In 15.3, add text to describe updating the other side of relationships where this side is deleted. This maintains referential integrity for delete as well as update.
Add to 17.1.11
In Chapter 18, add an xml element to specify the fetch plan to use for a query.
In 18.15.1, change "(e.g. a field of type Object can specify field-type=”Integer”)." to "(e.g. an element of type Object can specify element-type=”Integer”).
In Chapter 18, add to .jdo metadata:
Add to 18.15.1 "The default for dependent-element is false."
Add to 18.15.2 "The default for dependent-key is false."
Add to 18.15.2 "The default for dependent-value is false."
Change the last paragraph of 21.6 from "For Detachable classes, the results of restoring a serialized persistent instance graph is a graph of interconnected detached instances that might be attached via the attachCopy methods." to "For Detachable classes, the results of restoring a serialized persistent instance graph is a graph of interconnected detached instances that might be attached via the makePersistent methods."
Change 21.13 from "Some methods require a non-null state manager. In these cases, if the jdoStateManager is null, then IllegalStateException is thrown." to "Some methods require a non-null state manager. In these cases, if the jdoStateManager is null, then JDOFatalInternalException is thrown."
Change 21.21.7 Generated jdoGetManagedFieldCount sample implementation to avoid using the jdoFieldNames field that might be initialized after it is used during initialization of a subclass.
Add to Chapter 23, constants defined in the JDOPermission class:
These are changes proposed for JDO 2 to better support JDK 1.5.
smime.p7s