一些好消息和一些坏消息。
首先,好消息:
要设置Sec-WebSocket-Protocol
标题,请使用以下内容。
client.setProtocol("xsCrossfire");
在你使用之前client.open()
接下来,坏消息:
使用 Jetty 8.x,您无法设置任意非 websocket 标头。这是由于早期的 WebSocket 实验草案是如何编写的。您根本不允许根据早期草案规范设置任意标头,因此在 Jetty 8.x 时代的实施只是不允许这样做。
然而,随着RFC6455(官方 WebSocket 规范)的最终确定,事情发生了变化,所有这些变化都被纳入了 Jetty 9.x 代码库。这是 100%符合RFC6455的。 (注意:Jetty 8 在服务器端 100% 符合 RFC6455。Jetty 8 在服务器端和客户端使用的 RFC6455 协议上也 100% 兼容。但是,Jetty 8 仅在客户端部分兼容,从功能和 API 的观点。)
Jetty 7 和 Jetty 8 的决定是为了保留旧的实验草案,以供那些仍然使用它们的早期采用者和旧浏览器(Safari 5.x)使用。这一决定使我们无法允许在旧的实验草案中明确禁止的行为。
从 Jetty 9.x 开始,所有旧的 websocket 实验草案都被删除,只支持RFC6455,这允许 Jetty 开放更多以前不允许的功能。这包括 WebSocketClient 上的任意标头。
Jetty 9.1 WebSocket 客户端示例
import java.io.IOException;
import java.net.URI;
import java.util.concurrent.Future;
import org.eclipse.jetty.websocket.api.Session;
import org.eclipse.jetty.websocket.api.WebSocketAdapter;
import org.eclipse.jetty.websocket.client.ClientUpgradeRequest;
import org.eclipse.jetty.websocket.client.WebSocketClient;
public class ExampleClient
{
public static class ExampleSocket extends WebSocketAdapter
{
@Override
public void onWebSocketText(String message)
{
try
{
// echo the message
getRemote().sendString(message);
}
catch (IOException e)
{
e.printStackTrace();
}
}
}
public static void main(String[] args)
{
try
{
new ExampleClient().demo();
}
catch (Throwable t)
{
t.printStackTrace(System.err);
}
}
public void demo() throws Exception
{
WebSocketClient client = new WebSocketClient();
try
{
client.start();
ClientUpgradeRequest request = new ClientUpgradeRequest();
request.setSubProtocols("xsCrossfire");
request.setHeader("Authorization","Basic TLVWQMZqRr2hasYnZoI=");
URI wsUri = URI.create("ws://iltlvl262:8000/echo");
ExampleSocket socket = new ExampleSocket();
Future<Session> future = client.connect(socket,wsUri,request);
future.get(); // wait for connect
socket.getRemote().sendString("hello"); // send message
}
finally
{
client.stop();
}
}
}
另请注意,从 Jetty 9.1 开始,甚至javax.websocket
完全支持 (JSR-356) API。
在 Jetty 9.1 上使用 javax.websocket 的相同示例
import java.net.URI;
import java.util.ArrayList;
import java.util.List;
import java.util.Map;
import javax.websocket.ClientEndpoint;
import javax.websocket.ContainerProvider;
import javax.websocket.OnMessage;
import javax.websocket.Session;
import javax.websocket.WebSocketContainer;
public class ExampleClient
{
@ClientEndpoint(subprotocols = { "xsCrossfire" },
configurator = ExampleClient.Configurator.class)
public static class ExampleSocket
{
@OnMessage
public String onMessage(String msg)
{
return msg; // echo
}
}
public static class Configurator
extends javax.websocket.ClientEndpointConfig.Configurator
{
@Override
public void beforeRequest(Map<String, List<String>> headers)
{
List<String> authvalues = new ArrayList<>();
authvalues.add("Basic TLVWQMZqRr2hasYnZoI=");
headers.put("Authorization", authvalues);
super.beforeRequest(headers);
}
}
public static void main(String[] args)
{
try
{
new ExampleClient().demo();
}
catch (Throwable t)
{
t.printStackTrace(System.err);
}
}
public void demo() throws Exception
{
WebSocketContainer client = ContainerProvider.getWebSocketContainer();
ExampleSocket socket = new ExampleSocket();
URI wsUri = URI.create("ws://iltlvl262:8000/echo");
Session session = client.connectToServer(socket,wsUri);
session.getAsyncRemote().sendText("Hello");
}
}