org.hibernate.validator.internal.engine.path

Class NodeImpl

java.lang.Object

org.hibernate.validator.internal.engine.path.NodeImpl

All Implemented Interfaces:

Serializable, Path.BeanNode, Path.ConstructorNode, Path.CrossParameterNode, Path.MethodNode, Path.Node, Path.ParameterNode, Path.PropertyNode, Path.ReturnValueNode, PropertyNode

public class NodeImpl
extends Object
implements Path.PropertyNode, Path.MethodNode, Path.ConstructorNode, Path.BeanNode, Path.ParameterNode, Path.ReturnValueNode, Path.CrossParameterNode, PropertyNode, Serializable

Immutable implementation of a Path.Node.

Author:

Hardy Ferentschik, Gunnar Morling

See Also:

Serialized Form

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.
String	asString()
int	buildHashCode()
static NodeImpl	createBeanNode(NodeImpl parent)
static NodeImpl	createCollectionElementNode(NodeImpl parent)
static NodeImpl	createConstructorNode(String name, NodeImpl parent, Class<?>[] parameterTypes)
static NodeImpl	createCrossParameterNode(NodeImpl parent)
static NodeImpl	createMethodNode(String name, NodeImpl parent, Class<?>[] parameterTypes)
static NodeImpl	createParameterNode(String name, NodeImpl parent, int parameterIndex)
static NodeImpl	createPropertyNode(String name, NodeImpl parent)
static NodeImpl	createReturnValue(NodeImpl parent)
boolean	equals(Object obj)
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.
int	getParameterIndex()
List<Class<?>>	getParameterTypes()
NodeImpl	getParent()
Object	getValue()
int	hashCode()
boolean	isInIterable()
boolean	isIterable()
static NodeImpl	makeIterable(NodeImpl node)
static NodeImpl	setIndex(NodeImpl node, Integer index)
static NodeImpl	setMapKey(NodeImpl node, Object key)
static NodeImpl	setPropertyValue(NodeImpl node, Object value)
String	toString() Returns a human-readable representation of this node.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface javax.validation.Path.BeanNode

getContainerClass, getTypeArgumentIndex

Methods inherited from interface javax.validation.Path.PropertyNode

getContainerClass, getTypeArgumentIndex

Method Detail

createPropertyNode

public static NodeImpl createPropertyNode(String name,
                                          NodeImpl parent)

createCollectionElementNode

public static NodeImpl createCollectionElementNode(NodeImpl parent)

createParameterNode

public static NodeImpl createParameterNode(String name,
                                           NodeImpl parent,
                                           int parameterIndex)

createCrossParameterNode

public static NodeImpl createCrossParameterNode(NodeImpl parent)

createMethodNode

public static NodeImpl createMethodNode(String name,
                                        NodeImpl parent,
                                        Class<?>[] parameterTypes)

createConstructorNode

public static NodeImpl createConstructorNode(String name,
                                             NodeImpl parent,
                                             Class<?>[] parameterTypes)

createBeanNode

public static NodeImpl createBeanNode(NodeImpl parent)

createReturnValue

public static NodeImpl createReturnValue(NodeImpl parent)

makeIterable

public static NodeImpl makeIterable(NodeImpl node)

setIndex

public static NodeImpl setIndex(NodeImpl node,
                                Integer index)

setMapKey

public static NodeImpl setMapKey(NodeImpl node,
                                 Object key)

setPropertyValue

public static NodeImpl setPropertyValue(NodeImpl node,
                                        Object value)

getName

public final String getName()

Description copied from interface: Path.Node

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.

Specified by:

getName in interface Path.Node

Returns:

name of the element which the node represents

isInIterable

public final boolean isInIterable()

Specified by:

isInIterable in interface Path.Node

Returns:

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

isIterable

public final boolean isIterable()

getIndex

public final Integer getIndex()

Specified by:

getIndex in interface Path.Node

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

public final Object getKey()

Specified by:

getKey in interface Path.Node

Returns:

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

getParent

public final NodeImpl getParent()

getKind

public ElementKind getKind()

Description copied from interface: Path.Node

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();
 [...]
 }
 

Specified by:

getKind in interface Path.Node

Returns:

the ElementKind

as

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

Description copied from interface: Path.Node

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

Specified by:

as in interface Path.Node

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.

getParameterTypes

public List<Class<?>> getParameterTypes()

Specified by:

getParameterTypes in interface Path.ConstructorNode

Specified by:

getParameterTypes in interface Path.MethodNode

Returns:

the list of parameter types

getParameterIndex

public int getParameterIndex()

Specified by:

getParameterIndex in interface Path.ParameterNode

Returns:

the parameter index in the method or constructor definition

getValue

public Object getValue()

Specified by:

getValue in interface PropertyNode

Returns:

Returns the value of the bean property represented by this node.

toString

public String toString()

Description copied from interface: Path.Node

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.

Specified by:

toString in interface Path.Node

Overrides:

toString in class Object

Returns:

a human-readable representation of this node

asString

public final String asString()

buildHashCode

public final int buildHashCode()

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object