Help

Built with Seam

You can find the full source code for this website in the Seam package in the directory /examples/wiki. It is licensed under the LGPL.

Seam Requirements

Please read the Requirements FAQ first if you have any questions, this is a quick overview:

  • Important: You do not need JBoss Application Server to write or deploy Seam applications. See this page for more information on supported application servers and containers. Seam is bundled with a number of useful example applications, many of which do target JBoss AS for out-of-the-box deployment. Some bundled examples have been ported to other application servers and servlet containers, as documented in their README files.
  • Seam 2.2 examples target JBoss Application Server 5.1.
  • Seam 2.0 and 2.1 examples target JBoss Application Server 4.2 or 5.0.
  • Seam 1.2 examples target JBoss 4.0, which must be installed using the JEMS installer with the ejb3 or ejb3-clustering profile.
  • JDK 5.0 is required for all Seam releases. Seam has not been tested on JDK 6.0 (check this page for updates).

To get started with Seam after you downloaded it, please follow the Getting Started guidelines.

Seam Releases

Package Version Category Size Released License
JBoss Seam 2.2 2.2.0.GA Production 111 MB 30.07.2009 LGPL Notes Download
JBoss Seam 2.1 2.1.2.GA Production 136 MB 08.06.2009 LGPL Notes Download
JBoss Seam 2.0 2.0.3.CR1 Preproduction 84 MB 13.06.2008 LGPL Notes Download
JBoss Seam 2.0 2.0.2.SP1 Production 84 MB 28.05.2008 LGPL Notes Download
JBoss Seam 1.2 1.2.1 GA Production 73 MB 27.03.2007 LGPL Notes Download

Browse all packages | Latest 2.0 Unstable Nightly Build | Latest 2.1 Unstable Nightly Build | Latest 2.2 Unstable Nightly Build | JBoss Product Versioning Guidelines

Weld Requirements

  • Weld 1.0 requires JBoss Application Server 5.2.0.Beta1 (currently only nightly builds available) to run or to deploy the examples out-of-the-box. Alternatively, there is support for GlassFish V3, Tomcat or Jetty, and Java SE. Other application servers may be supported for the 1.0.0 release.

Weld 1.0.0 is available out of the box with JBoss Application Server 5.2.0.Beta1 - no need to install any libraries, just deploy your application.

  • JDK 5.0 or JDK 6.0 is required for all Weld releases

To get started with Weld after you downloaded it, please follow Chapter 6 Getting started with Weld in the Documentation.

Weld and JSR-299 TCK releases

Package Version Category Size Released License
Weld 1.0 1.0.0.SP1 Production 21.0 MB 12.11.2009 APL 2.0 Notes Download
JSR-299 TCK 1.0 1.0.1.CR1 Production 29.8 MB 21.01.2010 APL 2.0 Notes Download
Current JSR-299 TCK 1.0 Exclude list
Current JSR-299 TCK 1.0 Exclude list (for Java EE)

Seam in Maven

Seam 2 is available from the JBoss Maven 2 repository:

  • Group Id: org.jboss.seam
  • Artifact Ids: jboss-seam, jboss-seam-ui, jboss-seam-remoting, jboss-seam-ioc, jboss-seam-pdf, jboss-seam-mail, jboss-seam-debug, jboss-seam-excel, jboss-seam-rss, jboss-seam-wicket, jboss-seam-resteasy

Read this article for more information about Seam with Maven. You can also find unstable nightly builds on the JBoss Maven 2 snapshot repository.

Weld in Maven

Weld is available from Maven Central:

  • Group Id: javax.enterprise
  • Artifact Ids: cdi-api
  • Group Id: org.jboss.weld
  • Artifact Ids: weld-core, weld-api, weld-spi

Please be advised that if you are building applications on Weld using Maven, we still recommend using the JBoss Maven repository as well as central. We haven't been able to confirm that all the runtime dependencies are located in the Maven Central repository.

Seam SVN Repository

Seam is located in the JBoss SVN Repository, in the seam module. Seam 2 is a organized as a single project (thus one repository), built using Ant. Seam 3 is entirely modular and is divided into multiple repositories (docs, examples, modules, sandbox), each built using Maven 2. In order to get all of Seam 3, you have to check out each repository individually.

# Anonymous SVN checkout of the 2.0 stable branch:
svn co http://anonsvn.jboss.org/repos/seam/branches/community/Seam_2_0 seam

# Anonymous SVN checkout of the 2.1 stable branch:
svn co http://anonsvn.jboss.org/repos/seam/branches/community/Seam_2_1 seam

# Anonymous SVN checkout of the 2.2 stable branch:
svn co http://anonsvn.jboss.org/repos/seam/branches/community/Seam_2_2 seam

# Anonymous SVN checkout of the 3.0 development branch (trunk):
mkdir seam-trunk && cd seam-trunk # creates directory to host the source
svn co http://anonsvn.jboss.org/repos/seam/docs/trunk docs
svn co http://anonsvn.jboss.org/repos/seam/examples/trunk examples
svn co http://anonsvn.jboss.org/repos/seam/modules/trunk modules
cd modules/version-matrix && mvn install # seeds the Maven 2 repository

# Developer/Committer SVN checkout of the 2.0 stable branch:
svn co https://svn.jboss.org/repos/seam/branches/community/Seam_2_0 seam

# Developer/Committer SVN checkout of the 2.1 stable branch:
svn co https://svn.jboss.org/repos/seam/branches/community/Seam_2_1 seam

