Apache Dubbo 项目

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。

如何贡献？