UnitIterableQuery (JP1/AJS2 Unitdef 2.7.0-RELEASE API)

すべてのスーパーインタフェース:

IterableQuery<Unit,Unit>, Query<Unit,Iterable<Unit>>
```
public interface UnitIterableQuery
extends IterableQuery<Unit,Unit>
```
ユニットに問合せを行い子ユニット（直接の下位ユニット）や子孫ユニット（直接・間接の下位ユニット）を返すクエリ.
このクエリのインスタンスを得るにはQueriesの提供する静的メソッドを利用する。 Unit.query(Query)メソッドをクエリに対して適用すると問合せが行われる：
```
 import static org.unclazz.jp1ajs2.unitdef.query.Queries.*;
 Unit u = ...;
 Iterable<Unit> ui = u.query(children());
```
このオブジェクト自身が提供するメソッドを通じてクエリに種々の条件を追加することが可能である。これらの条件は内部的に記憶されて問い合わせの時に利用される。クエリはイミュータブルでありステートレスであるので、複雑な条件を設定したインスタンスの参照を保持しておくことで、複数の異なるユニットに対して繰り返し問合せを行うことができる。
```
 Query<Unit,Iterable> q0 = children().hasChildren();
 Query<Unit,Iterable> q1 = q0.typeIs(UnitType.PC_JOB);
 Query<Unit,Iterable> q2 = q1.hasParameter("cm");
 Iterable<Unit> ui = u.query(q1); // cmパラメータを持つこと という条件は付かない
```
queryFrom(Unit)メソッドから返えされるIterableは遅延評価に基づき値を返す。問合せのロジックの起動は可能な限り遅らせられるので、仮に1つ取得するだけでIterableを破棄したとしても、そのために消費されるCPUとメモリのコストは当該の1ユニットを問合せるのに必要な分だけである。

なおこのように問合せ結果のうち最初の1つだけを取得したい場合は、 IterableQuery.one()もしくはそのオーバーロードを呼び出してOneQueryのインスタンスを得ると便利である。また問合せ結果として遅延評価Iterableの代わりに正格評価Listを取得したい場合は、 IterableQuery.list()メソッドを呼び出してクエリListQueryのインスタンスを得るとよい。
```
 Unit u2 = u.query(children().one());
 List<Unit> ul = u.query(children().list());
```

ネストされたクラスのサマリー

ネストされたクラス
修飾子とタイプ	インタフェースと説明
`static interface`	`UnitIterableQuery.HasParameterValueAtN`
`static interface`	`UnitIterableQuery.HasParameterValueAtNIsTuple` ユニット定義パラメータ値のタプル条件を付与された`UnitIterableQuery`を生成するためのファクトリ.

メソッドのサマリー

すべてのメソッドインスタンス・メソッド abstractメソッド
修飾子とタイプ	メソッドと説明
`UnitIterableQuery`	`fqnContains(String n)` ユニット完全名の条件を追加したクエリを返す.
`UnitIterableQuery`	`fqnEndsWith(String n)` ユニット完全名の条件を追加したクエリを返す.
`UnitIterableQuery`	`fqnEquals(String n)` ユニット完全名の条件を追加したクエリを返す.
`UnitIterableQuery`	`fqnStartsWith(String n)` ユニット完全名の条件を追加したクエリを返す.
`UnitIterableQuery`	`hasChildren()` 子ユニット（直接の下位ユニット）の条件を追加したクエリを返す.
`UnitIterableQuery.HasParameterValueAtN`	`hasParameter(String name)` ユニット定義パラメータの条件を追加したクエリのファクトリを返す.
`UnitIterableQuery`	`nameContains(String n)` ユニット名の条件を追加したクエリを返す.
`UnitIterableQuery`	`nameEndsWith(String n)` ユニット名の条件を追加したクエリを返す.
`UnitIterableQuery`	`nameEquals(String n)` ユニット名の条件を追加したクエリを返す.
`UnitIterableQuery`	`nameMatches(Pattern regex)` ユニット名の条件を追加したクエリを返す.
`UnitIterableQuery`	`nameMatches(String regex)` ユニット名の条件を追加したクエリを返す.
`UnitIterableQuery`	`nameStartsWith(String n)` ユニット名の条件を追加したクエリを返す.
`Iterable<Unit>`	`queryFrom(Unit u)` オブジェクトに対して問合せを行う.
`IterableQuery<Unit,FullQualifiedName>`	`theirFqn()` 問合せの結果のユニットが持つ完全名を問合せるクエリを返す.
`IterableQuery<Unit,String>`	`theirName()` 問合せの結果のユニットが持つユニット名を問合せるクエリを返す.
`ParameterIterableQuery`	`theirParameters()` 問合せの結果のユニットが持つユニット定義パラメータを問合せるクエリを返す.
`ParameterIterableQuery`	`theirParameters(String name)` 問合せの結果のユニットが持つユニット定義パラメータを問合せるクエリを返す.
`UnitIterableQuery`	`typeIs(UnitType t)` ユニット種別の条件を追加したクエリを返す.

