Getting Started Guide

A new JBoss Server should now appear in the Servers view.

Now, we are ready to create the first web application.

All settings are already specified here, you can just modify the Configuration. Click on the Modify... button to configure your custom facet options:

On the whole the dialog allows to select the "features" you want to use in your project. JBoss Developer Studio will then setup the appropriate tooling for your project. Since JBoss Seam integrates all popular Java EE frameworks, you can select any combination of technologies from the list. Here, for the default configuration, Dynamic Web Module, Java, JavaServer Faces (JSF), and Seam Facet are already selected for a typical database-driven web application. The default project facets should suffice.

In the Project Facets form you can also bring up server runtimes panel by clicking Runtimes tab on the right corner. This panel shows available server runtimes.

Click the OK and then the Next button to proceed to the next step.

A dynamic web application contains both web pages and Java code. The next wizard will ask you where you want to store Java files.

Following page provides you Web Module Settings .You can just leave the default values or choose another folder.

On the next form, you will be able to select where those library JARs come from. The easiest is just to select the JARs provided by the JBoss AS runtime associated with this project. That is why it is important to chose the right JBoss AS 4.2 runtime in the project setup window.

Next wizard step needs more settings that previous. Let's start with General section.

Leave the default Seam runtime and check a WAR deployment.

The Database section is a little tricky. The Connection Profile needs to be edited so that the new project works properly with the external HSQLDB server. By default the project wizard tries to use the JBoss embedded HSQLDB, but the tutorial uses an external database to replicate a more real world development scenario. Click on the Edit button to modify the Connection Profile.

Select HSQLDB Profile Properties. Make sure the Database location is set to hsql://localhost:1701

Click the Test Connection button. At this point it probably won’t work. This happens if the HSQL JDBC driver is not exactly the same. This can be solved by modifying the HSQLDB database driver settings. To modify the settings, click the Edit Driver Definition Driver button.

The proper Driver JAR File should be listed under Jar List. Select the hsqldb.jar file found in the jbdevstudio/jboss-eap/jboss-as/common/lib/ directory and click the OK button.

Now, the Test Connection should succeed. After testing the connection, click the OK button.

You can leave the Code Generation section as is. It refers to Java packages in which the generated code will be placed.

Click on Finish button. Now, there should be a new Seam project called “workshop” listed in the Package Explorer view.

Select the server you want to run the project on, and click the Finish button.

Your project looks like this:

The view tier of the application is also important. Seam uses facelets and there is a built-in facelets GUI editor that includes nice WYSIWYG and component drag/drop functionality. Try this out by opening home.xhtml from WebContent folder.

Notice that the templates reside in the WebContent/layout folder. There is a stylesheet in the WebContent/stylesheet folder. There is also a login and default error page. The Facelet editor will be explored in more detail later in the lab.

The project already has a datasource that was created via the Seam project wizard database settings. All of the Seam specific configuration files and JAR dependencies are included and located in their proper locations. On last noteworthy line item is related to the build script. There isn’t a build script because the Eclipse WTP (Web Tools Project) plugin is used to publish web application changes. As you can see, JBoss Developer Studio is removing a great deal of complexity from the enterprise Java project setup and deployment process. The end result is the developer is writing code, not spending time trying to figure out how to get a decent development environment and project build process.

Now, open the MyAction.java file and replace the "myAction" method with this logic:

public void myAction() {
Calendar cal = Calendar.getInstance();
log.info("myAction.myAction() action called");
statusMessages.add("MyAction Executed on:" + cal.getTime());
}

You also need to import the java.util.Calendar class by clicking CTRL+Shift+O.

The test case simulates a Seam method execution for the MyAction.myAction() logic.

To run the test case, right click on MyActionTest.xml and click Run As → TestNG Suite or use the Run As... toolbar shortcut as shown below.

With any luck, the test case will pass. Look at the TestNG view.

Now, it’s safe to test the new Seam Action in a web browser. The fastest way to do that is to right click on myAction.xhtml and use Run As... → Run On Server which will show the appropriate URL in the browser. Alternatively you can manually enter http://localhost:8080/workshop/myAction.seam into a browser.

Right click on the "myAction!" button in the visual part of editor and select <h:commandButton> Attributes.

Change the value of the button to something different. If desired, you can change any other text on the page. Then, type CTRL+S to save the facelet.

Refresh http://localhost:8080/workshop/myAction.seam and now you should see your changes.

Notice that you did not have to publish the application. JBoss Developer Studio auto-published it for you.

The secured button is not visible because the user isn’t logged in as "admin".

The user is logged in as "admin". Securing components is easy but securing pages is pretty simple as well.

