Apache Dubbo 프로젝트

Apache Dubbo는 고성능의 Java 기반 오픈소스 RPC 프레임워크입니다. 빠른 시작과 문서는 공식 사이트를, 뉴스, FAQ 및 릴리스 정보는 wiki를 참조하세요.

저희는 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 리스트: 개발자/사용자 토론용. 구독, 구독 해지, 아카이브, 가이드

• 버그: Issues

• Gitter: Gitter 채널

• Twitter: @ApacheDubbo

기여

패치 제출 및 기여 워크플로에 대한 자세한 내용은 CONTRIBUTING을 참조하세요.

어떻게 기여할 수 있나요?