Методы экранов

close() - запрашивает закрытие экрана с переданным результатом - значением перечисления StandardOutcome или объектом CloseAction.

@Subscribe("discardButton")
public void onDiscardButtonClick(ClickEvent<Button> event) {
    close(StandardOutcome.DISCARD);
}

closeWithDefaultAction() - запрашивает закрытие экрана с результатом StandardOutcome.CLOSE.

setPreventBrowserTabClosing() - устанавливает, должен ли этот экран предотвращать случайное закрытие вкладки браузера, если свойство jmix.ui.view.prevent-browser-tab-closing установлено в true (по умолчанию false). Включено по умолчанию для экранов деталей.

getViewData() - возвращает объект ViewData, который служит реестром всех компонентов данных, определенных в XML-дескрипторе экрана. Вы можете использовать его метод loadAll(), чтобы запустить все загрузчики данных экрана:

@Subscribe
public void onReady(final ReadyEvent event) {
    getViewData().loadAll();
}

getViewAttributes() - возвращает объект ViewAttributes, который служит хранилищем именованных значений. Использует VaadinSession для хранения. Например, экран деталей использует ViewAttributes для хранения состояния только чтение и статуса блокировки и возвращения этих установок при обновлении экрана.

getPageTitle() - возвращает заголовок экрана. По умолчанию возвращает локализованное значение, определенное в XML-дескрипторе экрана. Может быть переопределен для динамического предоставления заголовка, например:

@Override
public String getPageTitle() {
    User user = getEditedEntity();
    return entityStates.isNew(user)
            ? messageBundle.getMessage("newUserTitle")
            : messageBundle.formatMessage("editUserTitle", metadataTools.getInstanceName(user));

}

beforeLeave() - callback, который выполняется перед переходом на другой экран. Часть жизненного цикла навигации Vaadin.

beforeEnter() - callback, который выполняется перед переходом на экран. Часть жизненного цикла навигации Vaadin.

afterNavigation() - callback, который выполняется после завершения навигации. Часть жизненного цикла навигации Vaadin.

closeWithDiscard() - запрашивает закрытие экрана с результатом StandardOutcome.DISCARD.

getLookupComponent() / findLookupComponent() - возвращает компонент для получения значения из данного экрана списка. По умолчанию, возвращает компонент с id, указанным в аннотации @LookupComponent.

setSelectionValidator() - устанавливает предикат, который проверяет, могут ли выбранные элементы быть обработаны SelectionHandler.

setSelectionHandler() - устанавливает callback, который обрабатывает выбранные элементы. По умолчанию, добавляет элементы в collection container, если просмотр списка открыт для компонента dataGrid или устанавливает одиночное значение, если экран списка открыт для поля, например entityPicker.

DialogWindow<View<?>> dialog = dialogWindows.lookup(ProjectDetailView.this, User.class) (1)
        .withSelectHandler(users -> { (2)
            for (User user : users) {
                ProjectParticipant projectParticipant = dataManager.create(ProjectParticipant.class);
                projectParticipant.setUser(user);
                projectParticipant.setProject(getEditedEntity());
                projectParticipant.setRole(projectRole);
                participantsDc.getMutableItems().add(projectParticipant);
            }
        })
        .build();

View<?> view = dialog.getView();
if (view instanceof MultiSelectLookupView multiSelectLookupView) { (3)
    multiSelectLookupView.setLookupComponentMultiSelect(true);
}

dialog.open();

getEditedEntity() - когда экран открыт, возвращает экземпляр редактируемой сущности. Это экземпляр, который установлен в контейнер данных, указанный в аннотации @EditedEntityContainer.

closeWithSave() - проверяет и сохраняет изменения, затем закрывает экран с результатом StandardOutcome.SAVE. Вы можете вызвать этот метод из слушателя события (например, ClickEvent) или добавить в экран встроенное действие detail_saveClose.

closeWithDiscard() - игнорирует любые несохраненные изменения и закрывает экран с результатом StandardOutcome.DISCARD. Вы можете вызвать этот метод из слушателя события (например, ClickEvent) или добавить в экран встроенное действие detail_discard.

hasUnsavedChanges() - возвращает true, если в экране есть несохраненные изменения. Реализация по умолчанию проверяет, есть ли удаленные или измененные сущности в DataContext. Если только новые сущности были зарегистрированы как измененные в DataContext, проверяет, были ли они изменены с момента открытия экрана. Этот метод можно переопределить и провести дополнительные проверки, или пропустить проверку и просто вернуть false.

save() - валидирует и сохраняет изменения без закрытия экрана. Вы можете вызвать этот метод из слушателя события (например, ClickEvent) или добавить в экран встроенное действие detail_save. Кроме того, метод save() можно переопределить для выполнения некоторых операций после сохранения данных, например:

@Override
public OperationResult save() {
    return super.save()     (1)
            .then(() -> {
                // ...      (2)
            });
}

setReloadSaved(boolean) - устанавливает, должен ли редактируемый экземпляр сущности быть перезагружен после вызова closeWithSave() метода. По умолчанию false.

setShowSaveNotification(boolean) - устанавливает, должно ли быть показано уведомление при успешном сохранении. По умолчанию true.

setShowValidationErrors(boolean) - устанавливает, должны ли быть показаны ошибки после валидации компонентов с помощью метода showValidationErrors(). По умолчанию true.

setCrossFieldValidationEnabled(boolean) - устанавливает, должна ли выполняться кросс-проверка полей перед сохранением изменений. Использует группу ограничений UiCrossFieldChecks для проверки экземпляра сущности. По умолчанию true.

getLockStatus() - Возвращает статус пессимистической блокировки текущего редактируемого экземпляра сущности. Возможные варианты: