Jetty 开发指导:Jetty Websocket API

本文介绍了Jetty提供的WebSocket API,包括WebSocket事件处理、Session管理、信息发送方式、注释和监听器使用方法等核心内容。同时展示了如何通过Servlet和客户端API实现WebSocket服务器和客户端的应用。
摘要由CSDN通过智能技术生成

Jetty 开发指导:Jetty Websocket API

原文 csdn tomato__ Jetty 开发指导:Jetty Websocket API

Jetty 提供了功能更强的 WebSocket API,使用一个公共的核心 API 供 WebSockets 的服务端和客户端使用。

他是一个基于 WebSocket 消息的事件驱动的API。

WebSocket 事件

每个 WebSocket 都能接收多种事件:

  1. On Connect Event

    表示 WebSocket 升级成功,WebSocket 现在打开。

    你将收到一个 org.eclipse.jetty.websocket.api.Session 对象,对应这个 Open 事件的 session

    为通常的 WebSocket,应该紧紧抓住这个 Session,并使用它与 Remote Endpoint 进行交流。

    如果为无状态(Stateless)WebSockets,这个 Session 将被传递到它出现的每一个事件,允许你使用一个 WebSocket 的 1 个实例为多个 Remote Endpoint 提供服务。

  2. On Close Event

    表示 WebSocket 已经关闭。

    每个 Close 事件将有一个状态码(Status Code)(和一个可选的Closure Reason Message)。

    一个通常的 WebSocket 终止将经历一个关闭握手,Local EndpointRemote Endpoint 都会发送一个 Close 帧表示连接被关闭。

    本地 WebSocket 可以通过发送一个 Close 帧到 Remote Endpoint 表示希望关闭,但 是Remote Endpoint 能继续发送信息直到它送一个 Close 帧为止。这被称之为半开(Half-Open)连接,注意一旦 Local Endpoint 发送了 Close 帧后,它将不能再发送任何 WebSocket 信息。

    在一个异常的终止中,例如一个连接断开或者超时,底层连接将不经历 Close Handshake 就被终止,这也将导致一个 On Close Event(和可能伴随一个 On Error Event)。

  3. On Error Event

    如果一个错误出现,在实现期间,WebSocket 将通过这个事件被通知。

  4. On Message Event

    表示一个完整的信息被收到,准备被你的 WebSocket 处理。

    这能是一个 (UTF8)TEXT 信息或者一个原始的 BINARY 信息。

WebSocket Session

Session对象能被用于:

  1. 获取 WebSocket 的状态

    连接状态(打开或者关闭)

    if(session.isOpen()) {  
      // send message  
    }

    连接是安全的吗。

    if(session.isSecure()) {  
      // connection is using 'wss://'  
    } 

    在升级请求和响应中的是什么。

    UpgradeRequest req = session.getUpgradeRequest();  
    String channelName = req.getParameterMap().get("channelName");  
    
    UpgradeRespons resp = session.getUpgradeResponse();  
    String subprotocol = resp.getAcceptedSubProtocol();  

    本地和远端地址是什么。

    InetSocketAddress remoteAddr = session.getRemoteAddress();  
  2. 配置策略

    获取和设置空闲超时时间。

    session.setIdleTimeout(2000); // 2 second timeout  

    获取和设置最大信息长度。

    session.setMaximumMessageSize(64*1024); // accept messages up to 64k, fail if larger 
  3. 发送信息到 Remote Endpoint

    Session的最重要的特征是获取 org.eclipse.jetty.websocket.api.RemoteEndpoint

    使用 RemoteEndpoint,你能选择发送 TEXT 或者 BINARY Websocket 信息,或者 WebSocket PING 和 PONG 控制帧。

    a. 阻塞式发送信息

    事实上大部分调用都是阻塞式的,直到发送完成(或者抛出一个异常)才返回。
    
    ```
    // 实例1 发送二进制信息(阻塞)  
    RemoteEndpoint remote = session.getRemote();  
    
    // Blocking Send of a BINARY message to remote endpoint  
    ByteBuffer buf = ByteBuffer.wrap(new byte[] { 0x11, 0x22, 0x33, 0x44 });  
    try  
    {  
        remote.sendBytes(buf);  
    }  
    catch (IOException e)  
    {  
        e.printStackTrace(System.err);  
    }  
    ```
    
    使用 `RemoteEndpoint` 送一个简单的二进制信息。这将阻塞直到信息被发送完成,如果不能发送信息可能将抛出一个 `IOException`。
    
    ```
    // 实例2 发送文本信息(阻塞)  
    RemoteEndpoint remote = session.getRemote();  
    
    // Blocking Send of a TEXT message to remote endpoint  
    try  
    {  
        remote.sendString("Hello World");  
    }  
    catch (IOException e)  
    {  
        e.printStackTrace(System.err);  
    }  
    ```
    
    使用 `RemoteEndpoint` 发送文本信息。这将阻塞直到信息发送,如果不能发送信息可能将抛出一个 `IOException`。
    

    b. 发送部分信息

    如果你有一个大的信息需要被发送,并且想分多次发送,每次一部分,你能使用 `RemoteEndpoint` 发送部分信息的方法。仅需要确保你最后发送一个完成发送的信息(isLast == true)
    
    ```
    // 实例3 发送部分二进制信息(阻塞)  
    RemoteEndpoint remote = session.getRemote();  
    
    // Blocking Send of a BINARY message to remote endpoint  
    // Part 1  
    ByteBuffer buf1 = ByteBuffer.wrap(new byte[] { 0x11, 0x22 });  
    // Part 2 (last part)  
    ByteBuffer buf2 = ByteBuffer.wrap(new byte[] { 0x33, 0x44 });  
    try  
    {  
        remote.sendPartialBytes(buf1,false);  
        remote.sendPartialBytes(buf2,true); // isLast is true  
    }  
    catch (IOException e)  
    {  
        e.printStackTrace(System.err);  
    }  
    ```
    
    分两次发送一个二进制信息,使用在 `RemoteEndpoint` 中的部分信息支持方法。这将阻塞直到每次信息发送完成,如果不能发送信息可能抛出一个 `IOException`。
    
    ```
    // 实例4 发送部分文本信息(阻塞)  
    RemoteEndpoint remote = session.getRemote();  
    
    // Blocking Send of a TEXT message to remote endpoint  
    String part1 = "Hello";  
    String part2 = " World";  
    try  
    {  
        remote.sendPartialString(part1,false);  
        remote.sendPartialString(part2,true); // last part  
    }  
    catch (IOException e)  
    {  
        e.printStackTrace(System.err);  
    }  
    ```
    
    通过两次发送一个文本信息,使用在 `RemoteEndpoint` 中的部分信息支持方法。这将阻塞直到每次信息发送完成,如果不能发送信息可能抛出一个 `IOException`。
    

    c. 发送 Ping/Pong 控制帧

    你也能使用 `RemoteEndpoint` 发送 `Ping` 和 `Pong` 控制帧。
    
    ```
    // 实例5 发送Ping控制帧(阻塞)  
    RemoteEndpoint remote = session.getRemote();  
    
    // Blocking Send of a PING to remote endpoint  
    String data = "You There?";  
    ByteBuffer payload = ByteBuffer.wrap(data.getBytes());  
    try  
    {  
        remote.sendPing(payload);  
    }  
    catch (IOException e)  
    {  
        e.printStackTrace(System.err);  
    }  
    ```
    
    发送一个 `Ping` 控制帧,附带一个负载 “You There?”(作为一个字节数组负载到达 **Remote Endpoint**)。这将阻塞直到信息发送完成,如果不能发送 `Ping` 帧,可能抛出一个 `IOException`。
    
    ```
    实例6 送Pong控制帧(阻塞)  
    RemoteEndpoint remote = session.getRemote();  
    
    // Blocking Send of a PONG to remote endpoint  
    String data = "Yup, I'm here";  
    ByteBuffer payload = ByteBuffer.wrap(data.getBytes());  
    try  
    {  
        remote.sendPong(payload);  
    }  
    catch (IOException e)  
    {  
        e.printStackTrace(System.err);  
    }  
    ```
    
    发送一个 Pong 控制帧,附带一个 "Yup I'm here" 负载(作为一个字节数组负载到达 **Remote Endpoint**)。这将阻塞直到信息被发送,如果不能发送Pong帧,可能抛出一个 `IOException`。
    
    为了正确的使用Pong帧,你应该返回你在 `Ping` 帧中收到的同样的字节数组数据。
    

    d. 异步发送信息

    也存在来年改革异步发送信息的方法可用:
    
    1. `RemoteEndpoint.sendBytesByFuture`(字节信息)
    
    2. `RemoteEndpoint.sendStringByFuture`(字符串信息)
    
    两个方法都返回一个 `Future<Void>`,使用标准 `Java.util.concurrent.Future` 行为,能被用于测试信息发送的成功和失败。
    
    ```
    // 实例7 送二进制信息(异步)  
    RemoteEndpoint remote = session.getRemote();  
    
    // Async Send of a BINARY message to remote endpoint  
    ByteBuffer buf = ByteBuffer.wrap(new byte[] { 0x11, 0x22, 0x33, 0x44 });  
    remote.sendBytesByFuture(buf);  
    ```
    
    使用 `RemoteEndpoint` 发送一个简单的二进制信息。这个信息将被放入发送队列,不知道发送成功或者失败。
    
    ```
    // 实例8 发送二进制信息(异步,等待直到成功)  
    RemoteEndpoint remote = session.getRemote();  
    
    // Async Send of a BINARY message to remote endpoint  
    ByteBuffer buf = ByteBuffer.wrap(new byte[] { 0x11, 0x22, 0x33, 0x44 });  
    try  
    {  
        Future<Void> fut = remote.sendBytesByFuture(buf);  
        // wait for completion (forever)  
        fut.get();  
    }  
    catch (ExecutionException | InterruptedException e)  
    {  
        // Send failed  
        e.printStackTrace();  
    }  
    ```
    
    使用 `RemoteEndpoint` 发送一个简单的二进制信息,追踪 `Future<Void>` 以确定发送成功还是失败。
    
    ```
    // 实例9 送二进制信息(异步,发送超时)  
    RemoteEndpoint remote = session.getRemote();  
    
    // Async Send of a BINARY message to remote endpoint  
    ByteBuffer buf = ByteBuffer.wrap(new byte[] { 0x11, 0x22, 0x33, 0x44 });  
    Future<Void> fut = null;  
    try  
    {  
        fut = remote.sendBytesByFuture(buf);  
        // wait for completion (timeout)  
        fut.get(2,TimeUnit.SECONDS);  
    }  
    catch (ExecutionException | InterruptedException e)  
    {  
        // Send failed  
        e.printStackTrace();  
    }  
    catch (TimeoutException e)  
    {  
        // timeout  
        e.printStackTrace();  
        if (fut != null)  
        {  
            // cancel the message  
            fut.cancel(true);  
        }  
    }  
    ```
    
    使用 `RemoteEndpoint` 发送一个简单的二进制信息,追踪 `Future<Void>` 并等待一个有限的时间,如果时间超限则取消该信息。
    
    ```
    // 实例10 发送文本信息(异步)  
    RemoteEndpoint remote = session.getRemote();  
    
    // Async Send of a TEXT message to remote endpoint  
    remote.sendStringByFuture("Hello World");  
      ```
    
    怎么使用RemoteEndpoint发送一个简单的文本信息。这个信息将被放到输出队列中,但是你将不知道发送成功还是失败。  
    
    ```
    // 实例11 发送文本信息(异步,等待直到成功)  
    RemoteEndpoint remote = session.getRemote();  
    
    // Async Send of a TEXT message to remote endpoint  
    try  
    {  
        Future<Void> fut = remote.sendStringByFuture("Hello World");  
        // wait for completion (forever)  
        fut.get();  
    }  
    catch (ExecutionException | InterruptedException e)  
    {  
        // Send failed  
        e.printStackTrace();  
    }  
    ```
    
    使用 `RemoteEndpoint` 发送一个简单的二进制信息,追踪 `Future<Void>` 以直到发送成功还是失败。
    
    ```
    // 实例12 发送文本信息(异步,发送超时)  
    RemoteEndpoint remote = session.getRemote();  
    
    // Async Send of a TEXT message to remote endpoint  
    Future<Void> fut = null;  
    try  
    {  
        fut = remote.sendStringByFuture("Hello World");  
        // wait for completion (timeout)  
        fut.get(2,TimeUnit.SECONDS);  
    }  
    catch (ExecutionException | InterruptedException e)  
    {  
        // Send failed  
        e.printStackTrace();  
    }  
    catch (TimeoutException e)  
    {  
        // timeout  
        e.printStackTrace();  
        if (fut != null)  
        {  
            // cancel the message  
            fut.cancel(true);  
        }  
    }  
    ```
    
    使用 `RemoteEndpoint` 发送一个简单的二进制信息,追踪 `Future<Void>` 并等待有限的时间,如果超时则取消。
    

使用 WebSocket 注释

WebSocket 的最基本的形式是一个被 Jetty WebSocket API 提供的用注释标记的 POJO

// 实例13 AnnotatedEchoSocket.java  
package examples.echo;  

import org.eclipse.jetty.websocket.api.Session;  
import org.eclipse.jetty.websocket.api.annotations.OnWebSocketMessage;  
import org.eclipse.jetty.websocket.api.annotations.WebSocket;  

/** 
 * Example EchoSocket using Annotations. 
 */  
@WebSocket(maxTextMessageSize = 64 * 1024)  
public class AnnotatedEchoSocket {  

    @OnWebSocketMessage  
    public void onText(Session session, String message) {  
        if (session.isOpen()) {  
            System.out.printf("Echoing back message [%s]%n", message);  
            session.getRemote().sendString(message, null);  
        }  
    }  
}  

上面的例子是一个简单的 WebSocket 回送端点,将回送所有它收到的文本信息。

这个实现使用了一个无状态的方法,因此对每个出现的事件 Session 都会被传递到 Message 处理方法中。这将允许你在同多个端口交互时可以重用 AnnotatedEchoSocket 的单实例。

你可用的注释如下:

  1. @WebSocket

    一个必须的类级别的注释。

    标记这个 POJO 作为一个 WebSocket

    类必须不是 abstract,且是 public

  2. @OnWebSocketConnect

    一个可选的方法级别的注释。

    标记一个在类中的方法作为 On Connect 事件的接收者。

    方法必须是 public ,且不是 abstract ,返回 void ,并且有且仅有一个 Session 参数。

  3. @OnWebSocketClose

    一个可选的方法级的注释。

    标记一个在类中的方法作为 On Close 事件的接收者。

    方法标签必须是 public ,不是 abstract ,并且返回 void

    方法的参数包括:

    a. Session session(可选)

    b. int closeCode(必须)

    c. String closeReason(必须)

  4. @OnWebSocketMessage

    一个可选的方法级注释。

    标记在类中的 2 个方法作为接收 On Message 事件的接收者。

    方法标签必须是 public,不是 abstract,并且返回 void

    为文本信息的方法参数包括:

    a. Session(可选)

    b. String text(必须)

    为二进制信息的方法参数包括:

    a. Session(可选)

    b. byte buf[](必须)

    c. int offset(必须)

    d. int length(必须)

  5. @OnWebSocketError

    一个可选的方法级注释。

    标记一个类中的方法作为 Error 事件的接收者。

    方法标签必须是 public,不是 abstract,并且返回 void

    方法参数包括:

    a. Session(可选)

    b. Throwable cause(必须)

  6. @OnWebSocketFrame

    一个可选的方法级注释。

    标记一个类中的方法作为 Frame 事件的接收者。

    方法标签必须是 public,不是 abstract,并且返回 void

    方法参数包括:

    a. Session(可选)

    b. Frame(必须)

    收到的 Frame 将在这个方法上被通知,然后被 Jetty 处理,可能导致另一个事件,例如 On Close,或者 On Message。对 Frame 的改变将不被 Jetty 看到。

WebSocketListener

一个 WebSocket 的基本形式是使用 org.eclipse.jetty.websocket.api.WebSocketListener 处理收到的事件。

// 实例14 ListenerEchoSocket.java  
package examples.echo;  

import org.eclipse.jetty.websocket.api.Session;  
import org.eclipse.jetty.websocket.api.WebSocketListener;  

/** 
 * Example EchoSocket using Listener. 
 */  
public class ListenerEchoSocket implements WebSocketListener {  

    private Session outbound;  

    @Override  
    public void onWebSocketBinary(byte[] payload, int offset, int len) {  
    }  

    @Override  
    public void onWebSocketClose(int statusCode, String reason) {  
        this.outbound = null;  
    }  

    @Override  
    public void onWebSocketConnect(Session session) {  
        this.outbound = session;  
    }  

    @Override  
    public void onWebSocketError(Throwable cause) {  
        cause.printStackTrace(System.err);  
    }  

    @Override  
    public void onWebSocketText(String message) {  
        if ((outbound != null) && (outbound.isOpen())) {  
            System.out.printf("Echoing back message [%s]%n", message);  
            outbound.getRemote().sendString(message, null);  
        }  
    }  
}  

如果 listener 做了太多的工作,你能使用 WebSocketAdapter 代替。

使用 WebSocketAdapter

WebSocketListener 的适配器。

// 实例15 AdapterEchoSocket.java  
package examples.echo;  

import java.io.IOException;  
import org.eclipse.jetty.websocket.api.WebSocketAdapter;  

/** 
 * Example EchoSocket using Adapter. 
 */  
public class AdapterEchoSocket extends WebSocketAdapter {  

    @Override  
    public void onWebSocketText(String message) {  
        if (isConnected()) {  
            try {  
                System.out.printf("Echoing back message [%s]%n", message);  
                getRemote().sendString(message);  
            } catch (IOException e) {  
                e.printStackTrace(System.err);  
            }  
        }  
    }  
}  

这个类比 WebSocketListener 跟为便利,并提供了有用的方法检查 Session 的状态。

Jetty WebSocket Server API

Jetty 通过 WebSocketServletservlet 桥接的使用,提供了将 WebSocket 端点到 Servlet 路径的对应。

内在地,Jetty 管理 HTTP 升级到 WebSocket,并且从一个 HTTP 连接移植到一个 WebSocket 连接。

这只有当运行在 Jetty 容器内部时才工作。

Jetty WebSocketServlet

为了通过 WebSocketServlet 对应你的 WebSocket 到一个指定的路径,你将需要扩展 org.eclipse.jetty.websocket.servlet.WebSocketServlet 并指定什么 WebSocket 对象应该被创建。

// 实例16 MyEchoServlet.java  
package examples;  

import javax.servlet.annotation.WebServlet;  
import org.eclipse.jetty.websocket.servlet.WebSocketServlet;  
import org.eclipse.jetty.websocket.servlet.WebSocketServletFactory;  

@SuppressWarnings("serial")  
@WebServlet(name = "MyEcho WebSocket Servlet", urlPatterns = { "/echo" })  
public class MyEchoServlet extends WebSocketServlet {  

    @Override  
    public void configure(WebSocketServletFactory factory) {  
        factory.getPolicy().setIdleTimeout(10000);  
        factory.register(MyEchoSocket.class);  
    }  
}  

这个例子将创建一个 Sevlet ,通过 @WebServlet 注解匹配到 Servlet 路径 /echo(或者你能在你的 web 应用的 WEB-INF/web.xml 中手动的配置),当收到 HTTP 升级请求时将创建 MyEchoSocket 实例。

WebSocketServlet.configure(WebSocketServletFactory factory) 是为你的 WebSocket 指定配置的地方。在这个例子中,我们指定一个 10s 的空闲超时,并注册 MyEchoSocket ,即当收到请求时我们想创建的 WebSocket 类,使用默认的 WebSocketCreator 创建。

使用 WebSocketCreator

所有 WebSocket 都是通过你注册到 WebSocketServletFactoryWebSocketCreator 创建的。

默认,WebSocketServletFactory 是一个简单的 WebSocketCreator ,能创建一个单例的 WebSocket 对象。 使用 WebSocketCreator.register(Class<?> websocket )告诉 WebSocketServletFactory 应该实例化哪个类(确保它有一个默认的构造器)。

如果你有更复杂的创建场景,你可以提供你自己的 WebSocketCreator,基于在 UpgradeRequest 对象中出现的信息创建的 WebSocket

// 实例17 MyAdvancedEchoCreator.java  
package examples;  

import org.eclipse.jetty.websocket.servlet.ServletUpgradeRequest;  
import org.eclipse.jetty.websocket.servlet.ServletUpgradeResponse;  
import org.eclipse.jetty.websocket.servlet.WebSocketCreator;  

public class MyAdvancedEchoCreator implements WebSocketCreator {  

    private MyBinaryEchoSocket binaryEcho;  

    private MyEchoSocket textEcho;  

    public MyAdvancedEchoCreator() {  
        this.binaryEcho = new MyBinaryEchoSocket();  
        this.textEcho = new MyEchoSocket();  
    }  

    @Override  
    public Object createWebSocket(ServletUpgradeRequest req, ServletUpgradeResponse resp) {  
        for (String subprotocol : req.getSubProtocols()) {  
            if ("binary".equals(subprotocol)) {  
                resp.setAcceptedSubProtocol(subprotocol);  
                return binaryEcho;  
            }  
            if ("text".equals(subprotocol)) {  
                resp.setAcceptedSubProtocol(subprotocol);  
                return textEcho;  
            }  
        }  
        return null;  
    }  
}  

这儿我们展示了一个 WebSocketCreator,将利用来自请求的 WebSocket 子协议信息决定什么类型的 WebSocket 应该被创建。

// 实例18 MyAdvancedEchoServlet.java  
package examples;  

import javax.servlet.annotation.WebServlet;  
import org.eclipse.jetty.websocket.servlet.WebSocketServlet;  
import org.eclipse.jetty.websocket.servlet.WebSocketServletFactory;  

@SuppressWarnings("serial")  
@WebServlet(name = "MyAdvanced Echo WebSocket Servlet", urlPatterns = { "/advecho" })  
public class MyAdvancedEchoServlet extends WebSocketServlet {  

    @Override  
    public void configure(WebSocketServletFactory factory) {  
        factory.getPolicy().setIdleTimeout(10000);  
        factory.setCreator(new MyAdvancedEchoCreator());  
    }  
}  

当你想要一个定制的 WebSocketCreator 时,使用 WebSocketServletFactory.setCreator(WebSocketCreator creator),然后 WebSocketServletFactory 将为所有在这个 servlet 上收到的 Upgrade 请求用你的创造器。

一个 WebSocketCreator 还可以用于:

  1. 控制 WebSocket 子协议的选择

  2. 履行任何你认为重要的 WebSocket

  3. 从输入的请求获取 HTTP

  4. 获取 Servlet HttpSession 对象(如果它存在)

  5. 指定一个响应状态码和原因

如果你不想接收这个请求,简单的从 WebSocketCreator.createWebSocket(UpgradeRequest req, UpgradeResponse resp) 返回 null

Jetty WebSocket Client API

Jetty 也提供了一个 Jetty WebSocket Client 库,为了更容易的与 WebSocket 服务端交互。
为了在你自己的 Java 项目上使用 Jetty WebSocket Client,你将需要下面的 maven 配置:

<dependency>  
  <groupId>org.eclipse.jetty.websocket</groupId>  
  <artifactId>websocket-client</artifactId>  
  <version>${project.version}</version>  
