[#JDO-55] Inconsistency between API doc and spec

JDO

Inconsistency between API doc and spec

Created: 25/May/05 05:55 PM Updated: 08/Dec/05 08:27 AM

Return to search

Component/s:

api11, api2

Affects Version/s:

None

Fix Version/s:

JDO 2 beta

Time Tracking:

Not Specified

Resolution Date:

08/Dec/05 08:27 AM

Description

« Hide

The API doc of PM.getObjectById defines that a JDODataStoreException might be thrown. The spec defines that an JDOObjectNotFoundException might be thrown:

API doc:

If the <code>validate</code> flag is <code>true</code> ...
If the instance does not exist in the datastore, then a JDODataStoreException is thrown.

Spec:

If the validate flag is true:
...
If there is an instance already in the cache with the same jdo identity as the oid parameter, the instance is not transactional, and the instance does not exist in the datastore, then a JDOObjectNotFoundException is thrown.

All

Comments

Work Log

Change History

Subversion Commits

Sort Order:

Repository	Revision	Date	User	Message
ASF	#328086	Mon Oct 24 15:34:44 UTC 2005	clr	~~JDO-55~~ Changed javadoc for getObjectById to throw JDOObjectNotFoundException instead of JDODataStoreException
				Files Changed
				MODIFY /incubator/jdo/trunk/api20/src/java/javax/jdo/PersistenceManager.java

[ Permlink | « Hide ]

Craig Russell added a comment - 25/Oct/05 12:35 AM

The javadoc was updated to reflect that JDOObjectNotFoundException is thrown in cases where the object does not exist.

Committed revision 328086.

Craig Russell made changes - 25/Oct/05 12:35 AM

Field	Original Value	New Value
Resolution		Fixed [ 1 ]
Status	Open [ 1 ]	Closed [ 6 ]
Assignee		Craig Russell [ clr ]

[ Permlink | « Hide ]

Craig Russell added a comment - 07/Dec/05 09:50 AM

Need to reopen this issue to assign it to a release.

Craig Russell made changes - 07/Dec/05 09:50 AM

Status	Closed [ 6 ]	Reopened [ 4 ]
Resolution	Fixed [ 1 ]

Craig Russell made changes - 07/Dec/05 09:51 AM

Description	The API doc of PM.getObjectById defines that a JDODataStoreException might be thrown. The spec defines that an JDOObjectNotFoundException might be thrown: API doc: If the <code>validate</code> flag is <code>true</code> ... If the instance does not exist in the datastore, then a JDODataStoreException is thrown. Spec: If the validate flag is true: ... If there is an instance already in the cache with the same jdo identity as the oid parameter, the instance is not transactional, and the instance does not exist in the datastore, then a JDOObjectNotFoundException is thrown.	The API doc of PM.getObjectById defines that a JDODataStoreException might be thrown. The spec defines that an JDOObjectNotFoundException might be thrown: API doc: If the <code>validate</code> flag is <code>true</code> ... If the instance does not exist in the datastore, then a JDODataStoreException is thrown. Spec: If the validate flag is true: ... If there is an instance already in the cache with the same jdo identity as the oid parameter, the instance is not transactional, and the instance does not exist in the datastore, then a JDOObjectNotFoundException is thrown.
Environment
Fix Version/s		JDO 2 beta [ 12310683 ]

Craig Russell made changes - 08/Dec/05 08:27 AM

Status	Reopened [ 4 ]	Resolved [ 5 ]
Resolution		Fixed [ 1 ]