• Best of JavaWorld
• Editor's Choice

Some reader favorites:

EJB fundamentals and session beans 

Create a scrollable virtual desktop in Swing

HMVC: The layered pattern for client tiers

Double-checked locking: Clever but broken

Wizard API updated!
Tim Boudreau has released a new version of the Swing Wizard library (version 0.997) that fixes the WizardException bug reported in JavaWorld's recent Open Source Java Project profile. The article's examples have been reworked to test out the new, improved WizardException. Thanks, Tim, for this helpful fix!
Open Source Java Projects: The Wizard API

package com.sabreware.tags;
import javax.faces.webapp.FacesTag;
import javax.faces.component.UIComponent;
import javax.faces.component.UIGraphic;
import javax.faces.context.FacesContext;
import javax.faces.event.FacesEvent;
import javax.faces.event.RequestEventHandler;
import com.sabreware.components.UIToggleGraphic;
public class ToggleGraphicTag extends FacesTag {
   private String imageOne, imageTwo;
   public void setImageOne(String imageOne) {
      this.imageOne = imageOne;   
   }
   public void setImageTwo(String imageTwo) {
      this.imageTwo = imageTwo;   
   }
   public void overrideProperties(UIComponent component) {
      super.overrideProperties(component);
      component.setAttribute("imageOne", imageOne);
      component.setAttribute("imageTwo", imageTwo);
   }
   public UIComponent createComponent() {
      UIToggleGraphic comp = new UIToggleGraphic();
      comp.setURL(imageOne);
      return comp;
   }
   public String getRendererType() {
      return null;
   }
}

package com.sabreware.components;
import javax.servlet.http.HttpServletRequest;
import javax.faces.component.UIGraphic;
import javax.faces.context.FacesContext;
import javax.faces.context.ResponseWriter;
import javax.faces.event.CommandEvent;
import javax.faces.event.FacesEvent;
public class UIToggleGraphic extends UIGraphic {
   // This component supports one command: click.
   private static String clickCommand = "click";
   // This method indicates whether this component renders itself
   // or delegates rendering to a renderer.
   public boolean getRendersSelf() { 
      return true; 
   }
   // This method, which is called during the Render Response phase,
   // generates the markup that represents the component.
   public void encodeEnd(FacesContext context) throws java.io.IOException {
      ResponseWriter writer = context.getResponseWriter();
      HttpServletRequest request = (HttpServletRequest)
                             context.getServletRequest();
      // Represent this component as an HTML anchor element with an
      // image. When the image is clicked, the current page is reloaded
      // with a request parameter named component whose value is this
      // component's ID.
      writer.write("<a href='?component=" + getComponentId() + "'>");
      writer.write("<img border='0' src='");
      writer.write(request.getContextPath() + (String)getURL() + "'/>");
      writer.write("</a>");
   }
   // This method, which is called during the Apply Request Values phase,
   // decodes request parameters.
   public void decode(FacesContext context) throws java.io.IOException {
      HttpServletRequest request = (HttpServletRequest)
                             context.getServletRequest();
      // If there's a request parameter named component whose value
      // matches this component's ID...
      if(getComponentId().equals(request.getParameter("component"))) {
         // ...enqueue a command event on the FacesContext event queue
         // for this component. The processEvent method, listed below,
         // processes that event.
         context.addRequestEvent(this, new CommandEvent(this, clickCommand));
      }
   }
   // This method, which is called during the Handle Request Events phase,
   // processes command events that were added to the FacesContext by
   // the decode method.
   public boolean processEvent(FacesContext context, FacesEvent event) {
      if(event instanceof CommandEvent) {
         CommandEvent cmdEvent = (CommandEvent)event;
         // If the event's command name equals "click"...
         if(clickCommand.equals(cmdEvent.getCommandName())) {
            // ...toggle the component's image.
            toggleImage();
         }
         return false; // Go directly to render phase.
      }
      return true; // Process request normally.
   }
   // This method returns a string representing the component's type.
   public String getComponentType() {
      return "com.sabreware.components.UIToggleGraphic";
   }
   // This private method toggles the component's image.
   private void toggleImage() {
      String     imageOne = (String)getAttribute("imageOne");
      String     imageTwo = (String)getAttribute("imageTwo");
      String currentImage = (String)getAttribute("image");
      if(imageTwo.equals(currentImage)) 
         setAttribute("image", imageOne);
      else                 
         setAttribute("image", imageTwo);
      // The setURL() method is defined in the superclass (UIGraphic).
      setURL((String)getAttribute("image"));
   }
}