グローバル配列の操作

Native SDK 用語の用語集

ここに示す概念の概要については、前のセクションを参照してください。この用語集の例は、以下に示すグローバル配列構造を指しています。Legs グローバル配列には、10 個のノードと 3 つのノード・レベルがあります。10 個のノードのうち 7 つには、値が含まれます。

  Legs                       // root node, valueless, 3 child nodes
    fish = 0                 // level 1 node, value=0
    mammal                   // level 1 node, valueless
      human = 2              // level 2 node, value=2
      dog = 4                // level 2 node, value=4
    bug                      // level 1 node, valueless, 3 child nodes
      insect = 6             // level 2 node, value=6
      spider = 8             // level 2 node, value=8
      millipede = Diplopoda  // level 2 node, value="Diplopoda", 1 child node
        centipede = 100      // level 3 node, value=100

グローバル命名規則

グローバル名と添え字は、次の規則に従います。

• ノード・アドレスの長さ (グローバル名とすべての添え字の長さの合計) は最大 511 文字です (入力した一部の文字は、この制限のために、複数のエンコードされた文字としてカウントされることがあります。詳細は、"グローバルの使用法" の “グローバル参照の最大長” を参照してください)。

• グローバル名には文字、数字、およびピリオド ('.') を使用でき、最大 31 文字の有効文字を使用できます。文字で始まる必要があり、ピリオドで終了することはできません。

• 添え字は文字列または数値にすることができます。文字列の添え字は大文字と小文字が区別され、すべての文字 (制御文字と非表示文字を含む) を使用できます。長さの制限は、ノード・アドレス全体の最大長が 511 文字という制限のみです。

ノードの作成とノード値の設定

set() メソッドと increment() メソッドを使用して、指定した値を持つ永続ノードを作成したり、既存のノードの値を変更したりできます。

IRIS.set() は、任意のサポートされているデータ型の value 引数を取り、指定されたアドレスにその値を格納します。ターゲット・アドレスにノードが存在しない場合は、新しいノードが作成されます。

ノード値の設定および変更

以下の例では、set() の最初の呼び出しによって、新しいノードがサブノード・アドレス myGlobal("A") に作成され、このノードの値が文字列 "first" に設定されます。2 回目の呼び出しによって、サブノードの値が変更され、整数 1 に置き換えられます。

  irisjv.set("first", "myGlobal", "A");    // create node myGlobal("A") = "first"
  irisjv.set(1, "myGlobal", "A");  // change value of myGlobal("A") to 1.

set() は、サポートされている任意のデータ型の値を作成および変更できます。既存の値を読み取るには、次のセクションで説明するように、データ型ごとに異なるゲッター・メソッドを使用する必要があります。

IRIS.increment() は number 引数を取り、その数だけノードの値をインクリメントし、そのインクリメントした値を返します。number 引数は、Double、Integer、Long、または Short のいずれかになります。

ターゲット・アドレスにノードがない場合、このメソッドはノードを作成し、値として number 引数を割り当てます。このメソッドはスレッドセーフなアトミック処理を使用して、ノードの値を変更します。したがって、ノードは決してロックされません。

ノード値のインクリメント

以下の例では、increment() の最初の呼び出しによって、新しいサブノード myGlobal("B") が値 -2 で作成されます。次の 2 回の呼び出しによって、それぞれ -2 だけインクリメントされ、最終値は -6 になります。

  for (int loop = 0; loop < 3; loop++) {
    irisjv.increment(-2,"myGlobal", "B");
  }

ノード値の取得

set() メソッドはサポートされているすべてのデータ型で使用できますが、各データ型には別個のゲッターが必要です。ノード値は、以下のいずれかのデータ型になります ： Boolean、byte[]、Double、Float、Integer、Long、Short、String、Date、Time、Timestamp に加え、Object、IRISList、java.io.InputStream と java.io.Reader のサブクラス、および java.io.Serializable を実装するオブジェクト。

以下のメソッドを使用して、これらのデータ型からノード値を取得します。

• 数値データ型 ： getBoolean()、getShort()、getInteger()、getLong()、getDouble()、 getFloat()

• 文字列およびバイナリ・データ型 ： getBytes()、 getString()

• オブジェクトおよび $list データ型 ： getObject()、 getIRISList()

• 一時データ型 ： getDate()、getTime()、 getTimestamp()

• その他のデータ型 ： getInputStream()、 getReader()

