org.apache.camel.spring.CamelBeanPostProcessor Maven / Gradle / Ivy
/**
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You 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.apache.camel.spring;
import java.lang.reflect.Field;
import java.lang.reflect.Method;
import javax.xml.bind.annotation.XmlAccessType;
import javax.xml.bind.annotation.XmlAccessorType;
import javax.xml.bind.annotation.XmlRootElement;
import javax.xml.bind.annotation.XmlTransient;
import org.apache.camel.CamelContext;
import org.apache.camel.CamelContextAware;
import org.apache.camel.Endpoint;
import org.apache.camel.EndpointInject;
import org.apache.camel.Produce;
import org.apache.camel.impl.CamelPostProcessorHelper;
import org.apache.camel.impl.DefaultEndpoint;
import org.apache.camel.spring.util.ReflectionUtils;
import org.apache.camel.util.ObjectHelper;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import org.springframework.beans.BeanInstantiationException;
import org.springframework.beans.BeansException;
import org.springframework.beans.factory.config.BeanPostProcessor;
import org.springframework.context.ApplicationContext;
import org.springframework.context.ApplicationContextAware;
/**
* A bean post processor which implements the Bean Integration
* features in Camel. Features such as the Bean Injection of objects like
* {@link Endpoint} and
* {@link org.apache.camel.ProducerTemplate} together with support for
* POJO Consuming via the
* {@link org.apache.camel.Consume} annotation along with
* POJO Producing via the
* {@link org.apache.camel.Produce} annotation along with other annotations such as
* {@link org.apache.camel.RecipientList} for creating a Recipient List router via annotations.
*
* If you use the <camelContext> element in your Spring XML
* then one of these bean post processors is implicity installed and configured for you. So you should never have to
* explicitly create or configure one of these instances.
*
* @version $Revision: 788297 $
*/
@XmlRootElement(name = "beanPostProcessor")
@XmlAccessorType(XmlAccessType.FIELD)
public class CamelBeanPostProcessor implements BeanPostProcessor, ApplicationContextAware {
private static final transient Log LOG = LogFactory.getLog(CamelBeanPostProcessor.class);
@XmlTransient
private CamelContext camelContext;
@XmlTransient
private ApplicationContext applicationContext;
@XmlTransient
private CamelPostProcessorHelper postProcessor;
@XmlTransient
private String camelId;
public CamelBeanPostProcessor() {
}
public Object postProcessBeforeInitialization(Object bean, String beanName) throws BeansException {
if (LOG.isTraceEnabled()) {
LOG.trace("Camel bean processing before initialization for bean: " + beanName);
}
// some beans cannot be post processed at this given time, so we gotta check beforehand
if (!canPostProcessBean(bean, beanName)) {
return bean;
}
if (camelContext == null && applicationContext.containsBean(camelId)) {
setCamelContext((CamelContext) applicationContext.getBean(camelId));
}
injectFields(bean);
injectMethods(bean);
if (bean instanceof CamelContextAware) {
CamelContextAware contextAware = (CamelContextAware)bean;
if (camelContext == null) {
LOG.warn("No CamelContext defined yet so cannot inject into: " + bean);
} else {
contextAware.setCamelContext(camelContext);
}
}
return bean;
}
public Object postProcessAfterInitialization(Object bean, String beanName) throws BeansException {
if (LOG.isTraceEnabled()) {
LOG.trace("Camel bean processing after initialization for bean: " + beanName);
}
// some beans cannot be post processed at this given time, so we gotta check beforehand
if (!canPostProcessBean(bean, beanName)) {
return bean;
}
if (bean instanceof DefaultEndpoint) {
DefaultEndpoint defaultEndpoint = (DefaultEndpoint) bean;
defaultEndpoint.setEndpointUriIfNotSpecified(beanName);
}
return bean;
}
// Properties
// -------------------------------------------------------------------------
public void setApplicationContext(ApplicationContext applicationContext) throws BeansException {
this.applicationContext = applicationContext;
}
public CamelContext getCamelContext() {
return camelContext;
}
public void setCamelContext(CamelContext camelContext) {
this.camelContext = camelContext;
postProcessor = new CamelPostProcessorHelper(camelContext) {
@Override
protected RuntimeException createProxyInstantiationRuntimeException(Class type, Endpoint endpoint, Exception e) {
return new BeanInstantiationException(type, "Could not instantiate proxy of type " + type.getName() + " on endpoint " + endpoint, e);
}
};
}
public String getCamelId() {
return camelId;
}
public void setCamelId(String camelId) {
this.camelId = camelId;
}
// Implementation methods
// -------------------------------------------------------------------------
/**
* Can we post process the given bean?
*
* @param bean the bean
* @param beanName the bean name
* @return true to process it
*/
protected boolean canPostProcessBean(Object bean, String beanName) {
// the JMXAgent is a bit strange and causes Spring issues if we let it being
// post processed by this one. It does not need it anyway so we are good to go.
if (bean instanceof CamelJMXAgentDefinition) {
return false;
}
// all other beans can of course be processed
return true;
}
/**
* A strategy method to allow implementations to perform some custom JBI
* based injection of the POJO
*
* @param bean the bean to be injected
*/
protected void injectFields(final Object bean) {
ReflectionUtils.doWithFields(bean.getClass(), new ReflectionUtils.FieldCallback() {
public void doWith(Field field) throws IllegalArgumentException, IllegalAccessException {
EndpointInject endpointInject = field.getAnnotation(EndpointInject.class);
if (endpointInject != null && postProcessor.matchContext(endpointInject.context())) {
injectField(field, endpointInject.uri(), endpointInject.name(), bean);
}
Produce produce = field.getAnnotation(Produce.class);
if (produce != null && postProcessor.matchContext(produce.context())) {
injectField(field, produce.uri(), produce.ref(), bean);
}
}
});
}
protected void injectField(Field field, String endpointUri, String endpointRef, Object bean) {
ReflectionUtils.setField(field, bean, getPostProcessor().getInjectionValue(field.getType(), endpointUri, endpointRef, field.getName()));
}
protected void injectMethods(final Object bean) {
ReflectionUtils.doWithMethods(bean.getClass(), new ReflectionUtils.MethodCallback() {
@SuppressWarnings("unchecked")
public void doWith(Method method) throws IllegalArgumentException, IllegalAccessException {
setterInjection(method, bean);
getPostProcessor().consumerInjection(method, bean);
}
});
}
protected void setterInjection(Method method, Object bean) {
EndpointInject endpointInject = method.getAnnotation(EndpointInject.class);
if (endpointInject != null && postProcessor.matchContext(endpointInject.context())) {
setterInjection(method, bean, endpointInject.uri(), endpointInject.name());
}
Produce produce = method.getAnnotation(Produce.class);
if (produce != null && postProcessor.matchContext(produce.context())) {
setterInjection(method, bean, produce.uri(), produce.ref());
}
}
protected void setterInjection(Method method, Object bean, String endpointUri, String endpointRef) {
Class[] parameterTypes = method.getParameterTypes();
if (parameterTypes != null) {
if (parameterTypes.length != 1) {
LOG.warn("Ignoring badly annotated method for injection due to incorrect number of parameters: " + method);
} else {
String propertyName = ObjectHelper.getPropertyName(method);
Object value = getPostProcessor().getInjectionValue(parameterTypes[0], endpointUri, endpointRef, propertyName);
ObjectHelper.invokeMethod(method, bean, value);
}
}
}
public CamelPostProcessorHelper getPostProcessor() {
ObjectHelper.notNull(postProcessor, "postProcessor");
return postProcessor;
}
}