ネストされた繰り返し
ネストされた繰り返し構造を使用すると、コンポーネントの定義に応じて、各コンポーネントに複数の繰り返し構造を持たせることができます。2レベルのネストされた繰り返しを考えてみましょう。外部リスト (最初の繰り返しリスト) の各要素に対して、内部リスト (2番目の繰り返しリスト) のすべての要素の繰り返しリストを作成できます。StyleBookコンパイラは、最大3つのネストされた繰り返しをサポートしています。各繰り返しレベルには、repeat-item属性とrepeat-index属性が関連付けられています。repeat-item属性とrepeat-index属性の両方はオプションです。さらに、各繰り返しはrepeat-conditionも指定できます。
例:
parameters:
-
name: vips
type: ipaddress[]
-
name: vip-ports
type: tcp-port[]
components:
-
name: lbvservers-comp
type: ns::lbvserver
repeat:
repeat-list: $parameters.vips
repeat-item: ip
repeat:
repeat-list: $parameters.vip-ports
repeat-item: port
properties:
name: str("lb-") + str($ip) + '-' + str($port)
servicetype: HTTP
ipv46: $ip
port: $port
上記の例では、$parameters.vips内の各項目に対して、$parameters.vip-portsのすべての項目を反復処理します。したがって、$parameters.vipsで指定された各IPアドレスに対して、$parameters.vip-portsで指定されたすべてのポートのlbvserver構成オブジェクトを作成します。プロパティセクションは、IPアドレスとポートの組み合わせに対して「lb」をプレフィックスとしてオブジェクトの名前を定義します。そのため、各反復処理で、$ip + $portはIPアドレスとポート番号の一意の組み合わせを定義します。
repeat-item属性が指定されていない場合、コンパイラはそれに対してデフォルト値を生成します。repeat-itemのデフォルト値は、各繰り返しレベルに対してそれぞれ$repeat-item、$repeat-item-1、$repeat-item-2です。同様に、repeat-index属性が指定されていない場合、コンパイラはそれに対してデフォルト値を生成します。repeat-indexのデフォルト値は、各繰り返しレベルに対してそれぞれ$repeat-index、$repeat-index-1、および$repeat-index-2です。
次の例は、ネストされた繰り返しオブジェクトにrepeat-item属性とrepeat-index属性がない場合の命名規則について説明しています。
例:
components:
-
name: lbvservers-comp
type: ns::lbvserver
repeat:
repeat-list: $parameters.vips
repeat:
repeat-list: $parameters.vip-ports
properties:
name: str("lb-") + str($repeat-item) + '-' + str($repeat-item-1)
servicetype: HTTP
ipv46: $repeat-item
port: $repeat-item-1