3.2. Setting up a new project

First, configure seam-gen for your environment. Just type the following in your command line interface: cd seam_distribution_dir; seam setup

You will receive the following prompt for the required information:

       
Buildfile: build.xml

init:

setup:

    [echo] Welcome to seam-gen 2.2.2.EAP5 :-)

    [echo] Answer each question or hit ENTER to accept the default (in brackets)

    [echo]

   [input] Enter the directory where you want the project to be created (should not contain spaces) [/home/mnovotny/projects] [/home/mnovotny/projects]



   [input] Enter your JBoss AS home directory [/var/lib/jbossas] [/var/lib/jbossas]

/home/mnovotny/apps/jboss-eap-5.1/jboss-as

   [input] Enter your JBoss AS domain [default] [default]

 

   [input] Enter the project name [myproject] [myproject]

helloworld

    [echo] Accepted project name as: helloworld

   [input] Select a RichFaces skin [glassX] (blueSky, classic, darkX, deepMarine, DEFAULT, emeraldTown, [glassX], japanCherry, laguna, ruby, wine)

 

   [input] Is this project deployed as an EAR (with EJB components) or a WAR (with no EJB support)? [war] (ear, [war])

ear

   [input] Enter the base package name for your Java classes [com.mydomain.helloworld] [com.mydomain.helloworld]

 

   [input] Enter the Java package name for your session beans [com.mydomain.helloworld.action] [com.mydomain.helloworld.action]

 

   [input] Enter the Java package name for your entity beans [com.mydomain.helloworld.model] [com.mydomain.helloworld.model]

 

   [input] Enter the Java package name for your test cases [com.mydomain.helloworld.test] [com.mydomain.helloworld.test]

 

   [input] What kind of database are you using? [hsql] ([hsql], mysql, derby, oracle, postgres, mssql, db2, sybase, enterprisedb, h2)

mysql

   [input] Enter the filesystem path to the JDBC driver jar [] []

/usr/share/java/mysql.jar

   [input] skipping input as property driver.license.jar.new has already been set.

   [input] Enter the Hibernate dialect for your database [org.hibernate.dialect.MySQLDialect] [org.hibernate.dialect.MySQLDialect]

 

   [input] Enter the JDBC driver class for your database [com.mysql.jdbc.Driver] [com.mysql.jdbc.Driver]

 

   [input] Enter the JDBC DataSource class for your database [com.mysql.jdbc.jdbc2.optional.MysqlDataSource] [com.mysql.jdbc.jdbc2.optional.MysqlDataSource]

 

   [input] Enter the JDBC URL for your database [jdbc:mysql:///test] [jdbc:mysql:///test]
 


   [input] Enter the database username [sa] [sa]

root

   [input] Enter the database password [] []

 

   [input] skipping input as property hibernate.default_schema.entered has already been set.

   [input] Enter the database catalog name (Enter '-' to clear previous value) [] []

 

   [input] Are you working with tables that already exist in the database? [n] (y, [n])

y

   [input] Do you want to recreate the database tables and execute import.sql each time you deploy? [n] (y, [n])

 

[propertyfile] Creating new property file: /home/mnovotny/apps/jboss-eap-5.1/seam/seam-gen/build.properties

    [echo] Installing JDBC driver jar to JBoss AS

    [copy] Copying 1 file to /home/mnovotny/apps/jboss-eap-5.1/jboss-as/server/default/lib

 

init:

 

init-properties:

    [echo] /home/mnovotny/apps/jboss-eap-5.1/jboss-as

 

validate-workspace:

 

validate-project:

 

settings:

    [echo] JBoss AS home: /home/mnovotny/apps/jboss-eap-5.1/jboss-as

    [echo] Project name: helloworld

    [echo] Project location: /home/mnovotny/projects/helloworld

    [echo] Project type: ear

    [echo] Action package: com.mydomain.helloworld.action

    [echo] Model package: com.mydomain.helloworld.model

    [echo] Test package: com.mydomain.helloworld.test

    [echo] JDBC driver class: com.mysql.jdbc.Driver

    [echo] JDBC DataSource class: com.mysql.jdbc.jdbc2.optional.MysqlDataSource

    [echo] Hibernate dialect: org.hibernate.dialect.MySQLDialect

    [echo] JDBC URL: jdbc:mysql:///test

    [echo] Database username: root

    [echo] Database password:

    [echo]

    [echo] Type './seam create-project' to create the new project

The tool provides sensible defaults. To accept them, press Enter when prompted.

The most important choice here is whether to deploy your project as an EAR or WAR archive. EAR projects support Enterprise JavaBeans 3.0 (EJB3) and require Java EE 5. WAR projects do not suppport EJB3, but can be deployed to a J2EE environment, and their packaging is simpler. If you have an EJB3-ready application server like JBoss installed, choose ear. Otherwise, choose war. This tutorial assumes you are using an EAR deployment, but you can follow these steps even if your project is WAR-deployed.

If you are working with an existing data model, make sure to tell seam-gen that tables already exist in the database.

Create a new project in our Eclipse workspace directory by typing: seam new-project

Buildfile: build.xml 
... 
new-project: 
  [echo] A new Seam project named 'helloworld' was created in the C:\Projects directory 
  [echo] Type 'seam explode' and go to http://localhost:8080/helloworld 
  [echo] Eclipse Users: Add the project into Eclipse using File > New > Project and select General > Project (not Java Project) 
  [echo] NetBeans Users: Open the project in NetBeans 
BUILD SUCCESSFUL Total time: 7 seconds 
C:\Projects\jboss-seam>

This copies the Seam JARs, dependent JARs and the JDBC driver JAR to a new Eclipse project. It generates all required resources and configuration files, a Facelets template file and stylesheet, along with Eclipse metadata and an Ant build script. The Eclipse project will be automatically deployed to an exploded directory structure in JBoss as soon as you add the project. To add the project, go to New → Project... → General → Project → Next, type the Project name (in this case, helloworld), and then click Finish. Do not select Java Project from the New Project wizard.

If your default JDK in Eclipse is not a Java SE 5 or Java SE 6 JDK, you will need to select a Java SE 5 compliant JDK. Go to Project → Properties → Java Compiler.

Alternatively, you can deploy the project from outside Eclipse by typing seam explode.

The welcome page can be found at http://localhost:8080/helloworld. This is a Facelets page (view/home.xhtml) created using the template found at view/layout/template.xhtml. You can edit the welcome page or the template in Eclipse, and see the results immediately by refreshing your browser.

XML configuration documents will be generated in the project directory. These may appear complicated, but they are comprised primarily of standard Java EE, and require little alteration, even between Seam projects.

There are three database and persistence configurations in the generated project. persistence-test.xml and import-test.sql are used while running TestNG unit tests against HSQLDB. The database schema and test data in import-test.sql is always exported to the database before tests are run. myproject-dev-ds.xml, persistence-dev.xml and import-dev.sql are used during application deployment to your development database. If you told seam-gen that you were working with an existing database, the schema may be exported automatically upon deployment. myproject-prod-ds.xml, persistence-prod.xml and import-prod.sql are used during application deployment to your production database. The schema will not be exported automatically upon deployment.