Selection#

public class Selection extends AbstractUiElement#

New in version 1.1.0: Добавлен методы locate(Map) и locate(Map, LocateOption[]), добавлены методы ожидания выборки, имена и сигнатуры методов приведены к соглашению по именам.

Выборка.

Не имеет графического представления на экране, но обладает элементом в дереве html-элементов браузера.

Constructors#

Selection#

protected Selection(BrowserContext browserContext, WebElement webElement)#

Selection#

protected Selection(AbstractUiElement parent, WebElement webElement)#

Methods#

executeJexl#

public Object executeJexl(String jexlScript)#

Отправляет Jexl-скрипт на сервер, где он выполняется в контексте текущей выборки.

Для возможности выполнения скриптов, в конфигурации сервера должна быть активирована опция. `<client><automation jexlExecution="true"/><client/>`

Parameters

  • jexlScript – Текст Jexl-скрипта.

Returns

Результат выполнения Jexl-скрипта, возвращённый из скрипта выражением return “результат”;.

executeOperation#

public Object executeOperation(String name)#

Отправляет на сервер команду выполнения операции по имени.

Для возможности выполнения скриптов, в конфигурации сервера должна быть активирована опция `<client><automation operExecution="true"/><client/>`

Parameters

  • name – Имя операции.

Returns

Строка с результатом выполнения операции, если операция возвращает результат.

find#

public static Optional<Selection> find(AbstractUiElement parent, String name)#

Метод ищет первый html-элемент, соответствующий выборке с именем name и отображением “Default”, во множестве дочерних html-элементов элемента parent.

Parameters

  • parent – родительский html-элемент

  • name – имя выборки

Returns

Опциональная выборка

find#

public static Optional<Selection> find(AbstractUiElement parent, String name, String representation)#

Метод ищет первый html-элемент, соответствующий выборке с именем name и отображением representation, во множестве дочерних html-элементов элемента parent.

Parameters

  • parent – родительский html-элемент

  • name – имя выборки

  • representation – отображение

Returns

Опциональная выборка

find#

public static Optional<Selection> find(AbstractUiElement parent, Name name)#

Метод ищет первый html-элемент, соответствующий выборке с именем и отображением указанным в name, во множестве дочерних html-элементов элемента parent.

Parameters

  • parent – родительский html-элемент

  • name – имя и отображение выборки

Returns

Опциональная выборка

findAll#

public static Selection[] findAll(BrowserContext browserContext)#

Метод ищет на странице все html-элементы, соответствующие выборкам.

Parameters

  • browserContext – Контекст браузера

Returns

Массив выборок

findAll#

public static Selection[] findAll(AbstractUiElement parent)#

Метод ищет все html-элементы, соответствующие выборкам, во множестве дочерних html-элементов элемента parent.

Parameters

  • parent – родительский html-элемент

Returns

массив выборок

findBySimpleName#

static Optional<Selection> findBySimpleName(AbstractUiElement parent, String simpleName, String representation)#

Метод ищет первый html-элемент, соответствующий выборке с именем завершающимся simpleName и отображением representation, во множестве дочерних html-элементов элемента parent.

Метод относится к системным и не вынесен в public намеренно. Не полные имена могут быть только у главных выборок приложений.

Parameters

  • parent – родительский html-элемент

  • simpleName – Краткое имя выборки

  • representation – отображение

Returns

Опциональная выборка

findBySimpleName#

static Optional<Selection> findBySimpleName(AbstractUiElement parent, Name name)#

Метод ищет первый html-элемент, соответствующий выборке с именем, завершающимся Name.getSimpleName(), и отображением Name.getRepresentation(), во множестве дочерних html-элементов элемента parent.

Метод относится к системным и не вынесен в public намеренно. Не полные имена могут быть только у главных выборок приложений.

Parameters

  • parent – родительский html-элемент

  • name – Краткое имя и отображение выборки

Returns

Опциональная выборка

get#

public static Selection get(AbstractUiElement parent, String name)#

Метод возвращает первый html-элемент, соответствующий выборке с именем name и отображением “Default”, во множестве дочерних html-элементов элемента parent.

Parameters

  • parent – родительский html-элемент

  • name – имя выборки

Throws
Returns

Выборка

get#

public static Selection get(AbstractUiElement parent, String name, String representation)#

Метод возвращает первый html-элемент, соответствующий выборке с именем name и отображением representation, во множестве дочерних html-элементов элемента parent.

Parameters

  • parent – родительский html-элемент

  • name – имя выборки

  • representation – отображение

Throws
Returns

Выборка

get#

public static Selection get(AbstractUiElement parent, Name name)#

Метод возвращает первый html-элемент, соответствующий выборке с именем и отображением указанным в name, во множестве дочерних html-элементов элемента parent.

Parameters

  • parent – родительский html-элемент

  • name – имя и отображение выборки

Throws
Returns

Выборка

getBySimpleName#

static Selection getBySimpleName(AbstractUiElement parent, String simpleName, String representation)#

Метод возвращает первый html-элемент, соответствующий выборке с именем завершающимся simpleName и отображением representation, во множестве дочерних html-элементов элемента parent.

Метод относится к системным и не вынесен в public намеренно. Не полные имена могут быть только у главных выборок приложений.

