Apache Dubbo is a high-performance, Java-based open-source RPC framework. Please visit the official site for the quick start guide and documentation, as well as the wiki for news, FAQ, and release notes.
We are now collecting Dubbo user info to help us to improve Dubbo further. Kindly support us by providing your usage information on issue#9436: Wanted: who's using dubbo, thanks :)
The following code snippet comes from Dubbo Samples. You may clone the sample project and step into the dubbo-samples-api
subdirectory before proceeding.
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. We recommend referencing the samples in that directory by following the below-mentioned instructions:
<properties> <dubbo.version>3.0.10</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>
package org.apache.dubbo.samples.api; public interface GreetingsService { String sayHi(String name); }
See api/GreetingsService.java on GitHub.
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.
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<>(); 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(); } }
See provider/Application.java on GitHub.
mvn clean package mvn -Djava.net.preferIPv4Stack=true -Dexec.mainClass=org.apache.dubbo.samples.provider.Application exec:java
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<>(); 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); } }
See client/Application.java on GitHub.
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.
If you want to try out the cutting-edge features, you can build with the following commands. (Java 1.8 is needed to build the master branch)
mvn clean install
To avoid intermittent test failures (i.e., flaky tests), it is recommended to have a machine or virtual machine with the following specifications:
Mailing list:
Bugs: Issues
Gitter: Gitter channel
Twitter: @ApacheDubbo
See CONTRIBUTING for details on submitting patches and the contribution workflow.
Good first issue
or Help wanted
.Please follow the template for reporting any issues.
Please report security vulnerabilities to us privately.
dubbo
to gather all Dubbo relevant projects not appropriate in apache group yetApache Dubbo software is licenced under the Apache License Version 2.0. See the LICENSE file for details.