From jdo-commits-return-2980-apmail-db-jdo-commits-archive=www.apache.org@db.apache.org Sat Feb 18 19:04:46 2012 Return-Path: X-Original-To: apmail-db-jdo-commits-archive@www.apache.org Delivered-To: apmail-db-jdo-commits-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id EEB1E952A for ; Sat, 18 Feb 2012 19:04:46 +0000 (UTC) Received: (qmail 50336 invoked by uid 500); 18 Feb 2012 19:04:46 -0000 Mailing-List: contact jdo-commits-help@db.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: jdo-dev@db.apache.org Delivered-To: mailing list jdo-commits@db.apache.org Received: (qmail 50329 invoked by uid 99); 18 Feb 2012 19:04:46 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Sat, 18 Feb 2012 19:04:46 +0000 X-ASF-Spam-Status: No, hits=-2000.0 required=5.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.131] (HELO eos.apache.org) (140.211.11.131) by apache.org (qpsmtpd/0.29) with ESMTP; Sat, 18 Feb 2012 19:04:43 +0000 Received: from eos.apache.org (localhost [127.0.0.1]) by eos.apache.org (Postfix) with ESMTP id CCD4FD1A for ; Sat, 18 Feb 2012 19:04:22 +0000 (UTC) MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable From: Apache Wiki To: Apache Wiki Date: Sat, 18 Feb 2012 19:04:22 -0000 Message-ID: <20120218190422.57331.86533@eos.apache.org> Subject: =?utf-8?q?=5BJdo_Wiki=5D_Update_of_=22ChangeLog=22_by_MichelleCaisse?= Auto-Submitted: auto-generated X-Virus-Checked: Checked by ClamAV on apache.org Dear Wiki user, You have subscribed to a wiki page or wiki category on "Jdo Wiki" for chang= e notification. The "ChangeLog" page has been changed by MichelleCaisse: http://wiki.apache.org/jdo/ChangeLog?action=3Ddiff&rev1=3D66&rev2=3D67 Comment: Fixed code formatting, moved 12-17 to Accepted = 1. Remove the "serialized" attribute from 18.15.8 since the ordering col= umn is not serialized. = - 1. Add property {{{CopyOnAttach}}} to {{{PersistenceManager}}} and {{{Pe= rsistenceManagerFactory}}}. With the property set to true, makes a copy of = the detached instance on {{{makePersistent}}}. If the property is set to fa= lse, it attaches the detached instance itself. - = - 1. Add {{{ObjectState}}} enum and convenience methods in {{{JDOHelper}}}= to return the {{{ObjectState}}} of an instance. - = - 1. Add method {{{void evictAll (boolean subclasses, Class pcClass)}}} to= {{{PersistenceManager}}}. This allows to evict instances for a particular = 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.... - = - 1. Clarify the behavior of method {{{evictAll}}} if the parameter is a p= ersistent interface. This comment also applies to the {{{DataStoreCache}}} = interface method {{{void evictAll (Class pcClass, boolean subclasses)}}}. = - = - 1. Require that the implementation not hold a strong reference to flushe= d dirty instances, allowing these instances to be garbage collected. - = - 1. Change signatures of {{{PersistenceManager}}} methods that take {{{Ob= ject[]}}} as an argument to take {{{Object...}}} as an argument. These sign= atures are source and binary compatible with existing programs. Where the {= {{Object...}}} parameter would not be the last parameter, deprecate the met= hod and reorder the parameters so {{{Object...}}} is last. = 1. 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. = @@ -108, +97 @@ = {{{public JDOHelper();}}} = - For some usage patterns, an instance of {{{JDOHelper}}} on which to inv= oke methods is preferable to the use of static methods. For this purpose, a= public constructor is provided. + For some usage patterns, an instance of {{{JDOHelper}}} on which to invo= ke methods is preferable to the use of static methods. For this purpose, a = public constructor is provided. = 1. In Chapter 8, add a convenience method that returns a {{{PersistenceM= anager}}} proxy that can be used in web and ejb containers to dynamically b= ind to the transaction-associated {{{PersistenceManager}}}. = @@ -176, +165 @@ 1. Change 21.13 from "Some methods require a non-null state manager. In = these cases, if the {{{jdoStateManager}}} is null, then {{{IllegalStateExce= ption}}} is thrown." to "Some methods require a non-null state manager. In = these cases, if the {{{jdoStateManager}}} is null, then {{{JDOFatalInternal= Exception}}} is thrown." = 1. Change 21.21.7 Generated jdoGetManagedFieldCount sample implementatio= n to avoid using the jdoFieldNames field that might be initialized after it= is used during initialization of a subclass. = + {{{ - {{{protected static int jdoGetManagedFieldCount () { = + protected static int jdoGetManagedFieldCount () { - return jdoFieldNames.length; + return jdoFieldNames.length; } + }}} + to = + {{{ - }}} to {{{protected static int jdoGetManagedFieldCount () { = + protected static int jdoGetManagedFieldCount () { - return ; + return ; - } + } = - }}} + }}} - = 1. Add to Chapter 23, constants defined in the {{{JDOPermission}}} class: + {{{ - {{{public static final javax.jdo.spi.JDOPermission CLOSE_PERSISTENCE_MA= NAGER_FACTORY =3D "closePersistenceManagerFactory"; + public static final javax.jdo.spi.JDOPermission CLOSE_PERSISTENCE_MANAGER= _FACTORY =3D "closePersistenceManagerFactory"; public static final javax.jdo.spi.JDOPermission GET_METADATA =3D "getMeta= data"; public static final javax.jdo.spi.JDOPermission MANAGE_METADATA =3D "mana= geMetadata"; - public static final javax.jdo.spi.JDOPermission SET_STATE_MANAGER =3D "se= tStateManager";}}} + public static final javax.jdo.spi.JDOPermission SET_STATE_MANAGER =3D "se= tStateManager"; + }}} + 1. Add property {{{CopyOnAttach}}} to {{{PersistenceManager}}} and {{{Pe= rsistenceManagerFactory}}}. With the property set to true, makes a copy of = the detached instance on {{{makePersistent}}}. If the property is set to fa= lse, it attaches the detached instance itself. + = + 1. Add {{{ObjectState}}} enum and convenience methods in {{{JDOHelper}}}= to return the {{{ObjectState}}} of an instance. + = + 1. Add method {{{void evictAll (boolean subclasses, Class pcClass)}}} to= {{{PersistenceManager}}}. This allows to evict instances for a particular = 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.... + = + 1. Clarify the behavior of method {{{evictAll}}} if the parameter is a p= ersistent interface. This comment also applies to the {{{DataStoreCache}}} = interface method {{{void evictAll (Class pcClass, boolean subclasses)}}}. = + = + 1. Require that the implementation not hold a strong reference to flushe= d dirty instances, allowing these instances to be garbage collected. + = + 1. Change signatures of {{{PersistenceManager}}} methods that take {{{Ob= ject[]}}} as an argument to take {{{Object...}}} as an argument. These sign= atures are source and binary compatible with existing programs. Where the {= {{Object...}}} parameter would not be the last parameter, deprecate the met= hod and reorder the parameters so {{{Object...}}} is last. = =3D=3D=3D JDK 1.5 changes =3D=3D=3D These are changes proposed for JDO 2 to better support JDK 1.5.