public static final

While Mojarra 2.0.0 is out on the street and Weld (aka Java Contexts and Dependency Injection (JSR-299)) is reaching CR1 there’s not much content on the web about it. So I tried to give a litte tutorial how they can be integrated with Tomcat6 (Glassfish v3 and JBoss provide built in support).What’s needed?

• Mojarra 2.0.0 (Instructions for obtaining can be found here)
• Weld 1.0.0CR1 Servlet Environment (“weld-servlet.jar” contained in Weld donwload archive)
• JSR-250 API
• jstl 1.2
• el-impl 2.1.2-b04

Thats’s not really much (just about 5 MB of JARs) but all you need to get your application running. I’m not going into detail on how to configurate JSF but just what’s additionally required for Weld.

First you have to “tell” Weld and Tomcat that Weld is present by including the Weld Servlet listener in your application’s web.xml:

<listener>
  <listener-class>org.jboss.weld.environment.servlet.Listener</listener-class>
</listener>

After that create an empty file called “beans.xml” in the WEB-INF folder. Now Weld can do its magical stuff with all incoming Servlet request. Buth there’s more. This was just the setup of the Weld Servlet environment. Next you need to tell Weld what BeanManager should be used. The BeanManager is the reference to the Injection Manager itself.

The first thing to add is a resource reference in web.xml:

<resource-env-ref>
 <description>Object factory for the CDI Bean Manager</description>
 <resource-env-ref-name>BeanManager</resource-env-ref-name>
 <resource-env-ref-type>javax.enterprise.inject.spi.BeanManager</resource-env-ref-type>
</resource-env-ref>

And finally if not already present create META-INF/context.xml and put the Resource itself in it:

<Resource
 name="BeanManager"
 auth="Container"
 type="javax.enterprise.inject.spi.BeanManager"
 factory="org.jboss.weld.resources.ManagerObjectFactory"
/>

That’s all. Tomcat6 is now running with JSF 2.0 and Weld 1.0.0CR1 and ready for hours of fun. As you might have already guessed this post doesn’t contain anything about how to use Weld but just how to set it up with Tomcat6. However I’m writing a short introduction for Wled which should be online within 3 or 4 days.

UPDATE: For those using Maven here’s a simple POM containing the required repositories and dependencies:

<project
 xmlns="http://maven.apache.org/POM/4.0.0"
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
 <modelVersion>4.0.0</modelVersion>
 <groupId>de.publicstaticfinal</groupId>
 <artifactId>WeldJSF2</artifactId>
 <packaging>war</packaging>
 <version>0.0.1-SNAPSHOT</version>
 <repositories>
  <repository>
   <id>maven2-repository.dev.java.net</id>
   <name>Java.net Repository for Maven</name>
   <url>http://download.java.net/maven/2/</url>
   <layout>default</layout>
  </repository>
  <repository>
  <snapshots />
   <id>ibiblio</id>
   <url>http://www.ibiblio.org/maven2/</url>
   </repository>
   <repository>
   <id>JBoss</id>
   <url>http://repository.jboss.com/maven2</url>
  </repository>
 </repositories>
 <dependencies>
  <dependency>
   <groupId>com.sun.faces</groupId>
   <artifactId>jsf-api</artifactId>
   <version>2.0.1</version>
  </dependency>
  <dependency>
   <groupId>com.sun.faces</groupId>
   <artifactId>jsf-impl</artifactId>
   <scope>runtime</scope>
   <version>2.0.1</version>
  </dependency>
  <dependency>
   <groupId>javax.enterprise</groupId>
   <artifactId>cdi-api</artifactId>
   <scope>provided</scope>
   <version>1.0-CR1</version>
  </dependency>
  <dependency>
   <groupId>javax.annotation</groupId>
   <artifactId>jsr250-api</artifactId>
   <version>1.0</version>
  </dependency>
  <dependency>
   <groupId>javax.servlet</groupId>
   <artifactId>jstl</artifactId>
   <version>1.2</version>
   <scope>runtime</scope>
  </dependency>
  <dependency>
   <groupId>org.jboss.weld.servlet</groupId>
   <artifactId>weld-servlet</artifactId>
   <version>1.0.0-CR1</version>
   <scope>runtime</scope>
  </dependency>
  <dependency>
   <groupId>org.glassfish.web</groupId>
   <artifactId>el-impl</artifactId>
   <version>2.1.2-b04</version>
   <scope>runtime</scope>
   <exclusions>
    <exclusion>
     <groupId>javax.el</groupId>
     <artifactId>el-api</artifactId>
    </exclusion>
   </exclusions>
  </dependency>
 </dependencies>
</project>