当前位置:首页 > 技术 > 正文内容

使用WebSocket构建实时群聊系统

访客 技术 2026年9月2日 1

WebSocket 提供了浏览器与服务器之间的全双工通道,非常适合做实时多人聊天。相比传统 HTTP 轮询,它延迟更低、流量更小,服务器也能主动推送消息。

功能清单

  • 用户进入房间时,全员收到"欢迎提示"。
  • 任何用户发送的文字,立即广播给所有人。
  • 用户关闭页面或刷新,全员收到"离开提示"。

项目结构

chat-room/
 ├─ src/
 │   └─ ChatEndpoint.java
 ├─ WebContent/
 │   ├─ index.html
 │   ├─ chat.js
 │   └─ style.css
 └─ WEB-INF/
     └─ web.xml

前端实现

index.html 仅负责引入样式和脚本,核心逻辑在 chat.js:

// chat.js
const socket = new WebSocket('ws://localhost:8080/chat-room/chat');

socket.onopen = () => {
  const nick = prompt('请输入昵称');
  if (nick) socket.send(JSON.stringify({ type: 'join', nick }));
};

socket.onmessage = evt => {
  const chatBox = document.getElementById('chatBox');
  chatBox.insertAdjacentHTML('beforeend', evt.data);
  chatBox.scrollTop = chatBox.scrollHeight;
};

function sendMsg() {
  const input = document.getElementById('msgInput');
  const text = input.value.trim();
  if (!text) return;
  socket.send(JSON.stringify({ type: 'chat', text }));
  input.value = '';
}

document.getElementById('msgInput').addEventListener('keydown', e => {
  if (e.key === 'Enter') sendMsg();
});

window.addEventListener('beforeunload', () => socket.close());

后端实现

使用 Java EE 的 WebSocket API,只需一个端点类即可:

package ws;

import javax.websocket.*;
import javax.websocket.server.ServerEndpoint;
import java.io.IOException;
import java.time.LocalTime;
import java.time.format.DateTimeFormatter;
import java.util.Map;
import java.util.concurrent.ConcurrentHashMap;

@ServerEndpoint("/chat")
public class ChatEndpoint {

    private static final Map<Session, String> users = new ConcurrentHashMap<>();
    private static final DateTimeFormatter fmt = DateTimeFormatter.ofPattern("HH:mm:ss");

    @OnOpen
    public void onConnect(Session session) {
        // 等待第一条 join 消息
    }

    @OnMessage
    public void onText(String json, Session session) throws IOException {
        Msg msg = Msg.fromJson(json);
        if ("join".equals(msg.type)) {
            users.put(session, msg.nick);
            broadcast(render("系统", msg.nick + " 加入聊天室"));
            return;
        }
        if ("chat".equals(msg.type)) {
            String nick = users.get(session);
            broadcast(render(nick, msg.text));
        }
    }

    @OnClose
    public void onClose(Session session) throws IOException {
        String nick = users.remove(session);
        if (nick != null) {
            broadcast(render("系统", nick + " 离开聊天室"));
        }
    }

    private void broadcast(String html) throws IOException {
        for (Session s : users.keySet()) {
            if (s.isOpen()) s.getBasicRemote().sendText(html);
        }
    }

    private String render(String user, String content) {
        return String.format(
            "<div class='bubble'><span class='time'>%s</span>" +
            "<strong>%s</strong>: %s</div>",
            LocalTime.now().format(fmt), user, content
        );
    }

    private static class Msg {
        String type;
        String nick;
        String text;

        static Msg fromJson(String json) {
            return new com.google.gson.Gson().fromJson(json, Msg.class);
        }
    }
}

部署

将项目打成 war 包或直接放入 Tomcat 的 webapps 目录,启动后访问:

http://localhost:8080/chat-room

即可体验实时群聊。

相关文章

Linux crontab 详解

1) crontab 是什么cron 是 Linux 的定时任务守护进程;crontab 是用来编辑/查看“按时间周期执行命令”的表(cron table)。常见两类:用户 crontab:每个用户一份(crontab -e 编辑)系统级 crontab / cron.d:可指定执行用户(/etc/crontab、/etc/cron.d/*)2) crontab 时间...

富文本里可以允许的 HTML 属性

一、所有标签默认允许的安全属性(极少)class        (可选)id           (通常建议禁用)title️ 注意:id 容易被滥用做锚点注入,很多系统直接禁用class 允许的话最好只允许固定前缀(如 editor-*)二、a 标签允许属性<a href="" t...

Mac 安装 Node.js 指南

方法一:通过官网安装包(最简单,适合初学者)如果你只是想快速安装并开始使用,这是最直接的方法。访问 Node.js 官网。页面会显示两个版本:LTS (Recommended For Most Users):长期支持版,最稳定。建议选这个。Current:最新特性版,包含最新功能但可能不够稳定。下载 .pkg 安装包并运行。按照安装向导点击“下一步”即可完成。方法二:使用 Homebrew 安装(...

Dom\HTML_NO_DEFAULT_NS 的副作用:自动加闭合标签

在使用Dom\HTMLDocument时,Dom\HTML_NO_DEFAULT_NS 将禁止在解析过程中设置元素的命名空间, 此设置是为了与DOMDocument向后兼容而存在的。当使用它时,已知的一个副作用就是:自动加闭合标签例如 </img> 为什么会这样?当你使用:Dom\HTML_NO_DEFAULT_NS文档会变成 无命名空间模式,此时内部更接近 XML...

Laravel 事件和监听器创建

在 Laravel 中,使用 Artisan 命令创建 Events(事件) 和 Listeners(监听器) 是非常高效的。你可以通过以下几种方式来实现:1. 手动创建单个 Event如果你只想创建一个事件类,可以使用 make:event 命令:Bashphp artisan make:event UserRegistered执行后,文件将生成在 app/Even...

自定义域名解析神器 dnsmasq

什么是 dnsmasq?dnsmasq 是一个轻量级、功能强大的网络服务工具,专为小型和中等规模网络设计。它是一个综合的网络基础设施解决方案[1]。dnsmasq 能做什么?功能说明应用场景DNS 转发与缓存将 DNS 查询转发到上游服务器(ISP、Google DNS 等),并在本地缓存结果加快 DNS 查询速度,减少外部 DNS 流量本地 DNS解析本地网络设备的主机名,无需编辑&n...

发表评论

访客

◎欢迎参与讨论,请在这里发表您的看法和观点。