JBoss JCA 1.0.0.Alpha4 is out

ORM Search Validator Reactive Repositories Others

I'm very happy to announce the 4th developer snapshot of the JBoss JCA project.

Enter Embedded JCA

The focus of this release was to provide the initial version of our embedded JCA platform. This is actually a big step in the right direction for embedding a JCA container inside your own application or to create an unit testing environment for your resource adapters.

Lets focus on the latter use-case as it'll most likely cover the majority of deployments.

Below is a JUnit 4 test case which starts the embedded container and verifies a deployment of a resource adapter.

import org.jboss.jca.embedded.EmbeddedJCA;

import java.net.URL;

import org.junit.AfterClass;
import org.junit.BeforeClass;
import org.junit.Test;
import static org.junit.Assert.*;

public class MyTestCase
{
   /* Embedded */
   private static EmbeddedJCA embedded;

   /**
    * Simple test to verify deployment of myresourceadapter.rar
    * @throws Throwable throwable exception 
    */
   @Test
   public void testDeployment() throws Throwable
   {
      URL archive = getURL("myresourceadapter.rar");
 
      try
      {
         embedded.deploy(archive);
      }
      catch (Throwable t)
      {
         fail(t.getMessage());
      }
      finally
      {
         embedded.undeploy(archive);
      }
   }

   @BeforeClass
   public static void beforeClass() throws Throwable
   {
      // Create an embedded JCA instance
      embedded = new EmbeddedJCA();

      // Startup
      embedded.startup();
   }

   @AfterClass
   public static void afterClass() throws Throwable
   {
      // Shutdown
      embedded.shutdown();
   }
}

As you can see the embedded JCA API is simple to use :) The above test case runs in about 2 seconds (yes, two seconds) on my old machine - of course there is still room for improvement in that area ;)

We have integrated the embedded environment in our build environment and it now provides the foundation for our testing platform of our JCA container configurations - eating our own dog-food.

The embedded environment is still in development and of course depends on the functionality of the standalone JCA container environment. We are working on making the integration between JBoss JCA Embedded and your application even easier - if you want to help out drop by our forum.

The detailed release notes are here.