com.haulmont.cuba.web.sys

Class WebDialogs.InputDialogBuilderImpl

java.lang.Object

com.haulmont.cuba.web.sys.WebDialogs.InputDialogBuilderImpl

All Implemented Interfaces:

Dialogs.InputDialogBuilder

Enclosing class:

WebDialogs

public class WebDialogs.InputDialogBuilderImpl
extends java.lang.Object
implements Dialogs.InputDialogBuilder

Field Summary

Fields

Modifier and Type	Field and Description
protected InputDialog	inputDialog

Constructor Summary

Constructors

Constructor and Description
InputDialogBuilderImpl(FrameOwner owner)

Method Summary

Modifier and Type	Method and Description
InputDialog	build() Builds the input dialog.
java.util.Collection<Action>	getActions()
java.lang.String	getCaption()
java.util.function.Consumer<InputDialog.InputDialogCloseEvent>	getCloseListener()
DialogActions	getDialogActions()
float	getHeight()
java.util.Collection<InputParameter>	getParameters()
java.util.function.Consumer<InputDialog.InputDialogResult>	getResultHandler()
java.util.function.Function<InputDialog.ValidationContext,ValidationErrors>	getValidator()
float	getWidth()
InputDialog	show() Shows the dialog.
Dialogs.InputDialogBuilder	withActions(DialogActions actions) Sets predefined dialog actions.
Dialogs.InputDialogBuilder	withActions(DialogActions actions, java.util.function.Consumer<InputDialog.InputDialogResult> resultHandler) Sets dialog actions and result handler.
Dialogs.InputDialogBuilder	withActions(InputDialogAction... actions) Sets dialog actions.
Dialogs.InputDialogBuilder	withCaption(java.lang.String caption) Sets dialog screen caption.
Dialogs.InputDialogBuilder	withCloseListener(java.util.function.Consumer<InputDialog.InputDialogCloseEvent> listener) Add close listener to the dialog.
Dialogs.InputDialogBuilder	withHeight(java.lang.String height) Sets dialog height.
Dialogs.InputDialogBuilder	withParameter(InputParameter parameter) Adds input parameter to the dialog.
Dialogs.InputDialogBuilder	withParameters(InputParameter... parameters) Sets input parameters.
Dialogs.InputDialogBuilder	withValidator(java.util.function.Function<InputDialog.ValidationContext,ValidationErrors> validator) Sets additional handler for field validation.
Dialogs.InputDialogBuilder	withWidth(java.lang.String width) Sets dialog width.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

inputDialog

protected InputDialog inputDialog

Constructor Detail

InputDialogBuilderImpl

public InputDialogBuilderImpl(FrameOwner owner)

Method Detail

withParameter

public Dialogs.InputDialogBuilder withParameter(InputParameter parameter)

Description copied from interface: Dialogs.InputDialogBuilder

Adds input parameter to the dialog. InputParameter describes field which will be used in the input dialog.

Example:

  dialogs.createInputDialog(this)
         .withParameter(
                 entityParameter("userField", User.class)
                         .withCaption("User field")
                         .withRequired(true)
         )
         .show();
  

Specified by:

withParameter in interface Dialogs.InputDialogBuilder

Parameters:

parameter - input parameter that will be added to the dialog

Returns:

builder

See Also:

InputParameter.entityParameter(String, Class)

withParameters

public Dialogs.InputDialogBuilder withParameters(InputParameter... parameters)

Description copied from interface: Dialogs.InputDialogBuilder

Sets input parameters. InputParameter describes field which will be used in the input dialog.

Example:

  dialogs.createInputDialog(this)
          .withParameters(
                  stringParameter("nameField")
                          .withCaption("Name field caption")
                          .withDefaultValue("default value"),
                  intParameter("countField")
                          .withCaption("Count field caption")
                          .withRequired(true))
          .show();
   

Specified by:

withParameters in interface Dialogs.InputDialogBuilder

Parameters:

parameters - input parameters

Returns:

builder

See Also:

InputParameter.stringParameter(String), InputParameter.intParameter(String)

getParameters

public java.util.Collection<InputParameter> getParameters()

withCloseListener

public Dialogs.InputDialogBuilder withCloseListener(java.util.function.Consumer<InputDialog.InputDialogCloseEvent> listener)

Description copied from interface: Dialogs.InputDialogBuilder

Add close listener to the dialog. See close actions for DialogActions in InputDialog.

Specified by:

withCloseListener in interface Dialogs.InputDialogBuilder

Parameters:

listener - close listener to add

Returns:

builder

getCloseListener

public java.util.function.Consumer<InputDialog.InputDialogCloseEvent> getCloseListener()

withActions

public Dialogs.InputDialogBuilder withActions(InputDialogAction... actions)

Description copied from interface: Dialogs.InputDialogBuilder

Sets dialog actions. InputDialogAction provides access to input dialog in InputDialogAction.InputDialogActionPerformed where it is possible to get values form the fields and implement logic to close dialog.

Note, if there is no actions are set input dialog will use DialogActions.OK_CANCEL by default.

