Google Git
Sign in
apache / dubbo-js / HEAD
commitc7f7c05fcd23209929d8ab677318d7fc45e90c47[log] [tgz]
authorKen Liu <ken.lj.hz@gmail.com>Thu Apr 25 15:48:29 2024 +0800
committerGitHub <noreply@github.com>Thu Apr 25 15:48:29 2024 +0800
tree0e032454dab579367dc01581a5e87ad1688485d6
parentb9d8eb55e93b6c2eccf332a5bf49657523771ca6 [diff]
parent5f216fad689655c2eff12d6f116b0cb89ec55185 [diff]
Merge pull request #389 from 0808zhongshang/dubbo3

docs
tree: 0e032454dab579367dc01581a5e87ad1688485d6
  1. .github/
  2. .husky/
  3. .vscode/
  4. docs/
  5. example/
  6. internal/
  7. lint/
  8. packages/
  9. .asf.yaml
  10. .editorconfig
  11. .eslintrc.js
  12. .gitignore
  13. .npmrc
  14. .prettierignore
  15. .prettierrc
  16. CHANGE.md
  17. CODE_OF_CONDUCT.md
  18. commitlint.config.js
  19. CONTRIBUTING.md
  20. LICENSE
  21. Makefile
  22. NOTICE
  23. package.json
  24. pnpm-lock.yaml
  25. pnpm-workspace.yaml
  26. README.md
  27. tsconfig.base.json
README.md

Apache Dubbo for ECMAScript

License Build

Apache Dubbo is an easy-to-use Web and RPC framework that provides different language implementations(Java, Go, Rust, Node.js, Javascript) for communication, service discovery, traffic management, observability, security, tools, and best practices for building enterprise-ready microservices.

Dubbo-js is the TypeScript implementation of Dubbo triple protocol (a fully gRPC compatible and http friendly protocol), which can be used for Node.js and web application development. With dubbo-js, you can easily build applications working on browser and frontend that can communicate with backend services through http-based protocol.

arc

Get Started

The following two demos will guide you on how to create Node.js backend and web applications using dubbo-js.

You can call backend Dubbo services with type-safe APIs:

const resp = await client.say({sentence: "Hello, Dubbo."});
console.log(resp);

Or, you can curl them if you want:

curl \
 --header 'Content-Type: application/json' \
 --data '{"sentence": "Hello World"}' \
 http://localhost:8080/apache.dubbo.demo.example.v1.ExampleService/Say

Get started on the web

Follow this guide to learn how to develop web applications that can access backend Dubbo services and running on browser.

We support all modern web browsers that implement the widely available fetch API and the Encoding API.

Get started on Node.js

Follow this guide here to learn how to develop and spin up a backend Dubbo service in Node.js, and call it from cURL, the web browser, or a Dubbo client in your terminal.

In addition, Dubbo integrates middlewares such as express, fastify, and next, making it easier for users to build a Dubbo distributed service framework using Node.js.

Service Governance features

Besides rpc protocol, we plan to provide dubbo-js rich service governance features so it can work seamlessly with other microservice architecture.

The features listed below are still under development, we will update each feature's status once ready.

  • :construction: Service Discovery:

Nacos, Zookeeper, Kubernetes, etc.

  • :construction: Load Balance:

Random, RoundRobin, LeastActive, ConsistentHash, etc.

  • :construction: Traffic Routing: Traffic split, Circuit breaking, Canary release, etc.

  • :construction: Filter: Token, AccessLog, Rate limiting, etc.

  • :construction: Metrics: Prometheus

  • :construction: Tracing: Jaeger, Zipkin

How to contribute

Please check CONTRIBUTING for how to contribute to this project.

Connect us

Search Dingding group number and join us: 27690019068

Credit

This project is based on bufbuild/connect-es, an open-source project released under Apache License v2. Comparing to connect-es, dubbo-js removed the unused grpc-web and connect protocol, added support for Dubbo protocol, no-idl programming api and many service governance features.

We have a announcement in our LICENSE file and keep all license headers of files come from connect-es unchanged.