# hprose-nodejs
**Repository Path**: andot/hprose-nodejs
## Basic Information
- **Project Name**: hprose-nodejs
- **Description**: Hprose 全名是高性能远程对象服务引擎。 它是一个新型的轻量级跨语言跨平台面向对象的高性能远程动态通讯中间件。它不但易学易用，而且功能强大。本项目是 Hprose 的 Node.js 版本实现。
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: http://hprose.com
- **GVP Project**: No
## Statistics
- **Stars**: 19
- **Forks**: 6
- **Created**: 2014-08-02
- **Last Updated**: 2022-05-28
## Categories & Tags
**Categories**: web-dev-toolkits
**Tags**: None
## README
# Hprose for Node.js
[](https://gitter.im/hprose/hprose-nodejs?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
[](https://www.npmjs.com/package/hprose)
[](https://david-dm.org/hprose/hprose-nodejs#info=optionalDependencies)
[](https://www.npmjs.com/package/hprose)
[](http://opensource.org/licenses/MIT)
>---
- **[简介](#简介)**
- **[使用](#使用)**
- **[Http 服务器](#http-服务器)**
- [同步函数或方法](#同步函数或方法)
- [异步函数或方法](#异步函数或方法)
- **[Http 客户端](#http-客户端)**
- [异常处理](#异常处理)
- **[Tcp 服务器与客户端](#tcp-服务器与客户端)**
- **[Unix Socket 服务器与客户端](#unix-socket-服务器与客户端)**
- **[WebSocket 服务器与客户端](#websocket-服务器与客户端)**
>---
## 简介
*Hprose* 是高性能远程对象服务引擎（High Performance Remote Object Service Engine）的缩写。
它是一个先进的轻量级的跨语言跨平台面向对象的高性能远程动态通讯中间件。它不仅简单易用，而且功能强大。你只需要稍许的时间去学习，就能用它轻松构建跨语言跨平台的分布式应用系统了。
*Hprose* 支持众多编程语言，例如：
* AAuto Quicker
* ActionScript
* ASP
* C++
* Dart
* Delphi/Free Pascal
* dotNET(C#, Visual Basic...)
* Golang
* Java
* JavaScript
* Node.js
* Objective-C
* Perl
* PHP
* Python
* Ruby
* ...
通过 *Hprose*，你就可以在这些语言之间方便高效的实现互通了。
本项目是 Hprose 的 Node.js 语言版本实现。
更多 Hprose 2.0 for Node.js 文档: https://github.com/hprose/hprose-nodejs/wiki
## 使用
### Http 服务器
#### 同步函数或方法
Hprose for Node.js 使用很简单。你可用像这样创建 Hprose 服务器：
```javascript
var hprose = require("hprose");
function hello(name) {
return "Hello " + name + "!";
}
var server = hprose.Server.create("http://0.0.0.0:8080");
server.addFunction(hello);
server.start();
```
启动使用下面的命令：
node --harmony server.js
--harmony 是 v8 的一个选项，Hprose 使用该选项对序列化进行了优化。它不是必须的选项，但是建议使用它。
#### 异步函数或方法
事实上，大多数 Node.js 服务是异步的，你可以像这样来发布异步函数或方法：
```javascript
var hprose = require("hprose");
function hello(name, callback) {
setTimeout(function() {
callback("Hello " + name + "!");
}, 10);
}
var server = hprose.Server.create("http://0.0.0.0:8080");
server.addAsyncFunction(hello);
server.start();
```
### Http 客户端
然后你可用创建 Hprose 客户端像这样来调用它：
```javascript
var hprose = require("hprose");
var client = hprose.Client.create("http://127.0.0.1:8080/");
var proxy = client.useService();
proxy.hello("world", function(result) {
console.log(result);
});
```
使用如下命令启动它：
node --harmony client.js
或者
node --harmony-proxies client.js
如果没有 --harmony-proxies 参数，你需要这样创建远程调用代理对象：
```javascript
var hprose = require("hprose");
var client = hprose.Client.create("http://127.0.0.1:8080/");
var proxy = client.useService(["hello"]);
proxy.hello("world", function(result) {
console.log(result);
});
```
或者像这样创建客户端：
```javascript
var hprose = require("hprose");
var client = hprose.Client.create("http://127.0.0.1:8080/", ["hello"]);
client.hello("world", function(result) {
console.log(result);
});
```
#### 异常处理
如果服务器端发生错误，或者你的服务函数或方法抛出了异常，它将被发送到客户端。你可以在成功回调函数后面传入错误回调函数来接收它。如果你忽略该回调函数，客户端将忽略该异常，就像从来没发生过一样。
例如：
```javascript
proxy.hello("world", function(result) {
console.log(result);
}, function(name, err) {
console.error(err);
});
```
### Tcp 服务器与客户端
Tcp 服务器与客户端的使用跟 Http 服务器与客户端是一样的。
创建一个 Tcp 服务器：
```javascript
var server = hprose.Server.create("tcp://0.0.0.0:4321");
```
创建一个 Tcp 客户端：
```javascript
var client = hprose.Client.create('tcp://127.0.0.1:4321');
```
### Unix Socket 服务器与客户端
Unix Socket 服务器与客户端的使用跟 Http 服务器与客户端是一样的。
创建一个 Unix Socket 服务器：
```javascript
var server = hprose.Server.create("unix:/tmp/my.sock");
```
创建一个 Unix Socket 客户端：
```javascript
var client = hprose.Client.create('unix:/tmp/my.sock');
```
### WebSocket 服务器与客户端
WebSocket 服务器与客户端的使用跟 Http 服务器与客户端是一样的。
创建一个 WebSocket 服务器：
```javascript
var server = hprose.Server.create("ws://0.0.0.0:8080/");
```
创建一个 WebSocket 客户端：
```javascript
var client = hprose.Client.create('ws://0.0.0.0:8080/');
```
更多详细文档请参见：[Hprose for Node.js 用户手册](https://github.com/hprose/hprose-nodejs/wiki)