javax.validation

Interface Path.Node

All Known Subinterfaces:

ContainerElementNode, Path.BeanNode, Path.ConstructorNode, Path.ContainerElementNode, Path.CrossParameterNode, Path.MethodNode, Path.ParameterNode, Path.PropertyNode, Path.ReturnValueNode, PropertyNode

All Known Implementing Classes:

NodeImpl

Enclosing interface:

Path

public static interface Path.Node

Represents an element of a navigation path.

Method Summary

Modifier and Type	Method and Description
<T extends Path.Node> T	as(Class<T> nodeType) Narrows the type of this node down to the given type.
Integer	getIndex()
Object	getKey()
ElementKind	getKind() The kind of element represented by the node.
String	getName() Returns the name of the element which the node represents: null if it is a leaf node which represents an entity / bean.
boolean	isInIterable()
String	toString() Returns a human-readable representation of this node.

Method Detail

getName

String getName()

Returns the name of the element which the node represents:

• null if it is a leaf node which represents an entity / bean. In particular, the node representing the root object.
• The property name for a property.
• The method name for a method.
• The unqualified name of the type declaring the constructor for a constructor.
• The parameter named as defined by the ParameterNameProvider for a method or constructor parameter.
• The literal <cross-parameter> for a method or constructor cross-parameter.
• The literal <return value> for a method or constructor return value.
• The node name as defined by the ValueExtractor for a container element; specifically, the literal <list element> for elements stored in a list, the literal <iterable element> for elements stored in an Iterable, the literal <map key> for the keys stored in a Map and the literal <map value> for the values stored in a Map.

Returns:

name of the element which the node represents

isInIterable

boolean isInIterable()

Returns:

true if the node represents an object contained in a multi-valued container such as Iterable or Map or an array, false otherwise

getIndex

Integer getIndex()

Returns:

the index the node is placed in if contained in an array, a List or any other container supporting indexed access, null otherwise

getKey

Object getKey()

Returns:

the key the node is placed in if contained in a Map or any other container supporting keyed access, null otherwise

getKind

ElementKind getKind()

The kind of element represented by the node. The following relationship between an ElementKind and its Node subtype exists:

• ElementKind.BEAN: Path.BeanNode
• ElementKind.PROPERTY: Path.PropertyNode
• ElementKind.METHOD: Path.MethodNode
• ElementKind.CONSTRUCTOR: Path.ConstructorNode
• ElementKind.PARAMETER: Path.ParameterNode
• ElementKind.CROSS_PARAMETER: Path.CrossParameterNode
• ElementKind.RETURN_VALUE: Path.ReturnValueNode
• ElementKind.CONTAINER_ELEMENT: Path.ContainerElementNode

This is useful to narrow down the Node type and access node specific information:

 switch(node.getKind() {
 case METHOD:
     name = node.getName();
     params = node.as(MethodNode.class).getParameterTypes();
 case PARAMETER:
     index = node.as(ParameterNode.class).getParameterIndex();
 [...]
 }
 

Returns:

the ElementKind

Since:

1.1

as

<T extends Path.Node> T as(Class<T> nodeType)

Narrows the type of this node down to the given type. The appropriate type should be checked before by calling getKind().

Type Parameters:

T - the type to narrow down to

Parameters:

nodeType - class object representing the descriptor type to narrow down to to

Returns:

this node narrowed down to the given type.

Throws:

ClassCastException - if this node is not assignable to the type T

Since:

1.1

toString

String toString()

Returns a human-readable representation of this node.

Clients should not rely on any specific structure of the returned value. Instead they should obtain any required information by calling the methods on this interface and its sub-types.

Overrides:

toString in class Object

Returns:

a human-readable representation of this node

Since:

2.0