EWD 3トレーニングコース#19 JavaScriptからGlobalストレジにアクセスする

1. EWD 3
トレーニング・コース #19
JavaScript から Global ストレージ
をアクセスする: NodeM API
M/Gateway Developments Ltd.
Rob Tweed
訳: 日本ダイナシステム株式会社 嶋 芳成
GT.M版編集: 澤田 潔
※ 本稿オリジナルはCache’向けとして編纂

2. NodeM
• NodeM インターフェース・モジュールを用いることで、
JavaScript から GT.M データベースにアクセスするこ
とができます
2016/9/30 EWD 3 トレーニング・コース #19 2

3. NodeM
• NodeM モジュールは、cache.nodeと等価であり
オープン・ソースのエミュレーションとして、JavaScript
から同じ方法で GT.M データベースにアクセスすること
ができます
• https://github.com/dlwicksell/nodem
2016/9/30 EWD 3 トレーニング・コース #19 3

4. cache.node と NodeM の API
• ewd-xpress アプリケーションの中で、次のようにアク
セスすることができます
this.db.someFunctionName()
2016/9/30 EWD 3 トレーニング・コース #19 4

5. インターフェース・モジュールの読込みと初期化
• このステップは、ewd-xpress によって自動的に実行
されます
• ここでは、手動でどのようにするかを説明します...
2016/9/30 EWD 3 トレーニング・コース #19 5

6. NodeM API
• NodeM の読み込み
require(‘./setEnvironment’); // GT.M環境変数をセット
var interface = require(‘nodem’); // NodeM I/F
var db = new interface.Gtm(); // GT.M DB インスタンス
2016/9/30 EWD 3 トレーニング・コース #19 6

7. NodeM API
• GT.M への接続を開く
db.open();
2016/9/30 EWD 3 トレーニング・コース #19 7

8. NodeM API
• Caché への接続を開く
db.open({
path: '/opt/cache/mgr',
username: '_SYSTEM',
password: 'SYS',
namespace: 'USER',
charset: 'UTF-8',
lock: 0
});
2016/9/30 EWD 3 トレーニング・コース #19 8

9. NodeM API
• GT.M への接続を閉じる
var ok = db.close();
2016/9/30 EWD 3 トレーニング・コース #19 9

10. NodeM API
• NodeM を読み込む
require(‘./setEnvironment’);
var interface = require('nodem');
var db = new interface.Gtm();
2016/9/30 EWD 3 トレーニング・コース #19 10

11. NodeM API
• GT.M への接続を開く
db.open();
2016/9/30 EWD 3 トレーニング・コース #19 11

12. NodeM API
• GT.M への接続を開く
db.open();
これ以降、API はすべて cache.node で用いられる
ものと同一です
2016/9/30 EWD 3 トレーニング・コース #19 12

13. NodeM API
• GT.M への接続を閉じる
var ok = db.close();
即ち、cache.node と同じです
2016/9/30 EWD 3 トレーニング・コース #19 13

14. テスト・アプリを設定します
• ewd-xpress には例題も用意してあります
• ~/ewd3/node_modules/ewd-xpress/example.test.js
• あなたの GT.M の構成に合わせて編集してください
2016/9/30 EWD 3 トレーニング・コース #19 14

15. GT.M環境変数定義ファイルを編集
2016/9/30 EWD 3 トレーニング・コース #19 15
cd ~/ewd3
vi ./setEnvironment
export gtmdir="$HOME/.fis-gtm"
export gtmver="V6.2-002A_x86_64“
export gtm_icu_version=5.0
export gtm_chset="utf-8“
export gtm_dist="/usr/lib/fis-gtm/$gtmver2/utf8“
export gtmgbldir=$gtmdir/$gtmver/g/gtm.gld
export gtmgbldir="/home/mta/.fis-gtm/V6.2-002A_x86_64/g/gtm.gld“
export gtmroutines="$gtm_dist” $HOME/ewdjs/node_modules/nodem/src"
export PATH=$PATH:$gtm_dist
# Define aliases
alias gtm="$gtm_dist/gtm"

