Package io.jmix.flowui.view
Class ViewValidation
java.lang.Object
io.jmix.flowui.view.ViewValidation
-
Nested Class Summary
Modifier and TypeClassDescriptionstatic class
Callbacks holder for saving or discarding unsaved changes dialog.static class
Callbacks holder for discarding unsaved changes dialog. -
Field Summary
Modifier and TypeFieldDescriptionprotected Dialogs
protected Messages
protected Notifications
protected jakarta.validation.Validator
protected UiViewProperties
-
Constructor Summary
ConstructorDescriptionViewValidation
(Messages messages, jakarta.validation.Validator validator, Dialogs dialogs, UiViewProperties viewProperties, Notifications notifications) -
Method Summary
Modifier and TypeMethodDescriptionprotected Collection<ValidationErrors.Item>
collectValidationErrorItems
(ValidationException e, com.vaadin.flow.component.Component component) void
Focuses a component corresponding to the first validation error, if there is one.static String
Creates a message explaining the given validation errors.showSaveConfirmationDialog
(View<?> origin) Shows confirmation dialog about saving or discarding unsaved changes.showUnsavedChangesDialog
(View<?> origin) Shows confirmation dialog about discarding unsaved changes.void
showValidationErrors
(ValidationErrors errors) Shows a notification with validation errors.protected void
showValidationErrorsNotification
(ValidationErrors errors, int duration, com.vaadin.flow.component.notification.Notification.Position position, Notifications.Type type) protected Collection<ValidationErrors.Item>
validate
(SupportsValidation<?> component) validateBeanGroup
(Class<?> groupClass, Object item) Performs Java Bean Validation of the given object.validateUiComponent
(com.vaadin.flow.component.Component component) Validates UI component by invoking theirSupportsValidation.executeValidators()
.validateUiComponents
(com.vaadin.flow.component.Component container) Validates UI components located inside the given container by invoking theirSupportsValidation.executeValidators()
.validateUiComponents
(Collection<com.vaadin.flow.component.Component> components) Validates UI components by invoking theirSupportsValidation.executeValidators()
.
-
Field Details
-
messages
-
validator
protected jakarta.validation.Validator validator -
dialogs
-
notifications
-
viewProperties
-
-
Constructor Details
-
ViewValidation
@Autowired public ViewValidation(Messages messages, jakarta.validation.Validator validator, Dialogs dialogs, UiViewProperties viewProperties, Notifications notifications)
-
-
Method Details
-
validateUiComponents
Validates UI components located inside the given container by invoking theirSupportsValidation.executeValidators()
.- Parameters:
container
- a component that can contain other components- Returns:
- validation errors
-
validateUiComponents
public ValidationErrors validateUiComponents(Collection<com.vaadin.flow.component.Component> components) Validates UI components by invoking theirSupportsValidation.executeValidators()
.- Parameters:
components
- components collection- Returns:
- validation errors
-
validateUiComponent
Validates UI component by invoking theirSupportsValidation.executeValidators()
.- Parameters:
component
- UI component- Returns:
- validation errors
-
validateBeanGroup
Performs Java Bean Validation of the given object.- Parameters:
groupClass
- the group or list of groups targeted for validationitem
- object to validate- Returns:
- validation errors
-
showValidationErrors
Shows a notification with validation errors.- Parameters:
errors
- validation errors
-
showValidationErrorsNotification
protected void showValidationErrorsNotification(ValidationErrors errors, int duration, com.vaadin.flow.component.notification.Notification.Position position, Notifications.Type type) -
focusProblemComponent
Focuses a component corresponding to the first validation error, if there is one.- Parameters:
errors
- validation errors
-
getValidationErrorsMessage
Creates a message explaining the given validation errors.- Parameters:
errors
- validation errors- Returns:
- error messsage
-
validate
-
collectValidationErrorItems
protected Collection<ValidationErrors.Item> collectValidationErrorItems(ValidationException e, com.vaadin.flow.component.Component component) -
showUnsavedChangesDialog
Shows confirmation dialog about discarding unsaved changes.The options invoke the callback methods of the returned
ViewValidation.UnsavedChangesDialogResult
object.- Parameters:
origin
- view controller- Returns:
- object that contains "discard" and "cancel" callbacks to be assigned by the caller.
-
showSaveConfirmationDialog
Shows confirmation dialog about saving or discarding unsaved changes.The options invoke the callback methods of the returned
ViewValidation.SaveChangesDialogResult
object.- Parameters:
origin
- view controller- Returns:
- object that contains "save", "discard" and "cancel" callbacks to be assigned by the caller.
-