websocket api
建议为支持Java [3]中的WebSocket协议而最近发布的JSR 356 Java API for WebSocket [3]，已经随Servlet容器的最新版本一起提供，例如Tomcat，Wildfly，Jetty和GlassFish。 尽管这是朝着正确方向迈出的真正良好一步，但在许多领域中，API要么功能不足，要么可以从重大改进中受益。 在最初发表在《 JAX杂志》上的这篇文章中，让·弗朗西斯·阿坎德（Jean Francis Arcand）向我们介绍了其中的一些。在使用API之前，想要使用WebSocket协议的应用程序需要使用专有的WebSocket API，以牺牲可移植性，或者使用诸如Atmosphere [2]之类的框架，该框架抽象了一个API层，允许跨Servlet容器的WebSocket应用程序，以及诸如Vert.x，播放！ 和Netty。
另一个重要的区别是，只有在浏览器支持WebSocket协议时，JSR 356 WebSocket应用程序才能运行。 如果没有浏览器，则该应用程序将无法运行。 这对于Atmosphere来说不是问题-框架能够透明地回退到HTTP等其他传输方式，而无需对应用程序进行任何更改。 请注意，如果您打算使用纯JSR 356 websocket应用程序进行生产，在Web上直播，则许多浏览器将无法与您的应用程序进行通信。 让我们使用一个聊天应用程序来比较JSR 356和Atmosphere的使用，并查看JSR从哪些改进中可以受益。 我们将通过编写最简单的端点开始比较。 在这里假设您对JSR 356注释ṡ有所了解。 首先，让我们编写我们的骨架类。 使用JSR 356，我们的端点将看起来像：
Listing 1
@ServerEndpoint(value = "/chat")
public class ChatRoom {
@OnOpen
public void ready(Session s) {
s.getAsyncRemote().sendText("You are connected");
}
@OnMessage
public void message(String message, Session session) {
// Sent the message back to all connected users.
for(Session s: session.getOpenSessions()) {
if (s.isOpen()) s.getAsyncRemote().sendText(message);
}
}
@OnClose
public void close(CloseReason reason) {
}
}
End
Listing 2
@ManagedService(path="/chat")
public class ChatRoom {
@Ready
public String ready(AtmosphereResource r) {
return "You are connected";
}
@Message
public String message(String message) {
// Sent the message back to all connected users.
return message;
}
@Disconnect
public void close(AtmosphereResourceEvent event) {
}
}
End
Listing 3
@ServerEndpoint(
value = "/chat"
)
public class ChatRoom {
// Warning, the Scheduler will never be shutdown. Add a ShutdownHook.
private final ScheduledExecutorService scheduler = Executors.newScheduledThreadPool(10);
private final AtomicBoolean isStated = new AtomicBoolean();
@OnOpen
public void ready(final Session session) {
session.getAsyncRemote().sendText("You are connected");
aliveSession.offer(session);
if (!isStated.getAndSet(true)) {
scheduler.schedule(new Runnable() {
@Override
public void run() {
// Send heartbeat every 10 seconds
for(Session s: session.getOpenSessions()) {
if (s.isOpen()) s.getAsyncRemote().sendText(" ");
}
}
}, 10, TimeUnit.SECONDS);
}
}
@OnMessage
public void message(String message, Session session) {
for(Session s: session.getOpenSessions()) {
if (s.isOpen()) s.getAsyncRemote().sendText(message);
}
}
@OnClose
public void close(Session session, CloseReason reason) {
}
}
End
Listing 4
@ServerEndpoint(
value = "/chat"
)
public class ChatRoom {
private final ConcurrentLinkedQueue<Session> aliveSession = new ConcurrentLinkedQueue<Session>();
// Warning, the Scheduler will never be shutdown
private final ScheduledExecutorService scheduler = Executors.newScheduledThreadPool(10);
private final AtomicBoolean isStated = new AtomicBoolean();
private final ConcurrentHashMap<String, List<String>> messages = new ConcurrentHashMap<String, List<String>>();
@OnOpen
public void ready(final Session session) {
session.getAsyncRemote().sendText("You are connected");
aliveSession.offer(session);
checkForCachedMessage(session);
if (!isStated.getAndSet(true)) {
scheduler.schedule(new Runnable() {
@Override
public void run() {
// Send heartbeat every 10 seconds
for(Session s: session.getOpenSessions()) {
if (s.isOpen()) s.getAsyncRemote().sendText(" ");
}
}
}, 10, TimeUnit.SECONDS);
}
}
private void checkForCachedMessage(Session session) {
// Unique Token
String clientUniqueToken = parseQueryStringForUniqueId(session.getQueryString());
List<String> cachedMessages = messages.get(clientUniqueToken);
for (String m : cachedMessages) {
if (s.isOpen()) session.getAsyncRemote().sendText(m);
}
}
private String parseQueryStringForUniqueId(String queryString) {
...
}
@OnMessage
public void message(String message, Session session) {
for(Session s: session.getOpenSessions()) {
if (s.isOpen()) s.getAsyncRemote().sendText(message);
}
}
@OnClose
public void close(Session session, CloseReason reason) {
aliveSession.remove(session);
startCachingMessageFor(session);
}
private void startCachingMessageFor(Session session) {
...
}
}
End
Listing 5
websocket.onmessage(message) {
// Will fail if the browser receives incomplete message.
window.JSON.parse(message);
}
End
Listing 6
atmosphereSocket.onMessage(response) {
var message = response.responseBody;
// Will always work
window.JSON.parse(message);
}
End
Listing 7
public class Message {
private String message;
public Message(String message) {
this.message = message;
}
public String getMessage() {
return message;
}
public void setMessage(String message) {
this.message = message;
}
}
End
Listing 8
public class MessageDecoder implements Decoder.Text<Message> {
private ObjectMapper mapper = new ObjectMapper();
@Override
public Message decode(String s) {
return mapper.readValue(s, Message.class);;
}
@Override
public boolean willDecode(String s) {
return true;
}
@Override
public void init(EndpointConfig config) {
}
@Override
public void destroy() {
}
}
with Atmosphere,
public class ChatDecoder implements Decoder<String, Message> {
private ObjectMapper mapper = new ObjectMapper();
@Override
public Message decode(String s) {
return mapper.readValue(s, Message.class);
}
}
End
Listing 9
public class ChatEncoder implements Encoder.Text<Message> {
private ObjectMapper mapper = new ObjectMapper();
@Override
public String encode(Message s) {
return mapper.writeValueAsString(s);
}
@Override
public void init(EndpointConfig config) {
}
@Override
public void destroy() {
}
}
with Atmosphere,
public class ChatEncoder implements Encoder<Message, String> {
private ObjectMapper mapper = new ObjectMapper();
@Override
public String encode(Message s) {
return mapper.writeValueAsString(s);
}
}
End
Listing 10
@ServerEndpoint(
value = "/chat",
encoders = {ChatEncoder.class},
decoders = {ChatDecoder.class}
)
public class ChatRoom {
@OnOpen
public void ready(final Session session) {
session.getAsyncRemote().sendText("You are connected");
}
@OnMessage
public void message(Message message, Session session) {
for(Session s: session.getOpenSessions()) {
if (s.isOpen()) s.getAsyncRemote().sendText(message);
}
}
@OnClose
public void close(Session session, CloseReason reason) {
}
}
End
Listing 11
@ManagedService(path="/chat")
public class BasicChatRoom {
@Ready
public String ready(AtmosphereResource r) {
return "You are connected";
}
@Message(encoders = {ChatEncoder.class}, decoders = {ChatDecoder.class})
public String message(String message) {
return message;
}
@Disconnect
public void close(AtmosphereResourceEvent event) {
}
}
End
Listing 11
var websocket = new WebSocket(uri);
websocket.onopen = function(evt) {
...
};
websocket.onmessage = function(evt) {
...
};
websocket.onclose = function(evt) {
...
};
websocket.onerror = function(evt) {
...
};
websocket.send(...);
End
Listing 12
var request = { url: url
transport: 'websocket',
fallbacktransport: 'long-polling'};
request.onOpen = function (response) {
...
};
request.onMessage = function (response) {
...
};
request.onClose = function (response) {
...
};
request.onError = function (response) {
...
};
socket = atmosphere.subscribe(request);
socket.push(...);
End
Listing 13
var request = { url: url
reconnectInterval : 5000 // 5 seconds before reconnecting
maxReconnectOnClose : 5 // Stop after 5 unsuccesful reconnect
transport: 'websocket',
fallbacktransport: 'long-polling'};
request.onOpen = function (response) {
...
};
request.onReOpen = function (response) {
// Invoked when the client successfully reconnect
};
request.onReconnect = function (response) {
// Invoked before trying to reconnect.
};
request.onMessage = function (response) {
...
};
request.onClose = function (response) {
...
};
request.onError = function (response) {
...
};
socket = atmosphere.subscribe(request);
socket.push(...);
End
翻译自: https://jaxenter.com/jsr-356-java-api-for-websocket-or-atmosphere-107316.html
websocket api
1163
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
