EWD 3トレーニングコース#20 GlobalストレージのJavaScript用抽象化-(a)DocumentNodeオブジェクト

EWD 3トレーニング・コース　 #20

Global ストレージの JavaScript 用の抽

象化 (a) DocumentNode オブジェクトM/Gateway Developments Ltd.

Rob Tweed訳 : 日本ダイナシステム株式会社　嶋　芳成

2

基本コンセプト

2016/9/11 EWD 3 トレーニング・コース #20

グローバルを表現する階層図

2016/9/11 EWD 3 トレーニング・コース #20 3

myGlobal("a")=123myGlobal("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"

2016/9/11 EWD 3 トレーニング・コース #20 4

Global 節の木構造と JavaScript オブジェクトとの 1 対 1 の対応


myGlobal = { a: 123, b: { c1: 'foo', c2: 'foo2' } d: { e1: { f1: 'bar1', f2: 'bar2' } e2: { f1: 'bar1', f2: 'bar2', f3: 'bar3' } }}

2016/9/11 EWD 3 トレーニング・コース #20 5

Global 節と JavaScript オブジェクトとの 1 対1 の対応


myGlobal = { a: 123, b: { c1: 'foo', c2: 'foo2' } d: { e1: { f1: 'bar1', f2: 'bar2' } e2: { f1: 'bar1', f2: 'bar2', f3: 'bar3' } }}

添え字　　　　　　　　プロパティ

6

• グローバル節

myGlobal("d","e2","f3")

• JavaScript オブジェクト

myGlobal.d.e2.f3



7




myGlobal.d.e2.f3



しかし ...

JavaScript オブジェクトはメモリー上にあり、グローバル節はディスク上にあり永続的です

8




myGlobal.d.e2.f3



グローバル節の抽象化を、永続的なJavaScript オブジェクトにすることができるでしょうか ?

ewd-document-store• Global ストレージの JavaScript 用抽象化

https://github.com/robtweed/ewd-document-store

• 基本的な cache.node API の上に搭載されます

2016/9/11 EWD 3 トレーニング・コース #20 9



• 基本的な cache.node API の上に搭載されます• ewd-xpress のワーカーの中に自動的に読み込まれま

す

2016/9/11 EWD 3 トレーニング・コース #20 10




す• ewd-xpress 内では this.documentStore でアクセ

スできます

2016/9/11 EWD 3 トレーニング・コース #20 11




す• ewd-xpress 内では this.documentStore でアクセ

スできます• テストとデバッグのために、それだけ ( スタンドアロ

ン ) でも利用可能です

2016/9/11 EWD 3 トレーニング・コース #20 12


• テストの枠組みの中で用いる• 次のサンプルを見てください

c:\ewd3\node_modules\ewd-qoper8-cahce\node_modules\ewd-document-store\lib\tests\CacheStandalone.js

2016/9/11 EWD 3 トレーニング・コース #20 13

14

CacheStandalone.js を編集するvar DocumentStore = require('ewd-document-store');var interface = require('cache');var db = new interface.cache();console.log('db: ' * JSON.stringify(db));// 次のパラメータをあなたの Caché システムに合わせて変更してくださいvar ok = db.open({ path: '/opt/cache/mgr', username: '_SYSTEM', password: 'SYS', namespace: 'USER'});console.log('ok: ' + JSON.stringify(ok));var documentStore = new DocumentStore(db);console.log(db.version());var rob = new documentStore.DocumentNode('rob');


15

CacheStandalone.js を編集するvar DocumentStore = require('ewd-qoper8-cache/node_modules/ewd-document-store');var interface = require('cache');var db = new interface.cache();console.log('db: ' * JSON.stringify(db));// 次のパラメータをあなたの Caché システムに合わせて変更してくださいvar ok = db.open({ path: 'c:\\InterSystems\\Cache2015-2\mgr', username: '_SYSTEM', password: 'SYS', namespace: 'USER'});console.log('ok: ' + JSON.stringify(ok));var documentStore = new DocumentStore(db);console.log(db.version());var rob = new documentStore.DocumentNode('rob');


16

c:\ewd3\docStoreTest.js として保存var DocumentStore = require('ewd-qoper8-cache/node_modules/ewd-document-store');var interface = require('cache');var db = new interface.cache();console.log('db: ' * JSON.stringify(db));// 次のパラメータをあなたの Caché システムに合わせて変更してくださいvar ok = db.open({ path: 'c:\\InterSystems\\Cache2015-2\mgr', username: '_SYSTEM', password: 'SYS', namespace: 'USER'});console.log('ok: ' + JSON.stringify(ok));var documentStore = new DocumentStore(db);console.log(db.version());var rob = new documentStore.DocumentNode('rob');


17

実行する

cd \ewd3node docStoreTest


18

実行する

cd \ewd3node docStoreTest

• これで、 DocumentNode オブジェクトを用いた一連のサンプルを実行します• これを、あなたのテスト用の基本的な枠組み

として利用することができます


19

あなたのテストの枠組みに合わせてくださいvar DocumentStore = require('ewd-qoper8-cache/node_modules/ewd-document-store');var interface = require('cache');var db = new interface.cache();

var ok = db.open({ path: 'c:\\InterSystems\\Cache2015-2\mgr', username: '_SYSTEM', password: 'SYS', namespace: 'USER'});

var documentStore = new DocumentStore(db);

// ここ先をすべて削除して置き換えてください// documentStore を用いると、あなたのデータベースへの抽象化されたインターフェースが利用できます

// これを用いて、この後のサンプルを試してください// this.documentStore を、 documentStrore に置き換えるだけです


20

DocumentNode オブジェクト


21

DocumentNode オブジェクトvar dnode = new documentStore.DocumentNode(name, subscripts);

スタンドアロンのテストの枠組みを用いるとき


22

DocumentNode オブジェクトvar dnode = new this.documentStore.DocumentNode(name, subscripts);

ewd-xpres を用いるとき


23


document store の階層構造の中の１つの節 ( ノード ) を表します

この時点では、それが物理的に存在するかどうかは分かりません

すなわち、これは節 ( ノード ) を生成しません


24


document store の階層構造の中の１つの節 ( ノード ) を表します

この時点では、それが物理的に存在するかどうかは分かりません

すなわち、これは節 ( ノード ) を生成しません

その節を表すオブジェクトのインスタンスと、その節を操作しアクセスするための、それに付随する一群のメソッドとプロパティを生成します


25

DocumentNode オブジェクトvar dnode = new this.documentStore.DocumentNode('myDoc', ['d','e2']);

これは、 mydoc("d","e2") を表します


26



　　生成 : dnode.value = 'foo2';


27



　　生成 : dnode.value = 'foo2';　　取得 : var x = dnode.value;


28



　　生成 : dnode.value = 'foo2';　　取得 : var x = dnode.value;

value は読み書きできるプロパティです


29



　　生成 : dnode.value = 'foo2';　　取得 : var x = dnode.value;　　削除 : dnode.delete();


30



　　生成 : dnode.value = 'foo2';　　取得 : var x = dnode.value;　　削除 : dnode.delete();

注意 : delete は、操作中の Global ストレージの木構造の中の、この節の下に付いている DocumentNode もすべて一緒に削除します


31



　　生成 : dnode.value = 'foo2';　　取得 : var x = dnode.value;　　削除 : dnode.delete();　　存在 ? var exists = dnode.exists; // true|

false


32

Global 節と JavaScript オブジェクトmyDoc("a")=123myDoc("b","c1")="foo"myDoc("b","c2")="foo2"myDoc("d","e1","f1")="bar1"myDoc("d","e1","f2")="bar2"myDoc("d","e2","f1")="bar1"myDoc("d","e2","f2")="bar2"myDoc("d","e2","f3")="bar3"

var dnode = new this.documentStore.DocumentNode('myDoc', ['d']);


33


var dnode = new this.documentStore.DocumentNode('myDoc', ['d']);

dnode.hasChildren // true

dnode.hasValue // false

dnode.exists // true


34


var dnode = new this.documentStore.DocumentNode('myDoc', ['d', 'e2']);

dnode.hasChildren // true




35


var dnode = new this.documentStore.DocumentNode('myDoc', ['d', 'e2', 'f3']);

dnode.hasChildren // false

dnode.hasValue // true



36



dnode.hasChildren // false


dnode.exists // false

その節が物理的に存在しなくても、それに対応する DocumentNode オブジェクトは定義可能です


37



dnode.name // f3 　　節の名前 === グローバルの最後の添字　　です

dnode.parent // myDoc("d","e2")

　　　　　　　　　　　　　　　これは DocumentNode オブジェクトを返します


38


var dnode = new this.documentStore.DocumentNode('myDoc', ['d', 'e2']);

dnode.firstChild // myDoc("d","e2","f1")

dnode.lastChild // myDoc("d","e2","f3")

dnode.previousSibling // myDoc("d","e1")

dnode.nextSibling // undefined


DocumentNodeオブジェクト

39

DocumentNode オブジェクト

• これについては、このコースのこれ以降のパートでさらに説明します

• さらに詳細については、以下を参照してください

http://gradvs1.mgateway.com/download/ewd-document-store.pdf


Software

EWD 3トレーニングコース#20 GlobalストレージのJavaScript用抽象化-(a)DocumentNodeオブジェクト