dubbo/dubbo-demo
liufarui 322a49e153
dubbo-demo-xml-consumer use correct metadata-report address (#9511)
2022-01-23 16:51:04 +08:00
..
dubbo-demo-annotation Update @Service And @Reference with @DubboService and @DubboReference (#6355) 2020-07-08 14:01:05 +08:00
dubbo-demo-api [Enhancement] Adding a build tools module for Apache License (#6060) 2020-04-26 16:19:23 +08:00
dubbo-demo-interface Merge branch 'cloud-native' into master-merged-performance-cloudnative 2019-10-10 21:15:18 +08:00
dubbo-demo-xml dubbo-demo-xml-consumer use correct metadata-report address (#9511) 2022-01-23 16:51:04 +08:00
README.md Add -jar for java command in dubbo-demo readme file (#4517) 2019-07-10 13:27:11 +08:00
pom.xml Fix service discovery impls and UTs after backported some 3.0 features (#7236) 2021-02-24 10:42:07 +08:00

README.md

Dubbo Demo

This directory contains basic usages of Dubbo to help Dubbo developers for debugging and smoke test purpose. If you are looking for Dubbo samples for study purpose, you should look into here where you will find comprehensive usages for how to use Dubbo in different scenarios with the different features.

How To Build

To build all demo applications from the source code, simply step into 'dubbo-demo' directory and use maven to build:

mvn clean package

After build completes, a couple of fat jars are generated under 'target' directory under each module directories, for example: 'dubbo-demo-api-provider-${project.version}.jar' can be found under the directory 'dubbo-demo/dubbo-demo-api/dubbo-demo-api-provider/target'.

How To Run

Since the generated artifacts are fat jars backed by spring boot maven plugin, they can be executed directly with 'java -jar', and since multicast is used for service registration, a necessary system property '-Djava.net.preferIPv4Stack=true' is required in order to registry and discover the demo service properly.

Use 'dubbo-demo/dubbo-demo-api' as an example, to start the provider 'dubbo-demo-api-provider', execute the following command:

java -Djava.net.preferIPv4Stack=true -jar dubbo-demo-api-provider-${project.version}.jar

To run the consumer 'dubbo-demo-api-consumer', execute the following command:

java -Djava.net.preferIPv4Stack=true -jar dubbo-demo-api-consumer-${project.version}.jar