/*
 * Copyright 2002-2013 the original author or authors.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package org.springframework.expression;


// TODO Is the resolver/executor model too pervasive in this package?
Executors are built by resolvers and can be cached by the infrastructure to repeat an
operation quickly without going back to the resolvers. For example, the particular
constructor to run on a class may be discovered by the reflection constructor resolver
- it will then build a ConstructorExecutor that executes that constructor and the
ConstructorExecutor can be reused without needing to go back to the resolver to
discover the constructor again.
They can become stale, and in that case should throw an AccessException - this will
cause the infrastructure to go back to the resolvers to ask for a new one.
Author:
Andy Clement
Since:
3.0/**
 * Executors are built by resolvers and can be cached by the infrastructure to repeat an
 * operation quickly without going back to the resolvers. For example, the particular
 * constructor to run on a class may be discovered by the reflection constructor resolver
 * - it will then build a ConstructorExecutor that executes that constructor and the
 * ConstructorExecutor can be reused without needing to go back to the resolver to
 * discover the constructor again.
 *
 * <p>They can become stale, and in that case should throw an AccessException - this will
 * cause the infrastructure to go back to the resolvers to ask for a new one.
 *
 * @author Andy Clement
 * @since 3.0
 */
public interface ConstructorExecutor {

	
Execute a constructor in the specified context using the specified arguments.
Params:
context – the evaluation context in which the command is being executed
arguments – the arguments to the constructor call, should match (in terms
of number and type) whatever the command will need to run
Throws:
AccessException – if there is a problem executing the command or the
CommandExecutor is no longer valid
Returns:
the new object/**
	 * Execute a constructor in the specified context using the specified arguments.
	 * @param context the evaluation context in which the command is being executed
	 * @param arguments the arguments to the constructor call, should match (in terms
	 * of number and type) whatever the command will need to run
	 * @return the new object
	 * @throws AccessException if there is a problem executing the command or the
	 * CommandExecutor is no longer valid
	 */
	TypedValue execute(EvaluationContext context, Object... arguments) throws AccessException;

}