chenmiu / ts-dde

使用typescript编写的Dynamic Data Exchange (DDE) 通信模块

ts-dde

Dynamic Data Exchange (DDE) 动态数据交换模块

此模块基于node-dde, 将原有edge依赖更新至edge-js 8.2.5,并使用typescript重构。

安装

npm install ts-dde --save

例子

Client

异步监听advise获取service-topic-item三级命名结构数据。

• 单个主题：

import { Client } from 'ts-dde';

const client = new Client({
    myapp: {
        mytopic1: ['myitem1', 'myitem2']
    }
});

client.on('advise', (service, topic, item, text) => {
  console.log('OnAdvise: '
    + 'Service: ' + service
    + ', Topic: ' + topic
    + ', Item: ' + item
    + ', Text: ' + text);
});

client.connect();

client.startAdvise();

• 多个主题：

import { Client } from 'ts-dde';

const client = new Client({
    myapp: {
        mytopic1: ['myitem1', 'myitem2'],
        mytopic2: ['myitem1', 'myitem2']
    }
});

client.on('advise', (service, topic, item, text) => {
  console.log('OnAdvise: '
    + 'Service: ' + service
    + ', Topic: ' + topic
    + ', Item: ' + item
    + ', Text: ' + text);
});

client.connect();

client.startAdvise();

Server

异步推送advise数据至客户端:

import { Server } from 'ts-dde';

const server = new Server('myapp');

server.on('disconnect', function(service, topic) {
  console.log('OnDisconnect: '
    + 'Service: ' + service
    + ', Topic: ' + topic);
});

server.on('advise', function(topic, item, format) {
  console.log('OnAdvise: '
    + 'Topic: ' + topic
    + ', Item: ' + item
    + ', Format: ' + format);
});

let i = 0;
server.onAdvise = function() {
  return 'advise-' + i++;
};

setInterval(function() { server.advise('*', '*'); }, 1000);

server.register();

方法

Client

方法名	说明	使用例
connect	连接服务器	client.connect()
disconnect	断开与服务器的连接	client.disconnect()
pause	暂停服务	client.pause()
resume	恢复服务	client.resume()
execute	通过指定的DDE通道，向应用程序发送一条或一组命令	client.execute(command, timeout)
poke	向应用程序发送数据	client.poke(item, data, timeout)
request	向接收应用程序查询信息,并以字符串方式返回该信息	client.request(item, format, timeout)
startAdvise	循环获取数据	client.startAdvise(item, format, hot, timeout)
stopAdvise	停止接收数据	client.stopAdvise(item, timeout)
beginExecute	开始发送命令	client.beginExecute(command, oncomplete)
beginPoke	开始发送数据	client.beginPoke(item, data, format, oncomplete)
beginRequest	开始请求数据	client.beginRequest(item, format, oncomplete)
beginStartAdvise	开始监听数据	client.beginStartAdvise(item, format, hot, oncomplete)
beginStopAdvise	开始停止监听	client.beginStopAdvise(item, oncomplete)
dispose	释放资源	client.dispose()
service	获取服务名	client.service()
topic	获取主题	client.topic()
isConnected	是否已连接	client.isConnected()
isPaused	是否已暂停	client.isPaused()

Server

方法名	说明	使用例
register	注册服务	server.register()
unregister	注销服务	server.unregister()
advise	建立数据传输接口	server.advise(topic, item)
disconnect	断开连接	server.disconnect()
pause	暂停服务	server.pause()
resume	恢复服务	server.resume()
dispose	释放资源	server.dispose()
service	获取服务名	server.service()
isRegistered	是否已注册	server.isRegistered()