Return-Path: Delivered-To: apmail-db-jdo-commits-archive@www.apache.org Received: (qmail 70178 invoked from network); 5 Oct 2008 13:16:39 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.2) by minotaur.apache.org with SMTP; 5 Oct 2008 13:16:39 -0000 Received: (qmail 44148 invoked by uid 500); 5 Oct 2008 13:16:38 -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 44139 invoked by uid 99); 5 Oct 2008 13:16:38 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Sun, 05 Oct 2008 06:16:38 -0700 X-ASF-Spam-Status: No, hits=-1998.7 required=10.0 tests=ALL_TRUSTED,DNS_FROM_DOB,DNS_FROM_SECURITYSAGE,RCVD_IN_DOB X-Spam-Check-By: apache.org Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4) by apache.org (qpsmtpd/0.29) with ESMTP; Sun, 05 Oct 2008 13:15:43 +0000 Received: by eris.apache.org (Postfix, from userid 65534) id E9A742388970; Sun, 5 Oct 2008 06:15:12 -0700 (PDT) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Subject: svn commit: r701794 [3/3] - in /db/jdo/site/docs: ./ guides/ releases/ Date: Sun, 05 Oct 2008 13:15:10 -0000 To: jdo-commits@db.apache.org From: andyj@apache.org X-Mailer: svnmailer-1.0.8 Message-Id: <20081005131512.E9A742388970@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org Modified: db/jdo/site/docs/state_transition.html URL: http://svn.apache.org/viewvc/db/jdo/site/docs/state_transition.html?rev=701794&r1=701793&r2=701794&view=diff ============================================================================== --- db/jdo/site/docs/state_transition.html (original) +++ db/jdo/site/docs/state_transition.html Sun Oct 5 06:15:09 2008 @@ -5,7 +5,7 @@ JDO manages the lifecycle of an object, from creation (Transient) through to persistence in the datastore (Hollow, Persistent Clean) and all of the various states between these. The transition between these states are achieved by using methods on the Persistence Manager such as makePersistent(), makeTransient(), deletePersistent(), and by commiting the changes made by these operations, or by rolling them back.

The various lifecycle states supported by JDO are shown below. -

NameDescription
TransientAny object created by the developer that do are not persisted. These don't have a JDO identity.
Persistent NewAny object that is newly persisted in the current transaction. A JDO identity has been assigned to these objects.
Persistent DirtyAny persistent object that has been changed in the current transaction.
HollowAny persistent object that represents data in the datastore, but whose values are not in the instance.
Persistent CleanAny persistent object that represents data in the datastore, and whose values have not been changed in the current transaction.
Persistent DeletedAny persistent object that represents data in the datastore, and that has been deleted in the cur rent transaction.
Persistent New DeletedAny object that have been newly made persistent and then deleted in the same current transaction.
Persistent Non transactionalAny persistent object that represents data in the datastore, whose values are loaded but not transactionally consistent.
Persistent Non transactional DirtyAny persistent object that represents data in the datastore, whose values are loaded but not transactionally consistent, and that has been modified.
Transient CleanAny transient object that represents a transactional instance whose values have not been changed in the current transaction.
Transient DirtyAny transient object that represents a transactional instance whose values have been changed in the current transaction.
Detached CleanAny detached object that represents a persistent instance whose values have not been changed since detaching.
Detached DirtyAny detached object that represents a persistent instance whose values have been changed since detaching.

Detecting Object State

+

NameDescription
TransientAny object created by the developer that do are not persisted. These don't have a JDO identity.
Persistent NewAny object that is newly persisted in the current transaction. A JDO identity has been assigned to these objects.
Persistent DirtyAny persistent object that has been changed in the current transaction.
HollowAny persistent object that represents data in the datastore, but whose values are not in the instance.
Persistent CleanAny persistent object that represents data in the datastore, and whose values have not been changed in the current transaction.
Persistent DeletedAny persistent object that represents data in the datastore, and that has been deleted in the cur rent transaction.
Persistent New DeletedAny object that have been newly made persistent and then deleted in the same current transaction.
Persistent Non transactionalAny persistent object that represents data in the datastore, whose values are loaded but not transactionally consistent.
Persistent Non transactional DirtyAny persistent object that represents data in the datastore, whose values are loaded but not transactionally consistent, and that has been modified.
Transient CleanAny transient object that represents a transactional instance whose values have not been changed in the current transaction.
Transient DirtyAny transient object that represents a transactional instance whose values have been changed in the current transaction.
Detached CleanAny detached object that represents a persistent instance whose values have not been changed since detaching.
Detached DirtyAny detached object that represents a persistent instance whose values have been changed since detaching.

