/dubbo-js

Node.js native Apache Dubbo client on hessian

Primary LanguageTypeScriptApache License 2.0Apache-2.0

Apache Dubbo-js

Dubbo-js, using Node.js to embrace the Dubbo ecosystem. See this Demo to find how intelligent this project is.

Document

Node.js CI

Features

  • Various transport protocols (Hessian, JSON-RPC etc.) supports
  • Tracing (Runtime information, Call Stack)
  • Multiple registry centers (Zookeeper, Nacos, Redis) supports or connecting to services directly
  • Extensibility, inspired from Koa Middleware
  • Builtin reconnection strategy
  • Typescript type definitions
  • Tools to automatically translate Java interfaces to Typescript type definitions
  • Dubbox supports

Architecture

Getting Started

yarn add apache-dubbo-consumer

Usage

Below code snippet shows how to work with the typescript type definitions which automatically translated from Java interfaces.

// ===================== service.ts ==================
// generated by interpret tools
import { BasicTypeProvider } from './providers/org/apache/dubbo/demo/BasicTypeProvider'
import { DemoProvider } from './providers/org/apache/dubbo/demo/DemoProvider'
import { ErrorProvider } from './providers/org/apache/dubbo/demo/ErrorProvider'

export default {
  BasicTypeProvider,
  DemoProvider,
  ErrorProvider
}

// =============== dubbo.ts ========================
import { Dubbo, s } from 'apache-dubbo-consumer'
import service from './service'

// dubbo interface setting
const dubboSetting = s.Setting(
  s.service(
    [
      'org.apache.dubbo.demo.DemoProvider',
      'org.apache.dubbo.demo.ErrorProvider'
    ],
    { version: '1.0.0' }
  ),
  s.service('org.apache.dubbo.demo.BasicTypeProvider', { version: '2.0.0' })
)

// create dubbo object
const dubbo = new Dubbo<typeof service>({
  application: { name: 'dubbo-js' },
  // zookeeper address
  register: 'localhost:2181',
  dubboSetting,
  service
})

// main method
;(async () => {
  let { res, err } = await dubbo.service.DemoProvider.sayHello('node')
  // print {err: null, res:'hello node from dubbo service'}
  ;({ res, err } = await dubbo.service.DemoProvider.echo())
  // print {err: null, res: 'pang'}
  ;({ res, err } = await dubbo.service.DemoProvider.getUserInfo())
  // print {status: 'ok', info: { id: '1', name: 'test' }, err: null}
})()

The automatically translated typescript type definitions are not necessary, below code snippet demonstrates how to use dubbo-js without them.

// create the service to be injected
import { Dubbo } from 'apache-dubbo-consumer'

const demoProvider = (dubbo) =>
  dubbo.proxyService({
    dubboInterface: 'org.apache.dubbo.demo.DemoProvider',
    version: '1.0.0',
    methods: {
      sayHello(name) {
        return [java.String(name)]
      },

      echo() {},

      test() {},

      getUserInfo() {
        return [
          java.combine('org.apache.dubbo.demo.UserRequest', {
            id: 1,
            name: 'nodejs',
            email: 'node@test.com'
          })
        ]
      }
    }
  })

// integrate the service in demoProvider with dubbo object constructor
const service = {
  demoProvider
}

const dubbo = new Dubbo<typeof service>({
  // ....other parameters
  service
})

How to run a quick starter?

Make sure java, maven, docker, Node, Yarn is installed locally. If you'd like to contribute, it's a good start to follow below commands to get a locally runnable project.

# cd root dir
cd dubbo-js

# start java dubbo service
chmod 755 ./start_dubbo_service.sh
sh ./start_dubbo_service.sh

# build package module
make

# start node
cd example/hello-koa
# install node modules
yarn
# start web
yarn run debug:start
# test /hello
curl http://localhost:3000/hello

# or hello-egg example
cd example/hello-egg
yarn
yarn run dev
# test /hello
http://127.0.0.1:7001/hello

How to run all tests

cd dubbo-js
sh ./start_dubbo_service.sh
yarn
make
yarn run test

How to build dubbo-js module

git clone https://github.com/apache/dubbo-js.git
cd dubbo-js
npm install -g lerna
lerna bootstrap
make build-dubbo

Next steps

Guides

Reporting bugs

Please follow the template for reporting any issues.

Knowledge Sharing

2019-meetup by hufeng

Thanks

Dubbo-js will not work without:

Many thanks to their authors fengmk2 and dead-horse.

contact us

License

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