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

[hibernate-commits at lists.jboss.org]

Author: epbernard
Date: 2009-07-02 08:40:48 -0400 (Thu, 02 Jul 2009)
New Revision: 16992

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

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-02 12:39:38 UTC (rev 16991)
+++ beanvalidation/trunk/validation-api/src/main/java/javax/validation/PathBuilder.java	2009-07-02 12:40:48 UTC (rev 16992)
@@ -29,13 +29,15 @@
 public interface PathBuilder {
 
     /**
-     * Start the creation of a Path object whose root node is
-     * named rootNode.
+     * Add a subNode to the path.
      *
-     * @param rootNode root node name
-     * @return a builder representing the root node
+     * name describes a single property. In particular,
+     * dot (.) are not allowed.
+     *
+     * @param name property
+     * @return a builder representing this node
      */
-    PathBuilder.NodeBuilderWithDefinedContext buildPath(String rootNode);
+    PathBuilder.NodeBuilderWithDefinedContext addSubNode(String name);
 
     /**
      * Represent a node whose context is known
@@ -43,8 +45,11 @@
      */
     interface NodeBuilderWithDefinedContext {
         /**
-         * Add a subNode to the path
+         * Add a subNode to the path.
          *
+         * name describes a single property. In particular,
+         * dot (.) are not allowed.
+         *
          * @param name property
          * @return a builder representing this node
          */
@@ -73,8 +78,11 @@
         NodeContextBuilder inIterable();
 
         /**
-         * Add a subNode to the path
+         * Add a subNode to the path.
          *
+         * name describes a single property. In particular,
+         * dot (.) are not allowed.
+         *
          * @param name property
          * @return a builder representing this node
          */
@@ -115,8 +123,11 @@
         NodeBuilderWithDefinedContext atIndex(Integer index);
 
         /**
-         * Add a subNode to the path
+         * Add a subNode to the path.
          *
+         * name describes a single property. In particular,
+         * dot (.) are not allowed.
+         *
          * @param name property
          * @return a builder representing this node
          */