Skip to content
Apache Dubbo is a high-performance, java based, open source RPC framework.
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/ISSUE_TEMPLATE Remove incubator (#4161) May 24, 2019
.mvn/wrapper Use maven CI friendly versions: revision. (#3851) Apr 12, 2019
codestyle Use maven CI friendly versions: revision. (#3851) Apr 12, 2019
dubbo-all Multiple registry (#4066) May 24, 2019
dubbo-bom Remove incubator (#4161) May 24, 2019
dubbo-cluster [Dubbo-4183] Fix unstable tests in ConditionRouterTest (#4226) Jun 6, 2019
dubbo-common 1. 将URL中的默认值使用三目运算符表示。 (#4301) Jun 13, 2019
dubbo-compatible Merge changes from 2.7.2-release (#4259) Jun 6, 2019
dubbo-config optimize junit Assert usage (#4214) Jun 1, 2019
dubbo-configcenter Merge changes from 2.7.2-release (#4259) Jun 6, 2019
dubbo-container [DUBBO-3137]: step3 - start using CommonConstants (#4030) May 12, 2019
dubbo-demo Remove incubator (#4161) May 24, 2019
dubbo-dependencies-bom Merge changes from 2.7.2-release (#4259) Jun 6, 2019
dubbo-dependencies Merge changes from 2.7.2-release (#4259) Jun 6, 2019
dubbo-distribution Remove incubator (#4161) May 24, 2019
dubbo-filter optimize junit Assert usage (#4214) Jun 1, 2019
dubbo-metadata-report [Dubbo-4183] Fix unstable tests in ConditionRouterTest (#4226) Jun 6, 2019
dubbo-monitor optimize junit Assert usage (#4214) Jun 1, 2019
dubbo-plugin optimize junit Assert usage (#4214) Jun 1, 2019
dubbo-registry Merge changes from 2.7.2-release (#4259) Jun 6, 2019
dubbo-remoting optimize junit Assert usage (#4214) Jun 1, 2019
dubbo-rpc Merge changes from 2.7.2-release (#4259) Jun 6, 2019
dubbo-serialization optimize junit Assert usage (#4214) Jun 1, 2019
.codecov.yml Merge pull request #2047, deprecate dubbo-rpc-thrift. Jul 9, 2018
.gitignore Add dependencies check script (#3941) May 22, 2019
.travis.yml add openjdk to travis (#3300) Mar 12, 2019
CHANGES.md Merge changes from 2.7.2-release (#4259) Jun 6, 2019
CODE_OF_CONDUCT.md Fix minor issues reported in 2.6.2 RC1 May 22, 2018
CONTRIBUTING.md Remove incubator (#4161) May 24, 2019
Jenkinsfile [CI] Add jenkinsfile for dubbo snapshot deployment (#4205) Jun 6, 2019
LICENSE Merge pull request #3578, fixes #3289, enhance tagRoute: support ip e… Mar 7, 2019
NOTICE Remove incubator (#4161) May 24, 2019
PULL_REQUEST_TEMPLATE.md Remove incubator (#4161) May 24, 2019
README.md Merge changes from 2.7.2-release (#4259) Jun 6, 2019
SECURITY.md Create security.md (#4165) May 29, 2019
licenseCheck.sh Add dependencies check script (#3941) May 22, 2019
mvnw Adding maven wrapper to Dubbo project (#1887) Jun 5, 2018
mvnw.cmd Adding maven wrapper to Dubbo project (#1887) Jun 5, 2018
pom.xml [CI] Add jenkinsfile for dubbo snapshot deployment (#4205) Jun 6, 2019

README.md

Apache Dubbo Project

Build Status codecov maven license Average time to resolve an issue Percentage of issues still open Tweet Gitter

Apache Dubbo is a high-performance, Java based open source RPC framework. Please visit official site for quick start and documentations, as well as Wiki for news, FAQ, and release notes.

We are now collecting dubbo user info in order to help us to improve Dubbo better, pls. kindly help us by providing yours on issue#1012: Wanted: who's using dubbo, thanks :)

Architecture

Architecture

Features

  • Transparent interface based RPC
  • Intelligent load balancing
  • Automatic service registration and discovery
  • High extensibility
  • Runtime traffic routing
  • Visualized service governance

Getting started

The following code snippet comes from Dubbo Samples. You may clone the sample project and step into dubbo-samples-api sub directory before read on.

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

There's a README file under dubbo-samples-api directory. Read it and try this sample out by following the instructions.

Maven dependency

<properties>
    <dubbo.version>2.7.2</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>

Define service interfaces

package org.apache.dubbo.samples.api;

public interface GreetingService {
    String sayHello(String name);
}

See api/GreetingService.java on GitHub.

Implement service interface for the provider

package org.apache.dubbo.samples.provider;
 
import org.apache.dubbo.samples.api.GreetingService;
 
public class GreetingServiceImpl implements GreetingService {
    @Override
    public String sayHello(String name) {
        return "Hello " + name;
    }
}

See provider/GreetingServiceImpl.java on GitHub.

Start service provider

package org.apache.dubbo.demo.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.GreetingService;

import java.io.IOException;
 
public class Application {

    public static void main(String[] args) throws IOException {
        ServiceConfig<GreetingService> serviceConfig = new ServiceConfig<GreetingService>();
        serviceConfig.setApplication(new ApplicationConfig("first-dubbo-provider"));
        serviceConfig.setRegistry(new RegistryConfig("multicast://224.5.6.7:1234"));
        serviceConfig.setInterface(GreetingService.class);
        serviceConfig.setRef(new GreetingServiceImpl());
        serviceConfig.export();
        System.in.read();
    }
}

See provider/Application.java on GitHub.

Build and run the provider

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

Call remote service in consumer

package org.apache.dubbo.demo.consumer;

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

public class Application {
    public static void main(String[] args) {
        ReferenceConfig<GreetingService> referenceConfig = new ReferenceConfig<GreetingService>();
        referenceConfig.setApplication(new ApplicationConfig("first-dubbo-consumer"));
        referenceConfig.setRegistry(new RegistryConfig("multicast://224.5.6.7:1234"));
        referenceConfig.setInterface(GreetingService.class);
        GreetingService greetingService = referenceConfig.get();
        System.out.println(greetingService.sayHello("world"));
    }
}

Build and run the consumer

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

The consumer will print out Hello world on the screen.

See consumer/Application.java on GitHub.

Next steps

Building

If you want to try out the cutting-edge features, you can built with the following commands. (Java 1.8 is required to build the master branch)

  mvn clean install

Contact

Contributing

See CONTRIBUTING for details on submitting patches and the contribution workflow.

How can I contribute?

  • Take a look at issues with tag called Good first issue or Help wanted.
  • Join the discussion on mailing list, subscription guide.
  • Answer questions on issues.
  • Fix bugs reported on issues, and send us pull request.
  • Review the existing pull request.
  • Improve the website, typically we need
    • blog post
    • translation on documentation
    • use cases about how Dubbo is being used in enterprise system.
  • Improve the dubbo-admin/dubbo-monitor.
  • Contribute to the projects listed in ecosystem.
  • Any form of contribution that is not mentioned above.
  • If you would like to contribute, please send an email to dev@dubbo.apache.org to let us know!

Reporting bugs

Please follow the template for reporting any issues.

Reporting a security vulnerability

Please report security vulnerability to us privately.

Dubbo ecosystem

Language

License

Apache Dubbo is under the Apache 2.0 license. See the LICENSE file for details.

You can’t perform that action at this time.