{info:title=Useful Information}
This page has been generated by [maven-confluence-plugin|http://code.google.com/p/maven-confluence-plugin/]
{info}
{toc}
----
{children}
h1. Description
{panel}
GAE CHANNEL EVENT
{panel}
h2. Introduction
First of all, you should read and be familiar with how to use the App Engine Channel API [java|http://code.google.com/appengine/docs/java/channel/] on the server-side.
This library simply wraps the client-side JavaScript with GWT bindings to make it accessible in a GWT application, and it doesn't manage telling your client the client ID it should use. That part's up to you, and is described in the documentation for the Channel API.
h2. A Short Sample
The following is a simple example of how to open a channel and receive updates when the channel receives a message.
{code:java}
ChannelFactory.createChannel(token, new ChannelCreatedCallback() {
@Override
public void onChannelCreated(Channel channel) {
channel.open(new SocketListener() {
@Override
public void onOpen() {
Window.alert("Channel opened!");
}
@Override
public void onMessage(String message) {
Window.alert("Received: " + message);
}
@Override
public void onError(SocketError error) {
Window.alert("Error: " + error.getDescription());
}
@Override
public void onClose() {
Window.alert("Channel closed!");
}
});
}
});
{code}
Whenever the server sends a message to your client ID, the onMessage() method will get called with the message that was sent.
h1. Project Summary
{anchor:Project_Summary} h2. Project Information
{anchor:Project_Information}
||Field||Value||
|Name|GWT GAE channel API|
|Description|GWT bindings for the App Engine Channel API client|
|Homepage|[http://code.google.com/p/gwt-gae-channel/|http://code.google.com/p/gwt-gae-channel/]
|
h2. Project Organization
{anchor:Project_Organization}
||Field||Value||
|Name|Google, Inc.|
|URL|[http://www.google.com|http://www.google.com]
|
h2. Build Information
{anchor:Build_Information}
||Field||Value||
|GroupId|gwt-gae-channel|
|ArtifactId|gwt-gae-channel|
|Version|1.0-20010325|
|Type|jar|
----
h1. Issue Tracking
----
h1. Source Repository
{anchor:Source_Repository} h2. Overview
{anchor:Overview} This project uses [Subversion|http://subversion.apache.org/]
to manage its source code. Instructions on Subversion use can be found at [http://svnbook.red-bean.com/|http://svnbook.red-bean.com/]
.\\
h2. Web Access
{anchor:Web_Access} The following is a link to the online source repository.
{noFormat}
[http://code.google.com/p/gwt-gae-channel/source/browse|http://code.google.com/p/gwt-gae-channel/source/browse]
{noFormat}
h2. Anonymous access
{anchor:Anonymous_access} The source can be checked out anonymously from SVN with this command:
{noFormat}
$ svn checkout http://gwt-gae-channel.googlecode.com/svn/trunk gwt-gae-channel{noFormat}
h2. Developer access
{anchor:Developer_access} Everyone can access the Subversion repository via HTTP, but Committers must checkout the Subversion repository via HTTPS.
{noFormat}
$ svn checkout https://gwt-gae-channel.googlecode.com/svn/trunk gwt-gae-channel{noFormat}
To commit changes to the repository, execute the following command to commit your changes (svn will prompt you for your password)
{noFormat}
$ svn commit --username your-username -m "A message"{noFormat}
h2. Access from behind a firewall
{anchor:Access_from_behind_a_firewall} For those users who are stuck behind a corporate firewall which is blocking HTTP access to the Subversion repository, you can try to access it via the developer connection:
{noFormat}
$ svn checkout https://gwt-gae-channel.googlecode.com/svn/trunk gwt-gae-channel{noFormat}
h2. Access through a proxy
{anchor:Access_through_a_proxy} The Subversion client can go through a proxy, if you configure it to do so. First, edit your "servers" configuration file to indicate which proxy to use. The file's location depends on your operating system. On Linux or Unix it is located in the directory "~/.subversion". On Windows it is in "%APPDATA%\Subversion". (Try "echo %APPDATA%", note this is a hidden directory.)
There are comments in the file explaining what to do. If you don't have that file, get the latest Subversion client and run any command; this will cause the configuration directory and template files to be created.
Example: Edit the 'servers' file and add something like:
{noFormat}
[global]
http-proxy-host = your.proxy.name
http-proxy-port = 3128
{noFormat}
----
h1. Project Dependencies
{anchor:Project_Dependencies} h2. provided
{anchor:provided} The following is a list of provided dependencies for this project. These dependencies are required to compile the application, but should be provided by default when using the library:
||GroupId||ArtifactId||Version||Classifier||Type||Optional||
|com.google.gwt|gwt-user|2.1.0|-|jar|-|
h1. report.transitivedependencies.title
{anchor:report.transitivedependencies.title} report.transitivedependencies.intro
h1. Project Dependency Graph
{anchor:Project_Dependency_Graph} h2. Dependency Tree
{anchor:Dependency_Tree} \\
* ** [com.google.gwt:gwt-user:jar|#com.google.gwt_gwt-user_jar]
h2. report.dependencies.graph.tables.title
{anchor:report.dependencies.graph.tables.title} {anchor:gwt-gae-channel_gwt-gae-channel_jar} *GWT GAE channel API*
GWT bindings for the App Engine Channel API client
[http://code.google.com/p/gwt-gae-channel/|http://code.google.com/p/gwt-gae-channel/]
{anchor:com.google.gwt_gwt-user_jar} *gwt-user*
Sonatype helps open source projects to set up Maven repositories on https://oss.sonatype.org/
[http://code.google.com/webtoolkit/gwt-user/|http://code.google.com/webtoolkit/gwt-user/]
This page has been generated by [maven-confluence-plugin|http://code.google.com/p/maven-confluence-plugin/]
{info}
{toc}
----
{children}
h1. Description
{panel}
GAE CHANNEL EVENT
{panel}
h2. Introduction
First of all, you should read and be familiar with how to use the App Engine Channel API [java|http://code.google.com/appengine/docs/java/channel/] on the server-side.
This library simply wraps the client-side JavaScript with GWT bindings to make it accessible in a GWT application, and it doesn't manage telling your client the client ID it should use. That part's up to you, and is described in the documentation for the Channel API.
h2. A Short Sample
The following is a simple example of how to open a channel and receive updates when the channel receives a message.
{code:java}
ChannelFactory.createChannel(token, new ChannelCreatedCallback() {
@Override
public void onChannelCreated(Channel channel) {
channel.open(new SocketListener() {
@Override
public void onOpen() {
Window.alert("Channel opened!");
}
@Override
public void onMessage(String message) {
Window.alert("Received: " + message);
}
@Override
public void onError(SocketError error) {
Window.alert("Error: " + error.getDescription());
}
@Override
public void onClose() {
Window.alert("Channel closed!");
}
});
}
});
{code}
Whenever the server sends a message to your client ID, the onMessage() method will get called with the message that was sent.
h1. Project Summary
{anchor:Project_Summary} h2. Project Information
{anchor:Project_Information}
||Field||Value||
|Name|GWT GAE channel API|
|Description|GWT bindings for the App Engine Channel API client|
|Homepage|[http://code.google.com/p/gwt-gae-channel/|http://code.google.com/p/gwt-gae-channel/]
|
h2. Project Organization
{anchor:Project_Organization}
||Field||Value||
|Name|Google, Inc.|
|URL|[http://www.google.com|http://www.google.com]
|
h2. Build Information
{anchor:Build_Information}
||Field||Value||
|GroupId|gwt-gae-channel|
|ArtifactId|gwt-gae-channel|
|Version|1.0-20010325|
|Type|jar|
----
h1. Issue Tracking
----
h1. Source Repository
{anchor:Source_Repository} h2. Overview
{anchor:Overview} This project uses [Subversion|http://subversion.apache.org/]
to manage its source code. Instructions on Subversion use can be found at [http://svnbook.red-bean.com/|http://svnbook.red-bean.com/]
.\\
h2. Web Access
{anchor:Web_Access} The following is a link to the online source repository.
{noFormat}
[http://code.google.com/p/gwt-gae-channel/source/browse|http://code.google.com/p/gwt-gae-channel/source/browse]
{noFormat}
h2. Anonymous access
{anchor:Anonymous_access} The source can be checked out anonymously from SVN with this command:
{noFormat}
$ svn checkout http://gwt-gae-channel.googlecode.com/svn/trunk gwt-gae-channel{noFormat}
h2. Developer access
{anchor:Developer_access} Everyone can access the Subversion repository via HTTP, but Committers must checkout the Subversion repository via HTTPS.
{noFormat}
$ svn checkout https://gwt-gae-channel.googlecode.com/svn/trunk gwt-gae-channel{noFormat}
To commit changes to the repository, execute the following command to commit your changes (svn will prompt you for your password)
{noFormat}
$ svn commit --username your-username -m "A message"{noFormat}
h2. Access from behind a firewall
{anchor:Access_from_behind_a_firewall} For those users who are stuck behind a corporate firewall which is blocking HTTP access to the Subversion repository, you can try to access it via the developer connection:
{noFormat}
$ svn checkout https://gwt-gae-channel.googlecode.com/svn/trunk gwt-gae-channel{noFormat}
h2. Access through a proxy
{anchor:Access_through_a_proxy} The Subversion client can go through a proxy, if you configure it to do so. First, edit your "servers" configuration file to indicate which proxy to use. The file's location depends on your operating system. On Linux or Unix it is located in the directory "~/.subversion". On Windows it is in "%APPDATA%\Subversion". (Try "echo %APPDATA%", note this is a hidden directory.)
There are comments in the file explaining what to do. If you don't have that file, get the latest Subversion client and run any command; this will cause the configuration directory and template files to be created.
Example: Edit the 'servers' file and add something like:
{noFormat}
[global]
http-proxy-host = your.proxy.name
http-proxy-port = 3128
{noFormat}
----
h1. Project Dependencies
{anchor:Project_Dependencies} h2. provided
{anchor:provided} The following is a list of provided dependencies for this project. These dependencies are required to compile the application, but should be provided by default when using the library:
||GroupId||ArtifactId||Version||Classifier||Type||Optional||
|com.google.gwt|gwt-user|2.1.0|-|jar|-|
h1. report.transitivedependencies.title
{anchor:report.transitivedependencies.title} report.transitivedependencies.intro
h1. Project Dependency Graph
{anchor:Project_Dependency_Graph} h2. Dependency Tree
{anchor:Dependency_Tree} \\
* ** [com.google.gwt:gwt-user:jar|#com.google.gwt_gwt-user_jar]
h2. report.dependencies.graph.tables.title
{anchor:report.dependencies.graph.tables.title} {anchor:gwt-gae-channel_gwt-gae-channel_jar} *GWT GAE channel API*
GWT bindings for the App Engine Channel API client
[http://code.google.com/p/gwt-gae-channel/|http://code.google.com/p/gwt-gae-channel/]
{anchor:com.google.gwt_gwt-user_jar} *gwt-user*
Sonatype helps open source projects to set up Maven repositories on https://oss.sonatype.org/
[http://code.google.com/webtoolkit/gwt-user/|http://code.google.com/webtoolkit/gwt-user/]