cobogwave

The Google Wave Gadget API is an extension to the Gadget API. This project is created to wrap the Wave Gadget API in Java classes to be able to program Gadgets with GWT. The following document provided by Google can help with Debugging Wave Gadgets.

How to useAdd the WaveGadget.gwt.xml to your project gwt.xml:

Create a class that extends WaveGadget.

@Gadget.ModulePrefs(title = "Hello World")
public class HelloWorld extends WaveGadget {

public HelloWorld() {
...
RootPanel.get().add();
}

protected void init(UserPreferences preferences) {
getWave().addParticipantUpdateEventHandler(new ParticipantUpdateEventHandler() {
public void onUpdate(ParticipantUpdateEvent event) {
//handle participants added, also called when wave with gadget is opened.
}
});
getWave().addStateUpdateEventHandler(new StateUpdateEventHandler() {
public void onUpdate(StateUpdateEvent event) {
//handle state changes.
}
});
}
}There are 3 events StatusUpdateEvent, ParticipantUpdateEvent and ModeChangeEvent to work easily with updates. Simple register a handler for one of those events with the methods on the WaveFeature class and the events will be fired when state or participants change.

If you are not using maven you need to add the GWT gadgets api library manually to your project. Download the library from the http://code.google.com/p/gwt-google-apis/ page and add the gwt-gadgets-1.0.3.jar file to your project.

To wave or to wave-preview?The first version 1.0.3 made use of the FeatureName "wave-preview". By using that name the wave-preview script is loaded by the gadget container. However, there are several problems reported with this version, e.g. not loading in some browsers and returning false in wave.isInWaveContainer(). Therefor in version 1.0.3.1 this was changed to FeatureName "wave". Using this name it is required to load the wave.js script by the gadget itself, but that is taken care of by the library via the WaveGadget.gwt.xml file. Thanks goes to Vicente J. Ruiz Jurado for providing the solution.

Maven2 SupportThe libraries are also supported for maven2. The repository is located at http://cobogwave.googlecode.com/svn/maven2/. Add the repository to your pom.xml file:

cobogwave
Cobogwave repository at googlecode
http://cobogwave.googlecode.com/svn/maven2/
And add the following dependency:

org.cobogw.gwt.wave-api
cobogwave-gadget
1.0.3.3