インタフェースから継承されたメソッド org.unclazz.jp1ajs2.unitdef.query.IterableQuery
and, cached, list, list, one, one, one, query

- メソッドの詳細
  - queryFrom
```
Iterable<Unit> queryFrom(Unit u)
```
    インタフェースからコピーされた説明: Query
    
    オブジェクトに対して問合せを行う.
    
    定義:
    
    queryFrom インタフェース内 Query<Unit,Iterable<Unit>>
    
    パラメータ:
    
    u - 問合せ対象
    
    戻り値:
    
    問合せ結果
  - theirParameters
```
ParameterIterableQuery theirParameters()
```
    問合せの結果のユニットが持つユニット定義パラメータを問合せるクエリを返す.
    
    戻り値:
    
    クエリ
  - theirParameters
```
ParameterIterableQuery theirParameters(String name)
```
    問合せの結果のユニットが持つユニット定義パラメータを問合せるクエリを返す.
    
    パラメータ:
    
    name - パラメータ名
    
    戻り値:
    
    クエリ
  - theirFqn
```
IterableQuery<Unit,FullQualifiedName> theirFqn()
```
    問合せの結果のユニットが持つ完全名を問合せるクエリを返す.
    
    戻り値:
    
    クエリ
  - theirName
```
IterableQuery<Unit,String> theirName()
```
    問合せの結果のユニットが持つユニット名を問合せるクエリを返す.
    
    戻り値:
    
    クエリ
  - typeIs
```
UnitIterableQuery typeIs(UnitType t)
```
    ユニット種別の条件を追加したクエリを返す.
    
    パラメータ:
    
    t - ユニット種別
    
    戻り値:
    
    クエリ
  - fqnEquals
```
UnitIterableQuery fqnEquals(String n)
```
    ユニット完全名の条件を追加したクエリを返す.
    
    パラメータ:
    
    n - ユニット完全名
    
    戻り値:
    
    クエリ
  - fqnStartsWith
```
UnitIterableQuery fqnStartsWith(String n)
```
    ユニット完全名の条件を追加したクエリを返す.
    
    パラメータ:
    
    n - ユニット完全名の部分文字列
    
    戻り値:
    
    クエリ
  - fqnEndsWith
```
UnitIterableQuery fqnEndsWith(String n)
```
    ユニット完全名の条件を追加したクエリを返す.
    
    パラメータ:
    
    n - ユニット完全名の部分文字列
    
    戻り値:
    
    クエリ
  - fqnContains
```
UnitIterableQuery fqnContains(String n)
```
    ユニット完全名の条件を追加したクエリを返す.
    
    パラメータ:
    
    n - ユニット完全名の部分文字列
    
    戻り値:
    
    クエリ
  - nameEquals
```
UnitIterableQuery nameEquals(String n)
```
    ユニット名の条件を追加したクエリを返す.
    
    パラメータ:
    
    n - ユニット名
    
    戻り値:
    
    クエリ
  - nameStartsWith
```
UnitIterableQuery nameStartsWith(String n)
```
    ユニット名の条件を追加したクエリを返す.
    
    パラメータ:
    
    n - ユニット名の部分文字列
    
    戻り値:
    
    クエリ
  - nameEndsWith
```
UnitIterableQuery nameEndsWith(String n)
```
    ユニット名の条件を追加したクエリを返す.
    
    パラメータ:
    
    n - ユニット名の部分文字列
    
    戻り値:
    
    クエリ
  - nameContains
```
UnitIterableQuery nameContains(String n)
```
    ユニット名の条件を追加したクエリを返す.
    
    パラメータ:
    
    n - ユニット名の部分文字列
    
    戻り値:
    
    クエリ
  - nameMatches
```
UnitIterableQuery nameMatches(Pattern regex)
```
    ユニット名の条件を追加したクエリを返す.
    
    パラメータ:
    
    regex - ユニット名の正規表現パターン
    
    戻り値:
    
    クエリ
  - nameMatches
```
UnitIterableQuery nameMatches(String regex)
```
    ユニット名の条件を追加したクエリを返す.
    
    パラメータ:
    
    regex - ユニット名の正規表現パターン
    
    戻り値:
    
    クエリ
  - hasChildren
```
UnitIterableQuery hasChildren()
```
    子ユニット（直接の下位ユニット）の条件を追加したクエリを返す.
    
    戻り値:
    
    クエリ
  - hasParameter
```
UnitIterableQuery.HasParameterValueAtN hasParameter(String name)
```
    ユニット定義パラメータの条件を追加したクエリのファクトリを返す.
    
    パラメータ:
    
    name - パラメータ名
    
    戻り値:
    
    ファクトリ

インタフェース UnitIterableQuery

ネストされたクラスのサマリー

メソッドのサマリー

インタフェースから継承されたメソッド org.unclazz.jp1ajs2.unitdef.query.IterableQuery

メソッドの詳細

queryFrom

theirParameters

theirParameters

theirFqn

theirName

typeIs

fqnEquals

fqnStartsWith

fqnEndsWith

fqnContains

nameEquals

nameStartsWith

nameEndsWith

nameContains

nameMatches

nameMatches

hasChildren

hasParameter