Giter VIP home page Giter VIP logo

drpc's Introduction

Drpc

codecov

Drpc is a high performance RPC framework, which aims to help users build their networking communications easily. The biggest feature to distinguish with other RPC frameworks is it supports multiple languages server.

Awesome Features

  • Multiple languages server and client
  • Asynchronous services in server
  • Dynamic registration for service
  • The ability for order preserving
  • High performance and easy to use

Quick Started

1. Build Project

mvn clean install -DskipTests

2. Run Server Example

Server example: ./example/src/main/java/com/distkv/drpc/pb/ExampleServer.java

3. Run Client Example

Client example: ./example/src/main/java/com/distkv/drpc/pb/ExampleServer.java

Examples

1. Server Example

import org.drpc.DrpcServer;
import org.drpc.config.ServerConfig;

public class ExampleServer {

  public static void main(String[] args) {
    ServerConfig serverConfig = ServerConfig.builder()
        .port(8080)
        .build();

    DrpcServer drpcServer = new DrpcServer(serverConfig);
    drpcServer.registerService(ExampleService.class, new ExampleServiceImpl());
    drpcServer.run();
  }
}

2. Client Example

import org.drpc.Stub;
import org.drpc.api.Client;
import org.drpc.config.ClientConfig;
import org.drpc.netty.DrpcClient;
import org.drpc.pb.generated.StringProtocol;
import org.drpc.session.DrpcSession;

import java.util.concurrent.CompletableFuture;

public class ExampleClient {

  public static void main(String[] args) throws Throwable {
    ClientConfig clientConfig = ClientConfig.builder()
        .address("127.0.0.1:8080")
        .build();

    Client client = new DrpcClient(clientConfig);
    client.open();

    Stub<ExampleService> stub = new Stub<>(ExampleService.class);
    ExampleService service = stub.getService(client);

    StringProtocol.PutRequest putRequest = StringProtocol.PutRequest.newBuilder()
        .setKey("dstPut")
        .setValue("PutValue")
        .build();

    StringProtocol.GetRequest getRequest = StringProtocol.GetRequest.newBuilder()
        .setKey("dstGet").build();

    //sync
    StringProtocol.GetResponse getResponse = service.get(getRequest).get();
    System.out.println(getResponse.getStatus());
    System.out.println(getResponse.getValue());
    StringProtocol.PutResponse putResponse = service.put(putRequest).get();
    System.out.println(putResponse.getStatus());

    //async
    CompletableFuture future1 = service.get(getRequest);
    future1.whenComplete((r, t) -> {
      if (t == null) {
        System.out.println(getResponse.getStatus());
        System.out.println(getResponse.getValue());
      }
    });

    CompletableFuture future2 = service.put(putRequest);
    future2.whenComplete((r, t) -> {
      if (t == null) {
        System.out.println(putResponse.getStatus());
      }
    });


    //session (keep order)
    DrpcSession session = DrpcSession.createSession();
    ExampleService sessionService = stub.getService(client, session);

    //async (keep order in server)
    CompletableFuture sessionFuture1 = sessionService.get(getRequest);
    sessionFuture1.whenComplete((r, t) -> {
      if (t == null) {
        System.out.println(getResponse.getValue());
      }
    });
    CompletableFuture sessionFuture2 = sessionService.put(putRequest);
    sessionFuture2.whenComplete((r, t) -> {
      if (t == null) {
        System.out.println(putResponse.getStatus());
      }
    });

    sessionFuture1.get();
    sessionFuture2.get();

    client.close();
  }
}

Roadmap

Done

  • Asynchronous services in server
  • Order preserving in one client context
  • Session concept for Order preserving

Doing

  • Go client and C++ client
  • Dynamic registration for service

Planned and TBD

  • Support Multiple languages for server
  • Load balance for services

Performance

TODO

Getting Involved

Thank you for your attention to the Drpc project. If you have any questions, you can create a new issue in our Issues list. And we welcome you to participate in our project. If you want to make some contributions, you can refer the file CONTRIBUTING.md.

drpc's People

Contributors

crm20230210 avatar dependabot[bot] avatar jovany-wang avatar kairbon avatar lovepoem avatar meijies avatar ou-taku14 avatar senyer avatar zhengrenjie avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar

drpc's Issues

Remove class URL

Remove class URL and replace with a more comprehensible class.

[IDL]Add drpcc tool to compile the proto file to service interface.

Add a compile tool of drpc to generate a java file from the following proto file.

# proto file
service DstDictService {
    rpc put(PutRequest) returns (PutResponse);
}

the auto-generated java file:

// java file
/// Auto-generated file by drpcc
package com.distkv.dst.rpc.service;

import com.distkv.dst.rpc.protobuf.generated.CommonProtocol;
import com.distkv.dst.rpc.protobuf.generated.ListProtocol;
import java.util.concurrent.CompletableFuture;

public interface DstListService {

  CompletableFuture<ListProtocol.PutResponse> put(ListProtocol.PutRequest request);

}

And note that we can use antlr4 to write the parser of drpcc

Enable codec to support multi-language RPC-client.

Description of method should not care args anymore. A ServerName and MethodName pair could determine which method should be invoked.
Method description map should be established when server has been registered.

Fix protocol bug

Question:
For example: a: //127.0.0.1: 8082 and b: //127.0.0.1: 8082 can successfully establish a connection.

It is unreasonable that a request can be established for any protocol. The agreement should be judged. If the agreement is incorrect, the corresponding prompt information of the user should be returned.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    πŸ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. πŸ“ŠπŸ“ˆπŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❀️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.