commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From bali...@apache.org
Subject cvs commit: jakarta-commons-sandbox/simplestore/docs users-guide.html
Date Sun, 31 Mar 2002 16:35:20 GMT
baliuka     02/03/31 08:35:20

  Modified:    simplestore/docs users-guide.html
  Log:
  
  
  Revision  Changes    Path
  1.2       +33 -7     jakarta-commons-sandbox/simplestore/docs/users-guide.html
  
  Index: users-guide.html
  ===================================================================
  RCS file: /home/cvs/jakarta-commons-sandbox/simplestore/docs/users-guide.html,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- users-guide.html	31 Mar 2002 10:46:35 -0000	1.1
  +++ users-guide.html	31 Mar 2002 16:35:20 -0000	1.2
  @@ -15,7 +15,7 @@
   
       SimpleStore is customizable persistence framework. It defines
       interfaces for Transparent Persistence and provides reference implementation.
  -    It designed to store objects in Transactionl resource like RDMS, but
  +    It designed to store objects in Transactional resource like RDMS, but
       can be used with any kind of storage. It is two storage types
       in reference implementation: RDMS and <a href='http://jdbm.sourceforge.net'>BTree
file from JDBM</a>.
       
  @@ -24,7 +24,7 @@
    <h3 > What can SimpleStore do for me? </h3>
    <p>
   
  -   You can use it to implement persitence aspect in your web application, or
  +   You can use it to implement persistence aspect in your web application, or
      object model, you can use it as  service for you server like  
        <a href='http://eob.sourceforge.net'>EOB</a> or EJB (CMP,BMP). 
      You can extend it and implement your  persitence framework. 
  @@ -35,7 +35,7 @@
   
     <p>
       This interface is used to implement well known Factory design pattern it
  -    used to setup singleton PersitenceManager instanse. PersitenceManager is
  +    used to setup singleton <code>PersitenceManager</code> instanse. <code>PersitenceManager</code>
is
       the most specific interface in your code:
      <p>
      <code>
  @@ -54,7 +54,7 @@
     </content>
      <h3 >PersitenceManager</h3>
      <p>
  -    PersitenceManager is factory for you beans and transactions, Transaction is
  +    <code>PersitenceManager</code> is factory for you beans and transactions,
<code>Transaction</code> is
       the last interface you need to know from SimpleStore if you not going to extend
       SimpleStore. You dont need to exdend any specific Class or implement internal
       persitence interfaces, you dont need any code generator. Just design your
  @@ -106,7 +106,7 @@
        </code>
      <p>
       This is persistent bean from Jakarta Velocity demo. All abstract methods are implemented

  -    by SimpleStore, PersitenceManager returns this implementation :
  +    by SimpleStore, <code>PersitenceManager</code> returns this implementation
:
      </p>
       <code>
        <pre >
  @@ -164,7 +164,33 @@
       </pre>
       </code>
       </p>  
  -      
  +    <h3>Identity</h3>  
  +    All persistent objects have OID, it is recomended to use Serializable Object for OID,
  +    reference implementaion uses <code>java.lang.Long</code> and default (Random)
generator.
  +    It is single persistent instance in SimpleStore with concreate OID.
  +   <pre>
  +   <code>
  +    PersistenceManager.getOID(object1).
  +                    equals(PersistenceManager.getOID(object2) );
  +      </code><h4><strong>&lt;==&gt;</strong></h4>
  +    <code>object1 <b>==</b> object2;</code>
  +    </code><h4><strong>&lt;==&gt;</strong></h4>
  +    <code>object1.equals(object2);</code>
     
  -  </BODY>
  +   </pre>
  +  OID is managed by framework and it is no way to change it for persistent object.
  +  SimpleStore overrides <code>int hashCode()</code> and 
  + <code>boolean equals(Object obj)</code>  methods in class Object.
  + <h3>State</h3>   
  +  It is to methods in <code>PersistenceManager</code> for persitent object
state.
  +  <code>boolean isNew(Object p)</code> returns <code>true</code>
if object is
  +  returned from <code>Object createInstance(Class cls)</code> in current transaction.
  +  <code>boolean isDeleted(Object p)</code> returns <code>true</code>
if object is
  +  deleted in any transacton. Use <code>void removeInstance(Object p)</code>
to
  +  delete persistent object. Managed methods throws 
  +  <code>java.lang.IllegalStateException</code> if deleted
  +  object is accessed inside or outside transaction.
  + 
  +
  + </BODY>
   </HTML>
  
  
  

--
To unsubscribe, e-mail:   <mailto:commons-dev-unsubscribe@jakarta.apache.org>
For additional commands, e-mail: <mailto:commons-dev-help@jakarta.apache.org>


Mime
View raw message