受支持的表达式函数

此处描述的表达式函数由 WebSphere® Business Monitor 中的监控器服务器支持和处理。

下表列出了所有可用于已建模的业务度量模型并可由监控器服务器处理的表达式函数,这些函数用于计算将在仪表板中显示的度量和 KPI 的值。这些表也列出了函数参数列表的每个数据类型变化的输出行为。

absolute-value (com.ibm.btools.expression.absoluteValue)

参数列表:长整型

变化 输出
长整型值 该长整型值的绝对值

参数列表:双精度

变化 输出
双精度值 该双精度值的绝对值
Double.POSITIVE_INFINITY (*)Double.POSITIVE_INFINITY
Double.NEGATIVE_INFINITY (*)Double.POSITIVE_INFINITY
Double.NaN (*)Double.NaN

integer-part (com.ibm.btools.expression.integerValue)

参数列表:双精度

变化 输出
双精度值 双精度值的整数强制类型转换值
Double.NaN 0
Double.MAX_VALUE Integer.MAX_VALUE
Double.MIN_VALUE 0
Double.NEGATIVE_INFINITY Integer.MIN_VALUE
Double.POSITIVE_INFINITY Integer.MAX_VALUE

decimal-part (com.ibm.btools.expression.fractionalValue)

参数列表:双精度

变化 输出
双精度值 双精度值的小数部分
Double.NaN (*)Double.NaN
Double.NEGATIVE_INFINITY (*)Double.NEGATIVE_INFINITY
Double.POSITIVE_INFINITY (*)Double.POSITIVE_INFINITY

if-then-else (com.ibm.btools.expression.ifthenelse)

参数列表:布尔值:test,字符串:thenTerm,字符串:elseTerm

变化 输出
Boolean, String, String 若 test 为 true,则返回 thenTerm;否则返回 elseTerm。

参数列表:布尔值:test,双精度:thenTerm,双精度:elseTerm

变化 输出
Boolean, double, double 若 test 为 true,则返回 thenTerm;否则返回 elseTerm。

参数列表:布尔值:test,布尔值:thenTerm,布尔值:elseTerm

变化 输出
布尔值,布尔值,布尔值 若 test 为 true,则返回 thenTerm;否则返回 elseTerm。

attribute-is-set (com.ibm.btools.expression.bom.ome.isSet)

参数列表: EventWrapper:cbe,字符串:propertyName

变化 输出
EventWrapper, String 验证能否在 CBE 中找到给定的属性,如果找到,它是否已设置。该方法将不会返回 true,除非在 CBE 中找到并设置了属性。用户必须检查是否设置了属性。如果没有设置,则通过使用 if-then-else 函数,可以提供代替路径。在表达式中使用而未在事件中设置的属性将使监控器服务器抛出严重异常并暂挂。

greater-value (com.ibm.btools.expression.maxValue)

参数列表:长整型:var1,长整型:var2

变化 输出
long, long 返回最大值。

参数列表:双精度:var1,双精度:var2

变化 输出
double, double 返回最大值。

Double.NaN,双精度

双精度,Double.NaN

(*)返回 Double.NaN

Double.POSITIVE_INFINITY, double

双精度,Double.POSITIVE_INFINITY

(*)返回 Double.POSITIVE_INFINITY
Double.NEGATIVE_INFINITY, Double.NEGATIVE_INFINITY (*)返回 Double.NEGATIVE_INFINITY

Double.NEGATIVE_INFINITY,双精度

double, Double.NEGATIVE_INFINITY

返回另一个双精度值。

参数列表:Double: var1, long: var2

变化 输出
double, long 返回最大值。
Double.POSITIVE_INFINITY, long (*)Double.POSITIVE_INFINITY
Double.NaN, long (*)Double.NaN
Double.NEGATIVE_INFINITY, Long.MAX_VALUE ((double)Long.MAX_VALUE)
Double.NEGATIVE_INFINITY, Long.MIN_VALUE ((double)Long.MIN_VALUE)

参数列表:long: var1, double: var2

