org.apache.maven.shared.utils.introspection
Class ReflectionValueExtractor

java.lang.Object
  org.apache.maven.shared.utils.introspection.ReflectionValueExtractor

public class ReflectionValueExtractor
extends Object

Using simple dotted expressions to extract the values from an Object instance, For example we might want to extract a value like: project.build.sourceDirectory

The implementation supports indexed, nested and mapped properties similar to the JSP way.

Version:

$Id: ReflectionValueExtractor.html 925654 2014-10-13 20:12:40Z krosenvold $

Author:

Jason van Zyl , Vincent Siveton

See Also:

http://struts.apache.org/1.x/struts-taglib/indexedprops.html

evaluate

public static Object evaluate(@Nonnull
                              String expression,
                              @Nullable
                              Object root)
                       throws org.apache.maven.shared.utils.introspection.IntrospectionException

The implementation supports indexed, nested and mapped properties.

• nested properties should be defined by a dot, i.e. "user.address.street"
• indexed properties (java.util.List or array instance) should be contains (\\w+)\\[(\\d+)\\] pattern, i.e. "user.addresses[1].street"
• mapped properties should be contains (\\w+)\\((.+)\\) pattern, i.e. "user.addresses(myAddress).street"

Parameters:

expression - not null expression

root - not null object

Returns:

the object defined by the expression

Throws:

IntrospectionException - if any

evaluate

public static Object evaluate(@Nonnull
                              String expression,
                              @Nullable
                              Object root,
                              boolean trimRootToken)
                       throws org.apache.maven.shared.utils.introspection.IntrospectionException

The implementation supports indexed, nested and mapped properties.

• nested properties should be defined by a dot, i.e. "user.address.street"
• indexed properties (java.util.List or array instance) should be contains (\\w+)\\[(\\d+)\\] pattern, i.e. "user.addresses[1].street"
• mapped properties should be contains (\\w+)\\((.+)\\) pattern, i.e. "user.addresses(myAddress).street"

Parameters:

expression - not null expression

root - not null object

Returns:

the object defined by the expression

Throws:

IntrospectionException - if any