# Developer/Committer SVN checkout of the 2.2 stable branch:
svn co https://svn.jboss.org/repos/seam/branches/community/Seam_2_2 seam

# Developer/Committer SVN checkout of the 3.0 development branch (trunk):
mkdir seam-trunk && cd seam-trunk # creates directory to host the source
svn co https://svn.jboss.org/repos/seam/docs/trunk docs
svn co https://svn.jboss.org/repos/seam/examples/trunk examples
svn co https://svn.jboss.org/repos/seam/modules/trunk modules
cd modules/version-matrix && mvn install # seeds the Maven 2 repository

Please see JBoss SVN Repository for complete access instructions, including how to get commit access.

Browse Seam Repository | Seam SVN Notification Feed | Seam SVN Notification Mailing List

Weld SVN Repository

Weld is located in the JBoss SVN Repository, in the weld module.

# Anonymous SVN checkout of the 1.0 development branch:
svn co http://anonsvn.jboss.org/repos/weld/core/trunk weld

# Developer/Committer SVN checkout of the 1.0 development branch:
svn co https://svn.jboss.org/repos/weld/core/trunk weld

# Anonymous SVN checkout of the examples:
svn co http://anonsvn.jboss.org/repos/weld/examples/trunk weld-examples

# Developer/Committer SVN checkout of the examples:
svn co https://svn.jboss.org/repos/weld/examples/trunk weld-examples

# Anonymous SVN checkout of the documentation:
svn co http://anonsvn.jboss.org/repos/weld/doc/trunk/reference weld-reference-guide

# Developer/Committer SVN checkout of the documentation:
svn co https://svn.jboss.org/repos/weld/doc/trunk/reference weld-reference-guide

# Anonymous SVN checkout of the JBoss AS integration
svn co http://anonsvn.jboss.org/repos/jbossas/projects/weld-int/trunk weld-int

# Developer/Committer SVN checkout of the JBoss AS integration:
svn co https://svn.jboss.org/repos/jbossas/projects/weld-int/trunk weld-int

Please see JBoss SVN Repository for complete access instructions, including how to get commit access.

Browse Weld Repository | Weld SVN Notification Feed | Weld SVN Notification Mailing List

Building Seam 2

You need a full install of ant 1.7.0. Some linux distributions only supply a partial installation of ant which will make the build fail. If so, make sure ant-nodeps.jar is on the classpath.

To build Seam from SVN, just run ant build in seam/. You'll find the built artifacts and current set of libraries in jboss-seam/lib.

For more information, see Getting Started Developing the Seam Framework.

Building Weld

You need a full install of ant 1.7.0. Some Linux distributions only supply a partial installation of ant which will make the build fail. If so, make sure ant-nodeps.jar is on the classpath.

To build Weld from SVN, just run mvn install in weld/. You'll find the built artifacts and current set of libraries in your maven repository. To update JBoss AS with this version of Weld, run ant -f jboss-as/build.xml.

For more information, see Guidelines for Weld development.

Building Seam 3

NOTE: This build is currently not working correctly due to recent changes to CDI and Weld.

Seam 3 is built entirely with Maven 2, so you will need to have that installed before you begin. You also need to use JDK 6 at the moment. Seam 3 will target JDK 5, but we're using a JDK 6 API for convenience/prototyping. Keep in mind that Seam 3 is in the very early stages, so put on your lab glasses ;)

Begin by installing/extracting JBoss AS 5. Set the JBOSS_HOME environment variable to point to this installation. Now, checkout and build!

Open a shell and switch to your development directory. (Committers note that you can change the repository URLs to https://svn.jboss.org...)

Let's begin by building Weld. Seam 3 requires a JSR-299 implementation, so Weld fulfills this requirement.

mkdir weld-trunk
cd weld-trunk
svn co http://anonsvn.jboss.org/repos/weld/ri/trunk ri
svn co http://anonsvn.jboss.org/repos/jbossas/projects/webbeans-ri-int/trunk ri-int
svn co http://anonsvn.jboss.org/repos/weld/extensions/trunk extensions
cd ri
mvn install -Dmaven.test.skip=true
cd ../ri-int
mvn install -Dmaven.test.skip=true
cd ../extensions/logger
mvn install -Dmaven.test.skip=true
cd ../../ri/jboss-as

PAUSE

Create file local.build.properties and populate with:

jboss.home=<<same as JBOSS_HOME>>
webbeans-ri-int.version=5.2.0-SNAPSHOT
webbeans.version=1.0.0-SNAPSHOT

Now to install the weld.deployer into JBoss AS 5.

ant update

Let's now get Seam 3 checked out and built.

cd ../../..
mkdir seam-trunk
cd seam-trunk
svn co http://anonsvn.jboss.org/repos/seam/modules/trunk modules
cd modules
mvn install
cd jsf-upgrade-tool
mvn
cd ../..

To run the examples, you must have a Bean Validation implementation and API JAR in the JBoss AS classpath. I use the following JARs:

hibernate-validator-4.0.0.Beta1.jar
slf4j-api-1.5.6.jar
slf4j-log4j12-1.5.6.jar
validation-api-1.0.CR2.jar

You can download the release here or get the SVN from here and here.

Now to build the booking example:

svn co http://anonsvn.jboss.org/repos/seam/examples/trunk examples
cd examples/booking
mvn cli:execute-phase
> explode

Start JBoss and visit http://localhost:8080/seam-booking/