データ型の詳細は、この章で後述する “クラス IRIS のサポートされているデータ型” を参照してください。

ノードの削除

IRIS.kill() は、指定したノードとそのすべてのサブノードを削除します。ルート・ノードを削除した場合、または値を持つすべてのノードを削除した場合、グローバル配列全体が削除されます。

以下の例では、グローバル配列 myGlobal には最初、以下のノードが含まれています。

   myGlobal = <valueless node>
     myGlobal("A") = 0
       myGlobal("A",1) = 0
       myGlobal("A",2) = 0
     myGlobal("B") = <valueless node>
       myGlobal("B",1) = 0

この例では、myGlobal("A") と myGlobal("B",1) の 2 つのサブノードで kill() を呼び出して、グローバル配列全体を削除します。

ノードまたはノード・グループの削除

最初の呼び出しによって、ノード myGlobal("A") とその両方のサブノードが削除されます。

  irisjv.kill("myGlobal", "A");
  // also kills child nodes myGlobal("A",1) and myGlobal("A",2)

2 番目の呼び出しによって、値を持つ最後の残りのサブノード myGlobal("B",1) が削除されます。

  irisjv.kill("myGlobal","B",1);

残りのどのノードにも値がない場合は、グローバル配列全体が削除されます。

• 親ノード myGlobal("B") は、値がなく、サブノードもなくなったため、削除されます。

• その結果、ルート・ノード myGlobal は値がなく、サブノードもなくなったため、グローバル配列全体がデータベースから削除されます。

一連の子ノードにわたる反復

子ノードは、同じ親ノードの直下にある一連のサブノードです。現在のターゲット・ノードの子は、ターゲット・アドレスに添え字を 1 つのみ追加してアドレス指定できます。同じ親の下のすべての子ノードは相互に兄弟ノードです。例えば、以下のグローバル配列には、親ノード ^myNames("people") の下に 6 つの兄弟ノードがあります。

  ^myNames                               (valueless root node)
     ^myNames("people")                  (valueless level 1 node)
        ^myNames("people","Anna") = 2    (first level 2 child node)
        ^myNames("people","Julia") = 4
        ^myNames("people","Misha") = 5
        ^myNames("people","Ruri") = 3
        ^myNames("people","Vlad") = 1
        ^myNames("people","Zorro") = -1  (this node will be deleted in example)

ここでは、以下のメソッドを示します。

• 反復子を作成して一連の子ノードを走査するために使用されるメソッド

  • jdbc.IRIS.getIRISIterator() は、指定されたノードから開始して、グローバルの IRISIterator のインスタンスを返します。

  • IRISIterator.next() は、照合順で次の兄弟ノードの添え字を返します。

  • IRISIterator.hasNext() は、照合順に別の兄弟ノードがある場合に true を返します。

• 現在のノードに作用するメソッド

  • IRISIterator.getValue() は、現在のノード値を返します。

  • IRISIterator.getSubscriptValue() は、現在の添え字 (最後に成功した next() の呼び出しと同じ値) を返します。

  • IRISIterator.remove() は、現在のノードとそのサブノードすべてを削除します。

以下の例は、^myNames("people") の下の各子ノードを反復処理します。値が 0 以上の場合は添え字とノード値を出力し、値が負の場合はノードを削除します。

^myNames("people") の下のすべての兄弟ノードの検索

// Read child nodes in collation order while iter.hasNext() is true
  System.out.print("Iterate from first node:");
  try {
    IRISIterator iter = irisjv.getIRISIterator("myNames","people");
    while (iter.hasNext()) {
      iter.next();
      if ((Long)iter.getValue()>=0) {
        System.out.print(" \"" + iter.getSubscriptValue() + "\"=" + iter.getValue()); }
      else {
        iter.remove();
      }
    };
  } catch  (Exception e) {
    System.out.println( e.getMessage());
  }

• getIRISIterator() の呼び出しによって、^myNames("people") の直接の子の反復子インスタンス iter が作成されます。

• while ループが繰り返されるたびに、以下のアクションが実行されます。

  • next() は、照合順で次に有効なノードの添え字を特定し、そのノードに反復子を配置します(最初の反復では、添え字は "Anna" で、ノード値は 2 です)。

  • getValue() から返されたノード値が負である場合は、remove() が呼び出されてノードが削除されます (すべてのサブノードも含みます。これは、現在のノードに対する kill() の呼び出しと同じです)。

    それ以外の場合は、getSubscriptValue() と getValue() を使用して、現在のノードの添え字と値が出力されます。

