Поддерживаемые функции выражений

Описанные здесь функции над выражениями поддерживаются и управляются Сервером монитора в WebSphere Business Monitor.

В следующих таблицах перечислены все функции над выражениями, которые можно применить в модели бизнес-величин и с помощью которых Сервер монитора вычисляет значения показателей и KPI, представленных в сводных панелях. Кроме того, в таблицах указано, каким будет вывод функции для каждого варианта типов данных ее аргументов.

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

Список аргументов: Long

Варианты Выход
Значение длинного целого Абсолютное значение этого значения длинного целого

Список аргументов: Double

Варианты Выход
Значение двойной точности Абсолютное значение этого значения с двойной точностью
Double.POSITIVE_INFINITY (*)Double.POSITIVE_INFINITY
Double.NEGATIVE_INFINITY (*)Double.POSITIVE_INFINITY
Double.NaN (*)Double.NaN

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

Список аргументов: Double

Варианты Выход
Значение двойной точности Целая часть этого значения с двойной точностью
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

Варианты Выход
Значение двойной точности Дробная часть этого значения с двойной точностью
Double.NaN (*)Double.NaN
Double.NEGATIVE_INFINITY (*)Double.NEGATIVE_INFINITY
Double.POSITIVE_INFINITY (*)Double.POSITIVE_INFINITY

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

Список аргументов: bBoolean: test, String: thenTerm, String: elseTerm

Варианты Выход
Boolean, String, String Если значение test истинно, то возвращается thenTerm. В противном случае, возвращается elseTerm.

Список аргументов: boolean: test, double: thenTerm, double: elseTerm

Варианты Выход
Boolean, double, double Если значение test истинно, то возвращается thenTerm. В противном случае, возвращается elseTerm.

Список аргументов: boolean: test, boolean: thenTerm, boolean: elseTerm

Варианты Выход
Boolean, boolean, boolean Если значение test истинно, то возвращается thenTerm. В противном случае, возвращается elseTerm.

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

Список аргументов: EventWrapper: cbe, String: propertyName

Варианты Выход
EventWrapper, String Проверяет, найдено ли данное свойство в CBE, и если да, то установлено ли оно. Этот метод возвращает истинное значение, только если свойство найдено в CBE и установлено. Пользователь должен проверить, установлено ли свойство. Если оно не установлено, то с помощью функции if-then-else можно задать другой вариант. Если свойство, используемое в выражении, не установлено в событии, то в Сервере монитора возникает критическая исключительная ситуация, и он приостанавливает работу.

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

Список аргументов: long: var1, long: var2

Варианты Выход
long, long Возвращает максимальное значение.

Список аргументов: double: var1, double: var2

Варианты Выход
double, double Возвращает максимальное значение.

Double.NaN, double

ИЛИ

double, Double.NaN

(*)Возвращает Double.NaN

Double.POSITIVE_INFINITY, double

ИЛИ

double, Double.POSITIVE_INFINITY

(*)Возвращает Double.POSITIVE_INFINITY
Double.NEGATIVE_INFINITY, Double.NEGATIVE_INFINITY (*)Возвращает Double.NEGATIVE_INFINITY

Double.NEGATIVE_INFINITY, double

ИЛИ

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
long, 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)

Список аргументов: long: var1, long: var2

Варианты Выход
long, long Возвращает минимальное значение.

Список аргументов: double: var1, double: var2

Варианты Выход
double, double Возвращает максимальное значение.

Double.NaN, double

ИЛИ

double, Double.NaN

(*)Возвращает Double.NaN

Double.NEGATIVE_INFINITY, double

ИЛИ

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 (double) 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 (double) long

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

Список аргументов: String: text, String: subText

Варианты Выход
String, String Ищет subText в text и возвращает true, если subText содержится в text. В противном случае, возвращает false.

"", String

ИЛИ

String, ""

false

null, String

ИЛИ

String, null

Выбрасывает исключение NullPointerException

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

Список аргументов: String: text, String: subText

