配置手册 on Apache Dubbo

Spring Boot

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

关于 Spring Boot 的注解、基本使用方法等请参考使用教程 - Spring Boot。以下是 spring boot 支持的配置详情与 starter 列表。

application.yaml

以下是 Dubbo 框架支持的配置组件列表，可以在 Spring Boot 配置文件中指定所需配置。

配置示例

dubbo:
 application:
 name: dubbo-springboot-demo-provider
 logger: slf4j
 protocol:
 name: dubbo
 port: 50052
 registry:
 address: nacos://${nacos.address:127.0.0.1}:8848?username=nacos&password=nacos

dubbo

dubbo.metrics

dubbo.tracing

starter列表

dubbo-spring-boot-starter

以下是一些 dubbo-spring-boot-starter 版本对应的 SpringBoot、JDK 依赖：

XML 配置

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

Dubbo 有基于 Spring Schema 扩展的自定义配置组件，XML 支持的配置项与配置参考手册中描述的一一对。本文使用的示例请参考 dubbo-samples-spring-xml

XML完整示例

服务提供者

定义服务接口

DemoService.java：

package org.apache.dubbo.demo;

public interface DemoService {
 String sayHello(String name);
}

在服务提供方实现接口

DemoServiceImpl.java：

package org.apache.dubbo.demo.provider;
import org.apache.dubbo.demo.DemoService;

public class DemoServiceImpl implements DemoService {
 public String sayHello(String name) {
 return "Hello " + name;
 }
}

用 Spring 配置声明暴露服务

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xmlns:dubbo="http://dubbo.apache.org/schema/dubbo"
 xmlns="http://www.springframework.org/schema/beans" xmlns:context="http://www.springframework.org/schema/context"
 xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
 http://dubbo.apache.org/schema/dubbo http://dubbo.apache.org/schema/dubbo/dubbo.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd">
 <context:property-placeholder/>

 <dubbo:application name="demo-provider"/>

 <dubbo:registry address="zookeeper://${zookeeper.address:127.0.0.1}:2181"/>

 <dubbo:provider token="true"/>

 <bean id="demoService" class="org.apache.dubbo.samples.basic.impl.DemoServiceImpl"/>

 <dubbo:service interface="org.apache.dubbo.samples.basic.api.DemoService" ref="demoService"/>

</beans>

加载 Spring 配置

public class Application {
 public static void main(String[] args) throws InterruptedException {
 ClassPathXmlApplicationContext context = new ClassPathXmlApplicationContext("spring/dubbo-demo-provider.xml");
 context.start();

 System.out.println("dubbo service started");
 // to hang up main thread
 new CountDownLatch(1).await();
 }
}

服务消费者

通过 Spring 配置引用远程服务

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xmlns:dubbo="http://dubbo.apache.org/schema/dubbo"
 xmlns="http://www.springframework.org/schema/beans" xmlns:context="http://www.springframework.org/schema/context"
 xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
 http://dubbo.apache.org/schema/dubbo http://dubbo.apache.org/schema/dubbo/dubbo.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd">
 <context:property-placeholder/>

 <dubbo:application name="demo-consumer"/>

 <dubbo:registry address="zookeeper://${zookeeper.address:127.0.0.1}:2181"/>

 <dubbo:reference id="demoService" check="true" interface="org.apache.dubbo.samples.basic.api.DemoService"/>

</beans>

加载 Spring 配置，并调用远程服务

public class Application {
 public static void main(String[] args) throws IOException {
 ClassPathXmlApplicationContext context = new ClassPathXmlApplicationContext("spring/dubbo-demo-consumer.xml");
 context.start();
 GreetingsService greetingsService = (GreetingsService) context.getBean("greetingsService");

 String message = greetingsService.sayHi("dubbo");
 System.out.println("Receive result ======> " + message);
 System.in.read();
 System.exit(0);
 }
}