001/*****************************************************************************
002 * Copyright (c) PicoContainer Organization. All rights reserved.            *
003 * ------------------------------------------------------------------------- *
004 * The software in this package is published under the terms of the BSD      *
005 * style license a copy of which has been included with this distribution in *
006 * the LICENSE.txt file.                                                     *
007 *                                                                           *
008 * Idea by Rachel Davies, Original code by Aslak Hellesoy and Paul Hammant   *
009 *****************************************************************************/
010
011package org.picocontainer.injectors;
012
013import org.picocontainer.ComponentAdapter;
014import org.picocontainer.Parameter;
015import org.picocontainer.PicoCompositionException;
016import org.picocontainer.ComponentMonitor;
017import org.picocontainer.LifecycleStrategy;
018import org.picocontainer.annotations.Inject;
019
020import java.lang.annotation.Annotation;
021import java.util.Properties;
022
023
024/**
025 * A {@link org.picocontainer.InjectionFactory} for Guice-style annotated methods.
026 * The factory creates {@link AnnotatedMethodInjector}.
027 *
028 * @author Paul Hammant
029 */
030@SuppressWarnings("serial")
031public class AnnotatedMethodInjection extends AbstractInjectionFactory {
032
033
034        private final Class<? extends Annotation> injectionAnnotation;
035    private final boolean useNames;
036
037    public AnnotatedMethodInjection(Class<? extends Annotation> injectionAnnotation, boolean useNames) {
038        this.injectionAnnotation = injectionAnnotation;
039        this.useNames = useNames;
040    }
041
042    public AnnotatedMethodInjection() {
043        this(Inject.class, false);
044    }
045
046    /**
047     * Create a {@link SetterInjector}.
048     * 
049     * @param monitor
050     * @param lifecycleStrategy
051     * @param componentProperties
052     * @param componentKey The component's key
053     * @param componentImplementation The class of the bean.
054     * @param parameters Any parameters for the setters. If null the adapter
055     *            solves the dependencies for all setters internally. Otherwise
056     *            the number parameters must match the number of the setter.
057     * @return Returns a new {@link SetterInjector}.
058     * @throws org.picocontainer.PicoCompositionException if dependencies cannot
059     *             be solved or if the implementation is an interface or an
060     *             abstract class.
061     */
062    public <T> ComponentAdapter<T> createComponentAdapter(ComponentMonitor monitor, LifecycleStrategy lifecycleStrategy, Properties componentProperties,
063                                                   Object componentKey, Class<T> componentImplementation, Parameter... parameters)
064            throws PicoCompositionException {
065        return wrapLifeCycle(monitor.newInjector(new AnnotatedMethodInjector(componentKey, componentImplementation, parameters, monitor, injectionAnnotation, useNames)), lifecycleStrategy);
066    }
067}