16. test.js を編集する
require('./setEnvironment'); // GT.M環境変数をセット
var interface = require('nodem');
var db = new interface.Gtm();
console.log('db: ' + JSON.stringify(db));
// 以下のパラメータは、あなたのGlobalDB または Caché システムに合わせて変更します
var ok = db.open();
console.log('ok: ' + JSON.stringify(ok));
console.log(db.version());
var node = {
global: 'rob',
subscripts: [1],
data: 'hello'
};
db.set(node);
var result = db.get(node);
console.log(JSON.stringify(result));
db.close();
2016/9/30 EWD 3 トレーニング・コース #19 16

17. test.js を編集する
require('./setEnvironment'); // GT.M環境変数をセット
var interface = require('nodem');
var db = new interface.Gtm();
console.log('db: ' + JSON.stringify(db));
// 以下のパラメータは、あなたのGlobalDB または Caché システムに合わせて変更します
var ok = db.open();
console.log('ok: ' + JSON.stringify(ok));
console.log(db.version());
var node = {
global: 'rob',
subscripts: [1],
data: 'hello'
};
db.set(node);
var result = db.get(node);
console.log(JSON.stringify(result));
db.close();
2016/9/30 EWD 3 トレーニング・コース #19 17

18. ~/ewd3/test.js として保存する
require('./setEnvironment'); // GT.M環境変数をセット
var interface = require('nodem');
var db = new interface.Gtm();
console.log('db: ' + JSON.stringify(db));
// 以下のパラメータは、あなたのGlobalDB または Caché システムに合わせて変更します
var ok = db.open();
console.log('ok: ' + JSON.stringify(ok));
console.log(db.version());
var node = {
global: 'rob',
subscripts: [1],
data: 'hello'
};
db.set(node);
var result = db.get(node);
console.log(JSON.stringify(result));
db.close();
2016/9/30 EWD 3 トレーニング・コース #19 18

19. 実行します
cd ~/ewd3
node test
2016/9/30 EWD 3 トレーニング・コース #19 19

20. 実行します
cd ~/ewd3
node test
db: {}
ok: {"ok":1,"result":"1"}
Node.js Adaptor for GT.M: Version: 0.6.2 (FWSLC); GT.M V6.2-002A Linux
x86_64
{"ok":1,"global":"rob","data":"hello","defined":1,"subscripts":[1]}
2016/9/30 EWD 3 トレーニング・コース #19 20

21. testプログラムとewd-xpress間の１つの違い
• test プログラム: NodeM API を次のように呼び出し
ます
• db.xxx()
• ewd-xpress ワーカー・モジュールでは
• this.db.xxx()
2016/9/30 EWD 3 トレーニング・コース #19 21

22. testプログラムとewd-xpress間の１つの違い
• test プログラム: NodeM API を次のように呼び出し
ます
• db.xxx()
2016/9/30 EWD 3 トレーニング・コース #19 22
db.set(node)
var result = db.get(node);
console.log(JSON.stringify(result));
db.close();

23. testプログラムとewd-xpress間の１つの違い
• ewd-xpress ワーカー・モジュールで
• this.db.xxx()
• 注意: ewd-xpress は、ワーカーが停止するとデータベースを
自動的に閉じます
2016/9/30 EWD 3 トレーニング・コース #19 23
this.db.set(node)
var result = db.get(node);
console.log(JSON.stringify(result));

24. 基本的なグローバル API
2016/9/30 EWD 3 トレーニング・コース #19 24

25. Global ストレージ操作 API
• グローバル節にアクセスする
• set
• get
• delete (kill)
2016/9/30 EWD 3 トレーニング・コース #19 25

26. Global ストレージ操作 API
• グローバル節を定義します
var node = {
global: 'employee',
subscripts: [123456, 'name']
};
2016/9/30 EWD 3 トレーニング・コース #19 26

27. Global ストレージ操作 API
• グローバル節を定義します
var node = {
global: 'employee',
subscripts: [123456, 'name']
};
employee(123456,"name")
2016/9/30 EWD 3 トレーニング・コース #19 27

28. Global ストレージ操作 API
• グローバル節にアクセスする
• set
node.data = 'Rob Tweed';
this.db.set(node);
2016/9/30 EWD 3 トレーニング・コース #19 28

29. Global ストレージ操作 API
• グローバル節にアクセスする
• get
var value = this.db.get(node).data;
2016/9/30 EWD 3 トレーニング・コース #19 29

