/**************************************************************************************
 * Copyright (c) Jonas Bonér, Alexandre Vasseur. All rights reserved.                 *
 * http://aspectwerkz.codehaus.org                                                    *
 * ---------------------------------------------------------------------------------- *
 * The software in this package is published under the terms of the LGPL license      *
 * a copy of which has been included with this distribution in the license.txt file.  *
 **************************************************************************************/
package org.codehaus.aspectwerkz.connectivity;

/**
 * Invokes the method for an instance mapped to a specific handle.
 *
 * @author <a href="mailto:jboner@codehaus.org">Jonas Bonér</a>
 */
public interface Invoker {

    /**
     * Invokes a specific method on the object mapped to the role specified.
     *
     * @param handle     the handle to the implementation class (class name, mapped name, UUID etc.)
     * @param methodName the name of the method
     * @param paramTypes the parameter types
     * @param args       the arguments to the method
     * @param context    the context with the users principal and credentials
     * @return the result from the invocation
     */
    public Object invoke(
            final String handle,
            final String methodName,
            final Class[] paramTypes,
            final Object[] args,
            final Object context);
}
