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/apache/incubator-dubbo-samples.git
    # cd incubator-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.7.0</dubbo.version>
    </properties>
        
    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.apache.dubbo</groupId>
                <artifactId>dubbo-dependencies-bom</artifactId>
                <version>${dubbo.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>
    
    <dependencies>
        <dependency>
            <groupId>org.apache.dubbo</groupId>
            <artifactId>dubbo</artifactId>
            <version>${dubbo.version}</version>
        </dependency>
        <dependency>
            <groupId>io.netty</groupId>
            <artifactId>netty-all</artifactId>
        </dependency>
        <dependency>
            <groupId>org.apache.curator</groupId>
            <artifactId>curator-framework</artifactId>
        </dependency>
        <dependency>
            <groupId>org.apache.curator</groupId>
            <artifactId>curator-recipes</artifactId>
        </dependency>
        <dependency>
            <groupId>org.apache.zookeeper</groupId>
            <artifactId>zookeeper</artifactId>
        </dependency>
    </dependencies>

    Define service interfaces

    package org.apache.dubbo.samples.api;
    
    public interface GreetingService {
        String sayHello(String name);
    }

    See api/GreetingService.java on GitHub.

    Implement service interface for the provider

    package org.apache.dubbo.samples.provider;
     
    import org.apache.dubbo.samples.api.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 org.apache.dubbo.config.ApplicationConfig;
    import org.apache.dubbo.config.RegistryConfig;
    import org.apache.dubbo.config.ServiceConfig;
    import org.apache.dubbo.samples.api.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 org.apache.dubbo.config.ApplicationConfig;
    import org.apache.dubbo.config.ReferenceConfig;
    import org.apache.dubbo.config.RegistryConfig;
    import org.apache.dubbo.samples.api.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 ecosystem

    Language

    License

    Apache Dubbo is under the Apache 2.0 license. See the LICENSE file for details.

    项目简介

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

    发行版本

    当前项目没有发行版本

    贡献者 209

    全部贡献者

    开发语言

    • Java 99.8 %
    • Shell 0.1 %
    • Lex 0.0 %
    • Batchfile 0.0 %
    • Thrift 0.0 %