Example:

  dialogs.createInputDialog(this)
         .withCaption("Dialog caption")
         .withParameter(parameter("nameField").withCaption("Name"))
         .withActions(
                 action("okAction")
                         .withCaption("OK")
                         .withIcon(CubaIcon.DIALOG_OK)
                         .withHandler(event -> {
                             InputDialog inputDialog = event.getInputDialog();
                             String name = inputDialog.getValue("nameField");
                             // do logic
                             inputDialog.close(InputDialog.INPUT_DIALOG_OK_ACTION);
                         }),
                 action("cancelAction")
                         .withCaption("Cancel")
                         .withIcon(CubaIcon.DIALOG_CANCEL)
                         .withValidationRequired(false)
                         .withHandler(event -> {
                             InputDialog inputDialog = event.getInputDialog();
                             inputDialog.close(InputDialog.INPUT_DIALOG_CANCEL_ACTION);
                         }))
         .show();
 
 

Specified by:

withActions in interface Dialogs.InputDialogBuilder

Parameters:

actions - actions

Returns:

builder

See Also:

InputDialogAction.action(String)

getActions

public java.util.Collection<Action> getActions()

withActions

public Dialogs.InputDialogBuilder withActions(DialogActions actions)

Description copied from interface: Dialogs.InputDialogBuilder

Sets predefined dialog actions. "OK" and "YES" actions always check fields validation before close the dialog. By default if there is no actions are set input dialog will use DialogActions.OK_CANCEL.

Specified by:

withActions in interface Dialogs.InputDialogBuilder

Parameters:

actions - actions

Returns:

builder

withActions

public Dialogs.InputDialogBuilder withActions(DialogActions actions,
                                              java.util.function.Consumer<InputDialog.InputDialogResult> resultHandler)

Description copied from interface: Dialogs.InputDialogBuilder

Sets dialog actions and result handler. "OK" and "YES" actions always check fields validation before close the dialog. Handler is invoked after close event and can be used instead of Dialogs.InputDialogBuilder.withCloseListener(Consumer). Example

  dialogs.createInputDialog(this)
         .withCaption("Dialog caption")
         .withParameter(parameter("nameField").withCaption("Name"))
         .withActions(DialogActions.OK_CANCEL, result -> {
             switch (result.getCloseActionType()) {
                 case OK:
                     String name = result.getValue("nameField");
                     // do logic
                     break;
                 case CANCEL:
                     // do logic
                     break;
             }
         })
         .show();
  

Specified by:

withActions in interface Dialogs.InputDialogBuilder

Parameters:

actions - dialog actions

resultHandler - result handler

Returns:

builder

getDialogActions

public DialogActions getDialogActions()

getResultHandler

@Nullable
public java.util.function.Consumer<InputDialog.InputDialogResult> getResultHandler()

withValidator

public Dialogs.InputDialogBuilder withValidator(java.util.function.Function<InputDialog.ValidationContext,ValidationErrors> validator)

Description copied from interface: Dialogs.InputDialogBuilder

Sets additional handler for field validation. It receives input dialog context and must return ValidationErrors instance. Returned validation errors will be shown with another errors from fields. Example

  dialogs.createInputDialog(this)
         .withParameters(
                 stringParameter("phoneField").withCaption("Phone"),
                 stringParameter("addressField").withCaption("Address"))
         .withValidator(context -> {
             String phone = context.getValue("phoneField");
             String address = context.getValue("addressField");
             if (Strings.isNullOrEmpty(phone) && Strings.isNullOrEmpty(address)) {
                 return ValidationErrors.of("Phone or Address should be filled");
             }
             return ValidationErrors.none();
         })
         .show();
  

Specified by:

withValidator in interface Dialogs.InputDialogBuilder

Parameters:

validator - validator

Returns:

builder

getValidator

public java.util.function.Function<InputDialog.ValidationContext,ValidationErrors> getValidator()

withCaption

public Dialogs.InputDialogBuilder withCaption(java.lang.String caption)

Description copied from interface: Dialogs.InputDialogBuilder

Sets dialog screen caption.

Specified by:

withCaption in interface Dialogs.InputDialogBuilder

Parameters:

caption - dialog screen caption

Returns:

builder

withWidth

public Dialogs.InputDialogBuilder withWidth(java.lang.String width)

Description copied from interface: Dialogs.InputDialogBuilder

Sets dialog width.

Specified by:

withWidth in interface Dialogs.InputDialogBuilder

Parameters:

width - dialog width

Returns:

builder

getWidth

public float getWidth()

withHeight

public Dialogs.InputDialogBuilder withHeight(java.lang.String height)

Description copied from interface: Dialogs.InputDialogBuilder

Sets dialog height.

Specified by:

withHeight in interface Dialogs.InputDialogBuilder

Parameters:

height - dialog height

Returns:

builder

getHeight

public float getHeight()

getCaption

@Nullable
public java.lang.String getCaption()

show

public InputDialog show()

Description copied from interface: Dialogs.InputDialogBuilder

Shows the dialog.

Specified by:

show in interface Dialogs.InputDialogBuilder

Returns:

opened input dialog

build

public InputDialog build()

Description copied from interface: Dialogs.InputDialogBuilder

Builds the input dialog.

Specified by:

build in interface Dialogs.InputDialogBuilder

Returns:

input dialog