API 配置

Mon, 01 Jan 0001 00:00:00 +0000

作为一款 RPC 框架，Dubbo 定义了一套完善的 API 接口，我们可以基于原生 API 开发 Dubbo 应用，关于如何使用原生API开发轻量RPC、微服务应用等的具体示例可查看使用教程 - API开发模式中的示例。它的适用场景包括以下两类：

轻量 RPC Server & Client，通常用于一些应用内、基础组件、中间件等内的简单远程调用场景
微服务应用，不依赖 Spring、Spring Boot 的情况下，直接用 API 开发微服务；同时，直接使用 API 对于一些网关或测试平台集成场景也可能比较有用。

目前的入口 API 主要有 Bootstrap、ServiceConfig、ReferenceConfig 等，分别用于不同场景下的 Dubbo 应用开发。

Bootstrap API

DubboBootstrap 实例代表一个 Dubbo 应用，是整个 Dubbo 应用的启动入口。在 DubboBootstrap 基础上，我们可以设置 protocol、service、registry、metrics 等来注册服务、连接注册中心等，这和我们在 Spring Boot 中调整 application.yml 或者 application.properties 文件是对等的作用。

官方推荐使用 DubboBootstrap.start() 作为应用的集中启动入口，但为了方便在进程启动后，在运行态单独发布一些服务，Dubbo 也允许直接调用 ServiceConfig.export() 或 ReferenceConfig.refer() 方法发布服务，这时 Service/Reference 会注册到默认的 DubboBootstrap 实例中，效果同调用 DubboBootstrap.service(…).start() 类似。

import org.apache.dubbo.config.bootstrap.DubboBootstrap;
import org.apache.dubbo.config.ApplicationConfig;
import org.apache.dubbo.config.RegistryConfig;
import org.apache.dubbo.config.ProviderConfig;
import org.apache.dubbo.config.ServiceConfig;
import com.xxx.DemoService;
import com.xxx.DemoServiceImpl;

public class DemoProvider {
 public static void main(String[] args) {

 ConfigCenterConfig configCenter = new ConfigCenterConfig();
 configCenter.setAddress("zookeeper://127.0.0.1:2181");

 // 服务提供者协议配置
 ProtocolConfig protocol = new ProtocolConfig();
 protocol.setName("dubbo");
 protocol.setPort(12345);
 protocol.setThreads(200);

 // 注意：ServiceConfig为重对象，内部封装了与注册中心的连接，以及开启服务端口
 // 服务提供者暴露服务配置
 ServiceConfig<DemoService> demoServiceConfig = new ServiceConfig<>();
 demoServiceConfig.setInterface(DemoService.class);
 demoServiceConfig.setRef(new DemoServiceImpl());
 demoServiceConfig.setVersion("1.0.0");

 // 第二个服务配置
 ServiceConfig<FooService> fooServiceConfig = new ServiceConfig<>();
 fooServiceConfig.setInterface(FooService.class);
 fooServiceConfig.setRef(new FooServiceImpl());
 fooServiceConfig.setVersion("1.0.0");

 ...

 // 通过DubboBootstrap简化配置组装，控制启动过程
 DubboBootstrap.getInstance()
 .application("demo-provider") // 应用配置
 .registry(new RegistryConfig("zookeeper://127.0.0.1:2181")) // 注册中心配置
 .protocol(protocol) // 全局默认协议配置
 .service(demoServiceConfig) // 添加ServiceConfig
 .service(fooServiceConfig)
 .start() // 启动Dubbo
 .await(); // 挂起等待(防止进程退出）
 }
}

import org.apache.dubbo.config.bootstrap.DubboBootstrap;
import org.apache.dubbo.config.ApplicationConfig;
import org.apache.dubbo.config.RegistryConfig;
import org.apache.dubbo.config.ProviderConfig;
import org.apache.dubbo.config.ServiceConfig;
import com.xxx.DemoService;
import com.xxx.DemoServiceImpl;

public class DemoConsumer {
 public static void main(String[] args) {

 // 引用远程服务
 ReferenceConfig<DemoService> demoServiceReference = new ReferenceConfig<DemoService>();
 demoServiceReference.setInterface(DemoService.class);
 demoServiceReference.setVersion("1.0.0");

 ReferenceConfig<FooService> fooServiceReference = new ReferenceConfig<FooService>();
 fooServiceReference.setInterface(FooService.class);
 fooServiceReference.setVersion("1.0.0");

 // 通过DubboBootstrap简化配置组装，控制启动过程
 DubboBootstrap bootstrap = DubboBootstrap.getInstance();
 bootstrap.application("demo-consumer") // 应用配置
 .registry(new RegistryConfig("zookeeper://127.0.0.1:2181")) // 注册中心配置
 .reference(demoServiceReference) // 添加ReferenceConfig
 .reference(fooServiceReference)
 .start(); // 启动Dubbo

 ...

 // 和本地bean一样使用demoService
 // 通过Interface获取远程服务接口代理，不需要依赖ReferenceConfig对象
 DemoService demoService = DubboBootstrap.getInstance().getCache().get(DemoService.class);
 demoService.sayHello("Dubbo");

 FooService fooService = fooServiceReference.get();
 fooService.greeting("Dubbo");
 }

}

基本配置

可以在 DubboBootstrap 中设置全局基本配置，包括应用配置、协议配置、注册中心、配置中心、元数据中心、模块、监控、SSL、provider 配置、consumer 配置等。

配置手册 on Apache Dubbo

API 配置

Bootstrap API

基本配置