如果使用 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
和模块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。
您也可以为 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