自定义服务容器
了解 Dubbo 中服务自定义容器类型和使用
特性说明
Dubbo 的服务容器是一个 standalone 的启动程序,因为后台服务不需要 Tomcat 或 JBoss 等 Web 容器的功能,如果硬要用 Web 容器去加载服务提供方,增加复杂性,也浪费资源。所以服务通常不需要 Tomcat/JBoss 等 Web 容器的特性,没必要用 Web 容器去加载服务。
Dubbo 服务容器只是一个简单的 Main 方法,并加载一个简单的 Spring 容器,用于暴露服务。
服务容器的加载内容可以扩展,内置了 spring, jetty, log4j 等加载,可通过 容器扩展点 进行扩展。配置配在 java 命令的 -D 参数或者 dubbo.properties
中。
使用场景
web 容器主要是用来响应 http 请求以及静态页面的,Dubbo 服务提供方只是对外提供 dubbo 服务,用 web 容器不太适合,单独作为 dubbo 服务提供方,只需要通过一个 main 方法加载一个简单的 spring 容器将服务暴露。
使用方式
Spring Container
- 自动加载
META-INF/spring
目录下的所有 Spring 配置。 - 配置 spring 配置加载位置:
dubbo.spring.config=classpath*:META-INF/spring/*.xml
Jetty Container
- 启动一个内嵌 Jetty,用于汇报状态。
- 配置:
dubbo.jetty.port=8080
:配置 jetty 启动端口dubbo.jetty.directory=/foo/bar
:配置可通过 jetty 直接访问的目录,用于存放静态文件dubbo.jetty.page=log,status,system
:配置显示的页面,缺省加载所有页面
Log4j Container
- 自动配置 log4j 的配置,在多进程启动时,自动给日志文件按进程分目录。
- 配置:
dubbo.log4j.file=/foo/bar.log
:配置日志文件路径dubbo.log4j.level=WARN
:配置日志级别dubbo.log4j.subdirectory=20880
:配置日志子目录,用于多进程启动,避免冲突
容器加载说明
缺省只加载 spring
java org.apache.dubbo.container.Main
通过 main 函数参数传入要加载的容器
java org.apache.dubbo.container.Main spring jetty log4j
通过 JVM 启动参数传入要加载的容器
java org.apache.dubbo.container.Main -Ddubbo.container=spring,jetty,log4j
通过 classpath 下的 dubbo.properties
配置传入要加载的容器
dubbo.container=spring,jetty,log4j
最后修改 May 23, 2023: Update service-container.md (#2626) (249d8399c46)