If you're lost among all the configuration files in the Seam examples, here is a quick explanation of what each of them does and when you need them:
META-INF/application.xml | The Java EE deployment descriptor for an EAR. Defines the EJB and WAR modules of the enterprise application. | Required in a Java EE environment | Nothing special to Seam |
META-INF/ejb-jar.xml | The EJB3 deployment descriptor for the EJB jar. Allows external overriding of transaction and security annotations, and definition of interceptors. | Required for EJB3 | Interceptor binding for SeamInterceptor is required |
META-INF/persistence.xml | EJB3 persistence deployment descriptor. Specifies the datasource location. | Required for EJB3 persistence | Nothing special to Seam |
META-INF/jboss-app.xml | The JBoss deployment descriptor for an EAR. May be used to specify scoped classloading. | Not required | Nothing special to Seam |
META-INF/jboss-beans.xml | A JBoss Microcontainer deployment descriptor. Defines infrastructural components such as JCA datasources. | Required for use of JCA datasource in Embeddable EJB3 or for JNDI/JTA/JCA support in JBoss Microcontainer | Nothing special to Seam |
WEB-INF/web.xml | The web application deployment descriptor for a WAR. | Always required | SeamListener is required at minimum. The JNDI pattern should also be specified here for use of EJB3. The Seam Redirect and Exception filters may optionally be enabled. |
WEB-INF/faces-config.xml | The JSF configuration. Declares JSF components and JSF navigation rules. | Required for JSF | SeamPhaseListener is required |
WEB-INF/jboss-web.xml | The JBoss deployment descriptor for a WAR. May be used to specify scoped classloading. | Not required | Nothing special to Seam |
WEB-INF/pages.xml | Seam page actions. | Not required | May be empty |
WEB-INF/events.xml | Seam events. | Not required | May be empty |
seam.properties | Seam properties file. Configuration for any Seam component. | Required for auto-detection of Seam components | May be empty |
hibernate.cfg.xml | A Hibernate configuration. | Required for Hibernate or for jBPM | Nothing special to Seam |
jbpm.cfg.xml | A jBPM configuration. | Required for jBPM | Nothing special to Seam |
xxxxxx.jpdl.xml | A jPDL pageflow definition or process definition. | Not required | Nothing special to Seam |
xxxxxx-ds.xml | A JBoss datasource configuration. | Required for use of JCA datasource in JBoss AS | Nothing special to Seam |
import.sql | A Hibernate data import script. | Not required | Nothing special to Seam |
classes/messages.properties | The Seam resource bundle. | Not required | May be empty |
For more information, go here.
Comments