net.sf.javagimmicks.cdi.InjectionFactory Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of gimmicks Show documentation

Utility classes, APIs and tools for Java

There is a newer version: 0.99-alpha1

package net.sf.javagimmicks.cdi;

import java.lang.annotation.Annotation;

import javax.inject.Qualifier;

import net.sf.javagimmicks.lang.ConstantFactory;
import net.sf.javagimmicks.lang.Factory;

/**
 * A {@link Factory} implementation that creates new instances via CDI lookup
 * mechanisms. Lookups can be configured using the {@link InjectionSpec} API.
 */
public class InjectionFactory extends CDIAware implements Factory
{
   private final Factory> _injectionFactory;

   /**
    * Creates a new instance based on a given {@link Factory} for
    * {@link InjectionSpec}s.
    * 
    * Every call to {@link #create()} will result in a respective call to
    * {@link InjectionSpec#getInstance(javax.enterprise.inject.spi.BeanManager)}.
    * 
    * @param injectionFactory
    *           the {@link Factory} to use for creating injection information
    *           via {@link InjectionSpec} instances.
    */
   public InjectionFactory(final Factory> injectionFactory)
   {
      _injectionFactory = injectionFactory;
   }

   /**
    * Convenience constructor to {@link #InjectionFactory(Factory)} that always
    * uses the specified {@link InjectionSpec} for looking up objects instead of
    * creating a new {@link InjectionSpec} all the time for each call to
    * {@link #create()}.
    * 
    * @param injection
    *           the {@link InjectionSpec} to use for bean creation
    */
   public InjectionFactory(final InjectionSpec injection)
   {
      this(new ConstantFactory>(injection));
   }

   /**
    * Convenience constructor to {@link #InjectionFactory(InjectionSpec)} that
    * uses the given {@link Class} and {@link Annotation}s as injection
    * information.
    * 
    * @param clazz
    *           the {@link Class} of objects to lookup
    * @param annotations
    *           the {@link Qualifier} annotations of the bean to lookup
    */
   public InjectionFactory(final Class clazz, final Annotation... annotations)
   {
      this(new InjectionSpec(clazz, annotations));
   }

   /**
    * Convenience constructor to {@link #InjectionFactory(Class, Annotation...)}
    * that builds injection information only upon a given {@link Class}.
    * 
    * @param clazz
    *           the {@link Class} of objects to lookup
    */
   public InjectionFactory(final Class clazz)
   {
      this(new InjectionSpec(clazz));
   }

   @Override
   public final E create()
   {
      return _injectionFactory.create().getInstance(getBeanManager());
   }
}