Newsletter sign-up
View all newsletters

Enterprise Java Newsletter
Stay up to date on the latest tutorials and Java community news posted on JavaWorld

Draw the world: Create networked whiteboards with Java 1.1

Learn how to easily write a whiteboard using the new features of JDK 1.1

  • Digg
  • Reddit
  • SlashDot
  • Stumble
  • del.icio.us
  • Technorati
  • dzone
A whiteboard is a simple drawing utility, commonly supplied as part of a collaboration framework to allow distributed users to share a common drawing space. In this article, we will examine how JDK 1.1 simplifies the implementation of such an application.

Lightweight components, introduced by JDK 1.1, offer several important advantages over traditional JDK 1.0-style components. For one, they are much more efficient than traditional components because they do not make use of native GUI peers, being instead a pure-Java kluge on top of the old AWT. More importantly for this particular application, however, is that these components are transparent. This means that a lightweight component can easily overlay information on top of another component.

We will use this transparency feature to implement our whiteboard; when the user selects a particular drawing tool then a lightweight component will be overlaid on the whiteboard. The drawing tool can then use this component to annotate the whiteboard display and collect GUI events.

The whiteboard

Our whiteboard is perforce simple; the constraint of understandability requires that it be of fairly limited expanse. Hopefully, however, the techniques I demonstrate will be of fairly broad use, and will allow you to easily modify the application to suit your own needs.

The whiteboard in action

The following classes comprise the whiteboard:

  • WBLauncher -- A simple applet that launches the whiteboard when clicked.

  • WB -- The main whiteboard class, which is a standalone Frame containing all of the whiteboard components.

  • Tool -- An interface that provides access to all the whiteboard's drawing tools.

  • Element -- An interface that describes the elements of a whiteboard drawing.

  • WBContainer -- A lightweight container that displays the contents of the whiteboard.

  • Rect -- A drawing tool that allows rectangles of various colors to be placed on the whiteboard.

  • Select -- A drawing tool that allows existing elements of the whiteboard to be moved.

  • ObservableList -- A class that maintains the list of elements comprising a whiteboard drawing. It is very similar to a Vector except that it notifies listeners whenever a change is made to the list.

  • UpdateListener -- An interface that must be implemented by classes wishing to be notified when an ObservableList is modified.

  • UpdateEvent -- An event that notifies of a change to an ObservableList; it is delivered through the ObservableList interface.

  • LWContainer -- A generic lightweight container; a lightweight equivalent to the Panel class.

  • LWImageButton -- A generic lightweight image button.


This may seem like a large number of classes, but the core of the whiteboard is, in fact, surprisingly small. The WB class contains the controlling logic of the whiteboard; the WBContainer class contains the display code; and the Tool and Element interfaces describe the various tools and elements.

Stepping through the classes

For the sake of brevity, I will discuss the classes in general terms only, allowing you to read the source for a greater understanding.

Class WBLauncher
WBLauncher is a simple applet that provides a simple introductory interface to the whiteboard, delaying the download of the whiteboard's classes until the user chooses to launch it.

  • Digg
  • Reddit
  • SlashDot
  • Stumble
  • del.icio.us
  • Technorati
  • dzone
Comments (1)
Login
Forgot your account info?

CNC MachiningBy Anonymous on April 1, 2009, 5:29 pmI am searching what is the best choice (with java) to draw simple shapes (2d) and vectorize them to build G-Code in order to machine them later. ¿Opinions?

Reply | Read entire comment

View all comments

Add comment
Anonymous comments subject to approval. Register here for member benefits.
Have a JavaWorld account? Log in here. Register now for a free account.
Resources
  • Rich Kadel explains how to subclass an AWT component so you can build an image button for toolbars, palettes, and other "icon-friendly" environments http://www.javaworld.com/javaworld/jw-03-1997/jw-03-imagebutton.html
  • Todd Sundsted's "Examining HotSpot, an object-oriented drawing program" (JavaWorld December, 1996) provides information a JDK 1.0.2 drawing tool that uses some techniques similar to the ones we discuss http://www.javaworld.com/javaworld/jw-12-1996/jw-12-howto.html
  • Todd's "Build dynamically extensible applications" (JavaWorld September, 1997) explains how to use Class.forName().newInstance() to load classes at runtime http://www.javaworld.com/javaworld/jw-09-1997/jw-09-howto.html
  • My own "Moving to JDK 1.1" (JavaWorld May, 1997)
  • details how to create custom components in JDK 1.1 http://www.javaworld.com/javaworld/jw-05-1997/jw-05-step.html
  • Download this article and the complete source code a gzipped tar file http://www.javaworld.com/javaworld/jw-11-1997/step/jw-11-step.tar.gz
  • Download this article and the complete source code a zip file http://www.javaworld.com/javaworld/jw-11-1997/step/jw-11-step.zip
  • Previous Step by Step articles