max()

このビジネス・オブジェクト配列のすべてのエレメントから、指定した属性の最大値を検索します。

構文

String max(String attr)
 

パラメーター

attr
ビジネス・オブジェクト内の属性を参照する変数。属性の型は、StringLongTextIntegerFloat、および Double のいずれかである必要があります。

戻り値

指定した属性の、ストリング形式での最大値。または、BusObjArray 内のすべてのエレメントについてその属性の値が null である場合は null。

例外

UnknownAttributeException - 指定した属性が、渡されたビジネス・オブジェクトの有効な属性ではない場合です。

UnsupportedAttributeTypeException - 指定した属性のデータ型が、『注記』セクションにあるサポート対象の属性データ型ではない場合です。

上記の例外すべては CollaborationException からサブクラス化されています。max() メソッドは、この例外に対して例外タイプ AttributeException を設定できます。

注記

max() メソッドは、BusObjArray の中のビジネス・オブジェクトのうち、指定した属性の最大値を検索します。例えば、3 つの Employee オブジェクトが使用されていて、その属性が Float 型の Salary である場合、最大の給与を表すストリングが戻されます。

BusObjArray 内のエレメントのうち、指定した属性の値が null であるエレメントは無視されます。すべてのエレメントについて指定した属性値が null の場合、null が戻されます。

属性のデータ型が String である場合、max() は字句が最長のストリングである属性値を戻します。

String maxSalary = items.max("Salary");
 

Copyright IBM Corp. 2004