seamWeb

repository.jboss.org
http://repository.jboss.org/maven2

true

org.jboss.seam
jboss-seam
2.0.1.GA
compile


org.jboss.seam
jboss-seam-ui
2.0.1.GA
compile



javax.transaction
jta
1.1


javax.persistence
persistence-api
1.0


org.hibernate
hibernate-validator
3.0.0.ga

javax.faces
jsf-api
1.2_04-p02


javax.faces
jsf-impl
1.2_04-p02


com.sun.facelets
jsf-facelets
1.1.11

log4j
log4j
1.2.14
compile

Hello world

Create a index.jsp in the root folder. It will redirect us to the hello page.

<% response.sendRedirect("hello.seam"); %>

Create the facelets page hello.xhtml.

PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
xmlns:s="http://jboss.com/products/seam/taglib"
xmlns:h="http://java.sun.com/jsf/html"
xmlns:f="http://java.sun.com/jsf/core"
xmlns:ui="http://java.sun.com/jsf/facelets">

Welcome to your first Seam application

Deploy your application to Tomcat or JBoss and test it. With my project name, I used the following URL

http://localhost:8080/seamWeb/

Writing a Seam component

The next step is to improve the hello page. Our application will deal with hedgehogs and the first thing to be done is to print a list of hedgehogs.

Create a class Hedgehog.

package de.laliluna.seam;

public class Hedgehog {

private String name;

public Hedgehog() {
}

public String getName() {
return name;
}

@Override
public String toString() {
final StringBuilder sb = new StringBuilder();
sb.append(„Hedgehog“);
sb.append(„{name=’“).append(name).append(“’);
sb.append(‘}’);
return sb.toString();
}

public void setName(String name) {
this.name = name;
}

public Hedgehog(String name) {
this.name = name;
}
}

Create a class HedgehogService. It is a Seam component. The @Name annotation marks it as component and defines the name. In addition we can define the context where this component is placed in with the @Scope.

We will see later that we can reference the component using the name. Our service class provides a data model for a JSF data table – hedgehogs.

package de.laliluna.seam;

import org.jboss.seam.annotations.Name;
import org.jboss.seam.annotations.Scope;
import org.jboss.seam.annotations.datamodel.DataModel;
import org.jboss.seam.ScopeType;
import java.util.List;
import java.util.ArrayList;

@Name(„hedgehogService“)
@Scope(ScopeType.SESSION)
public class HedgehogService {

@DataModel
private List hedgehogs;

public HedgehogService() {
hedgehogs = new ArrayList();
hedgehogs.add(new Hedgehog(„Holger“));
hedgehogs.add(new Hedgehog(„Pete“));
hedgehogs.add(new Hedgehog(„Sebastian“));
}

public String getHello() {
return „Your hedgehogService says hello“;
}
}

Finally we will add some messages to the English resource bundle.

Create a file messages_en.properties in the src folder.

hello=Welcome to your Seam application
hedgehog.name=Name

Improve the hello.xhtml to print the hedgehogs, messages from our resource bundle and the getHello method.

PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
xmlns:s="http://jboss.com/products/seam/taglib"
xmlns:h="http://java.sun.com/jsf/html"
xmlns:f="http://java.sun.com/jsf/core"
xmlns:ui="http://java.sun.com/jsf/facelets">

#{messages.hello}

#{hedgehogService.hello}

#{messages['hedgehog.name']}
#{h.name}

That’s it. Test your application again.

Tips for debugging

When your application starts up it will print all components being created (Seam and your own) and the context they are placed in. Validate that your new component is displayed as well.

Seam has a debug page showing useful information.

Add the library jboss-seam-debug.jar in the WEB-INF folder. Alternatively add the following dependency to your pom.xml:

org.jboss.seam
jboss-seam-debug
2.0.1.GA

In the components.xml activate the debug mode.

Open your browser and point to the following URL to see the debug page.

http://localhost:8080/seamWeb/debug.seam

Add Hibernate

In this step we will leverage our application to load hedgehogs from the database.

In this example, I will use a PostgreSQL database. To change the database, just change the hibernate.cfg.xml settings to your database and replace the library.
Add libraries

In addition we need the following libraries.

*

antlr-2.7.6.jar
*

asm-1.5.3.jar
*

commons-beanutils-1.7.0.jar
*

asm-attrs-1.5.3.jar
*

hibernate-3.2.5.ga.jar
*

commons-collections-2.1.1.jar
*

c3p0-0.9.1.2.jar
*

postgresql-8.2-507.jdbc3.jar
*

backport-util-concurrent-3.0.jar
*

commons-logging-1.0.4.jar
*

hibernate-annotations-3.3.0.ga.jar
*

hibernate-commons-annotations-3.3.0.ga.jar
*

ehcache-1.3.0.jar
*

cglib-2.1_3.jar
*

jsr107cache-1.0.jar

If you prefer Maven, here are the additional dependencies.

org.hibernate
hibernate
3.2.5.ga
compile


c3p0
c3p0
0.9.1.2
compile


net.sf.ehcache
ehcache
1.3.0


org.hibernate
hibernate-annotations
3.3.0.ga
compile


org.hibernate
hibernate-commons-annotations
3.3.0.ga



postgresql
postgresql
8.2-507.jdbc3
compile

Configuration

We need a Hibernate configuration file hibernate.cfg.xml in the root source folder.

"-//Hibernate/Hibernate Configuration DTD 3.0//EN"
"http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd">