首页 > 文章列表 > Java Websocket开发指南:如何实现客户端与服务器端的实时通信

Java Websocket开发指南:如何实现客户端与服务器端的实时通信

java 实时通信 websocket
477 2023-12-02

Java Websocket开发指南:如何实现客户端与服务器端的实时通信,需要具体代码示例

随着Web应用程序的不断发展,实时通信已成为项目中必不可少的一部分。在传统的HTTP协议中,客户端向服务器发送请求,只有在收到响应之后才能得到数据,这导致客户端需要不断地轮询(polling)服务器以获取最新数据,这样会导致性能和效率问题。而WebSocket则是为了解决这些问题而生的。

WebSocket是HTML5中的一种新协议。它能够提供双向通信的功能,并且减少了客户端轮询的工作。客户端可以直接向服务器发送消息,而无需等待服务器的响应。这使得开发实时应用变得更加容易和高效。

Java作为一种广泛应用于Web应用程序开发的语言,也提供了轻松实现Websocket的方式。下面将介绍如何在Java中使用Websocket。

第一步,需要导入Java的WebSocket API。你可以从Maven中央库或者使用Java EE 7框架中的javax.websocket包中的API。

下面是一个使用Java EE 7中的javax.websocket包中的API实现Websocket的示例:

  1. 创建ServerEndpoint注释类

使用@WebSocket标注创建类,以便告诉Java服务器这个类可以将这个会话作为一个WebSocket endpoint,并提供了URI,将这个地址和WebSocket endpoint相匹配。

import javax.websocket.*;
import javax.websocket.server.ServerEndpoint;
 
@ServerEndpoint(value = "/websocket")
public class WebSocketExample {
     
    @OnOpen
    public void onOpen(){
        System.out.println("Connection opened");
    }
     
    @OnClose
    public void onClose(){
        System.out.println("Connection closed");
    }
     
    @OnMessage
    public void onMessage(String message){
        System.out.println("Message received: " + message);
    }
}

使用WebSocketExample类作为我们WebSocket程序的入口。在上面的例子中,我们使用了@ServerEndpoint注释配合Endpoint类,将类映射到指定的URI。

@OnOpen, @OnMessage和@OnClose注释是基于事件的,用于指定方法在WebSocket连接打开,消息接收和连接关闭时被调用。

获取的消息字符串将被直接传递给onMessage回调方法。现在,我们已经在WebSocket server端定义了endpoints。

  1. 创建client端示例
public class WebSocketClientExample extends Endpoint {
 
    public static CountDownLatch latch;
 
    @Override
    public void onOpen(final Session session, EndpointConfig config) {
        System.out.println("Connected");
 
        try {
            session.getBasicRemote().sendText("Hello");
        } catch (IOException ex) {
        }
    }
 
    @Override
    public void onError(final Session session, Throwable t) {
        t.printStackTrace();
    }
}

我们的WebSocket客户端可以使用javax.websocket.Endpoint作为基类,这是WebSocket API的一部分。

我们将使用CountDownLatch来判断客户端是否连接到服务器。

在onOpen()回调方法中,我们已经连接到了服务器,并发送消息。

注意:在这个示例中,通过使用session.getBasicRemote().sendText(“Hello”); 方法发送消息。在WebSocket API中,还有另一个用于发送消息的方法,即session.getAsyncRemote().sendText("Hello");,区别在于getBasicRemote()的方式是阻塞的,而getAsyncRemote()的方式是非阻塞的。如果我们想异步发送消息,可以使用getAsyncRemote()。

  1. 创建测试类并运行应用程序

构建测试类,为服务器端和客户端服务,确保连接的正常建立。你需要启动应用程序,并让正在运行的应用程序与WebSocket服务器交互。如果一切正常,应该看到一些消息打印在开发工具的控制台上。

import javax.websocket.*;
import java.net.URI;
import java.util.concurrent.CountDownLatch;
 
public class AppRunner {
 
    public static void main(String[] args) throws Exception {
        WebSocketContainer container = ContainerProvider.getWebSocketContainer();
 
        CountDownLatch latch = new CountDownLatch(1);
 
        container.connectToServer(new WebSocketExample(), new URI("ws://localhost:8080/websocket"));
 
        latch.await();
    }
}

这个测试代码将启动WebSocket客户端,并尝试连接到localhost:8080上的WebSocket服务器。我们将使用CountDownLatch对象等待成功的连接以及一些附加信息。

运行测试时,我们可以通过Web浏览器键入http://localhost:8080/websocket并打开JavaScript控制台,查看并通过JavaScript WebSocket对象向WebSocket客户端发送消息。

总结:

使用WebSocket进行实时通信远比使用传统的HTTP周期性轮询来得更高效。在Java语言中,你可以使用WebSocket API来实现Websocket。本文提供了一个WebSocket server和client的Java示例程序以及具体的代码实现示例,希望对读者有所帮助。