Apache Dubbo Project
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
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
2.7.7
org.apache.dubbo
dubbo
${dubbo.version}
org.apache.dubbo
dubbo-dependencies-zookeeper
${dubbo.version}
pom
Define service interfaces
package org.apache.dubbo.samples.api;
public interface GreetingsService {
String sayHi(String name);
}
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;
}
}
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 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();
}
}
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 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);
}
}
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
Your first Dubbo application - A 101 tutorial to reveal more details, with the same code above.
Dubbo user manual - How to use Dubbo and all its features.
Dubbo developer guide - How to involve in Dubbo development.
Dubbo admin manual - How to admin and manage Dubbo services.
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
Mailing list:
dev list: for dev/user discussion. subscribe, unsubscribe, archive, guide
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.
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 [email protected] 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
Dubbo Ecosystem Entry - A GitHub group dubbo to gather all Dubbo relevant projects not appropriate in apache group yet
Dubbo Website - Apache Dubbo official website
Dubbo Samples - samples for Apache Dubbo
Dubbo Spring Boot - Spring Boot Project for Dubbo
Dubbo Admin - The reference implementation for Dubbo admin
Dubbo Awesome - Dubbo's slides and video links in Meetup
Language
License
Apache Dubbo is under the Apache 2.0 license. See the LICENSE file for details.