Apache Dubbo (incubating) is a high-performance, java based, open source RPC framework.
kexianjun and cvictory [Dubbo-2798]fix apporiate NotWritablePropertyException (#2800)
fix #2798 .
'propertyname in java donot contain '-' but camel format'.
Latest commit 5ea6b33 Nov 20, 2018
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 add checkstyle rule to check import order (#2745) Nov 8, 2018
dubbo-common [REFACTOR]:[fix typo] (#2804) Nov 19, 2018
dubbo-compatible add checkstyle rule to check import order (#2745) Nov 8, 2018
dubbo-config [Dubbo-2798]fix apporiate NotWritablePropertyException (#2800) Nov 20, 2018
dubbo-container Merge pull request #2725, problems of graceful shutdown in 2.6.3 and … Nov 5, 2018
dubbo-demo add checkstyle rule to check import order (#2745) Nov 8, 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 Changing URL so tests can run in any order (#2760) Nov 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 【Unit Test】FailbackRegistry Test: recover method (#2591) Oct 30, 2018
dubbo-remoting #2777: heartbeat threads blocks process shutdown (#2778) Nov 13, 2018
dubbo-rpc [REFACTOR]:[fix typo] (#2804) Nov 19, 2018
dubbo-serialization add checkstyle rule to check import order (#2745) Nov 8, 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 Add compatible module and rename groupId to org.apache.dubbo (#1952) Jun 19, 2018
README.md oschina vote (#2786) Nov 14, 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 Merge pull request #2725, problems of graceful shutdown in 2.6.3 and … Nov 5, 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 :)

各位 Dubboer,开源中国正在举办 2018 年度最受欢迎中国开源软件评比活动,请投 Dubbo 一票。

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.4</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.