Open WebContent/WEB-INF/pages.xml . Then add this markup directly underneath the <pages> element:

<page view-id="/myAction.xhtml" login-required="true"/>

Refresh http://localhost:8080/workshop/myAction.seam If you are not logged in you will get bounced back to the login page.

Thus, if you enter login credentials for the "admin" user, you will be re-directed to the secured page and secured component. If you enter different login credentials, page access will be granted, but the secured component will not be displayed.

Congratulations! You have secured your new action both at the facelet component and page level. You also added custom authentication logic to the login action.

Right click on CUSTOMERS, select Data → Sample Contents to view the data in the table.

There should be a SQL Results view on the workbench, but it could be hidden. Click on the "Result1" tab in the right side and you should see the data in the CUSTOMERS table.

Congratulations! You just connected to the workshop database and queried the content using Database Explorer tools.

On the next page use the Refresh button to display the database, then click the Include button to include all the tables from the database, and finally click the Finish button.

After running the Generate Entities action, you will see new org.domain.workshop.entity classes. These classes represent insert/update/delete/query logic.

Congratulations! You now have a fully functioning CRUD application that is AJAX enabled.

Look at the Hibernate Configurations view. In the "workshop" project, drill down on the Session Factory and notice that the JPA entities/attributes are listed in a nice tree view.

Right click on the Session Factory and select HQL Editor. This will open a JPA query scratch pad window.

Write your query and click on the "Hibernate Dynamic SQL Preview" tab. You should see the SQL that will be executed if this JPA query is run.

Run the query by clicking on the green run icon.

The results are listed in the "Hibernate Query Result" view. There is a "Properties" tab in the workbench that can be used to see a specific JPA result. These results represent the JPA objects because our query did not specify column names.

The query can be refined, and take note that there is nice code completion in the JPA query editor.

A refined query will return results that are more ResultSet oriented. Notice the join logic that JPA supports.

There was no need to specify an Employees table in the from part of the JPA query because JPA supports reference traversal via Java class attribute references. Not only are JPA and HQL queries fully supported, but Criteria based queries can also be written in the Criteria Editor. You should spend some time tinkering with different queries and possibly Criteria based queries, even though the instructions are not provided in this lab.

You see a Diagram tab for the CUSTOMERS table and any tables that have FK references. This is a handy way to view the data model and JPA mappings. Now, you’ve got access to something that the Erwin Data Modeler can’t do.

Also, replace the QTY Ordered input field with a inputNumberSlider. You can use the JBoss Developer Studio palette or right click on the form and insert the RichFaces component.

One the last option is to use the source view and manually copy the inputNumberSlider markup listed below:

<rich:inputNumberSlider id="quantityOrdered" required="true"
                                                               value="#{orderdetailsHome.instance.quantityordered}"/>

The end result is an edit page that has better form labels and a new RichFaces control.

Congratulations! You have completed the JBoss Developer Studio lab.

First let's declare the properties file in the inputnumber.jsp page using the loadBundle JSF tag.

<f:loadBundle basename="game.messages" var="msg"/>

As always JBoss Developer Studio provides code assist:

JBoss Developer Studio will display a list of possible values:

<h:inputText id="userNumber" value="#{NumberBean.userNumber}" required="true">
           <f:validateLongRange minimum="0" maximum="100"/>
</h:inputText>

inputnumber.jsp page should look like this:

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<%@ taglib prefix="f"  uri="http://java.sun.com/jsf/core"%>
<%@ taglib prefix="h"  uri="http://java.sun.com/jsf/html"%>
<f:loadBundle basename="game.messages" var="msg"/>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
	<head>
		<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
		<title>Insert title here</title>
	</head>
	<body>
		<f:view>
			<h:form id="inputNumbers">
				<h:outputText value="#{msg.how_to_play}"/>
				<br/>
				<h:messages style="color: blue" />
				<br/>
				<h:inputText id="userNumber" required="true" value="#{NumberBean.userNumber}">
					<f:validateLongRange minimum="0" maximum="100" />
				</h:inputText>
				<br/>
				<br/>
				<h:commandButton action="#{NumberBean.checkGuess}" value="#{msg.makeguess_button}"/>			
			</h:form>
	</f:view>
	</body>
</html>

The success.jsp page is shown if you correctly guessed the number. The <h:outputFormat> tag will get the value of success_text from the properties file. The {0} in success_text will be substituted for by the value of the value attribute within the <f:param> tag during runtime.

In the final result you have a button which allows you to replay the game. The action value references a backing bean method. In this case, the method only terminates the current session so that when you are shown the first page, the input text box is clear and a new random number is generated.