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();
}
Show replies by date