变化 输出
long, double 返回最大值。
long, Double.POSITIVE_INFINITY (*)Double.POSITIVE_INFINITY
长整型,Double.NaN (*)Double.NaN
Long.MAX_VALUE,Double.NEGATIVE_INFINITY ((double)Long.MAX_VALUE)
Long.MIN_VALUE,Double.NEGATIVE_INFINITY ((double)Long.MIN_VALUE)

lesser-value (com.ibm.btools.expression.minValue)

参数列表:长整型:var1,长整型:var2

变化 输出
long, long 返回最小值。

参数列表:双精度:var1,双精度:var2

变化 输出
double, double 返回最大值。

Double.NaN,双精度

双精度,Double.NaN

(*)返回 Double.NaN

Double.NEGATIVE_INFINITY,双精度

double, Double.NEGATIVE_INFINITY

(*)返回 Double.NEGATIVE_INFINITY
Double.POSITIVE_INFINITY,Double.POSITIVE_INFINITY (*)返回 Double.POSITIVE_INFINITY

参数列表:Double: var1, long: var2

变化 输出
Double.MIN_VALUE,Long.MIN_VALUE ((double)Long.MIN_VALUE)
Double.MAX_VALUE,Long.MAX_VALUE ((double)Long.MAX_VALUE)
Double.NaN, long (*)Double.NaN
Double.NEGATIVE_INFINITY, long (*)Double.NEGATIVE_INFINITY
Double.POSITIVE_INFINITY, long (双精度)长整型

参数列表:long: var1, double: var2

变化 输出
Double.MIN_VALUE,Long.MIN_VALUE ((double)Long.MIN_VALUE)
Double.MAX_VALUE,Long.MAX_VALUE ((double)Long.MAX_VALUE)
Double.NaN, long (*)Double.NaN
Double.NEGATIVE_INFINITY, long (*)Double.NEGATIVE_INFINITY
Double.POSITIVE_INFINITY, long (双精度)长整型

includes-specified-text (com.ibm.btools.expression.containsText)

参数列表:字符串:text,字符串:subText

变化 输出
字符串,字符串 在 text 中查找 subText,如果 text 中包含 subText,返回 true;否则,返回 false。

"", String

String, ""

false

null,字符串

字符串,null

抛出 NullPointerException

starts-with-specified-text (com.ibm.btools.expression.startsWithText)

参数列表:字符串:text,字符串:subText

变化 输出
字符串,字符串 如果 text 以 subText 开头,则返回 true;否则返回 false。
"", String false
String, "" true

null,字符串

字符串,null

抛出 NullPointerException

to-uppercase (com.ibm.btools.expression.toUpperCase)

参数列表:字符串:text

变化 输出
String 以大写字母返回 text。
"" ""
null 抛出 NullPointerException

to-lowercase (com.ibm.btools.expression.toLowerCase)

参数列表:字符串:text

变化 输出
String 以小写字母返回 text。
"" ""
null 抛出 NullPointerException

Concatenate (com.ibm.btools.expression.concat )

参数列表:字符串:s1,字符串:s2

变化 输出
字符串,字符串 返回 s1 + s2
null,字符串 "null" + s2
字符串,null s1 + "null"
null, null "nullnull"
"", String s2
String, "" s1

current-event-creation-time (com.ibm.btools.expression.currentTime)

参数列表:EventWrapper: currentEvent

变化 输出
EventWrapper 返回以毫秒为单位的事件创建时间。

current-event-creation-date (com.ibm.btools.expression.currentTime)

参数列表:EventWrapper: currentEvent

变化 输出
EventWrapper 返回以毫秒为单位的事件创建日期。

current-event-creation-datetime (com.ibm.btools.expression.currentTime)

参数列表:EventWrapper: currentEvent

变化 输出
EventWrapper 返回以毫秒为单位的事件创建日期时间。

Add-To-String-List (com.ibm.btools.expression.bom.ome.addToList)

参数列表:字符串:list,字符串:addedItem,布尔值:duplicate

