Apache Dubbo プロジェクト

Apache Dubbo は、高性能な Java ベースのオープンソース RPC フレームワークです。クイックスタートやドキュメントについては公式サイトをご覧ください。ニュース、FAQ、リリースノートについてはwikiもご確認ください。

現在、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 リスト: 開発者/ユーザー向けの議論。購読、購読解除、アーカイブ、ガイド

• バグ報告: Issues

• Gitter: Gitter チャンネル

• Twitter: @ApacheDubbo

コントリビューション

パッチの提出方法とコントリビューションのワークフローについては、CONTRIBUTING を参照してください。

どのように貢献できますか？