Github url

dubbo

by apache

apache /dubbo

Apache Dubbo is a high-performance, java based, open source RPC framework.

32.9K Stars 21.5K Forks Last release: about 2 months ago (dubbo-2.7.7) Apache License 2.0 4.4K Commits 69 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

Apache Dubbo Project

Build Statuscodecov maven licenseAverage time to resolve an issuePercentage of issues still openTweetGitter

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/java/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.7</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 GreetingsService { String sayHi(String name); }

See api/GreetingsService.java on GitHub.

Implement service interface for the provider

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; } }

See provider/GreetingsServiceImpl.java on GitHub.

Start service provider

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&lt;&gt;();
        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();
    }
}
</greetingsservice>

See provider/Application.java on GitHub.

Build and run the provider

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

Call remote service in consumer

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&lt;&gt;();
        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);
    }
}
</greetingsservice>

See consumer/Application.java on GitHub.

Build and run the consumer

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

The consumer will print out

hi, dubbo

on the screen.

Next steps

Building

If you want to try out the cutting-edge features, you can build 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?

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.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.