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:

  • Seam 2.x examples require JBoss Application Server 4.2 or 5.0 if you want to deploy these examples out-of-the-box. Some bundled examples have been ported to other application servers and servlet containers, as documented in their README files. You do not need JBoss AS to write or deploy Seam 2.0 applications. See this page for more information on application servers and containers.
  • Seam 1.2 requires 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.CR1 Pre-production 141 MB 26.06.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 | JBoss Product Versioning Guidelines

Web Beans Requirements

  • Web Beans 1.0 requires JBoss Application Server 5.0.1.GA to run or to deploy the examples out-of-the-box. Other application servers will be supported for the 1.0.0 release.
  • JDK 5.0 or JDK 6.0 is required for all Web Beans releases

To get started with Web Beans after you downloaded it, please follow Chapter 3 Getting started with Web Beans, the Reference Implementation of JSR-299 in the Documentation.

Web Beans releases

Package Version Category Size Released License
Web Beans 1.0 1.0.0.PREVIEW1 Development 30.0 MB 24.04.2009 APL 2.0 Notes Download

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.

Web Beans in Maven

Web Beans is available from the JBoss Maven 2 repository:

  • Group Id: org.jboss.webbeans
  • Artifact Ids: jsr299-api, webbeans-core, webbeans-spi, webbeans-api

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
NOTE If you are working off of the Seam 3 trunks, you also need to have Web Beans checked out and installed in your local Maven 2 repository. See the next section.

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

Web Beans SVN Repository

Web Beans is located in the JBoss SVN Repository, in the webbeans module.

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

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

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

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

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

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

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

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

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

Browse Web Beans Repository | Web Beans SVN Notification Feed | Web Beans 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 Web Beans

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 Web Beans from SVN, just run mvn install in webbeans/. You'll find the built artifacts and current set of libraries in your maven repository. To update JBoss AS with this version of Web Beans, run ant -f jboss-as/build.xml.

For more information, see Guidelines for Web Beans RI development.

Building Seam 3

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 Web Beans. Seam 3 requires a JSR-299 implementation, so Web Beans fulfills this requirement.

mkdir webbeans-trunk
cd webbeans-trunk
svn co http://anonsvn.jboss.org/repos/webbeans/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/webbeans/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 web beans 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/