This section both lists the compile-time and runtime dependencies for Seam. Where the type is listed as ear, the library should be included in the /lib directory of your application's ear file. Where the type is listed as war, the library should be placed in the /WEB-INF/lib directory of your application's war file. The scope of the dependency is either all, runtime or provided (by JBoss AS 4.2).
Up to date version information is not included in the docs, but is provided in the /build/root.pom.xml Maven POM.
Table 33.1.
Name | Scope | Type | Notes |
---|---|---|---|
commons-codec.jar | runtime | ear | Required by Seam Security when using Digest authentication. |
jboss-seam.jar | all | ear | The core Seam library, always required. |
jboss-seam-debug.jar | runtime | war | Include during development when enabling Seam's debug feature |
jboss-seam-ioc.jar | runtime | war | Required when using Seam with Spring |
jboss-seam-pdf.jar | runtime | war | Required when using Seam's PDF features |
jboss-seam-remoting.jar | runtime | war | Required when using Seam Remoting |
jboss-seam-ui.jar | runtime | war | Required to use the Seam JSF controls |
jsf-api.jar | provided | JSF API | |
jsf-impl.jar | provided | JSF Reference Implementation | |
jsf-facelets.jar | runtime | war | Facelets |
urlrewrite.jar | runtime | war | URL Rewrite library |
jcaptcha-all.jar | runtime | ear | Required for Captcha support |
quartz.jar | runtime | ear | Required when you wish to use Quartz with Seam's asynchronous features |
Table 33.2. RichFaces dependencies
Name | Scope | Type | Notes |
---|---|---|---|
richfaces-api.jar | all | ear | Required to use RichFaces. Provides API classes that you may wish to use from your application e.g. to create a tree |
richfaces-impl.jar | runtime | war | Required to use RichFaces. |
richfaces-ui.jar | runtime | war | Required to use RichFaces. Provides all the UI components. |
Table 33.3. Seam Mail Dependencies
Name | Scope | Type | Notes |
---|---|---|---|
activation.jar | runtime | ear | Required for attachment support |
mail.jar | runtime | ear | Required for outgoing mail support |
mail-ra.jar | compile only | Required for incoming mail support mail-ra.rar should be deployed to the application server at runtime | |
jboss-seam-mail.jar | runtime | war | Seam Mail |
The JBoss Rules libraries can be found in the drools/lib directory in Seam.
These libraries are required if you with to use the Google Web Toolkit (GWT) with your Seam application.
These libraries are required if you with to use the Spring Framework with your Seam application.
Maven offers support for transitive dependency management and can be used to manage the dependencies of your Seam project. You can use Maven Ant Tasks to integrate Maven into your Ant build, or can use Maven to build and deploy your project.
We aren't actually going to discuss how to use Maven here, but just run over some basic POMs you could use.
Released versions of Seam are available in http://repository.jboss.org/maven2 and nightly snapshots are available in http://snapshots.jboss.org/maven2.
All the Seam artifacts are available in Maven:
<dependency> <groupId>org.jboss.seam</groupId> <artifactId>jboss-seam</artifactId> </dependency>
<dependency> <groupId>org.jboss.seam</groupId> <artifactId>jboss-seam-ui</artifactId> </dependency>
<dependency> <groupId>org.jboss.seam</groupId> <artifactId>jboss-seam-pdf</artifactId> </dependency>
<dependency> <groupId>org.jboss.seam</groupId> <artifactId>jboss-seam-remoting</artifactId> </dependency>
<dependency> <groupId>org.jboss.seam</groupId> <artifactId>jboss-seam-ioc</artifactId> </dependency>
<dependency> <groupId>org.jboss.seam</groupId> <artifactId>jboss-seam-ioc</artifactId> </dependency>
This sample POM will give you Seam, JPA (provided by Hibernate) and Hibernate Validator:
<?xml version="1.0" encoding="UTF-8"?> <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>org.jboss.seam.example/groupId> <artifactId>my-project</artifactId> <version>1.0</version> <name>My Seam Project</name> <packaging>jar</packaging> <repositories> <repository> <id>repository.jboss.org</id> <name>JBoss Repository</name> <url>http://repository.jboss.org/maven2</url> </repository> </repositories> <dependencies> <dependency> <groupId>org.hibernate</groupId> <artifactId>hibernate-validator</artifactId> <version>3.0.0.GA</version> </dependency> <dependency> <groupId>org.hibernate</groupId> <artifactId>hibernate-annotations</artifactId> <version>3.3.0.ga</version> </dependency> <dependency> <groupId>org.hibernate</groupId> <artifactId>hibernate-entitymanager</artifactId> <version>3.3.1.ga</version> </dependency> <dependency> <groupId>org.jboss.seam</groupId> <artifactId>jboss-seam</artifactId> <version>2.0.0.GA</version> </dependency> </dependencies> </project>