Apache Dubbo 项目

maven license

Apache Dubbo 是一个高性能、基于 Java 的开源 RPC 框架。请访问官方网站获取快速入门指南和文档，也可通过 wiki 获取新闻、FAQ 和版本发布说明。

我们正在收集 Dubbo 用户信息，以帮助我们进一步改进 Dubbo。恳请您在 issue#1012: Wanted: who's using dubbo 中补充您的信息以支持我们，谢谢 :)

架构

特性

基于透明接口的 RPC
智能负载均衡
自动服务注册与发现
高扩展性
运行时流量路由
可视化服务治理

快速入门

以下代码片段来自 Dubbo Samples。您可以先克隆示例项目并进入 dubbo-samples-api 子目录，然后再继续。

# git clone https://github.com/apache/dubbo-samples.git
# cd dubbo-samples/java/dubbo-samples-api

dubbo-samples-api 目录下有一个 README 文件。我们建议按照下述说明参考该目录中的示例：

Maven 依赖

<properties>
    <dubbo.version>2.7.8</dubbo.version>
</properties>

<dependencies>
    <dependency>
        <groupId>org.apache.dubbo</groupId>
        <artifactId>dubbo</artifactId>
        <version>${dubbo.version}</version>
    </dependency>
    <dependency>
        <groupId>org.apache.dubbo</groupId>
        <artifactId>dubbo-dependencies-zookeeper</artifactId>
        <version>${dubbo.version}</version>
        <type>pom</type>
    </dependency>
</dependencies>

定义服务接口

package org.apache.dubbo.samples.api;

public interface GreetingsService {
    String sayHi(String name);
}

参见 GitHub 上的 api/GreetingsService.java。

为服务提供者实现服务接口

package org.apache.dubbo.samples.provider;

import org.apache.dubbo.samples.api.GreetingsService;

public class GreetingsServiceImpl implements GreetingsService {
    @Override
    public String sayHi(String name) {
        return "hi, " + name;
    }
}

参见 GitHub 上的 provider/GreetingsServiceImpl.java。

启动服务提供者

package org.apache.dubbo.samples.provider;


import org.apache.dubbo.config.ApplicationConfig;
import org.apache.dubbo.config.RegistryConfig;
import org.apache.dubbo.config.ServiceConfig;
import org.apache.dubbo.samples.api.GreetingsService;

import java.util.concurrent.CountDownLatch;

public class Application {
    private static String zookeeperHost = System.getProperty("zookeeper.address", "127.0.0.1");

    public static void main(String[] args) throws Exception {
        ServiceConfig<GreetingsService> service = new ServiceConfig<>();
        service.setApplication(new ApplicationConfig("first-dubbo-provider"));
        service.setRegistry(new RegistryConfig("zookeeper://" + zookeeperHost + ":2181"));
        service.setInterface(GreetingsService.class);
        service.setRef(new GreetingsServiceImpl());
        service.export();

        System.out.println("dubbo service started");
        new CountDownLatch(1).await();
    }
}

参见 GitHub 上的 provider/Application.java。

构建并运行服务提供者

# mvn clean package
# mvn -Djava.net.preferIPv4Stack=true -Dexec.mainClass=org.apache.dubbo.samples.provider.Application exec:java

在服务消费者中调用远程服务

package org.apache.dubbo.samples.client;


import org.apache.dubbo.config.ApplicationConfig;
import org.apache.dubbo.config.ReferenceConfig;
import org.apache.dubbo.config.RegistryConfig;
import org.apache.dubbo.samples.api.GreetingsService;

public class Application {
    private static String zookeeperHost = System.getProperty("zookeeper.address", "127.0.0.1");

    public static void main(String[] args) {
        ReferenceConfig<GreetingsService> reference = new ReferenceConfig<>();
        reference.setApplication(new ApplicationConfig("first-dubbo-consumer"));
        reference.setRegistry(new RegistryConfig("zookeeper://" + zookeeperHost + ":2181"));
        reference.setInterface(GreetingsService.class);
        GreetingsService service = reference.get();
        String message = service.sayHi("dubbo");
        System.out.println(message);
    }
}

参见 GitHub 上的 consumer/Application.java。

构建并运行服务消费者

# mvn clean package
# mvn -Djava.net.preferIPv4Stack=true -Dexec.mainClass=org.apache.dubbo.samples.client.Application exec:java

服务消费者将在屏幕上打印出 hi, dubbo。

后续步骤

您的第一个 Dubbo 应用 - 一个 101 教程，使用上述相同的代码揭示更多细节。
Dubbo 用户手册 - 如何使用 Dubbo 及其所有特性。
Dubbo 开发者指南 - 如何参与 Dubbo 开发。
Dubbo 管理手册 - 如何管理和维护 Dubbo 服务。

构建

如果您想试用最新的特性，可以使用以下命令进行构建。（构建 master 分支需要 Java 1.8）

  mvn clean install

联系方式

邮件列表：
- dev 列表：用于开发者/用户讨论。订阅、退订、存档、指南
Bug：Issues
Gitter：Gitter 聊天室
Twitter：@ApacheDubbo

参与贡献

有关提交补丁和贡献工作流程的详细信息，请参阅 CONTRIBUTING。

如何贡献？

查看带有 Good first issue 或 Help wanted 标签的 issue。
加入邮件列表的讨论，订阅指南。
在 Issues 上回答问题。
修复 Issues 上报告的 Bug，并向我们发送拉取请求。
审查现有的拉取请求。
改进网站，通常我们需要
- 博客文章
- 文档翻译
- 关于 Dubbo 在企业系统中集成的使用案例。
改进 dubbo-admin/dubbo-monitor。
为生态系统中列出的项目做出贡献。
其他上述未明确列举的贡献形式。
如果您想贡献，请发送邮件至 [email protected] 告知我们！

报告 Bug

请按照模板报告任何问题。

报告安全漏洞

请私下向我们报告安全漏洞。

Dubbo 生态系统

Dubbo 生态系统入口 - GitHub 上名为 dubbo 的组织，用于汇集所有尚不适合放入 apache 组织的 Dubbo 相关项目
Dubbo 官方网站 - Apache Dubbo 官方网站
Dubbo 示例 - Apache Dubbo 的示例
Dubbo Spring Boot - Dubbo 的 Spring Boot 项目
Dubbo Admin - Dubbo 管理后台的参考实现
Dubbo Awesome - Meetup 中 Dubbo 的幻灯片和视频链接

语言

Go（推荐）
Node.js
Python
PHP
Erlang

许可证

Apache Dubbo 软件根据 Apache 许可证 2.0 版授权。详情请参阅 LICENSE 文件。

apache__dubbo_CVE-2021-30180_2-7-9

最受欢迎