Apache Dubbo (incubating) is a high-performance, java based, open source RPC framework.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/ISSUE_TEMPLATE Update dubbo-issue-report-template.md (#2483) Sep 11, 2018
.mvn/wrapper Adding maven wrapper to Dubbo project (#1887) Jun 5, 2018
codestyle add checkstyle rule to check import order (#2745) Nov 8, 2018
dubbo-all Merge pull request #2725, problems of graceful shutdown in 2.6.3 and … Nov 5, 2018
dubbo-bom Merge pull request #2725, problems of graceful shutdown in 2.6.3 and … Nov 5, 2018
dubbo-cluster Improve several map iteration (#2938) Dec 12, 2018
dubbo-common Limit the times of registry retry. (#2946) Dec 13, 2018
dubbo-compatible add checkstyle rule to check import order (#2745) Nov 8, 2018
dubbo-config fix issue-2948:spring boot external config invalid (#2950) Dec 13, 2018
dubbo-container Fix log4j pattern layout (#2802) Dec 6, 2018
dubbo-demo Fix log4j pattern layout (#2802) Dec 6, 2018
dubbo-dependencies-bom fix pom for protostuff serialization (#2700) Oct 29, 2018
dubbo-distribution Merge pull request #2725, problems of graceful shutdown in 2.6.3 and … Nov 5, 2018
dubbo-filter Added javadoc for dubbo-filter module dubbo github issue 2884 (#2921) Dec 8, 2018
dubbo-metrics add checkstyle rule to check import order (#2745) Nov 8, 2018
dubbo-monitor code format (#2528) Sep 21, 2018
dubbo-plugin #2762: [Dubbo - qos-http] stopServer should be invoked ? (#2767) Nov 9, 2018
dubbo-registry Limit the times of registry retry. (#2946) Dec 13, 2018
dubbo-remoting Improve several map iteration (#2938) Dec 12, 2018
dubbo-rpc [Dubbo-2328]Fix the concurrency limit of 'ActiveLimitFilter' to calcu… Dec 14, 2018
dubbo-serialization Fixing test-order dependency for FstObjectInputTest (#2815) Dec 10, 2018
dubbo-test add checkstyle rule to check import order (#2745) Nov 8, 2018
.codecov.yml Merge pull request #2047, deprecate dubbo-rpc-thrift. Jul 9, 2018
.gitignore Remove .orig file and update gitigonre. May 20, 2018
.travis.yml rm java 9 and 10 on travis (#2559) Sep 26, 2018
CHANGES.md Polish release notes in CHANGES.md May 15, 2018
CODE_OF_CONDUCT.md Fix minor issues reported in 2.6.2 RC1 May 22, 2018
CONTRIBUTING.md Add contact and issue report section. Jul 12, 2018
DISCLAIMER manually merge the work made by pull request #1491 on master branch (#… Apr 5, 2018
FAQ.md fix typo error in FAQ (#2684) Oct 26, 2018
LICENSE supplemental change for pull request 1973 (#2329) Aug 22, 2018
NOTICE Enhance NOTICE file. Sep 17, 2018
PULL_REQUEST_TEMPLATE.md should not skipTests (#2958) Dec 14, 2018
README.md fixed involve (#2957) Dec 13, 2018
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 [Dubbo-2864] Fix build failed with -Prelease (#2923) Dec 11, 2018

README.md

Apache Dubbo (incubating) Project

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

Apache Dubbo (incubating) 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/dubbo/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

<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>dubbo</artifactId>
    <version>2.6.5</version>
</dependency>

Define service interfaces

package org.apache.dubbo.demo.api;

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

See api/GreetingService.java on GitHub.

Implement service interface for the provider

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

See provider/GreetingServiceImpl.java on GitHub.

Start service provider

package org.apache.dubbo.demo.provider;

import com.alibaba.dubbo.config.ApplicationConfig;
import com.alibaba.dubbo.config.RegistryConfig;
import com.alibaba.dubbo.config.ServiceConfig;
import org.apache.dubbo.demo.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 com.alibaba.dubbo.config.ApplicationConfig;
import com.alibaba.dubbo.config.ReferenceConfig;
import com.alibaba.dubbo.config.RegistryConfig;
import org.apache.dubbo.demo.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

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-ops/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.incubator.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 eco system

Language

License

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