28.3. Configuring Seam in Java EE 5
If you're running in a Java EE 5 environment, this is all the configuration required to start using Seam!
28.3.1. Packaging
Once packaged into an
EAR
, your archive will be structured similarly to the following:
my-application.ear/ jboss-seam.jar lib/ jboss-el.jar META-INF/ MANIFEST.MF application.xml my-application.war/ META-INF/ MANIFEST.MF WEB-INF/ web.xml components.xml faces-config.xml lib/ jsf-facelets.jar jboss-seam-ui.jar login.jsp register.jsp ... my-application.jar/ META-INF/ MANIFEST.MF persistence.xml seam.properties org/ jboss/ myapplication/ User.class Login.class LoginBean.class Register.class RegisterBean.class ...
Declare
jboss-seam.jar
as an EJB module in META-INF/application.xml
. Add jboss-el.jar
to the EAR
classpath by placing it in the EAR
's lib
directory.
To use jBPM or Drools, include the required
JAR
s in the EAR
's lib
directory.
Tp use Facelets, as recommended, include
jsf-facelets.jar
in the WEB-INF/lib
directory of the WAR
.
Most applications use the Seam tag library — to do so, include
jboss-seam-ui.jar
in the WEB-INF/lib
directory of the WAR. To use the PDF or email tag libraries, you must also place jboss-seam-pdf.jar
or jboss-seam-mail.jar
in WEB-INF/lib
.
To use the Seam debug page, include
jboss-seam-debug.jar
in the WEB-INF/lib
directory of the WAR
. Seam's debug page only works for applications using Facelets.)
Seam also ships with several example applications — these are deployable in any Java EE container with EJB3 support.