创建你的第一个WebSocket应用程序.PDFVIP

第1章 Java WebSocket 基础 加菲ye烦恼 这章介绍了 Java WebSocket API,并给出了它的功能的高层次之旅.本章将深入示例应用程序,这个应用程序的 服务器 简单地回显由它的客户 发送的消息.我们将使用它说明 Java WebSocket API 的主要特性.这样做,本 章将建立本书剩余部分的主要特性的一个基础.如果你需要复习下 WebSocket 协议的主要概念,请在阅读之前看下 它的介绍. 创创建建你你的的第第一一个个 WebSocket 应应用用程程序序 因为 WebSocket 协议的核心就是允许在两 之间进行消息传递,我们将以一个最简单的示例开始 Java WebSocket API： EchoServer 应用程序. EchoServer 是一个 客户 /服务器 应用程序.它的客户 是一小段 JavaScript 代码运行在浏览器中.服务 器是一个 WebSocket 点使用 Java WebSocket API 编写,作为一个 web 应用程序的一部分部署到应用程序 服务器中.当用户加载 web 网页到浏览器中,在他/她的命令中,JavaScript 代码片段被执行.这段代码要做的第 一件事就是连接到应用程序服务器中的 Java EchoServer WebSocket 点.然后立刻发送一条消息.Java EchoServer 点运行于应用程序服务器中等待传入的连接,当它从它的连接的客户 中的某一个接收到一条消 息,它立即回复确定. 我们将使用这个应用程序说明我们创建的 WebSocket 点的主要概念. 这个示例通常有两步设置--首先,最重要的,我们将编写 Java EchoServer 点并部署到服务器上.接着,包含一 个 JavaScript WebSocket 客户 的 web 页面将运行于一个浏览器中.图 1-1 展示了我们将创建示例的设置 的通用图示. 创创建建一一个个 WebSocket 点点 创建第一个 WebSocket 点相当简单,需要了解的就是 Java WebSocket API 定义的一些 annotations. 首先,创建一个名为 EchoServer 的类,添加一个有一个 String 参数的方法保存任何从客户 传入的消息. 方法的返回值也是一个 String . 清清单单 一一个个简简单单的的 Java 对对象象(POJO) 1. public class EchoServer { 2. public String echo(String incomingMessage) { 3. return I got this ( + incomingMessage + ) + so I am sen ing it back !; 4. } 5. } 接下来要做的就是使用 Java WebSocket API 将这个 POJO 变为 WebSocket.我们只需要 Java WebSocket API 中的两个注解： @ServerEn point 和 @OnMessage . @ServerEn point 是一个类级别的注解用来告诉 Java 平台这个类将作为一个 WebSocket 点.这个注解 只有一个强制的参数,就是相对的 URI,开发者用来使得此 点可用.这就像给某些人电话号码,这些人可以呼叫.在 第1章 Java WebSocket 基础 加菲ye烦恼 这个例子中,我们保持一切简单,使用 URI /echo 来发布我们创建的这个新 点. 所以, EchoServer 类使用下面的注解 清清单单 一一个个 POJO 变变为为一一个个 WebSocket 点点 1. import javax.websocket.server.ServerEn point; 2. @ServerEn point(/echo) 3. public class EchoServer {