websocket 和传统意义上的socket编程虽然存在差别,但也存在相通概念,也分服务端和客户端。
主要区别
对于websocket,客户端的编写方式是通过JS编写回调函数完成交互;而传统socket,则需要连接端口,通过输入输出流来传递信息,完成交互;
传统的socket,服务端则需要绑定端口,通过accept 方法,等待客户端的连接。websocket 规范则把处理细节由web服务器来完成。
数据处理是websocket的一项主要工作。按工作阶段划分,主要包括以下方面。
信息发送
信息解码
信息编码
信息接收
按传递数据划分,分为
文本信息
二进制流信息
ping/pong信息
上面的内容,仅限于服务端,websocket html5相关暂时不讨论
1.信息发送( Sending Messages)
表示服务端,将消息传递给客户端(peer)
1.1将消息广播到所有连接客户端
@ServerEndpoint("/echoall")
public class EchoAllEndpoint {
@OnMessage
public void onMessage(Session session, String msg) {//1
try {
for (Session sess : session.getOpenSessions()) {
if (sess.isOpen())
sess.getBasicRemote().sendText(msg);//2,3
}
} catch (IOException e) { ... }
}
}
信息发送三步
1.Obtain the Session
object from the connection.(通过在参数中添加Session,获取Session)
2.Use the Session
object to obtain a RemoteEndpoint
object.
3.Use the RemoteEndpoint
object to send messages to the peer.
1.2返回值,作为信息发送
@OnMessage
public String onMessage(String message,Session session) {
System.out.println("Received : "+ message);
return message+"-"+session.getId();
}
2.信息解码和编码(codec)
拿打电话为例,如果电话双方,都用一样的标准普通话沟通,就没必要用翻译器了。如果电话双方,一边用着标准的牛津话,一方操着标准的山东土话,想想也能想想出来,沟通直接乱掉了,这时候必须要用到双方必须都需要翻译器了。websocket的编码和解码部分就是“翻译器”的角色。
编码及×××位置
可以简单理解为:解码就是反序列化的过程;编码就是序列化的过程。
2.1 使用Encoders 反序列化对象
响应信息需要转换成二进制,才能进行网络传递。
来自j2ee的例子
1.实现Encoder.Text<T> 或Encoder.Binary<T>接口
public class MessageATextEncoder implements Encoder.Text<MessageA> {
@Override
public void init(EndpointConfig ec) { }
@Override
public void destroy() { }
@Override
public String encode(MessageA msgA) throws EncodeException {
// Access msgA's properties and convert to JSON text...
return msgAJsonString;
}
}
2.将第一步中新建的Encoder,添加到ServerEndpoint 注解的encoders 属性中
@ServerEndpoint(
value = "/myendpoint",
encoders = { MessageATextEncoder.class, MessageBTextEncoder.class }
)
public class EncEndpoint { ... }
3.使用RemoteEndpoint.Basic or RemoteEndpoint.Async 的sendObject发送对象。
MessageA msgA = new MessageA(...);
MessageB msgB = new MessageB(...);
session.getBasicRemote.sendObject(msgA);
session.getBasicRemote.sendObject(msgB);
2.2 使用Decoders 序列化信息
将请求信息转换成对象,才方便ServerPoint处理响应
与Encoders处理步骤类似
1.实现Decoder.Text<T>或Decoder.Binary
<T>接口
public class MessageTextDecoder implements Decoder.Text<Message> {
@Override
public void init(EndpointConfig ec) { }
@Override
public void destroy() { }
@Override
public Message decode(String string) throws DecodeException {
// Read message...
if ( /* message is an A message */ )
return new MessageA(...);
else if ( /* message is a B message */ )
return new MessageB(...);
}
@Override
public boolean willDecode(String string) {
// Determine if the message can be converted into either a
// MessageA object or a MessageB object...
return canDecode;
}
}
请注意willDecode方法,决定是否进行解码
2. 新建的Decoder,添加到ServerEndpoint 注解的decoders 属性中
@ServerEndpoint(
value = "/myendpoint",
encoders = { MessageATextEncoder.class, MessageBTextEncoder.class },
decoders = { MessageTextDecoder.class }
)
public class EncDecEndpoint { ... }
3. 这时候就可以在@OnMessage注解的参数方法中直接使用Decoder.decode返回的对象类型了。
@OnMessage
public void message(Session session, Message msg) {
if (msg instanceof MessageA) {
// We received a MessageA object...
} else if (msg instanceof MessageB) {
// We received a MessageB object...
}
}
具体例子,见我的github项目。https://github.com/janecms/websocket_example
(XML)编码解密处理(codec)
(JSON)编码解密处理(codec)
3.信息接收(Receiving Messages)
3.1 接收三种不同形式消息
package com.sample.websocket.endpoint;
import javax.websocket.OnMessage;
import javax.websocket.PongMessage;
import javax.websocket.Session;
import javax.websocket.server.ServerEndpoint;
import java.nio.ByteBuffer;
@ServerEndpoint("/receive")
public class ReceiveEndpoint {
@OnMessage
public void textMessage(Session session, String msg) {
System.out.println("Text message: " + msg);
}
@OnMessage
public void textMessage(Session session, String msg) {
System.out.println("Text message: " + msg);
}
@OnMessage
public void binaryMessage(Session session, ByteBuffer msg) {
System.out.println("Binary message: " + msg.toString());
}
@OnMessage
public void pongMessage(Session session, PongMessage msg) {
System.out.println("Pong message: " + msg.getApplicationData().toString());
}
}
一个奇怪的情况,不同版本的Tomcat,对@OnMessage注解的方法限制有所不同。也进一步说明,websocket规范是个快速变化中的规范。有的直接编译期出错;有的运行时错误。(有可能和我选择不同版本的开发工具有关系,不太确定,一样的代码,表现不同的行为,蹊跷)
需要注意的是被OnMessage注解的三个方法,分别接收不同的消息类型。
3.2 错误代码
@ServerEndpoint("/echo")
public class EchoEndpoint {
@OnMessage
public String onMessage(String message,Session session) {
System.out.println("Received : "+ message);
return message+"-"+session.getId();
}
@OnMessage
public String onMessage2(String message,Session session) {
System.out.println("Received : "+ message);
return message+"####"+session.getId();
}
}
代码,报运行时异常。
javax.servlet.ServletException: javax.websocket.DeploymentException: Duplicate annotation
一种消息类型,只能对应一个OnMessage方法。
参考资源
https://docs.oracle.com/javaee/7/tutorial/websocket005.htm
结论:主要讨论了消息相关的内容 按消息处理的不同阶段进行总结。接下来即将讨论websocket相关的配置信息,及错误处理。
亿速云「云服务器」,即开即用、新一代英特尔至强铂金CPU、三副本存储NVMe SSD云盘,价格低至29元/月。点击查看>>
免责声明:本站发布的内容(图片、视频和文字)以原创、转载和分享为主,文章观点不代表本网站立场,如果涉及侵权请联系站长邮箱:is@yisu.com进行举报,并提供相关证据,一经查实,将立刻删除涉嫌侵权内容。