简介：这份源码包围绕 Tomcat8、Java7 与 ExtJS 搭建 WebSocket 实时聊天室，面向已具备 Java Web 基础、希望理解服务端推送与富客户端界面联动的开发者，也可作为课程设计或小型实时通信项目的参考实现。压缩包共 1753 个文件、约 7.01MB，其中大量 gif 与 png 为界面素材和演示图，scss、css 支撑 ExtJS 主题样式，js 负责客户端交互，java、class、jar 及 xml 配置则对应 WebSocket 端点、Servlet 容器部署与依赖组织，包体虽小但类型分布较完整。已有 263 人学习，说明其对入门实时通信场景具有一定参考价值，也方便评估案例的典型程度。资源涵盖 @ServerEndpoint 生命周期处理、连接池与消息广播、客户端 WebSocket 封装、用户登录与聊天窗口实时更新等关键环节，并涉及历史消息展示、SSL/TLS 加密、并发连接管理和测试调试思路，便于读者对照梳理从服务端编程、前端组件集成到部署运维的完整链路。
1. 一次“能连上但不回消息”的翻车：Tomcat 8 + Java 7 跑 WebSocket 聊天室先卡在哪
Tomcat 8 配 Java 7 跑一个 ExtJS 前端的 WebSocket 聊天室，在很多存量系统里仍然常见。源码和工具包拿到手，最怕的不是编译报错，而是页面能打开、连接也显示已建立，消息却像进了黑匣子。端口、上下文路径、端点注解、前端 ws 地址，任意一处对不上，表现都不一样。这套环境适合还在 JDK 7 上维护内网小工具、教学演示或给存量系统加聊天模块的人。装之前先把版本钉死，后面少走很多弯路。
2. 装前钉版本：JDK 7、Tomcat 8 与 ExtJS 前端包的取舍
这套源码不是“随便找个 Tomcat 就能跑”的类型。WebSocket 端点依赖容器实现，前端 ExtJS 包又要求静态资源路径和后端上下文一致。我一般先把 JDK、Tomcat、前端包三样分开确认，再动 server.xml。这样出了问题能定位到版本层还是配置层。源码和工具包要分开看：源码决定编译级别，工具包决定容器能力。
2.1 为什么这套源码要求 Java 7 而不是更高版本
Tomcat 8 的最低 Java 版本是 7，源码按 Java 7 语法和字节码编写。直接换更高 JDK 不一定报错，但存量环境里其他依赖未必跟着走。先确认java -version和javac -version指向同一套 JDK 7，别出现运行时是 7、编译器是更高版本的情况。常见做法是临时用环境变量把路径固定住，确认没问题再写进当前 shell 的启动文件。
# 先把 JDK 7 和 Tomcat 8 的路径固定下来，不要依赖系统默认 java export JAVA_HOME=/path/to/jdk7 export CATALINA_HOME=/path/to/tomcat8 export PATH="$JAVA_HOME/bin:$CATALINA_HOME/bin:$PATH" java -version javac -versionJAVA_HOME指向 JDK 根目录，不是 bin 目录；CATALINA_HOME指向 Tomcat 8 根目录；PATH顺序让当前终端优先用 JDK 7。java -version看运行时，javac -version看编译器，两者不一致时编译出来的 class 可能比运行环境高一个版本，启动时就会报 UnsupportedClassVersionError。安装阶段先临时 export，后面编译、启动都在同一个终端里做，减少“换个窗口就找不到 JAVA_HOME”的翻车。
2.2 Tomcat 8 的 WebSocket 实现依赖哪些 jar 与目录
Tomcat 8 的 lib 目录已经带了 WebSocket API 和实现，应用侧不需要再往WEB-INF/lib里塞一份 API 包。很多源码包为了“省事”会把websocket-api.jar一起放进WEB-INF/lib，部署后容易出现类加载冲突，表现是ClassCastException或NoClassDefFoundError。我一般先看应用里的 jar，再决定要不要删。
| 位置 | 作用 | 注意 |
|---|---|---|
$CATALINA_HOME/lib/websocket-api.jar | JSR 356 API | 编译时引用，不复制进WEB-INF/lib |
$CATALINA_HOME/lib/tomcat-websocket.jar | Tomcat 实现 | 运行时由容器加载 |
WEB-INF/lib | 应用依赖 | 不放websocket-api.jar |
WEB-INF/classes | 编译后的端点类 | 包路径与源码一致 |
提示：Tomcat 8 的 lib 目录已经带 websocket-api.jar，应用里再放一份同名 jar 容易出类加载冲突。
编译时 classpath 指向容器 lib，运行时让容器自己加载实现。这个取舍在安装阶段就要定下来，否则后面排查握手失败会多一个变量。源码里如果已经带了 API jar，先移出去再部署，日志会干净很多。
2.3 下载源码后先做一次目录体检
源码目录常见结构是WebContent或webapp作为 Web 根，WEB-INF/web.xml放应用描述，src下是 Java 源码。先别急着编译，用find把目录层级看清楚，确认 Web 根、web.xml、Java 包路径三件事。
cd /path/to/chatroom-src find . -maxdepth 3 -type d | sort find . -name "web.xml" -o -name "*.java" | head -20find . -maxdepth 3 -type d只看三层目录，避免输出刷屏；sort让目录顺序固定；第二条命令找web.xml和 Java 文件，head -20只看前 20 条。Web 根决定后面打包 WAR 从哪个目录进，web.xml决定 Servlet 版本，Java 包路径决定编译输出。如果源码是 Maven 结构，Web 根可能是src/main/webapp，编译输出是target/classes，后面命令按实际改。源码和工具包在这里落地：源码目录决定编译输入，工具包决定 classpath。
3. 配 Tomcat 8 的
本文还有配套的精品资源，点击获取