Detecting Object State

JDO provides a class JDOHelper that allows you to interrogate the object state via its attributes (isPersistent(), isDeleted(), etc). In JDO 2.1 for JDKs 1.5+ JDOHelper is extended to also provide a method that gives the full object state.

@@ -81,5 +81,5 @@





Possible state transitions

The following diagram shows the state transitions possible with JDO.



JDO State Transition

\ No newline at end of file Modified: db/jdo/site/docs/svn.html URL: http://svn.apache.org/viewvc/db/jdo/site/docs/svn.html?rev=701794&r1=701793&r2=701794&view=diff ============================================================================== --- db/jdo/site/docs/svn.html (original) +++ db/jdo/site/docs/svn.html Sun Oct 5 06:15:09 2008 @@ -54,5 +54,5 @@

  • Copy the servers file and the auth folder from the sygwin ~/.subversion directory to C:\Documents and Settings\<user>\Application Data\Subversion used by Win32 subversion.

    • Note that windows svn uses backslash as the path separator when displaying file names. You cannot just copy and paste this file name to another svn command when running from within a cygwin shell. You need to enclose the file name into double quotes.

    Alternatively, Windows users can set file permissions in Windows Explorer. (Right-click on the top-level folder & select Properties. Select the Security tab. Click Advanced. Remove all instances of Read & Execute from the Permission Entries. Click "Reset permissions on all child objects and enable propogations of inheritable permissions". Click Apply. OK. OK.) You will have to do this again when you do a clean checkout to a new directory.

    \ No newline at end of file Modified: db/jdo/site/docs/tck.html URL: http://svn.apache.org/viewvc/db/jdo/site/docs/tck.html?rev=701794&r1=701793&r2=701794&view=diff ============================================================================== --- db/jdo/site/docs/tck.html (original) +++ db/jdo/site/docs/tck.html Sun Oct 5 06:15:09 2008 @@ -24,5 +24,5 @@ test run, which consists of multiple log files containing configuration information and test results. For an example of the required posting, please see http://db.apache.org/jdo/tck/final.

    \ No newline at end of file Modified: db/jdo/site/docs/team-list.html URL: http://svn.apache.org/viewvc/db/jdo/site/docs/team-list.html?rev=701794&r1=701793&r2=701794&view=diff ============================================================================== --- db/jdo/site/docs/team-list.html (original) +++ db/jdo/site/docs/team-list.html Sun Oct 5 06:15:09 2008 @@ -15,5 +15,5 @@ If you would like to become a committer, please see Get Involved.

    Apache JDO Committers

    NameOrganization
    Matthew AdamsInterface21
    Erik BengtsonJPOX
    Michael BouschenTech@Spree
    Michelle CaisseSun Microsystems, Inc.
    Andy JeffersonJPOX
    Patrick LinskeySolarmetric
    Geir Magnusson Jr.IBM
    Brian McCallister
    Craig RussellSun Microsystems, Inc.
    Dain Sundstrom
    Brian Topping
    Michael WatzekTech@Spree
    Martin ZaunSun Microsystems, Inc.

    Apache JDO Contributors

    NameOrganization
    Chris Beams
    Ilan KirschObjectDB
    \ No newline at end of file Modified: db/jdo/site/docs/transactions.html URL: http://svn.apache.org/viewvc/db/jdo/site/docs/transactions.html?rev=701794&r1=701793&r2=701794&view=diff ============================================================================== --- db/jdo/site/docs/transactions.html (original) +++ db/jdo/site/docs/transactions.html Sun Oct 5 06:15:09 2008 @@ -40,5 +40,5 @@ 

    pm.currentTransaction().setOptimistic(true);
    \ No newline at end of file Modified: db/jdo/site/docs/why_jdo.html URL: http://svn.apache.org/viewvc/db/jdo/site/docs/why_jdo.html?rev=701794&r1=701793&r2=701794&view=diff ============================================================================== --- db/jdo/site/docs/why_jdo.html (original) +++ db/jdo/site/docs/why_jdo.html Sun Oct 5 06:15:09 2008 @@ -35,5 +35,5 @@ whether you can just persist by simple calls.
  • requires the developer to write this layer.
    • \ No newline at end of file