Google Git
Sign in
apache / dubbo / refs/tags/dubbo-2.7.0
tag117a0042041aeb5ea113f05a94b83e065cb9d7de
taggerHuxing Zhang <huxing.zhang@gmail.com>Mon Jan 21 17:45:56 2019 +0800
object614bcebc01336ee5047a98f96b28915680c0399c 
[maven-release-plugin] copy for tag dubbo-2.7.0
commit614bcebc01336ee5047a98f96b28915680c0399c[log] [tgz]
authorHuxing Zhang <huxing.zhang@gmail.com>Mon Jan 21 17:45:46 2019 +0800
committerHuxing Zhang <huxing.zhang@gmail.com>Mon Jan 21 17:45:46 2019 +0800
treea3a69c33b9d46262ab9a49af20d60f90cab69615
parentdbc1f79effa1bd6c6c32c4e101ee13c6a78c04d5 [diff]
[maven-release-plugin] prepare release dubbo-2.7.0
86 files changed
tree: a3a69c33b9d46262ab9a49af20d60f90cab69615
  1. .github/
  2. .mvn/
  3. codestyle/
  4. dubbo-all/
  5. dubbo-bom/
  6. dubbo-cluster/
  7. dubbo-common/
  8. dubbo-compatible/
  9. dubbo-config/
  10. dubbo-configcenter/
  11. dubbo-container/
  12. dubbo-demo/
  13. dubbo-dependencies-bom/
  14. dubbo-distribution/
  15. dubbo-filter/
  16. dubbo-metadata-report/
  17. dubbo-metrics/
  18. dubbo-monitor/
  19. dubbo-plugin/
  20. dubbo-registry/
  21. dubbo-remoting/
  22. dubbo-rpc/
  23. dubbo-serialization/
  24. dubbo-test/
  25. .codecov.yml
  26. .gitignore
  27. .travis.yml
  28. CHANGES.md
  29. CODE_OF_CONDUCT.md
  30. CONTRIBUTING.md
  31. DISCLAIMER
  32. LICENSE
  33. mvnw
  34. mvnw.cmd
  35. NOTICE
  36. pom.xml
  37. PULL_REQUEST_TEMPLATE.md
  38. README.md
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 :)

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

<properties>
    <dubbo.version>2.6.5</dubbo.version>
</properties>
    
<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>dubbo-dependencies-bom</artifactId>
            <version>${dubbo.version}</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

<dependencies>
    <dependency>
        <groupId>com.alibaba</groupId>
        <artifactId>dubbo</artifactId>
        <version>${dubbo.version}</version>
    </dependency>
    <dependency>
        <groupId>io.netty</groupId>
        <artifactId>netty-all</artifactId>
    </dependency>
</dependencies>

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?

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.