Варианты Выход
String, String Если text начинается с subText, то возвращается true. В противном случае, возвращается false.
"", String false
String, "" true

null, String

ИЛИ

String, null

Выбрасывает исключение NullPointerException

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

Список аргументов:String: text

Варианты Выход
String Возвращает text в верхнем регистре.
"" ""
null Выбрасывает исключение NullPointerException

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

Список аргументов:String: text

Варианты Выход
String Возвращает text в нижнем регистре.
"" ""
null Выбрасывает исключение NullPointerException

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

Список аргументов:String: s1, String: s2

Варианты Выход
String, String Возвращает s1 + s2
null, String "null" + s2
String, 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)

Список аргументов:String: list, String: addedItem, Boolean: duplicate

Варианты Выход
String, String, boolean Элемент добавлен к списку, разделенному запятыми. Если duplicate равен true, то в списке допускаются повторения. В противном случае, повторения не допускаются.
String, "", (false или true) Список с замыкающей запятой, например, "hhh,kkk,"
"", элемент, (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)

Список аргументов:String: list, String: removedItem, boolean: 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)

Список аргументов:double: number

Варианты Выход
Double Возвращает строковое представление данного числа.
Double.POSITIVE_INFINITY Бесконечность
Double.NEGATIVE_INFINITY -Бесконечность
Double.NaN NaN

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

Список аргументов:long: date

Варианты Выход
long Преобразует данную дату в формат даты и времени

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

Список аргументов:long: date

Варианты Выход
long Формат даты и времени усекается до даты. Усеченная дата преобразуется в миллисекунды.

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

Список аргументов:long: date

Варианты Выход
long Преобразует данную дату и время в формат времени. Значение даты устанавливается в ноль, а время преобразуется в миллисекунды.

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

Список аргументов:String: string

Варианты Выход
String Возвращает значение целого данной строки.
Неотформатированная строка Выбрасывает исключение NumberFormatException
null Выбрасывает исключение NullPointerException

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

Список аргументов:String: string

Варианты Выход
String Возвращает число, найденное в строке, в форме двойной точности.
Неотформатированная строка Выбрасывает исключение NumberFormatException
null Выбрасывает исключение NullPointerException

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

Список аргументов:String: string, String: format

Варианты Выход
String, String Преобразует данную строку в формат даты. Поскольку в системе формат даты представлен длинным целым, этот метод возвращает длинное целое.

String, null

ИЛИ

null, String

Выбрасывает исключение NullPointerException

String, ""

ИЛИ

"", ""

ИЛИ

"", String

Выбрасывает исключение ParseException

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

Список аргументов:String: string, String: format

Варианты Выход
String, String Преобразует данную строку в формат даты. Поскольку в системе формат даты представлен длинным целым, этот метод возвращает длинное целое.

String, null

ИЛИ

null, String

Выбрасывает исключение NullPointerException

String, ""

ИЛИ

"", ""

ИЛИ

"", String

Выбрасывает исключение ParseException
Важное замечание: Эта функция может привести к исключительной ситуации IllegalArgumentException. Для показателей модели, которые заполняются событиями, используйте вместо нее функцию text-to-datetime.

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

Список аргументов:String: string, String: format

Варианты Выход
String, String Преобразует данную строку в формат даты. Поскольку в системе формат даты представлен длинным целым, этот метод возвращает длинное целое.

String, null

ИЛИ

null, String

Выбрасывает исключение NullPointerException

String, ""

ИЛИ

"", ""

ИЛИ

"", String

Выбрасывает исключение ParseException

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

Список аргументов:String: string, String: format

Варианты Выход
String, String Преобразует данную строку в формат интервала времени. Поскольку в системе формат интервала времени представлен длинным целым, этот метод возвращает длинное целое. Формат должен иметь вид dddd-hh-mm-ss. Любой другой формат приведет к исключительной ситуации NoSuchElementException.
"", String Выбрасывает исключение NoSuchElementException
null, String Выбрасывает исключение NullPointerException

Copyright IBM Corporation 2005. Все права защищены.