</dependency>  

WebSocketClient

为了使用 WebSocketClient,你将需要连接一个 WebSocket 对象实例到一个指定的目标 WebSocket URI

// 实例19 SimpleEchoClient.java  
package examples;  

import java.net.URI;  
import java.util.concurrent.TimeUnit;  
import org.eclipse.jetty.websocket.client.ClientUpgradeRequest;  
import org.eclipse.jetty.websocket.client.WebSocketClient;  

/** 
 * Example of a simple Echo Client. 
 */  
public class SimpleEchoClient {  

    public static void main(String[] args) {  
        String destUri = "ws://echo.websocket.org";  
        if (args.length > 0) {  
            destUri = args[0];  
        }  
        WebSocketClient client = new WebSocketClient();  
        SimpleEchoSocket socket = new SimpleEchoSocket();  
        try {  
            client.start();  
            URI echoUri = new URI(destUri);  
            ClientUpgradeRequest request = new ClientUpgradeRequest();  
            client.connect(socket, echoUri, request);  
            System.out.printf("Connecting to : %s%n", echoUri);  
            socket.awaitClose(5, TimeUnit.SECONDS);  
        } catch (Throwable t) {  
            t.printStackTrace();  
        } finally {  
            try {  
                client.stop();  
            } catch (Exception e) {  
                e.printStackTrace();  
            }  
        }  
    }  
}  

上面的例子连接到一个远端 WebSocket 服务端,并且连接后使用一个 SimpleEchoSocket 履行在 websocket 上的处理逻辑,等待 socket 关闭。

// 实例20 SimpleEchoSocket.java  
package examples;  

import java.util.concurrent.CountDownLatch;  
import java.util.concurrent.Future;  
import java.util.concurrent.TimeUnit;  
import org.eclipse.jetty.websocket.api.Session;  
import org.eclipse.jetty.websocket.api.StatusCode;  
import org.eclipse.jetty.websocket.api.annotations.OnWebSocketClose;  
import org.eclipse.jetty.websocket.api.annotations.OnWebSocketConnect;  
import org.eclipse.jetty.websocket.api.annotations.OnWebSocketMessage;  
import org.eclipse.jetty.websocket.api.annotations.WebSocket;  

/** 
 * Basic Echo Client Socket 
 */  
@WebSocket(maxTextMessageSize = 64 * 1024)  
public class SimpleEchoSocket {  

    private final CountDownLatch closeLatch;  

    @SuppressWarnings("unused")  
    private Session session;  

    public SimpleEchoSocket() {  
        this.closeLatch = new CountDownLatch(1);  
    }  

    public boolean awaitClose(int duration, TimeUnit unit) throws InterruptedException {  
        return this.closeLatch.await(duration, unit);  
    }  

    @OnWebSocketClose  
    public void onClose(int statusCode, String reason) {  
        System.out.printf("Connection closed: %d - %s%n", statusCode, reason);  
        this.session = null;  
        this.closeLatch.countDown();  
    }  

    @OnWebSocketConnect  
    public void onConnect(Session session) {  
        System.out.printf("Got connect: %s%n", session);  
        this.session = session;  
        try {  
            Future<Void> fut;  
            fut = session.getRemote().sendStringByFuture("Hello");  
            fut.get(2, TimeUnit.SECONDS);  
            fut = session.getRemote().sendStringByFuture("Thanks for the conversation.");  
            fut.get(2, TimeUnit.SECONDS);  
            session.close(StatusCode.NORMAL, "I'm done");  
        } catch (Throwable t) {  
            t.printStackTrace();  
        }  
    }  

    @OnWebSocketMessage  
    public void onMessage(String msg) {  
        System.out.printf("Got msg: %s%n", msg);  
    }  
}  

SimpleEchoSocket 连接成功后,它发送 2 个文本信息,然后关闭 socket

onMessage(String msg) 收到来自远端 WebSocket 的响应,并输出他们到控制台。

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值