@adempiere/grpc-api 中文文档教程

Question

ADempiere gRPC-API library to Node.js

ADempiere node.js 为 gRPC 服务用 JavaScript 编写，目前用作代理 ADempiere 服务的库并发布为 NPM

• ADempiere-gRPC-Server, docker image erpya/adempiere-grpc-all-in-one.

另请参阅：

• ADempiere-Vue, docker image erpya/adempiere-vue. service, use it for connect with:
• Proxy-Adempiere-API, docker image erpya/proxy-adempiere-api.

Using it

# installing via NPM
npm install @adempiere/grpc-api --save

# installing via Yarn
yarn add @adempiere/grpc-api

A Example

这里有一个使用来自 Proxy of 的示例ADempiere API：https://github.com/adempiere/proxy-adempiere-api/blob/master/src/modules/adempiere-api/index.ts#L17

Recreate proto stub class (only for contribute to project)

对于重新创建存根类，您必须遵循：

• protobuf
• protoc
• Also you can see it: gRPC-web
• gRPC
• gRPC-Node

Install prerequisites for proto stub generation

Install Proto C

# Get the latest version number of protoc
LATEST_VERSION=$(curl --silent "https://api.github.com/repos/protocolbuffers/protobuf/releases/latest" |
    grep -Po '"tag_name": "\K.*?(?=")' |
    sed -E 's|v||g')

ARCHITECTURE=$(arch)

ZIP_FILE=protoc-$1-linux-$ARCHITECTURE.zip

# Download latest version
URL="https://github.com/protocolbuffers/protobuf/releases/download/v$LATEST_VERSION/$ZIP_FILE"
curl -OL $URL

# Extract and overwrite into dir
sudo unzip -o $ZIP_FILE -d /usr/local bin/protoc
sudo unzip -o $ZIP_FILE -d /usr/local 'include/*'

# Delete donwloaded file
rm -f -v $ZIP_FILE

# Assign read and execute permissions
sudo chmod 755 /usr/local/bin/protoc
sudo chmod 755 -R /usr/local/include/google/

安装完成后，检查版本

protoc --version

Install Proto C Gen gRPC Web

如果在客户端处理 gRPC，这仅用于生成存根。

# Get the latest version number of protoc-gen-grpc-web
LATEST_VERSION=$(curl --silent "https://api.github.com/repos/grpc/grpc-web/releases/latest" |
    grep -Po '"tag_name": "\K.*?(?=")' |
    sed -E 's|v||g')

FILE=protoc-gen-grpc-web

# Download
URL=https://github.com/grpc/grpc-web/releases/download/$LATEST_VERSION/$FILE-$1-linux-x86_64
curl -L $URL -o $FILE

# Extract and overwrite into dir
sudo mv -f -v $FILE /usr/local/bin/

# Assign read and execute permissions
sudo chmod 755 /usr/local/bin/$FILE

Install gRPC Tools (Node Proto C)

尽管它已经作为项目依赖项进行管理，但它可以作为全局依赖项安装。

通过 npm：

sudo npm install -g grpc-tools

通过 yarn：

yarn global add grpc-tools

Generate Proto Stub:

Generate with npm (Recommended):

# install dependecies and dev dependencies
npm i

# generate all stub
npm run stub

注意生成特定的 proto 定义：

• To access: npm run stub:access
• To base data type: npm run stub:base_data_type
• To business: npm run stub:business
• To client: npm run stub:client
• To core functionality: npm run stub:core_functionality
• To dictionary: npm run stub:dictionary
• To enrollment: npm run stub:enrollment
• To point of sales: npm run stub:point_of_sales

Generate directly with grpctoolsnode_protoc:

生成所有存根：

grpc_tools_node_protoc \
    --js_out=import_style=commonjs,binary:src/grpc \
    --grpc_out=src/grpc \
    proto/access.proto proto/base_data_type.proto proto/business.proto proto/client.proto proto/core_functionality.proto proto/dictionary.proto proto/enrollment.proto proto/point_of_sales.proto
    # --grpc-web_out=import_style=commonjs,mode=grpcwebtext:$OUT_DIR

• To access:

# Generate stub to access.proto file
grpc_tools_node_protoc \
    proto/access.proto \
    --js_out=import_style=commonjs,binary:$OUT_DIR  \
    --grpc_out=grpc_js:$OUT_DIR
    # --grpc-web_out=import_style=commonjs,mode=grpcwebtext:$OUT_DIR

• To base data type:

# Generate stub to base_data_type.proto file
grpc_tools_node_protoc \
    proto/base_data_type.proto \
    --js_out=import_style=commonjs,binary:$OUT_DIR  \
    --grpc_out=grpc_js:$OUT_DIR
    # --grpc-web_out=import_style=commonjs,mode=grpcwebtext:$OUT_DIR

• To business:

# Generate stub to business.proto file
grpc_tools_node_protoc \
    proto/business.proto \
    --js_out=import_style=commonjs,binary:$OUT_DIR  \
    --grpc_out=grpc_js:$OUT_DIR
    # --grpc-web_out=import_style=commonjs,mode=grpcwebtext:$OUT_DIR

• To client:

# Generate stub to client.proto file
grpc_tools_node_protoc \
    proto/access.proto \
    --js_out=import_style=commonjs,binary:$OUT_DIR  \
    --grpc_out=grpc_js:$OUT_DIR
    # --grpc-web_out=import_style=commonjs,mode=grpcwebtext:$OUT_DIR

• To core functionality:

# Generate stub to access.proto file
grpc_tools_node_protoc \
    proto/core_functionality.proto \
    --js_out=import_style=commonjs,binary:$OUT_DIR  \
    --grpc_out=grpc_js:$OUT_DIR
    # --grpc-web_out=import_style=commonjs,mode=grpcwebtext:$OUT_DIR

• To dictionary:

# Generate stub to access.proto file
grpc_tools_node_protoc \
    proto/dictionary.proto \
    --js_out=import_style=commonjs,binary:$OUT_DIR  \
    --grpc_out=grpc_js:$OUT_DIR
    # --grpc-web_out=import_style=commonjs,mode=grpcwebtext:$OUT_DIR

• To enrollment:

# Generate stub to access.proto file
grpc_tools_node_protoc \
    proto/enrollment.proto \
    --js_out=import_style=commonjs,binary:$OUT_DIR  \
    --grpc_out=grpc_js:$OUT_DIR
    # --grpc-web_out=import_style=commonjs,mode=grpcwebtext:$OUT_DIR

• To point of sales:

# Generate stub to access.proto file
grpc_tools_node_protoc \
    proto/point_of_sales.proto \
    --js_out=import_style=commonjs,binary:$OUT_DIR  \
    --grpc_out=grpc_js:$OUT_DIR
    # --grpc-web_out=import_style=commonjs,mode=grpcwebtext:$OUT_DIR

Output proto stub

结果生成在：src/grpc/proto/ 文件

• access_grpc_pb.js
• access_pb.js
• base_data_type_grpc_pb.js
• base_data_type_pb.js
• business_grpc_pb.js
• business_pb.js
• client_grpc_pb.js
• client_pb.js
• core_functionality_grpc_pb.js
• core_functionality_pb.js
• dictionary_grpc_pb.js
• dictionary_pb.js
• enrollment_grpc_pb.js
• enrollment_pb.js
• point_of_sales_grpc_pb.js
• point_of_sales_pb.js

Sponsors

夹指向您网站的链接。 成为赞助商