Question

鉴于：

我想将包含web.xml且打包为WAR的webapp部署到Jetty服务器。

在该应用程序中，我希望能够配置一个JSR-356指定的javax websocket端点。我希望这些端点通过ServerEndpointConfig提供，不是注释扫描。

有很多资源可以利用嵌入式Jetty，利用已经著名的WebSocketServerContainerInitializer.configureContext(context); API来举例说明。显然，我做不到。

还有其他人，直接跳到ServletContextListener并通过著名的ServerContainer获得context.getAttribute("javax.websocket.server.ServerContainer"）。到目前为止，我已经通过该API获得了NULL的收益，因此显然没有添加容器。

问题：

缺少哪些配置？是否可以最好通过web.xml完成？如果是与jetty.xml或jetty.ini之类的配置文件有关的，则示例同样会很好，最好使用xml语法。

更新：

按照下面的答案（已接受的答案），正如我实际上试图在此处描述的那样-已知的配置方式绝对可以正常工作。说出已知的意思是通过将--module=websocket添加到某个非嵌入式Jetty的*.ini文件中，或调用WebSocketServerContainerInitializer.configureContext来嵌入一个文件。

所以改写这个问题：有人通过纯XML的配置启用websocket模块是否有任何经验/知识？

Answer 1

如果使用${jetty.base}和${jetty.home} recommended installation process for Standalone Jetty，则应转到${jetty.base}实例目录并启用websocket模块。

$ cd /path/to/mybase
$ java -jar /opt/jetty/jetty-home-9.4.14.v20181114/start.jar --add-to-start=websocket
$ grep "websocket" start.ini
--module=websocket

现在您已为该${jetty.base}实例启用了websocket。

如果您希望Jetty通过扫描部署的Web应用程序的字节码来查找服务器WebSocket端点，则还需要annotations模块。

$ cd /path/to/mybase
$ java -jar /opt/jetty/jetty-home-9.4.14.v20181114/start.jar --add-to-start=annotations
$ grep "annotations" start.ini
--module=annotations

完成后，您可以执行以下一项（或多项）操作，以将websocket服务器端点与您的web应用一起部署。

用@ServerEndpoint（来自javax.websocket.server.ServerEndpoint）为班级添加注释
或者，如果要以编程方式添加WebSocket服务器端点，则有2个选项。
1. 在项目中提供javax.websocket.server.ServerApplicationConfig的实现，并返回您要部署Jetty的服务器端点。
2. 在WebApp启动/初始化期间，从ServletContext.getAttribute("javax.websocket.server.ServerContainer")获取javax.websocket.server.ServerContainer，并使用其addEndpoint()方法。请注意，这只能通过ServletContextListener.contextInitialized(ServletContextEvent sce)或ServletContainerInitializer.onStartup(Set<Class<?>> c, ServletContext ctx)

为什么这在独立的Jetty中有效？独立Jetty在做什么才能做到这一点？

发生以下情况：

websocket module将lib/websocket/*.jar添加到服务器类路径
websocket模块依赖于client和annotations模块
client module将lib/jetty-client-<jetty.version>.jar添加到服务器类路径
annotations module将lib/jetty-annotations-<jetty.version>.jar和lib/annotations/*.jar添加到服务器类路径
annotations模块取决于plus模块
annotations模块选择etc/jetty-annotations.xml在启动时执行
annotations模块按名称org.objectweb.asm添加JPMS模块
plus module将lib/jetty-plus-<jetty.version>.jar添加到服务器类路径
plus模块选择etc/jetty-plus.xml在启动时执行
plus模块取决于server，security，jndi，webapp和transactions模块

（我将跳过以这种方式选择的其余模块）

简而言之，只需添加websocket模块，您将获得以下服务器类路径条目

lib/websocket/*.jar
lib/jetty-client-<jetty.version>.jar
lib/jetty-annotations-<jetty.version>.jar
lib/annotations/*.jar
lib/jetty-plus-<jetty.version>.jar

以及以下XML文件

lib/jetty-annotations.xml
lib/jetty-plus.xml

这两个XML文件都只需修改服务器端的默认Configuration列表，使它们引入的Configuration行为可用于所有已部署的WebApp。

您也可以set the Configuration on the WebAppContext（在启动之前）针对Webapp特定的行为。

示例：

WebAppContext context = new WebAppContext();
context.setContextPath("/");
context.setBaseResource(Resource.newResource(rootResourceUrl));

context.setConfigurations(new Configuration[] {
            new AnnotationConfiguration(),
            new WebXmlConfiguration(),
            new WebInfConfiguration(),
            new PlusConfiguration(), 
            new MetaInfConfiguration(),
            new FragmentConfiguration(), 
            new EnvConfiguration()});    

handlerList.addHandler(context);

注意：对于javax.websocket，您必须使用WebAppContext，因为为其初始化定义的行为需要完整的Web App才能起作用。尽管您可以将ServletContextHandler与javax.websocket端点一起使用，但是这种样式是100％手动定义，初始化和声明的，没有JSR-356依赖的自动字节码/注释扫描功能。

您也可以从命令行查看所有这些信息。

显示活动的${jetty.base}配置，XML属性值是什么，服务器类路径是什么以及将要执行什么XML（以什么顺序！）

$ cd /path/to/mybase
$ java -jar /opt/jetty/jetty-home-9.4.14.v20181114/start.jar --list-config

显示模块列表及其之间的关系（以及在${jetty.base}配置中选择的模块）

$ cd /path/to/mybase
$ java -jar /opt/jetty/jetty-home-9.4.14.v20181114/start.jar --list-modules

Jetty中的JSR-356 javax websocket（嵌入式和非嵌入式）

鉴于：

问题：

更新：

1 个答案: