Dubbo Spring Boot 工程

Dubbo Apache Dubbo™ 是一款高性能Java RPC框架。

Spring Boot 应用场景的开发。同时也整合了 Spring Boot 特性：

自动装配 (比如： 注解驱动, 自动装配等).

Production-Ready (比如： 安全, 健康检查, 外部化配置等).

Apache Dubbo |ˈdʌbəʊ| 是一款高性能、轻量级的开源Java RPC框架，它提供了三大核心能力：面向接口的远程方法调用，智能容错和负载均衡，以及服务自动注册和发现。

已发行版本

您可以为您的工程引入最新 dubbo-spring-boot-starter 的发布，增加以下依赖到工程的 pom.xml 文件中：

2.3.0.RELEASE

2.7.8

org.springframework.boot

spring-boot-dependencies

${spring-boot.version}

pom

import

org.apache.dubbo

dubbo-dependencies-bom

${dubbo.version}

pom

import

org.apache.dubbo

dubbo

${dubbo.version}

org.springframework

spring

javax.servlet

servlet-api

log4j

log4j

org.apache.dubbo

dubbo-spring-boot-starter

2.7.8

org.apache.dubbo

dubbo

如果您的工程遇到了依赖问题, 请尝试添加如下 Maven 参考到工程的 pom.xml 文件中：

apache.snapshots.https

Apache Development Snapshot Repository

https://repository.apache.org/content/repositories/snapshots

false

true

历史版本

如果您现在使用的Dubbo版本低于2.7.0，请使用如下对应版本的Dubbo Spring Boot：

Dubbo Spring Boot

Dubbo

Spring Boot

源代码构建

如果您需要尝试最新 dubbo-spring-boot-project 的特性，您可将当前工程手动 Maven install 到本地 Maven 仓库：

Maven install 当前工程

Maven install = mvn install

快速开始

如果您对 Dubbo 不是非常了解，耽误您几分钟访问 http://dubbo.apache.org/ 。了解后，如果您期望更深入的探讨，可以移步用户手册。

通常情况 , Dubbo 应用有两种使用场景 , 其一为 Dubbo 服务提供方 , 另外一个是 Dubbo 服务消费方，当然也允许两者混合，下面我们一起快速开始！

首先，我们假设存在一个 Dubbo RPC API ，由服务提供方为服务消费方暴露接口 :

public interface DemoService {

String sayHello(String name);

}

实现 Dubbo 服务提供方

实现 DemoService 接口

@DubboService(version = "1.0.0")

public class DefaultDemoService implements DemoService {

/

* The default value of ${dubbo.application.name} is ${spring.application.name}

*/

@Value("${dubbo.application.name}")

private String serviceName;

public String sayHello(String name) {

return String.format("[%s] : Hello, %s", serviceName, name);

}

}

编写 Spring Boot 引导程序

@EnableAutoConfiguration

public class DubboProviderDemo {

public static void main(String[] args) {

SpringApplication.run(DubboProviderDemo.class,args);

}

}

配置 application.properties :

# Spring boot application

spring.application.name=dubbo-auto-configuration-provider-demo

# Base packages to scan Dubbo Component: @org.apache.dubbo.config.annotation.Service

dubbo.scan.base-packages=org.apache.dubbo.spring.boot.sample.provider.service

# Dubbo Application

The default value of dubbo.application.name is ${spring.application.name}

dubbo.application.name=${spring.application.name}

# Dubbo Protocol

dubbo.protocol.name=dubbo

dubbo.protocol.port=12345

Dubbo Registry

dubbo.registry.address=N/A

实现 Dubbo 服务消费方

通过 @DubboReference 注入 DemoService :

@EnableAutoConfiguration

public class DubboAutoConfigurationConsumerBootstrap {

private final Logger logger = LoggerFactory.getLogger(getClass());

@DubboReference(version = "1.0.0", url = "dubbo://127.0.0.1:12345")

private DemoService demoService;

public static void main(String[] args) {

SpringApplication.run(DubboAutoConfigurationConsumerBootstrap.class).close();

}

@Bean

public ApplicationRunner runner() {

return args -> {

logger.info(demoService.sayHello("mercyblitz"));

};

}

}

配置 application.yml :

spring:

application:

name: dubbo-auto-configure-consumer-sample

请确保 Dubbo 服务提供方服务可用， DubboProviderDemo 运行方可正常。

更多的实现细节，请参考 Dubbo 示例

社区交流

如果您在使用 Dubbo Spring Boot 中遇到任何问题或者有什么建议? 我们非常需要您的支持!

如果您需要升级版本，请提前阅读发布公告，了解最新的特性和问题修复。

如果您遇到任何问题 ，您可以订阅 Dubbo 用户邮件列表。

问题反馈，您可以在 issues 提出您遇到的使用问题。

模块工程

Dubbo Spring Boot 采用多 Maven 模块工程 , 模块如下：

dubbo-spring-boot-parent 模块主要管理 Dubbo Spring Boot 工程的 Maven 依赖

dubbo-spring-boot-autoconfigure 模块提供 Spring Boot's @EnableAutoConfiguration 的实现 - DubboAutoConfiguration，

它简化了 Dubbo 核心组件的装配。

Dubbo Spring Boot 示例工程包括:

License

Apache Dubbo spring boot project 基于Apache 2.0许可证开源，详细请参考LICENSE。