• この順序に子ノードがそれ以上ないことを示す false を hasNext() が返すと、while ループが終了します。

このコードは、以下の行を出力します (要素 "Zorro" は、値が負であるため出力されていません)。

  Iterate from first node: "Anna"=2 "Julia"=4 "Misha"=5 "Ruri"=3 "Vlad"=1

この例は、非常に単純であり、いくつかの状況で失敗する可能性があります。最初または最後のノードから開始したくない場合、どうなるでしょうか。コードが、値なしノードから値を取得しようとする場合、どうなるでしょうか。グローバル配列の複数のレベルにデータがある場合、どうなるでしょうか。以下のセクションでは、これらの状況を処理する方法を説明します。

すべてのレベルのサブノードの検索

次の例では、少し複雑なサブノードのセットを検索します。新しい子ノード "dogs" を ^myNames に追加し、それをこの例のターゲット・ノードとして使用します。

  ^myNames                                         (valueless root node)
     ^myNames("dogs")                              (valueless level 1 node)
        ^myNames("dogs","Balto") = 6
        ^myNames("dogs","Hachiko") = 8
        ^myNames("dogs","Lassie")                  (valueless level 2 node)
           ^myNames("dogs","Lassie","Timmy") = 10  (level 3 node)
        ^myNames("dogs","Whitefang") = 7
     ^myNames("people")                            (valueless level 1 node)
        [five child nodes]                         (as listed in previous example)

ターゲット・ノード ^myNames("dogs") には 5 つのサブノードがありますが、そのうちの 4 つのみが子ノードです。4 つのレベル 2 サブノードに加え、レベル 3 サブノード ^myNames("dogs","Lassie","Timmy") もあります。検索では "Timmy" は見つかりません。これは、このサブノードが "dogs" の子ではなく "Lassie" の子であるため、その他のサブノードの兄弟ではないからです。

ノード ^myNames("dogs","Lassie") には子ノードがありますが、これには値がありません。この場合、getValue() の呼び出しでは null が返されます。以下の例では、逆の照合順で ^myNames("dogs") の子が検索されます。

^myNames("dogs") の下の最後のノードから逆の順序でノードを取得

// Read child nodes in descending order while iter.next() is true
  System.out.print("Descend from last node:");
  try {
    IRISIterator iter = irisjv.getIRISIterator("myNames","dogs");
    while (iter.hasPrevious()) {
      iter.previous();
      System.out.print(" \"" + iter.getSubscriptValue() + "\"");
      if (iter.getValue()!=null) System.out.print("=" + iter.getValue());
    };
  } catch  (Exception e) {
    System.out.println( e.getMessage());
  }

このコードは以下の行を出力します。

Descend from last node: "Whitefang"=7 "Lassie" "Hachiko"=8 "Balto"=6

前の例の検索では、グローバル配列 ^myNames のノードのいくつかが検出されません。これは、検索範囲がさまざまな方法で制限されるためです。

• ノード ^myNames("dogs","Lassie","Timmy") は、^myNames("dogs") のレベル 2 サブノードではないため検出されません。

• ^myNames("people") の下のレベル 2 ノードは、^myNames("dogs") の下のレベル 2 ノードの兄弟ではないため検出されません。

いずれの場合でも、問題は、previous() および next() が、同じ親の下にある開始アドレスと同じレベルのノードしか検出しないことです。兄弟ノードの各グループに対して異なる開始アドレスを指定する必要があります。

ほとんどの場合は、既知の構造を処理することになるため、入れ子になった単純な呼び出しを使用してさまざまなレベルを走査します。構造に任意の数のレベルがあるようなあまり一般的でない場合には、以下の jdbc.IRIS メソッドを使用して、指定されたノードにサブノードがあるかどうかを確認できます。

• isDefined() — 指定されたノードが存在しない場合は 0 を返し、ノードが存在し、それに値がある場合は 1 を返します。ノードに値はないが、サブノードがある場合は 10 を返し、値とサブノードの両方がある場合は 11 を返します。

isDefined() が 10 または 11 を返す場合、サブノードが存在し、前述の例で説明したように反復子を作成することによって処理することができます。再帰アルゴリズムでは、このテストを使用して任意の数のレベルを処理できます。