Today WireLoad is releasing SwtCallback, a Java library for SWT that enables callbacks for event handling. SwtCallback is inspired by the Swing enhancer Buoy by Peter Eastman.
If you know you want this, just skip to the bottom of this post for the download link. Otherwise, read on and I’ll explain the reason we wrote this library.
I’m a big fan of readable and concise code. Another thing I’m a big fan of is user interfaces that look and feel like what users expect. Given this, I’ve always had an aversion to UI programming in Java. Because I think it’s very telling, I’ll let this flash video illustrate: totally gridbag. Bottom line is that in Java, user interfaces look weird and often attempts to alleviate this weirdness result in enormous amounts of hard to read code.
One solution is to use the Standard Widget Toolkit (SWT) instead. SWT enables easier UI building with resulting UIs that are both faster and look and feel better for the end user. What’s more, the code is more concise thanks to FormLayouts, sane widget sizing and the availability of standard functionality.
There’s one thing I think can be improved on though: readability. SWT code has a tendency to, like Swing, become littered with hundreds of listener classes, or worse, faceless listener implementations. For example, your code may look like this:
public class Demo implements SelectionListener { ... void initialize() { Button myButton = new Button(shell, SWT.NONE); myButton.setText("Click Me"); myButton.addSelectionListener(this); } ... public void widgetDefaultSelected(SelectionEvent e) { // I don't care about this event but I have to // have a handler to satisfy the interface. } public void widgetSelected(SelectionEvent e) { // Do something } }
Notice how the method named ‘widgetSelected’ has a very generic name: it has to since that’s the name it was given in the SelectionListener interface. Also, if there are many widgets that listen for selection events, then this single method has to handle all of them with a big if statement or some such. Not very readable. We also had to thumb on conciseness by adding one method which we didn’t even want: widgetDefaultSelected.
A better method is to associate the handler with only a single widget by using an inner class, and to use an adapter to avoid having to add a dummy method. This would typically look like this:
Button myButton = new Button(shell, SWT.NONE); myButton.setText("Click Me"); myButton.addSelectionListener(new SelectionAdapter() { public void widgetSelected(SelectionEvent e) { // Do something } });
Much better. Less code, easier to read and it’s clear what ‘do something’ is associated with. But now we end up with a bunch of anonymous classes and deeply nested code. It’s still not perfect.
Enter SwtCallback. With SwtCallback, our final version of the program may look like so:
void initialize() { Button myButton = new Button(shell, SWT.NONE); myButton.setText("Click Me"); Callback.add(myButton, SWT.Selection, this, "myButtonSelected"); } /** * Called when myButton is selected. */ @SuppressWarnings("unused") private void myButtonSelected() { // Do something }
This has everything we wanted: it’s clear what the ‘myButtonSelected’ method does because it’s well named. There are no listeners to implement and no inner class bloat. The definition of myButton is short without being complicated or hard to understand. As an added bonus SwtCallback allowed us to make the event handler method private – this makes sense since the method is only relevant for the corresponding UI class.
UI programmers with experience outside of Swing will hopefully immediately recognize and appreciate the idea of callbacks. If you still need more reasons though, I’ll suggest a couple:
- Less code means fewer bugs and easier maintenance. Callbacks allow you to handle events without lots of extra classes or big if-else statements.
- You can link many events to the same handler. For example, maybe you have a ‘Quit’ button in a window. This button can have the same handler as the standard close event for the window.
- No need for dummy methods. Since you’re not implementing listener interfaces you don’t have to implement handlers for events you don’t care about.
- Natural names for methods. You’re not constrained to some standard name for an event handler. You can name your method ‘handlePasswordFieldGainedFocus’ if you want to.
- Private or protected event handlers. With interfaces your event handling methods have to be public. Most of the time they’re very specific to some UI classes. It doesn’t make sense for other unrelated classes to call your handlePasswordFieldGainedFocus() method.
If you still need more, Peter Eastman, the author of Buoy, expresses the rationale for callbacks much better than I ever could here.
SwtCallback is released under the BSD license. Download the source and binary here:
Download SwtCallBack. More information is available here.
Patches and comments are welcome. Apologies for the lack of documentation – if there’s interest in this library we’ll revisit it. For now, if you find it useful, great!
Update 1: SwtCallback 0.2 has been released.
Author: Alexander Ljungberg Tags: Java, open source, WireLoad