net.sf.javagimmicks.cdi.testing.WeldTestRule 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.testing;

import java.lang.annotation.Annotation;

import javax.enterprise.inject.Instance;
import javax.enterprise.util.TypeLiteral;
import javax.inject.Inject;
import javax.inject.Qualifier;

import org.jboss.weld.environment.se.Weld;
import org.jboss.weld.environment.se.WeldContainer;
import org.junit.rules.ExternalResource;
import org.junit.rules.TestRule;
import org.junit.runner.Runner;
import org.junit.runners.BlockJUnit4ClassRunner;

/**
 * A JUnit {@link TestRule} implementation which sets up a local CDI context
 * (using Weld-SE internally) for each test run. CDI beans can be retrieved via
 * the additional methods provided by this class.
 * 
 * Note: if you don't need a special {@link Runner} for your test (other
 * than {@link BlockJUnit4ClassRunner}), you can use
 * {@link WeldJUnit4TestRunner} instead of this class which enables CDI
 * injection directly into the test class using @{@link Inject}.
 * 
 * @see WeldJUnit4TestRunner
 */
public class WeldTestRule extends ExternalResource
{
   private Weld _weld;
   private WeldContainer _weldContainer;

   @Override
   protected void before() throws Throwable
   {
      _weld = new Weld();
      _weldContainer = _weld.initialize();
   }

   @Override
   protected void after()
   {
      _weldContainer = null;
      _weld.shutdown();
      _weld = null;
   }

   /**
    * Provides a CDI {@link Instance} object which can be used to lookup any
    * other CDI bean.
    * 
    * @return an {@link Instance} providing access to the whole CDI context
    */
   public Instance