30. Global ストレージ操作 API
• グローバル節にアクセスする
• kill
this.db.kill(node)
2016/9/30 EWD 3 トレーニング・コース #19 30

31. Global 添字を横断する
2016/9/30 EWD 3 トレーニング・コース #19 31

32. Global ストレージ操作 API
• グローバル節を横断する
• 添字を横切って操作する
2016/9/30 EWD 3 トレーニング・コース #19 32

33. Global ストレージ操作 API
• グローバル節を横断する
• 階層構造のあるレベルの添字を横切って操作する
2016/9/30 EWD 3 トレーニング・コース #19 33
myGlobal("a")=123
myGlobal("b","c1")="foo"
myGlobal("b","c2")="foo2"
myGlobal("d","e1","f1")="bar1"
myGlobal("d","e1","f2")="bar2"
myGlobal("d","e2","f1")="bar1"
myGlobal("d","e2","f2")="bar2"
myGlobal("d","e2","f3")="bar3"
myGlobal
"a" 123
"b"
"c1" "foo"
"c2" "foo2"
"d"
"e1"
"e2"
"f1" "bar1"
"f2" "bar2"
"f1" "bar1"
"f2" "bar2"
"f3" "bar3"
"a", "b", "d"

34. Global ストレージ操作 API
• グローバル節を横断する
• 階層構造のあるレベルの添字を横切って操作する
2016/9/30 EWD 3 トレーニング・コース #19 34
myGlobal("a")=123
myGlobal("b","c1")="foo"
myGlobal("b","c2")="foo2"
myGlobal("d","e1","f1")="bar1"
myGlobal("d","e1","f2")="bar2"
myGlobal("d","e2","f1")="bar1"
myGlobal("d","e2","f2")="bar2"
myGlobal("d","e2","f3")="bar3"
myGlobal
"a" 123
"b"
"c1" "foo"
"c2" "foo2"
"d"
"e1"
"e2"
"f1" "bar1"
"f2" "bar2"
"f1" "bar1"
"f2" "bar2"
"f3" "bar3"
"e1", "e2"

35. Global ストレージ操作 API
• グローバル節を横断する
• 階層構造のあるレベルの添字を横切って操作する
2016/9/30 EWD 3 トレーニング・コース #19 35
myGlobal("a")=123
myGlobal("b","c1")="foo"
myGlobal("b","c2")="foo2"
myGlobal("d","e1","f1")="bar1"
myGlobal("d","e1","f2")="bar2"
myGlobal("d","e2","f1")="bar1"
myGlobal("d","e2","f2")="bar2"
myGlobal("d","e2","f3")="bar3"
myGlobal
"a" 123
"b"
"c1" "foo"
"c2" "foo2"
"d"
"e1"
"e2"
"f1" "bar1"
"f2" "bar2"
"f1" "bar1"
"f2" "bar2"
"f3" "bar3"
"f1", "f2", "f3"

36. Global ストレージ操作 API
2016/9/30 EWD 3 トレーニング・コース #19 36
myGlobal("d","e2","f1")="bar1"
myGlobal("d","e2","f2")="bar2"
myGlobal("d","e2","f3")="bar3"
"f1", "f2", "f3"

37. Global ストレージ操作 API
• Global節を横断する
var node = {
global: 'myGlobal',
subscripts: ['d', 'e2', '']
};
2016/9/30 EWD 3 トレーニング・コース #19 37
myGlobal("d","e2","f1")="bar1"
myGlobal("d","e2","f2")="bar2"
myGlobal("d","e2","f3")="bar3"
"f1", "f2", "f3"

38. Global ストレージ操作 API
• Global節を横断する
var node = {
global: 'myGlobal',
subscripts: ['d', 'e2', '']
};
2016/9/30 EWD 3 トレーニング・コース #19 38
myGlobal("d","e2","f1")="bar1"
myGlobal("d","e2","f2")="bar2"
myGlobal("d","e2","f3")="bar3"
"f1", "f2", "f3"
繰り返し処理の初期値
空文字列

39. Global ストレージ操作 API
• Global節を横断する
var node = {
global: 'myGlobal',
subscripts: ['d', 'e2', '']
};
var subscript = this.db.order(node).result;
// f1
2016/9/30 EWD 3 トレーニング・コース #19 39
myGlobal("d","e2","f1")="bar1"
myGlobal("d","e2","f2")="bar2"
myGlobal("d","e2","f3")="bar3"
"f1", "f2", "f3"

40. Global ストレージ操作 API
• Global節を横断する
var node = {
global: 'myGlobal',
subscripts: ['d', 'e2', '']
};
var subscript = this.db.order(node).result;
// f1
subscript = this.db.order(node).result;
// f2
2016/9/30 EWD 3 トレーニング・コース #19 40
myGlobal("d","e2","f1")="bar1"
myGlobal("d","e2","f2")="bar2"
myGlobal("d","e2","f3")="bar3"
"f1", "f2", "f3"

41. Global ストレージ操作 API
• Global節を横断する
var node = {
global: 'myGlobal',
subscripts: ['d', 'e2', '']
};
var subscript = this.db.order(node).result;
// f1
subscript = this.db.order(node).result;
// f2
subscript = this.db.order(node).result;
// f3
2016/9/30 EWD 3 トレーニング・コース #19 41
myGlobal("d","e2","f1")="bar1"
myGlobal("d","e2","f2")="bar2"
myGlobal("d","e2","f3")="bar3"
"f1", "f2", "f3"

42. Global ストレージ操作 API
• Global節を横断する
var node = {
global: 'myGlobal',
subscripts: ['d', 'e2', '']
};
var subscript = this.db.order(node).result;
// f1
subscript = this.db.order(node).result;
// f2
subscript = this.db.order(node).result;
// f3
subscript = this.db.order(node).result;
// ''
2016/9/30 EWD 3 トレーニング・コース #19 42
myGlobal("d","e2","f1")="bar1"
myGlobal("d","e2","f2")="bar2"
myGlobal("d","e2","f3")="bar3"
"f1", "f2", "f3"

43. Global ストレージ操作 API
• Global節を横断する
var node = {
global: 'myGlobal',
subscripts: ['d', 'e2', 'f2']
};
var subscript = this.db.order(node).result;
// f3
2016/9/30 EWD 3 トレーニング・コース #19 43
myGlobal("d","e2","f1")="bar1"
myGlobal("d","e2","f2")="bar2"
myGlobal("d","e2","f3")="bar3"
"f1", "f2", "f3"
繰り返し処理の初期値
空文字列

44. Global ストレージ操作 API
• Global節を横断する
var subscript = this.db.order(node).result;
// f3
Global節の現状:
{
global: 'myGlobal',
subscripts: ['d', 'e2', 'f3']
};
2016/9/30 EWD 3 トレーニング・コース #19 44
myGlobal("d","e2","f1")="bar1"
myGlobal("d","e2","f2")="bar2"
myGlobal("d","e2","f3")="bar3"
"f1", "f2", "f3"

45. Global ストレージ操作 API
• Global節を横断する
var node = {
global: 'myGlobal',
subscripts: ['d', 'e2', 'f2']
};
var subscript = this.db.order(node).result;
// f3
var subscript = this.db.order(node).result;
// ''
空文字列は、これ以上添字がないことを示します
2016/9/30 EWD 3 トレーニング・コース #19 45
myGlobal("d","e2","f1")="bar1"
myGlobal("d","e2","f2")="bar2"
myGlobal("d","e2","f3")="bar3"
"f1", "f2", "f3"

46. Global ストレージ操作 API
• Global節を横断する
var node = {
global: 'myGlobal',
subscripts: ['d', 'e2', 'f2']
};
var subscript;
do {
subscript = this.db.order(node).result;
if (subscript !== '') console.log(subscript);
}
while (subscript !== '');
2016/9/30 EWD 3 トレーニング・コース #19 46
myGlobal("d","e2","f1")="bar1"
myGlobal("d","e2","f2")="bar2"
myGlobal("d","e2","f3")="bar3"
"f1", "f2", "f3"

47. この API は低水準です
• Globalストレージにアクセスする基本機能を提供する
ために慎重に設計されています
• アプリケーション開発者がGlobalストレージの機構につ
いて理解していることを前提としています
• JavaScriptによる開発のためには低水準過ぎます
• 特に、添え字を縦断する機能は多くのコードを必要とします
• しかし、もっとJavaScript中心の見方からすると、抽
象化は可能です
• この問題について、このコースの次のパートで扱います
2016/9/30 EWD 3 トレーニング・コース #19 47