org.apache.juneau.utils

Class PojoIntrospector

java.lang.Object

org.apache.juneau.utils.PojoIntrospector

public final class PojoIntrospector
extends Object

Used to invoke methods on Objects using arguments in serialized form.

Example:

String s = "foobar"; String s2 = (String)new PojoIntrospector(s) .invoke("substring(int,int)", "[3,6]"); // "bar"

Constructor Summary

Constructors

Constructor and Description
PojoIntrospector(Object o) Shortcut for calling new PojoIntrospector(o, null);
PojoIntrospector(Object o, ReaderParser p) Constructor.

Method Summary

Modifier and Type	Method and Description
Object	invokeMethod(Method method, Reader args) Primary method.
Object	invokeMethod(String method, String args) Convenience method for invoking argument from method signature (@see MethodInfo.getSignature().

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

PojoIntrospector

public PojoIntrospector(Object o,
                        ReaderParser p)

Constructor.

Parameters:

o - The object on which Java methods will be invoked.

p - The parser to use to parse the method arguments. If null, JsonParser.DEFAULT is used.

PojoIntrospector

public PojoIntrospector(Object o)

Shortcut for calling new PojoIntrospector(o, null);

Parameters:

o - The object on which Java methods will be invoked.

Method Detail

invokeMethod

public Object invokeMethod(Method method,
                           Reader args)
                    throws InvocationTargetException,
                           IllegalArgumentException,
                           IllegalAccessException,
                           ParseException,
                           IOException

Primary method.

Invokes the specified method on this bean.

Parameters:

method - The method being invoked.

args - The arguments to pass as parameters to the method. These will automatically be converted to the appropriate object type if possible. Can be null if method has no arguments.

Returns:

The object returned by the call to the method, or null if target object is null.

Throws:

IllegalAccessException - If the Constructor object enforces Java language access control and the underlying constructor is inaccessible.

IllegalArgumentException - If one of the following occurs:

• The number of actual and formal parameters differ.
• An unwrapping conversion for primitive arguments fails.
• A parameter value cannot be converted to the corresponding formal parameter type by a method invocation conversion.
• The constructor pertains to an enum type.

InvocationTargetException - If the underlying constructor throws an exception.

ParseException - Malformed input encountered.

IOException - Thrown by underlying stream.

invokeMethod

public Object invokeMethod(String method,
                           String args)
                    throws NoSuchMethodException,
                           IllegalArgumentException,
                           InvocationTargetException,
                           IllegalAccessException,
                           ParseException,
                           IOException

Convenience method for invoking argument from method signature (@see MethodInfo.getSignature().

Parameters:

method - The method being invoked.

args - The arguments to pass as parameters to the method. These will automatically be converted to the appropriate object type if possible. Can be null if method has no arguments.

Returns:

The object returned by the call to the method, or null if target object is null.

Throws:

NoSuchMethodException - If method does not exist.

IllegalAccessException - If the Constructor object enforces Java language access control and the underlying constructor is inaccessible.

IllegalArgumentException - If one of the following occurs:

• The number of actual and formal parameters differ.
• An unwrapping conversion for primitive arguments fails.
• A parameter value cannot be converted to the corresponding formal parameter type by a method invocation conversion.
• The constructor pertains to an enum type.

InvocationTargetException - If the underlying constructor throws an exception.

ParseException - Malformed input encountered.

IOException - Thrown by underlying stream.