如果使用 Standalone Jetty 的${jetty.base}推荐${jetty.home} 安装过程,您应该转到您的${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 服务器端点与您的 webapp 一起部署。
为什么这在独立的 Jetty 中有效?独立的 Jetty 做了什么来使这成为可能?
会发生以下情况:
- 该
websocket模块添加lib/websocket/*.jar到服务器类路径
- 模块
websocket依赖于和client模块annotations
- 该
client模块添加lib/jetty-client-<jetty.version>.jar到服务器类路径
- 该
annotations模块将lib/jetty-annotations-<jetty.version>.jar和添加lib/annotations/*.jar到服务器类路径
annotations模块依赖于plus模块
annotations模块在etc/jetty-annotations.xml启动时选择执行
- 该
annotations模块按名称添加JPMS模块org.objectweb.asm
- 该
plus模块添加lib/jetty-plus-<jetty.version>.jar到服务器类路径
plus模块在etc/jetty-plus.xml启动时选择执行
plus模块依赖于, server, security,jndi和模块webapptransactions
(我将跳过以这种方式选择的其余模块)
简而言之,只需添加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。
您也可以为 webapp 特定行为设置(Configuration在它开始之前)。WebAppContext
例子:
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 应用程序才能运行。虽然您可以使用ServletContextHandler带有javax.websocket端点的 a,但这种样式是 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