[ http://issues.apache.org/jira/browse/JDO-117?page=all ]

Craig Russell updated JDO-117:
------------------------------

    Fix Version: JDO 2 beta

> PM.newObjectIdInstance javadoc description is inadequate to describe the usage
> ------------------------------------------------------------------------------
>
>          Key: JDO-117
>          URL: http://issues.apache.org/jira/browse/JDO-117
>      Project: JDO
>         Type: Improvement
>   Components: api20
>     Reporter: Andy Jefferson
>     Assignee: Craig Russell
>     Priority: Minor
>      Fix For: JDO 2 beta

>
> People often rely on javadocs to decide how to use a method (yes, I know they also have the spec). If someone looks at the javadoc for PersistenceManager.newObjectIdInstance(Class, Object) they have
> "pcClass - the Class of the persistence-capable instance
> key - the value of the key field for single-field identity."
> This doesn't tell them that the "key" should be a String (the result of toString() on the id) when using datastore identity or application identity (when not SingleFieldIdentity) and should only be Long/Integer/Byte/Char/etc when using SingleFieldIdentity.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
   http://www.atlassian.com/software/jira