变化 输出
String, String, boolean 向逗号分隔的列表添加元素。如果 duplicate 为 true,则 list 接受 duplicate;否则,list 将不接受 duplicate。
String, "", (false 或 true) 带有逗号后缀的列表,例如 "hhh,kkk,"
"", element, (false 或 true) 包含元素的字符串
"", "",(false 或 true) "",空字符串
null, String, (false 或 true) 包含元素的字符串
String, null, (false 或 true) 抛出 NullPointerException

Remove-From-String-List (com.ibm.btools.expression.bom.ome.removeFromList.string)

参数列表:字符串:list,字符串:removedItem,布尔值:allOccurences

变化 输出
String, String, boolean 从逗号分隔的列表中删除元素。提供了一个选项:可以选择是否删除列表中出现的所有该元素。
null, String, (false 或 true) ""
"", String, (false 或 true) ""
String, "", (false 或 true) 列表的字符串
String, null, (false 或 true) 抛出 NullPointerException

number-to-text (com.ibm.btools.expression.bom.ome.numberToString)

参数列表:双精度:number

变化 输出
Double 返回给定数字的字符串。
Double.POSITIVE_INFINITY 无穷大
Double.NEGATIVE_INFINITY 负无穷大
Double.NaN NaN

date-to-datetime (com.ibm.btools.expression.bom.ome.dateToDateTime)

参数列表:长整型:date

变化 输出
long 将给定的日期转换成日期时间

datetime-to-date (com.ibm.btools.expression.bom.ome.dateTimeToDate)

参数列表:长整型:date

变化 输出
long 将截断日期时间,以删除日期。 截断的日期变为毫秒。

datetime-to-time (com.ibm.btools.expression.dateTimeToTime)

参数列表:长整型:date

变化 输出
long 将给定的日期时间转换成时间。它将日期的值设为 0,并以毫秒来表示时间。

text-to-integer (com.ibm.btools.expression.bom.ome.textToInteger)

参数列表:字符串:string

变化 输出
String 返回给定字符串文本的整数值。
无格式的字符串 抛出 NumberFormatException
null 抛出 NullPointerException

text-to-number (com.ibm.btools.expression.bom.ome.stringToNumber)

参数列表:字符串:string

变化 输出
String 以双精度格式返回在字符串中找到的数。
无格式的字符串 抛出 NumberFormatException
null 抛出 NullPointerException

text-to-date (com.ibm.btools.expression.bom.ome.stringToDate)

参数列表:字符串:string,字符串:format

变化 输出
字符串,字符串 将给定的字符串的格式化为日期格式。由于系统中的日期格式以长整型表示,所以该方法将返回长整型。

字符串,null

null,字符串

抛出 NullPointerException

String, ""

"", ""

"", String

抛出 ParseException

text-to-time (com.ibm.btools.expression.bom.ome.stringToTime)

参数列表:字符串:string,字符串:format

变化 输出
字符串,字符串 将给定的字符串格式化为日期格式;由于系统中日期格式采用长整型表示,所以该方法返回长整型。

字符串,null

null,字符串

抛出 NullPointerException

String, ""

"", ""

"", String

抛出 ParseException
重要: 该函数可能会导致 IllegalArgumentException。 如果要构建由事件填充的度量,请使用 text-to-datetime 函数替代。

text-to-datetime (com.ibm.btools.expression.bom.ome.stringToDateTime)

参数列表:字符串:string,字符串:format

变化 输出
字符串,字符串 将给定的字符串格式化为日期格式;由于系统中日期格式采用长整型表示,所以该方法返回长整型。

字符串,null

null,字符串

抛出 NullPointerException

String, ""

"", ""

"", String

抛出 ParseException

text-to-duration (com.ibm.btools.expression.stringToDuration)

参数列表:字符串:string,字符串:format

变化 输出
字符串,字符串 将给定的字符串的格式为持续时间格式。由于系统中的持续时间格式以长整型表示,所以该方法将返回长整型。格式必须是 dddd-hh-mm-ss;如果有任何其他格式,则将抛出 NoSuchElementException。
"", String 抛出 NoSuchElementException
null,字符串 抛出 NullPointerException

Copyright IBM Corporation 2005, 2006. All Rights Reserved.