[hibernate-commits] Hibernate SVN: r16988 - beanvalidation/trunk/validation-api/src/main/java/javax/validation.

[hibernate-commits at lists.jboss.org]

Author: epbernard
Date: 2009-07-01 09:30:20 -0400 (Wed, 01 Jul 2009)
New Revision: 16988

Modified:
   beanvalidation/trunk/validation-api/src/main/java/javax/validation/PathBuilder.java
Log:
BVAL-171 Prototype for a PathBuilder

Modified: beanvalidation/trunk/validation-api/src/main/java/javax/validation/PathBuilder.java
===================================================================
--- beanvalidation/trunk/validation-api/src/main/java/javax/validation/PathBuilder.java	2009-07-01 12:55:44 UTC (rev 16987)
+++ beanvalidation/trunk/validation-api/src/main/java/javax/validation/PathBuilder.java	2009-07-01 13:30:20 UTC (rev 16988)
@@ -22,7 +22,7 @@
  * Once a Path object is returned ( by calling #build() ),
  * instances of the fluent API should no longer be used
  * and an IllegalStateException is raised upon any of the
- * method call
+ * method call.
  *
  * @author Emmanuel Bernard
  */
@@ -53,9 +53,10 @@
         /**
          * Return a Path object whose state is represented by
          * the path builder.
-         * Methods of the PathBuilder instance this object comes
-         * from and the path builder nested
-         * objects return IllegalStateException from now on.
+         * Once a Path object is returned ( by calling #build() ),
+         * instances of the fluent API should no longer be used
+         * and an IllegalStateException is raised upon any of the
+         * method call.
          */
         Path build();
     }
@@ -64,8 +65,6 @@
      * Represent a subnode whose context is
      * configurable (ie index, key and isInIterable)
      */
-    //ContextualizableNodeBuilder
-    //NodeBuilderWithCustomizableContext
     interface NodeBuilderWithCustomizableContext {
         /**
          * Mark the node as being in an Iterable or a Map
@@ -84,15 +83,16 @@
         /**
          * Return a Path object whose state is represented by
          * the path builder.
-         * Methods of the PathBuilder instance this object comes
-         * from and the path builder nested
-         * objects return IllegalStateException from now on.
+         * Once a Path object is returned ( by calling #build() ),
+         * instances of the fluent API should no longer be used
+         * and an IllegalStateException is raised upon any of the
+         * method call.
          */
         Path build();
     }
 
     /**
-     * Represent choices for a node which is
+     * Represent refinement choices for a node which is
      * in an Iterator or Map.
      * If the iterator is an indexed collection or a map,
      * the index or the key should be set.
@@ -125,9 +125,10 @@
         /**
          * Return a Path object whose state is represented by
          * the path builder.
-         * Methods of the PathBuilder instance this object comes
-         * from and the path builder nested
-         * objects return IllegalStateException from now on.
+         * Once a Path object is returned ( by calling #build() ),
+         * instances of the fluent API should no longer be used
+         * and an IllegalStateException is raised upon any of the
+         * method call.
          */
         Path build();
     }