org.apache.brooklyn.util.core.flags

Class MethodCoercions

java.lang.Object

org.apache.brooklyn.util.core.flags.MethodCoercions

public class MethodCoercions
extends java.lang.Object

A way of binding a loosely-specified method call into a strongly-typed Java method call.

Constructor Summary

Constructors

Constructor and Description
MethodCoercions()

Method Summary

Modifier and Type	Method and Description
static <any>	matchMethodByName(java.lang.String methodName) Returns a predicate that matches a method with the given name.
static <any>	matchMultiParameterMethod(java.util.List<?> arguments) Returns a predicate that matches a method with parameters that org.apache.brooklyn.util.core.flags.TypeCoercions#tryCoerce(Object, com.google.common.reflect.TypeToken) can process from the given list of arguments.
static <any>	matchMultiParameterMethod(java.lang.String methodName, java.util.List<?> arguments) Returns a predicate that matches a method with the given name, and parameters that org.apache.brooklyn.util.core.flags.TypeCoercions#tryCoerce(Object, com.google.common.reflect.TypeToken) can process from the given list of arguments.
static <any>	matchSingleParameterMethod(java.lang.String methodName, java.lang.Object argument) Returns a predicate that matches a method with the given name, and a single parameter that org.apache.brooklyn.util.core.flags.TypeCoercions#tryCoerce(Object, com.google.common.reflect.TypeToken) can process from the given argument.
static Maybe<?>	tryFindAndInvokeBestMatchingMethod(java.lang.Object instance, java.lang.String methodName, java.lang.Object argument) Tries to find a method with each parameter compatible with (can be coerced to) the corresponding argument, and invokes it.
static Maybe<?>	tryFindAndInvokeMultiParameterMethod(java.lang.Object instanceOrClazz, java.lang.Iterable<java.lang.reflect.Method> methods, java.util.List<?> arguments) Tries to find a multiple-parameter method with each parameter compatible with (can be coerced to) the corresponding argument, and invokes it.
static Maybe<?>	tryFindAndInvokeMultiParameterMethod(java.lang.Object instance, java.lang.String methodName, java.util.List<?> arguments) Tries to find a multiple-parameter method with each parameter compatible with (can be coerced to) the corresponding argument, and invokes it.
static Maybe<?>	tryFindAndInvokeSingleParameterMethod(java.lang.Object instance, java.lang.String methodName, java.lang.Object argument) Tries to find a single-parameter method with a parameter compatible with (can be coerced to) the argument, and invokes it.

Methods inherited from class java.lang.Object

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

Constructor Detail

MethodCoercions

public MethodCoercions()

Method Detail

matchSingleParameterMethod

public static <any> matchSingleParameterMethod(java.lang.String methodName,
                                               java.lang.Object argument)

Returns a predicate that matches a method with the given name, and a single parameter that org.apache.brooklyn.util.core.flags.TypeCoercions#tryCoerce(Object, com.google.common.reflect.TypeToken) can process from the given argument.

Parameters:

methodName - name of the method

argument - argument that is intended to be given

Returns:

a predicate that will match a compatible method

tryFindAndInvokeSingleParameterMethod

public static Maybe<?> tryFindAndInvokeSingleParameterMethod(java.lang.Object instance,
                                                             java.lang.String methodName,
                                                             java.lang.Object argument)

Tries to find a single-parameter method with a parameter compatible with (can be coerced to) the argument, and invokes it.

Parameters:

instance - the object to invoke the method on

methodName - the name of the method to invoke

argument - the argument to the method's parameter.

Returns:

the result of the method call, or Maybe.absent() if method could not be matched.

matchMultiParameterMethod

public static <any> matchMultiParameterMethod(java.lang.String methodName,
                                              java.util.List<?> arguments)

Returns a predicate that matches a method with the given name, and parameters that org.apache.brooklyn.util.core.flags.TypeCoercions#tryCoerce(Object, com.google.common.reflect.TypeToken) can process from the given list of arguments.

Parameters:

methodName - name of the method

arguments - arguments that is intended to be given

Returns:

a predicate that will match a compatible method

matchMethodByName

public static <any> matchMethodByName(java.lang.String methodName)

Returns a predicate that matches a method with the given name.

Parameters:

methodName - name of the method

Returns:

a predicate that will match a compatible method

matchMultiParameterMethod

public static <any> matchMultiParameterMethod(java.util.List<?> arguments)

Returns a predicate that matches a method with parameters that org.apache.brooklyn.util.core.flags.TypeCoercions#tryCoerce(Object, com.google.common.reflect.TypeToken) can process from the given list of arguments.

Parameters:

arguments - arguments that is intended to be given

Returns:

a predicate that will match a compatible method

tryFindAndInvokeMultiParameterMethod

public static Maybe<?> tryFindAndInvokeMultiParameterMethod(java.lang.Object instanceOrClazz,
                                                            java.lang.Iterable<java.lang.reflect.Method> methods,
                                                            java.util.List<?> arguments)

Tries to find a multiple-parameter method with each parameter compatible with (can be coerced to) the corresponding argument, and invokes it.

Parameters:

instanceOrClazz - the object or class to invoke the method on

methods - the methods to choose from

argument - a list of the arguments to the method's parameters.

Returns:

the result of the method call, or Maybe.absent() if method could not be matched.

tryFindAndInvokeMultiParameterMethod

public static Maybe<?> tryFindAndInvokeMultiParameterMethod(java.lang.Object instance,
                                                            java.lang.String methodName,
                                                            java.util.List<?> arguments)

Tries to find a multiple-parameter method with each parameter compatible with (can be coerced to) the corresponding argument, and invokes it.

Parameters:

instance - the object to invoke the method on

methodName - the name of the method to invoke

argument - a list of the arguments to the method's parameters.

Returns:

the result of the method call, or Maybe.absent() if method could not be matched.

tryFindAndInvokeBestMatchingMethod

public static Maybe<?> tryFindAndInvokeBestMatchingMethod(java.lang.Object instance,
                                                          java.lang.String methodName,
                                                          java.lang.Object argument)

Tries to find a method with each parameter compatible with (can be coerced to) the corresponding argument, and invokes it.

Parameters:

instance - the object to invoke the method on

methodName - the name of the method to invoke

argument - a list of the arguments to the method's parameters, or a single argument for a single-parameter method.

Returns:

the result of the method call, or Maybe.absent() if method could not be matched.