Parameters

  • parent – родительский html-элемент

  • simpleName – Краткое имя выборки

  • representation – отображение

Throws
Returns

выборка

getBySimpleName#

static Selection getBySimpleName(AbstractUiElement parent, Name name)#

Метод возвращает первый html-элемент, соответствующий выборке с именем, завершающимся Name.getSimpleName(), и отображением Name.getRepresentation(), во множестве дочерних html-элементов элемента parent.

Метод относится к системным и не вынесен в public намеренно. Не полные имена могут быть только у главных выборок приложений.

Parameters

  • parent – родительский html-элемент

  • name – Краткое имя и отображение выборки

Throws
Returns

Выборка

getId#

public String getId()#

Возвращает идентификатор выборки в виде строкового представления.

Returns

Идентификатор

getJexlSelectionLocateScript#

protected static String getJexlSelectionLocateScript(Map<String, Object> propertyMap, Selection.LocateOption[] locateOptions)#

Конструирование простого запроса вида “selection.locate”

Parameters

  • propertyMap – простая карта параметров.

  • locateOptions – массив опций запроса

Returns

строка, которую можно передать в метод executeJexl

getName#

public String getName()#

Возвращает полное имя.

Returns

полное имя.

getQualifiedName#

public Name getQualifiedName()#

Возвращает квалифицированное имя формы Name.

Returns

Квалифицированное имя.

getRepresentation#

public String getRepresentation()#

Возвращает отображение.

Returns

отображение.

layout#

public Layout layout()#

locate#

public Object locate(Map<String, Object> propertyMap)#

Метод, упрощающий написание вызова вида ‘selection.executeJexl(“selection.locate(asScala({‘id’: 353L}), asScala([…]))”);’. Собственно, именно такой вызов этот метод и делает.

Parameters

  • propertyMap – простая карта параметров.

Returns

результат

locate#

public Object locate(Map<String, Object> propertyMap, Selection.LocateOption[] locateOptions)#

Метод, упрощающий написание вызова вида ‘selection.executeJexl(“selection.locate(asScala({‘id’: 353L}), asScala([new ru.bitec.app.gtk.gl.selection.locateoption.Up(), …]))”);’. Собственно, именно такой вызов этот метод и делает, с учетом переданных :java:ref:`LocateOption <ru.bitec.gs.automation.client.ui.Selection.LocateOption>`[].

Parameters

  • propertyMap – простая карта параметров.

  • locateOptions – массив опций для selection.locate

Returns

результат

locateOptionArrayToString#

protected static String locateOptionArrayToString(Selection.LocateOption[] locateOptions)#

Конструирование строки опций для запроса вида “selection.locate”

Parameters

  • locateOptions – массив опций

Returns

строка

toString#

public String toString()#

wait#

public static Selection wait(AbstractUiElement parent, String name)#

Метод ожидает появления на dom-модели первого html-элемента, соответствующего выборке с именем name и отображением “Default”, во множестве дочерних html-элементов элемента parent.

Parameters

  • parent – родительский html-элемент

  • name – имя выборки

Returns

Выборка

wait#

public static Selection wait(AbstractUiElement parent, String name, String representation)#

Метод ожидает появления на dom-модели первого html-элемента, соответствующего выборке с именем name и отображением representation, во множестве дочерних html-элементов элемента parent.

Parameters

  • parent – родительский html-элемент

  • name – имя выборки

  • representation – отображение

Returns

Выборка

wait#

static Selection wait(AbstractUiElement parent, Name name)#

Метод ожидает появления на dom-модели первого html-элемента, соответствующего выборке с именем и отображением указанным в name, во множестве дочерних html-элементов элемента parent.

Parameters

  • parent – родительский html-элемент

  • name – имя и отображение выборки

Returns

Выборка

wait#

public static Selection wait(AbstractUiElement parent, Name name, Duration duration)#

Метод ожидает появления на dom-модели первого html-элемента, соответствующего выборке с именем и отображением указанным в name, во множестве дочерних html-элементов элемента parent.

Parameters

  • parent – родительский html-элемент

  • name – имя и отображение выборки

  • duration – длительность ожидания

Returns

Выборка

waitBySimpleName#

static Selection waitBySimpleName(AbstractUiElement parent, Name name)#

Метод ожидает появления на dom-модели первого html-элемента, соответствующего выборке с именем, завершающимся Name.getSimpleName(), и отображением Name.getRepresentation(), во множестве дочерних html-элементов элемента parent.

Метод относится к системным и не вынесен в public намеренно. Не полные имена могут быть только у главных выборок приложений.

Parameters

  • parent – родительский html-элемент

  • name – Краткое имя и отображение выборки

Returns

Выборка

waitBySimpleName#

static Selection waitBySimpleName(AbstractUiElement parent, Name name, Duration duration)#

Метод ожидает появления на dom-модели первого html-элемента, соответствующего выборке с именем, завершающимся Name.getSimpleName(), и отображением Name.getRepresentation(), во множестве дочерних html-элементов элемента parent.

Метод относится к системным и не вынесен в public намеренно. Не полные имена могут быть только у главных выборок приложений.

Parameters

  • parent – родительский html-элемент

  • name – Краткое имя и отображение выборки

  • duration – Длительность ожидания

Returns

Выборка