自定义服务容器

了解 Dubbo 3 中服务自定义容器类型和使用

特性说明

Dubbo 3 的服务容器是一个 standalone 的启动程序,因为后台服务不需要 Tomcat 或 JBoss 等 Web 容器的功能,如果硬要用 Web 容器去加载服务提供方,增加复杂性,也浪费资源。所以服务通常不需要 Tomcat/JBoss 等 Web 容器的特性,没必要用 Web 容器去加载服务。

Dubbo3 服务容器只是一个简单的 Main 方法,并加载一个简单的 Spring 容器,用于暴露服务。

服务容器的加载内容可以扩展,内置了 spring, jetty, log4j 等加载,可通过 容器扩展点 进行扩展。配置配在 java 命令的 -D 参数或者 dubbo.properties 中。

使用场景

web 容器主要是用来响应 http 请求以及静态页面的,Dubbo 服务提供方只是对外提供 dubbo 服务,用 web 容器不太适合,单独作为 dubbo 服务提供方,只需要通过一个 main 方法加载一个简单的 spring 容器将服务暴露。

使用方式

Spring Container

  • 自动加载 META-INF/spring 目录下的所有 Spring 配置。

  • 配置 spring 配置加载位置:

    1. 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

  1. java org.apache.dubbo.container.Main

通过 main 函数参数传入要加载的容器

  1. java org.apache.dubbo.container.Main spring jetty log4j

通过 JVM 启动参数传入要加载的容器

  1. java org.apache.dubbo.container.Main -Ddubbo.container=spring,jetty,log4j

通过 classpath 下的 dubbo.properties 配置传入要加载的容器

  1. dubbo.container=spring,jetty,log4j

最后修改 December 16, 2022: Fix check (#1736) (97972c1)