Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
420678 - Add WebSocketPartialListener to support receiving partial We…
…bSocket TEXT/BINARY messages + Reworking WebSocketListener to be based on new WebSocketConnectionListener + Adding new WebSocketPartialListener and example
- Loading branch information
Showing
4 changed files
with
181 additions
and
38 deletions.
There are no files selected for viewing
61 changes: 61 additions & 0 deletions
61
...socket-api/src/main/java/org/eclipse/jetty/websocket/api/WebSocketConnectionListener.java
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,61 @@ | ||
// | ||
// ======================================================================== | ||
// Copyright (c) 1995-2015 Mort Bay Consulting Pty. Ltd. | ||
// ------------------------------------------------------------------------ | ||
// All rights reserved. This program and the accompanying materials | ||
// are made available under the terms of the Eclipse Public License v1.0 | ||
// and Apache License v2.0 which accompanies this distribution. | ||
// | ||
// The Eclipse Public License is available at | ||
// http://www.eclipse.org/legal/epl-v10.html | ||
// | ||
// The Apache License v2.0 is available at | ||
// http://www.opensource.org/licenses/apache2.0.php | ||
// | ||
// You may elect to redistribute this code under either of these licenses. | ||
// ======================================================================== | ||
// | ||
|
||
package org.eclipse.jetty.websocket.api; | ||
|
||
/** | ||
* Core WebSocket Connection Listener | ||
*/ | ||
public interface WebSocketConnectionListener | ||
{ | ||
/** | ||
* A Close Event was received. | ||
* <p> | ||
* The underlying Connection will be considered closed at this point. | ||
* | ||
* @param statusCode | ||
* the close status code. (See {@link StatusCode}) | ||
* @param reason | ||
* the optional reason for the close. | ||
*/ | ||
void onWebSocketClose(int statusCode, String reason); | ||
|
||
/** | ||
* A WebSocket {@link Session} has connected successfully and is ready to be used. | ||
* <p> | ||
* Note: It is a good idea to track this session as a field in your object so that you can write messages back via the {@link RemoteEndpoint} | ||
* | ||
* @param session | ||
* the websocket session. | ||
*/ | ||
void onWebSocketConnect(Session session); | ||
|
||
/** | ||
* A WebSocket exception has occurred. | ||
* <p> | ||
* This is a way for the internal implementation to notify of exceptions occured during the processing of websocket. | ||
* <p> | ||
* Usually this occurs from bad / malformed incoming packets. (example: bad UTF8 data, frames that are too big, violations of the spec) | ||
* <p> | ||
* This will result in the {@link Session} being closed by the implementing side. | ||
* | ||
* @param cause | ||
* the error that occurred. | ||
*/ | ||
void onWebSocketError(Throwable cause); | ||
} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
58 changes: 58 additions & 0 deletions
58
...websocket-api/src/main/java/org/eclipse/jetty/websocket/api/WebSocketPartialListener.java
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,58 @@ | ||
// | ||
// ======================================================================== | ||
// Copyright (c) 1995-2015 Mort Bay Consulting Pty. Ltd. | ||
// ------------------------------------------------------------------------ | ||
// All rights reserved. This program and the accompanying materials | ||
// are made available under the terms of the Eclipse Public License v1.0 | ||
// and Apache License v2.0 which accompanies this distribution. | ||
// | ||
// The Eclipse Public License is available at | ||
// http://www.eclipse.org/legal/epl-v10.html | ||
// | ||
// The Apache License v2.0 is available at | ||
// http://www.opensource.org/licenses/apache2.0.php | ||
// | ||
// You may elect to redistribute this code under either of these licenses. | ||
// ======================================================================== | ||
// | ||
|
||
package org.eclipse.jetty.websocket.api; | ||
|
||
import java.nio.ByteBuffer; | ||
|
||
/** | ||
* WebSocket Partial Message Listener interface for incoming WebSocket TEXT/BINARY/CONTINUATION frames. | ||
*/ | ||
public interface WebSocketPartialListener extends WebSocketConnectionListener | ||
{ | ||
/** | ||
* A WebSocket BINARY (or associated CONTINUATION) frame has been received. | ||
* <p> | ||
* <b>Important Note</b>: The payload <code>ByteBuffer</code> cannot be modified, and the ByteBuffer object itself | ||
* will be recycled on completion of this method call, make a copy of the data contained within if you want to | ||
* retain it between calls. | ||
* | ||
* @param payload | ||
* the binary message frame payload | ||
* @param fin | ||
* true if this is the final frame, false otherwise | ||
*/ | ||
void onWebSocketPartialBinary(ByteBuffer payload, boolean fin); | ||
|
||
/** | ||
* A WebSocket TEXT (or associated CONTINUATION) frame has been received. | ||
* | ||
* @param payload | ||
* the text message payload | ||
* <p> | ||
* Note that due to framing, there is a above average chance of any UTF8 sequences being split on the | ||
* border between two frames will result in either the previous frame, or the next frame having an | ||
* invalid UTF8 sequence, but the combined frames having a valid UTF8 sequence. | ||
* <p> | ||
* The String being provided here will not end in a split UTF8 sequence. Instead this partial sequence | ||
* will be held over until the next frame is received. | ||
* @param fin | ||
* true if this is the final frame, false otherwise | ||
*/ | ||
void onWebSocketPartialText(String payload, boolean fin); | ||
} |
60 changes: 60 additions & 0 deletions
60
jetty-websocket/websocket-common/src/test/java/examples/ListenerPartialSocket.java
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,60 @@ | ||
// | ||
// ======================================================================== | ||
// Copyright (c) 1995-2015 Mort Bay Consulting Pty. Ltd. | ||
// ------------------------------------------------------------------------ | ||
// All rights reserved. This program and the accompanying materials | ||
// are made available under the terms of the Eclipse Public License v1.0 | ||
// and Apache License v2.0 which accompanies this distribution. | ||
// | ||
// The Eclipse Public License is available at | ||
// http://www.eclipse.org/legal/epl-v10.html | ||
// | ||
// The Apache License v2.0 is available at | ||
// http://www.opensource.org/licenses/apache2.0.php | ||
// | ||
// You may elect to redistribute this code under either of these licenses. | ||
// ======================================================================== | ||
// | ||
|
||
package examples; | ||
|
||
import java.nio.ByteBuffer; | ||
|
||
import org.eclipse.jetty.websocket.api.Session; | ||
import org.eclipse.jetty.websocket.api.WebSocketPartialListener; | ||
import org.eclipse.jetty.websocket.common.events.EventCapture; | ||
|
||
public class ListenerPartialSocket implements WebSocketPartialListener | ||
{ | ||
public EventCapture capture = new EventCapture(); | ||
|
||
@Override | ||
public void onWebSocketClose(int statusCode, String reason) | ||
{ | ||
capture.add("onWebSocketClose(%d, %s)",statusCode,capture.q(reason)); | ||
} | ||
|
||
@Override | ||
public void onWebSocketConnect(Session session) | ||
{ | ||
capture.add("onWebSocketConnect(%s)",session); | ||
} | ||
|
||
@Override | ||
public void onWebSocketError(Throwable cause) | ||
{ | ||
capture.add("onWebSocketError((%s) %s)",cause.getClass().getSimpleName(),cause.getMessage()); | ||
} | ||
|
||
@Override | ||
public void onWebSocketPartialText(String payload, boolean fin) | ||
{ | ||
capture.add("onWebSocketPartialText('%s', %b)",payload,fin); | ||
} | ||
|
||
@Override | ||
public void onWebSocketPartialBinary(ByteBuffer payload, boolean fin) | ||
{ | ||
capture.add("onWebSocketPartialBinary(%s [%d], %b)",payload,payload.remaining(),fin); | ||
} | ||
} |