Open Source Repository

Home /spring/spring-beans-3.0.5 | Repository Home



org/springframework/beans/factory/annotation/InjectionMetadata.java
/*
 * Copyright 2002-2010 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.beans.factory.annotation;

import java.beans.PropertyDescriptor;
import java.lang.reflect.Field;
import java.lang.reflect.InvocationTargetException;
import java.lang.reflect.Member;
import java.lang.reflect.Method;
import java.util.Collection;
import java.util.Iterator;
import java.util.LinkedHashSet;
import java.util.Set;

import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;

import org.springframework.beans.MutablePropertyValues;
import org.springframework.beans.PropertyValues;
import org.springframework.beans.factory.support.RootBeanDefinition;
import org.springframework.util.ReflectionUtils;

/**
 * Internal class for managing injection metadata.
 * Not intended for direct use in applications.
 *
 <p>Used by {@link AutowiredAnnotationBeanPostProcessor},
 {@link org.springframework.context.annotation.CommonAnnotationBeanPostProcessor} and
 {@link org.springframework.orm.jpa.support.PersistenceAnnotationBeanPostProcessor}.
 *
 @author Juergen Hoeller
 @since 2.5
 */
public class InjectionMetadata {

  private final Log logger = LogFactory.getLog(InjectionMetadata.class);

  private final Set<InjectedElement> injectedElements;


  public InjectionMetadata(Class targetClass, Collection<InjectedElement> elements) {
    this.injectedElements = new LinkedHashSet<InjectedElement>();
    for (InjectedElement element : elements) {
      if (logger.isDebugEnabled()) {
        logger.debug("Found injected element on class [" + targetClass.getName() "]: " + element);
      }
      this.injectedElements.add(element);
    }
  }

  public void checkConfigMembers(RootBeanDefinition beanDefinition) {
    for (Iterator<InjectedElement> it = this.injectedElements.iterator(); it.hasNext();) {
      Member member = it.next().getMember();
      if (!beanDefinition.isExternallyManagedConfigMember(member)) {
        beanDefinition.registerExternallyManagedConfigMember(member);
      }
      else {
        it.remove();
      }
    }
  }

  public void inject(Object target, String beanName, PropertyValues pvsthrows Throwable {
    if (!this.injectedElements.isEmpty()) {
      boolean debug = logger.isDebugEnabled();
      for (InjectedElement element : this.injectedElements) {
        if (debug) {
          logger.debug("Processing injected method of bean '" + beanName + "': " + element);
        }
        element.inject(target, beanName, pvs);
      }
    }
  }


  public static abstract class InjectedElement {

    protected final Member member;

    protected final boolean isField;

    protected final PropertyDescriptor pd;

    protected volatile Boolean skip;

    protected InjectedElement(Member member, PropertyDescriptor pd) {
      this.member = member;
      this.isField = (member instanceof Field);
      this.pd = pd;
    }

    public final Member getMember() {
      return this.member;
    }

    protected final Class getResourceType() {
      if (this.isField) {
        return ((Fieldthis.member).getType();
      }
      else if (this.pd != null) {
        return this.pd.getPropertyType();
      }
      else {
        return ((Methodthis.member).getParameterTypes()[0];
      }
    }

    protected final void checkResourceType(Class resourceType) {
      if (this.isField) {
        Class fieldType = ((Fieldthis.member).getType();
        if (!(resourceType.isAssignableFrom(fieldType|| fieldType.isAssignableFrom(resourceType))) {
          throw new IllegalStateException("Specified field type [" + fieldType +
              "] is incompatible with resource type [" + resourceType.getName() "]");
        }
      }
      else {
        Class paramType =
            (this.pd != null this.pd.getPropertyType() ((Methodthis.member).getParameterTypes()[0]);
        if (!(resourceType.isAssignableFrom(paramType|| paramType.isAssignableFrom(resourceType))) {
          throw new IllegalStateException("Specified parameter type [" + paramType +
              "] is incompatible with resource type [" + resourceType.getName() "]");
        }
      }
    }

    /**
     * Either this or {@link #getResourceToInject} needs to be overridden.
     */
    protected void inject(Object target, String requestingBeanName, PropertyValues pvsthrows Throwable {
      if (this.isField) {
        Field field = (Fieldthis.member;
        ReflectionUtils.makeAccessible(field);
        field.set(target, getResourceToInject(target, requestingBeanName));
      }
      else {
        if (checkPropertySkipping(pvs)) {
          return;
        }
        try {
          Method method = (Methodthis.member;
          ReflectionUtils.makeAccessible(method);
          method.invoke(target, getResourceToInject(target, requestingBeanName));
        }
        catch (InvocationTargetException ex) {
          throw ex.getTargetException();
        }
      }
    }

    /**
     * Checks whether this injector's property needs to be skipped due to
     * an explicit property value having been specified. Also marks the
     * affected property as processed for other processors to ignore it.
     */
    protected boolean checkPropertySkipping(PropertyValues pvs) {
      if (this.skip == null) {
        synchronized (pvs) {
          if (this.skip == null) {
            if (this.pd != null && pvs != null) {
              if (pvs.contains(this.pd.getName())) {
                // Explicit value provided as part of the bean definition.
                this.skip = true;
                return true;
              }
              else if (pvs instanceof MutablePropertyValues) {
                ((MutablePropertyValuespvs).registerProcessedProperty(this.pd.getName());
              }
            }
            this.skip = false;
          }
        }
      }
      return this.skip;
    }

    /**
     * Either this or {@link #inject} needs to be overridden.
     */
    protected Object getResourceToInject(Object target, String requestingBeanName) {
      return null;
    }

    @Override
    public boolean equals(Object other) {
      if (this == other) {
        return true;
      }
      if (!(other instanceof InjectedElement)) {
        return false;
      }
      InjectedElement otherElement = (InjectedElementother;
      return this.member.equals(otherElement.member);
    }

    @Override
    public int hashCode() {
      return this.member.getClass().hashCode() 29 this.member.getName().hashCode();
    }

    @Override
    public String toString() {
      return getClass().getSimpleName() " for " this.member;
    }
  }

}