svn commit: r471511 - /incubator/cayenne/main/trunk/core/cayenne-jdk1.4/src/main/java/org/apache/cayenne/property/Property.java

[aa...@apache.org]

Author: aadamchik
Date: Sun Nov  5 11:55:41 2006
New Revision: 471511

URL: http://svn.apache.org/viewvc?view=rev&rev=471511
Log:
javadocs

Modified:
    incubator/cayenne/main/trunk/core/cayenne-jdk1.4/src/main/java/org/apache/cayenne/property/Property.java

Modified: incubator/cayenne/main/trunk/core/cayenne-jdk1.4/src/main/java/org/apache/cayenne/property/Property.java
URL: http://svn.apache.org/viewvc/incubator/cayenne/main/trunk/core/cayenne-jdk1.4/src/main/java/org/apache/cayenne/property/Property.java?view=diff&rev=471511&r1=471510&r2=471511
==============================================================================
--- incubator/cayenne/main/trunk/core/cayenne-jdk1.4/src/main/java/org/apache/cayenne/property/Property.java (original)
+++ incubator/cayenne/main/trunk/core/cayenne-jdk1.4/src/main/java/org/apache/cayenne/property/Property.java Sun Nov  5 11:55:41 2006
@@ -39,24 +39,32 @@
     Object readPropertyDirectly(Object object) throws PropertyAccessException;
 
     /**
-     * Returns a property value, resolving object fault if needed.
+     * Returns a property value, inflating unresolved object if need.
      */
     Object readProperty(Object object) throws PropertyAccessException;
 
     /**
      * Sets a property value of an object without disturbing the object fault status. Old
-     * value of the property is specified as a hint.
+     * value of the property is specified as a hint and can be ignored by the property
+     * implementor.
      */
     void writePropertyDirectly(Object object, Object oldValue, Object newValue)
             throws PropertyAccessException;
 
     /**
-     * Sets a property value,resolving object fault if needed. Old value of the property
-     * is specified as a hint.
+     * Sets a property value, inflating unresolved object if need. Old value of the
+     * property is specified as a hint and can be ignored by the property implementor.
      */
     void writeProperty(Object object, Object oldValue, Object newValue)
             throws PropertyAccessException;
 
+    /**
+     * A visitor accept method.
+     * 
+     * @return a status returned by the corresponding callback method of the visitor. It
+     *         serves as an indication of whether peer properties processing is still
+     *         needed.
+     */
     boolean visit(PropertyVisitor visitor);
 
     /**