org.springframework.webflow.action.BeanInvokingActionFactory Maven / Gradle / Ivy
/*
* Copyright 2002-2006 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.webflow.action;
import java.lang.reflect.Method;
import org.springframework.beans.factory.BeanFactory;
import org.springframework.binding.convert.ConversionService;
import org.springframework.binding.method.ClassMethodKey;
import org.springframework.binding.method.MethodSignature;
import org.springframework.webflow.core.collection.AttributeMap;
import org.springframework.webflow.execution.Action;
/**
* A helper factory for {@link Action} instances that invoke methods on
* beans managed in a Spring bean factory.
*
* This factory encapsulates the logic required to take an arbitrary
* java.lang.Object
from a Spring bean factory and adapt
* a method on it to the {@link Action} interface. If the bean you
* want to use is not managed in a Spring bean factory, consider
* subclassing {@link AbstractBeanInvokingAction} and using it directly.
*
* @see AbstractBeanInvokingAction
*
* @author Keith Donald
*/
public class BeanInvokingActionFactory {
/**
* Determines which result event factory should be used for each bean
* invoking action created by this factory.
*/
private ResultEventFactorySelector resultEventFactorySelector = new ResultEventFactorySelector();
/**
* Returns the strategy for calculating the result event factory to configure
* for each bean invoking action created by this factory.
*/
public ResultEventFactorySelector getResultEventFactorySelector() {
return resultEventFactorySelector;
}
/**
* Sets the strategy to calculate the result event factory to configure for
* each bean invoking action created by this factory.
*/
public void setResultEventFactorySelector(ResultEventFactorySelector resultEventFactorySelector) {
this.resultEventFactorySelector = resultEventFactorySelector;
}
/**
* Factory method that creates a bean invoking action, an adapter that
* adapts a method on an abitrary {@link Object} to the {@link Action}
* interface. This method is an atomic operation that returns a fully
* initialized Action. It encapsulates the selection of the action
* implementation as well as the action assembly.
* @param beanId the id of the bean to be adapted to an Action instance
* @param beanFactory the bean factory where the bean is managed
* @param methodSignature the method to invoke on the bean when the action
* is executed (required)
* @param resultExposer the specification for what to do with the method
* return value (optional)
* @param conversionService the conversion service to be used to convert
* method parameters (optional)
* @param attributes attributes that may be used to affect the bean invoking
* action's construction
* @return the fully configured bean invoking action instance
*/
public Action createBeanInvokingAction(String beanId, BeanFactory beanFactory, MethodSignature methodSignature,
ActionResultExposer resultExposer, ConversionService conversionService, AttributeMap attributes) {
Object bean = beanFactory.getBean(beanId);
AbstractBeanInvokingAction action = new LocalBeanInvokingAction(methodSignature, bean);
action.setMethodResultExposer(resultExposer);
Method method = new ClassMethodKey(bean.getClass(), methodSignature.getMethodName(), methodSignature.getParameters()
.getTypesArray()).getMethod();
action.setResultEventFactory(resultEventFactorySelector.forMethod(method));
action.setConversionService(conversionService);
return action;
}
}