Thursday Jan 17, 2008
Thursday May 10, 2007
By paulsen on May 10, 2007
How to win a helicopter @ JavaONE
BT had a booth at JavaONE for their Web21C SDK. The SDK, among other things, allows you to write software that invokes a WebService hosted by BT to place a phone call between 2 parties. You simply need to provide 2 phone numbers and BT calls both parties and connects the two. They provide a limited amount of usage for free, and for a small fee you can use their service more, here's a link to their pricing. The Web21C SDK opens up the door to many possibilities, however, that's outside the scope of this blog.
BT was offering a challenge at their booth: Use their SDK to place a phone call and win a remote controlled helicopter. My son is 5 and would love to crash the helicopter, and it sounded like any easy task for GlassFish + JSFTemplating... so I got to work!
Here's what I had to do:
2) I added the Web21C jar files to my WEB-INF/lib directory of the demo app. They gave me a memory stick with these, but I think you can find them here.
3) I had problems w/ some of their jar files because many of them are already part of GlassFish and were not needed. Also some of the versions may not have been compatible. I ended up turning off classloader delegation by adding this to my sun-web.xml file:
4) I registered my application. BT requires you to register your application. This was a necessary, but the most painful part of the process. It required me to download the Web21C-Certificate-Tool, patch the JDK with the unlimited strength policy files, run their certificate tool, place the generated file in the WEB-INF/classes directory of the demo app, and create / place a security.properties file in the WEB-INF/classes directory that pointed to the generated file.
5) With the environment finally setup, I was ready to write the app! I created the following JSFTemplating page:
6) I created the following handler in a new java file called Web21Handlers.java (see above call.jsf page where the button is invoking this handler):
7) I compiled the app (just typed "ant" on the command line, the demo application already has the build environment setup), started the server and went to http://localhost:8080/demo/call.jsf where I saw:
After typing in the 2 phone numbers and clicking the "Make Call" button... the 2 phones rang!
8) Finally... I showed this to the Web21C people and they gave me a helicopter!
(I'm in the blue Sun shirt. You can also see this on flickr.)
That's how to get a helicopter using JSFTemplating + Web21C + GlassFish at JavaONE.
Sunday May 06, 2007
By paulsen on May 06, 2007
I have received questions from several people about how to use the "FileStreamer" feature of JSFTemplating. So I thought a blog would be the best way to demonstrate how it works.
FileStreamer provides the ability for the FacesServlet to stream content to the client (i.e. web browser). If that sounds generic, it is because FileStreamer is very generic. It allows you to define a ContentSource that is capable of getting content from just about anywhere. You might choose to get content from a database, retrieve it via a web service, generate it in code, access it from the filesystem or the classpath, or just about anywhere else. The ContentSource interface allows you to specify the content and information about it so that appropriate http headers will be set, causing the client (browser) to treat it correctly (i.e. Content-type, Content-Disposition, etc.). In addition to this, FileStreamer works in the context of JSF, meaning you will have access to managed beans or anything you require from your JSF environment. (NOTE: FileStreamer actually provides a Context which interacts with its environment. This allows different Context implementations to be provided for different environments; Servlet and JSF Contexts are currently available, see: ServletStreamerContext and FacesStreamerContext).
Lets look at a couple of examples.
First you have to have your JSFTemplating evironment setup. Follow these instructions for this.
Next to configure FileStreamer for JSF, add the following to your web.xml file:
The context-param registers 2 ContentSources. The source to both of these is checked into JSFTemplating's demo application. You can browse that source online here. The servlet-mapping requires a prefix mapping and needs its own dedicated FacesServlet mapping. "/resource/\*" is the default, however, this can be configured, see RESOURCE_PREFIX for more info.
Let's take a look at the key part of the ExampleContentSource to see how it works.
The above ContentSource (ExampleContentSource) is very simple, it generates its content from a String (see green text above). The String is some text with the request path (which is the PATH_INFO of the request, in other words the part of the URL after the "/resource"). Notice I added some HTML tags to show how they're treated. The red text shows that the Content-type is being explicitly set to "text/plain". This should cause the browser not to parse any html (so we should see those <b> tags on the screen).
As you can see, this simple ContentSource produces plain text in the browser. You also see that the URL requires "contentSourceId=example". "example" comes from the "id" of ExampleContentSource.
Let's take a look at 1 more example ContentSource. We'll use the same URL, except we'll use the contentSourceId of "proxy" to target our other ContentSource. Below is the interesting part of the source code for ProxyContentSource.java:
Again we are creating an InputStream, however, this time we are getting it via a URL. This time instead of hard-coding the Content-type, we're setting the extension of the file so that it will be mapped to an appropriate Content-type. Here's the output for the same URL as before (except w/ our "proxy" contentSourceId):
In this example, the content is pulled from java.sun.com from the server (not the client), then streamed to the client. The appropriate Content-type of "image/gif" was sent to the browser so that it could treat the content correctly. If you run this example, try other urls and types of media (html, pdf, doc, etc.).
I hope this blog gives you an idea of how FileStreamer functionality is useful. Please leave a comment and let me know what you think! Below is one more section describing how to configure FileStreamer in a Servlet environment (doesn't need JSF):
That's it... the rest is the same as above. You can change the url mapping directly in the web.xml file in this case. Oh... and yes, you can use the same ContentSources in both environments!
Thursday Feb 15, 2007
By paulsen on Feb 15, 2007
Woodstock JavaServer Faces Components
Sun has delivered some great components as part of Sun Java Studio Creator and NetBeans Visual Web Pack. But if you don't use one of those products, you probably didn't know it. Well, now you don't have to use these tools to enjoy the rich JavaServer Faces components they provide. In fact not only are they available outside these products, they are now Open Source!
Project Woodstock is the Java.net project which contains the source code for these components. Both Creator's and NB VWP components were derived from earlier versions of this code base. The code is released under the very flexible CDDL license. These components have been in the making for over 2 years and have gone through several development cycles. They're stable, full featured, and work seemlessly together sharing a common theme -- they're ready for production!
Let's take a look at what some of these components look like:
All of these components are "themed" so you can adapt the look of these components to your company's look and feel by creating your own theme. Many of the components use Ajax (via Ed Burn's Dynamic Faces project), and more Ajax features are sure to come. The TLD document and example application included in the project provide more than enough information to get you started.
If you're a Faclets user, Jason Lee is already working on creating a Facelets taglib for Woodstock. And of course if you're a JSFTemplating user, I have full support for the Woodstock components built in... plus I have a simple example app on the site to get you started. Plus, the entire GlassFish admin console (source here) is built using JSFTemplating and Woodstock components. So whatever your JSF environment (NetBeans, Facelets, JSFTemplating), you'll be able to use these components.
So what are you waiting for? Go download the components and try them out!
Tuesday Jan 09, 2007
By paulsen on Jan 09, 2007
Ok, let's get right to it. Ajax is hot, but it needs to be "real". You need a fast way to be productive with Ajax, not gfx-clock productive, but real-world productive. Let me offer a suggestion...
In an effort to keep my blog entries concise (part of my New Year's Resolution), I will get right to the point. By using JSFTemplating with Ed Burns's DynamicFaces project, you have a perfect Ajax solution tailored to JSF's component architecture. Add JSF widgets like those found Greg Murray's jMaki project and you have a complete solution. However, I will save jMaki for a later blog. I want to stick to the basics for this entry -- Keep It Simple.
I created a very simple example which shows all you need and little more. You can download the complete war file and try it out. Here are the contents of the .war file:
guess.jsf <-- JSF pageWEB-INF/lib/dataprovider.jar <-- Sun component libraries & dependenciesWEB-INF/lib/json2.jarWEB-INF/lib/webui-jsf.jarWEB-INF/lib/webui-jsf-suntheme.jarWEB-INF/lib/jsftemplating.jar <-- JSFTemplating .jar fileWEB-INF/lib/jsftemplating-dynafaces-0.1.jar <-- JSFTemplating/DynamicFaces integration .jar fileWEB-INF/web.xml <-- deployment descriptor
This is a 1 page application -- doesn't get much simpler than that. It also doesn't use any managed beans, or any custom Java code. Instead it leverages JSFTemplating to do everything in the .jsf file. Let's look at the page:
And the source:
The blue area above defines an area where a prompt will be shown to the user. The beforeCreate event allows an initial value to be set. PageSession is a JSFTemplating-added scope. The value bound to the pageSession variable msg will be shown to the user. This is plain, oridinary text that will be replaced by an Ajax request.
- immediate: Not really needed, but if there was validation on the field in "execute" immediate would skip the validation. In this example it does nothing useful. I added it to show that the other required field on the page truely isn't processed even when immediate is false. This is true partial-page processing.
- inputs: The values sent to the server. This may be different than the components processed. In this case the HTML id of the form field is different than the component id because of how the componet is implemented, so I need to send "form:guess_field" for the value to be sent correctly during the Ajax request.
- render: This specifies which area(s) of the screen should be updated with the response. In this case the <div> around our message text.
Finally, the green area is the business logic. It evaluates the submitted value and displays an appropriate response. In real-world JSFTemplating applications, you'd likely put this in Java code in a handler such as is done by the built-in "setPageSessionAttribute" handler in this example. But to keep the example simple (1 page), JSFTemplating's condition processing was used instead.
Tuesday May 16, 2006
By paulsen on May 16, 2006
Friday Apr 14, 2006
By paulsen on Apr 14, 2006
The BluePrints team has added some of the AJAX JSF components they have recently built. These components serve as good examples of strategies to combine AJAX and JSF together via reusable components -- and since they are components, they're easy to plug in to your application. Check them out at: https://blueprints.dev.java.net/ajaxcomponents.html
Monday Apr 03, 2006
By paulsen on Apr 03, 2006
In an earlier entry I wrote about Security Manager woes when I attempted to install Jive Forums from Jive Software. Many applications (including Jive Forums) require privileges that may be considered "unsafe" in some environments -- Java's security manager allows administrators to control the settings ensure applications don't write to disk, send email, load unsafe classes, etc. However, this can get in the way when a user attempts to install trusted software, yet the server doesn't have security properly configured (and it's not easy to properly configure).
GlassFish has changed. It no longer enables the security manger by default. This is consitent with most other application servers and makes deploying applications (such as Jive Forums) much easier. Here's what I had to do when installing Jive Forums Gold 5 on GlassFish (build 42):
- Download Jive Forums files (server + license file) (Find it on: Jive Software's web site)
- Copy jiveHome to a new directory
- Copy the license file into the new diretory; name it jive.license
- Start GlassFish (i.e. asadmin start-domain)
- Go to GlassFish's Admin GUI: http://localhost:4848
- Applications -> Web Applications -> Deploy
- Upload "jiveforums.war"
- Select options (defaults are fine)
- Go to the application (I clicked on "Launch" button in Admin GUI)
- Message states jiveHome is not set. Type in the correct path (the new directory from step 2). Click the update button.
- Click continue (everything should have a "success" check now).
- Choose embedded DB (you may want something else), click continue.
- Click continue (db should be configured properly).
- I picked "Default" for authentication. Click continue.
- Setup your email server settings. Click continue.
- Setup your admin user. Click continue.
- Setup should be complete, click "Login to Admin Tool"
- I logged in as "admin" / "<admin-password>"...
Tuesday Feb 21, 2006
By paulsen on Feb 21, 2006
- Goto (http://java.sun.com/javaee/5/index.jsp)
- Click Get Java EE 5 SDK Resources
- Choose one of the Screencasts (like: ).
To take it for a spin, visit the download page. Or get even more involved: goto the GlassFish site and start contributing!
- The Ajax Experiment
- JavaOne Hidden Treasure
- Looking for Opinions...
- Introducing GlassFish Performance Tuner
- Tips for creating a GlassFish Admin Console Plugin
- GlassFish Birds Of a Feather (BOF) Session at JavaOne 2008
- Don't forget your laptop!
- Where will you be at JavaOne?
- JavaServer Faces overview @ the Salem JUG
- GlassFish Book Review