$ git clone git://github.com/richfaces/showcase.git
$ cd showcase
$ git checkout -b blog-demo 54b8211b9bfc065dda32c8809cd9a4e2b7c90b71

$ mvn clean package -Pjbas7 --update-snapshots

$ ./standalone.sh --server-config standalone-preview.xml

registering web context: /showcase
Deployed "showcase.war

I have said that Showcase is using several Java EE 6 technologies: JSF, CDI, JPA and JMS. That means AS7 needs to load and configure each of the appropriate modules for these technologies.

For both JSF and CDI, it is enough to create two configuration files, faces-config.xml and beans.xml, to load the appropriate modules. For JPA, it is necessary to create persistence.xml with a proper configuration. Showcase uses ExampleDS as the data source, which is deployed out-of-the-box on AS7 for sample applications.

In the case of JMS, the situation is a bit different, since it is not possible to initialize it by configuring WAR deployment: RichFaces Push needs to have JMS topics initialized just before the application starts. The Java API for DMR creates topics on the JMS server bundled with AS7 (HornetQ) when an application is being deployed. Using this API, you can manage the server in an elegant way, as the following snippet from the JMS provider management script shows:

public void createTopic(String topicName, String jndiName) throws Exception {
    ...
    operation = new ModelNode();
    operation.get("operation").set("add");
    operation.get("address").add("subsystem", "messaging");
    operation.get("address").add("jms-topic", topicName);
    operation.get("entries").add(jndiName);
    client.executeAsync(operation, null);
    ...
}

RichFaces Push needs to be configured for using of blocking I/O approach of managing requests on AS7. You need to configure org.atmosphere.useBlocking=true in web.xml.

These tweaks are necessary to get Showcase working on AS7 without having to perform any custom server management operations before the application is deployed.

Now we’re ready to get looking at a higher level and inspect the Tweetstream application and other options of deployment control and server management.

Tweetstream on AS7

Tweetstream is a RichFaces/JSF2 app that was optimized for mobile device browsers. It was writen by Jay Balunas and Wesley Hales for the JBoss World 2011 Keynote. You may find more information on blogs RichFaces And The Mobile Web… and Runtime Type Detection and Usage with Weld.

Connection to twitter is driven through OAuth credentials and associated security tokens. These credentials are pre-filled in properties file using fake twitter account created for demonstration purpose, but I encourage you to change them – Twitter won’t allow two consumers (like the Tweetstream application) to connect using the same application account.<

To run Tweetstream, you should follow the same steps you used in the Showcase example above, but additionally you need to setup Twitter OAuth credentials and also setup JMS. We will also inspect another way to deploy WAR files.

The following section assumes that you have already downloaded and unpacked AS7 (using the Showcase instructions above).

Clone the Project from the Git Repository

You need to clone project from RichFaces Tweetstream repository, move into that directory, and then reset to a specific reference point (i.e. a specific commit) like so:

$ git clone git://github.com/richfaces/tweetstream.git
$ cd tweetstream
$ git checkout -b blog-demo ccae090ef0c59c9275fb011aa426a88f53544fe1

Change the Twitter4j Credentials (optional)

This is really not that hard, but it does require some effort. Because these steps change from time to time you should refer to http://twitter4j.org/en/configuration.html and https://dev.twitter.com/pages/auth for up-to-date details.

Once you have access to the values in tweetstream/src/main/resources/twitter4j.properties:

oauth.consumerKey=**************************
oauth.consumerSecret=**************************
oauth.accessToken=**************************
oauth.accessTokenSecret=**************************

Update with these your own values.

Change Keywords that Tweetstream Tracks (optional)

By default, Tweetstream tracks various JBoss related keywords with twitter4j. If you want to change the tracking list, just enter another keyword (each on its own line) in this file:

tweetstream/src/main/resources/twittertracks.properties

Build the Project

Before starting a build, make sure you have properly setup Maven for development with JBoss repositories (check out Maven Getting Started, paragraph “Configuring Maven to use the JBoss Repository”).

$ mvn clean package --update-snapshots

Start AS7

Without deploying the application, start the server by entering the jboss-7.0.0/bin directory and running:

$ ./standalone.sh --server-config standalone-preview.xml

Create the JMS Topic on AS7

To do this, you have two choices: use AS7’s command line admin interface, or use the web console. Both are bundled with AS7 distribution:

Command-line interface

To start the command line interface, ensure AS7 is running and enter the jboss-7.0.0 directory. From this directory, follow these steps:

$ ./jboss-admin.sh
[disconnected /] connect
[standalone@localhost:9999 /] add-jms-topic --name=twitter --entries=topic/twitter

Using the Web Console

Navigate to http://localhost:9990/console/ in your browser. In the management console, select Messaging > Messaging Provider, look for Subresources, and switch to the Topics tab. Hit the Add button (on the right) and in the popup titled Create JMS Topic, enter twitter as the name and topic/twitter as the JNDI.

Deploy Tweetstream to AS7

You can certainly use the deployment way mentioned in the Showcase guide above, but I will show here two different ways to deploy: by using the web console, or using the command line interface.

Using the Web Console

Enter the console again (http://localhost:9990/console/) and select Deployments > Manage Deployments and hit the Add Content button (on the right). In the popup, Choose a WAR file to deploy and hit Next button. Leave the default values in the next popup screen and hit the Finish button. The popup will disappear and you will see your WAR in the list of deployed resources. Hit the Enable button for tweetstream.war. You should see a green ball indicating successful deployment.

Using the Command Line Interface

Start the command line interface again and follow these steps:

$ **./jboss-admin.sh**
[disconnected /] connect[standalone@localhost:9999 /] deploy  /path_to_tweetstream/target/tweetstream.war 
tweetstream.war' deployed successfully.

<a href="/images/blog/2011-07-19-richfaces-heading-to-jboss-as7-era/Screenshot-19.png"><img style="cursor:pointer; cursor:hand;width: 400px; height: 224px;" src="/images/blog/2011-07-19-richfaces-heading-to-jboss-as7-era/Screenshot-19.png" alt="" id="BLOGGER_PHOTO_ID_5631116023812325106" border="0" /></a>

Enjoy the Tweetstream application!

Enter http://localhost:8080/tweetstream/ in your browser. From now on, new tweets are displayed on the left side of the page and the top hashes and tweeters counts are displayed on the right side.

As you can see, AS7 deployment is simple, and multiple means of deployment are provided. Nevertheless, application startup time has been reduced dramatically, finally giving web developers the speed they need!

blog comments powered by Disqus