WebSocket.java

/*
 * Copyright 2010 Richard Zschech.
 * 
 * Licensed under the Apache License, Version 2.0 (the "License"); you may not
 * use this file except in compliance with the License. You may obtain a copy of
 * the License at
 * 
 * http://www.apache.org/licenses/LICENSE-2.0
 * 
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
 * License for the specific language governing permissions and limitations under
 * the License.
 */
package net.zschech.gwt.websockets.client;

import com.google.gwt.core.client.JavaScriptObject;

public class WebSocket extends JavaScriptObject {
	
	public static final int CONNECTING = 0;
	public static final int OPEN = 1;
	public static final int CLOSED = 2;
	
	/**
	 * Creates an WebSocket object.
	 * 
	 * @return the created object
	 */
	public static native WebSocket create(String url) /*-{
		return new WebSocket(url);
	}-*/;
	
	public static native WebSocket create(String url, String protocol) /*-{
		return new WebSocket(url, protocol);
	}-*/;

	protected WebSocket() {
	}
	
	public final native int getReadyState() /*-{
		return this.readyState;
	}-*/;
	
	public final native int getBufferedAmount() /*-{
		return this.bufferedAmount;
	}-*/;

	public final native void send(String data) /*-{
		this.send(data);
	}-*/;
	
	public final native void close() /*-{
		this.close();
	}-*/;
	
	public final native void setOnOpen(OpenHandler handler) /*-{
		// The 'this' context is always supposed to point to the websocket object in the
		// onreadystatechange handler, but we reference it via closure to be extra sure.
		var _this = this;
		this.onopen = $entry(function() {
			handler.@net.zschech.gwt.websockets.client.OpenHandler::onOpen(Lnet/zschech/gwt/websockets/client/WebSocket;)(_this);
		});
	}-*/;
	
	public final native void setOnClose(CloseHandler handler) /*-{
		// The 'this' context is always supposed to point to the websocket object in the
		// onreadystatechange handler, but we reference it via closure to be extra sure.
		var _this = this;
		this.onclose = $entry(function() {
			handler.@net.zschech.gwt.websockets.client.CloseHandler::onClose(Lnet/zschech/gwt/websockets/client/WebSocket;)(_this);
		});
	}-*/;

	public final native void setOnError(ErrorHandler handler) /*-{
		// The 'this' context is always supposed to point to the websocket object in the
		// onreadystatechange handler, but we reference it via closure to be extra sure.
		var _this = this;
		this.onerror = $entry(function() {
			handler.@net.zschech.gwt.websockets.client.ErrorHandler::onError(Lnet/zschech/gwt/websockets/client/WebSocket;)(_this);
		});
	}-*/;
	
	public final native void setOnMessage(MessageHandler handler) /*-{
		// The 'this' context is always supposed to point to the websocket object in the
		// onreadystatechange handler, but we reference it via closure to be extra sure.
		var _this = this;
		this.onmessage = $entry(function(event) {
			handler.@net.zschech.gwt.websockets.client.MessageHandler::onMessage(Lnet/zschech/gwt/websockets/client/WebSocket;Lnet/zschech/gwt/websockets/client/MessageEvent;)(_this, event);
		});
	}-*/;
}