Package com.storedobject.ui

Class SteppedObjectForm<T extends StoredObject>

java.lang.Object

com.storedobject.vaadin.View

com.storedobject.ui.SteppedView

com.storedobject.ui.SteppedObjectForm<T>

Type Parameters:

T - Type of object.

All Implemented Interfaces:

Executable, Reentrant, HasLogic, ObjectSetter<T>, Transactional, ClickHandler, ExecutableView, ValueChangeHandler, com.vaadin.flow.component.ComponentEventListener<com.vaadin.flow.component.ClickEvent<? extends com.vaadin.flow.component.Component>>, com.vaadin.flow.component.HasValue.ValueChangeListener, Serializable, Runnable, EventListener, Consumer<T>

public class SteppedObjectForm<T extends StoredObject>
extends SteppedView
implements ObjectSetter<T>

A Form for editing an object that has multiple steps of content views.

Author:

Syam

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface com.storedobject.vaadin.ClickHandler

ClickHandler.ModifiedClickEvent<C extends com.vaadin.flow.component.Component>

Constructor Summary

Constructors

Constructor	Description
SteppedObjectForm(Class<T> objectClass, int numberOfSteps)	Constructor.
SteppedObjectForm(Class<T> objectClass, int numberOfSteps, String caption)	Constructor.

Method Summary

Modifier and Type	Method	Description
protected final boolean	commit(int step)	This method is invoked before invoking SteppedView.complete(int) and if it raises any error or returns false, forward movement will be stopped.
protected ObjectForm<T>	createObjectForm(int step)	Create the form for the step.
protected void	enter(int step)	This method is invoked when you enter into this step.
protected void	execute(View parent, boolean doNotLock)	Override this if you want to do something before the View comes up on the screen.
protected StringList	getFields(int step)	Get field names for the step.
protected IncludeField	getIncludeFieldChecker(int step)	Return the "include field checker" for the step.
T	getObject()	Get the currenct object value.
final Class<T>	getObjectClass()	Get the class of the object.
protected final ObjectForm<T>	getObjectForm(int step)	Get the form for the step.
Id	getObjectId()	Get the Id of the current object value.
protected final com.vaadin.flow.component.Component	getStepComponent(int step)	Get the component to be used for the respective step.
void	setObject(T object)	Set the object (to all the steps).

Methods inherited from class com.storedobject.ui.SteppedView

addExtraButton, align, back, cancel, center, complete, complete, finish, formsConstructed, getStepCaption, getStepLabel, goToStep, hideBackButton, hideCancelButton, hideFinishButton, hideNextButton, initUI, isFinalStep, isFirstStep, justify, nextStep, previousStep, setBackLabel, setCancelLabel, setFinishLabel, setNextLabel, unhideBackButton, unhideCancelButton, unhideFinishButton, unhideNextButton

Methods inherited from class com.storedobject.vaadin.View

abort, aborted, addClosedListener, addOpenedListener, clean, close, createCloseableView, createWindow, decorateComponent, execute, execute, executing, focus, focus, focusAny, getApplication, getCaption, getComponent, getContent, getCreatedBy, getEmbeddedView, getMenuItem, getMenuItem, getView, invoke, isFullScreen, isScrollable, isWindowMode, select, setCaption, setComponent, setCreatedBy, setDefaultPadding, setEmbeddedView, setFirstFocus, setFullScreen, setScrollable, setWindowMode, skipFirstFocus

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.storedobject.vaadin.ClickHandler

clicked, doubleClicked, onComponentEvent, rightClicked

Methods inherited from interface java.util.function.Consumer

andThen

Methods inherited from interface com.storedobject.common.Executable

act

Methods inherited from interface com.storedobject.vaadin.ExecutableView

abort, clean, clearAlerts, clicked, close, createMenuItem, error, execute, getApplication, getCaption, getMenuIconName, getMenuItem, getView, getView, invoke, isCloseable, isFullScreen, isHomeView, log, log, message, returnedFrom, run, setCaption, setClickable, speak, trackValueChange, tray, valueChanged, warning

Methods inherited from interface com.storedobject.core.ObjectSetter

accept, isAllowAny, setObject

Methods inherited from interface com.storedobject.common.Reentrant

isReentrant

Methods inherited from interface com.storedobject.ui.Transactional

commit, execute, getLogic, getTransactionManager, run, setLogic, transact, transact, transactControl, transactControl

Methods inherited from interface com.storedobject.vaadin.ValueChangeHandler

valueChanged

Constructor Details

SteppedObjectForm

public SteppedObjectForm(Class<T> objectClass,
 int numberOfSteps)

Constructor.

Parameters:

objectClass - Class of the object

numberOfSteps - Number of steps

SteppedObjectForm

public SteppedObjectForm(Class<T> objectClass,
 int numberOfSteps,
 String caption)

Constructor.

Parameters:

objectClass - Class of the object

numberOfSteps - Number of steps

caption - Caption for the view

Method Details

execute

protected void execute(View parent,
 boolean doNotLock)

Description copied from class: View

Override this if you want to do something before the View comes up on the screen. Call super.execute(parent, doNotLock) to make the View appear on the screen. Parent view is automatically selected when this view closes.

Overrides:

execute in class View

Parameters:

parent - Parent-view to lock

doNotLock - True if parent should not be locked

commit

protected final boolean commit(int step)
                        throws Exception

Description copied from class: SteppedView

This method is invoked before invoking SteppedView.complete(int) and if it raises any error or returns false, forward movement will be stopped.

Overrides:

commit in class SteppedView

Parameters:

step - Step

Returns:

True if the commit operation is successful.

Throws:

Exception - Any exception

getStepComponent

protected final com.vaadin.flow.component.Component getStepComponent(int step)

Description copied from class: SteppedView

Get the component to be used for the respective step. (After creating your component, you may invoke one of these static methods to position the component if needed: SteppedView.align(Component, CSSGrid.Position), SteppedView.justify(Component, CSSGrid.Position), SteppedView.center(Component)).

Overrides:

getStepComponent in class SteppedView

Parameters:

step - Step

Returns:

Component to be added. (Default implementation) returns null.

getObjectForm

protected final ObjectForm<T> getObjectForm(int step)

Get the form for the step.

Parameters:

step - Step

Returns:

Form for the step.

createObjectForm

protected ObjectForm<T> createObjectForm(int step)

Create the form for the step.

Parameters:

step - Step

Returns:

Form for the step. If returned null a default form will be created for the class of the object. Default implementation returns null.

getIncludeFieldChecker

protected IncludeField getIncludeFieldChecker(int step)

Return the "include field checker" for the step. If this method returns a non-null value, that will be used to filter out field names of the object in this step, otherwise, getFields(int) will be used to identify the fields.

Parameters:

step - Step

Returns:

Default implementation returns null.

getFields

protected StringList getFields(int step)

Get field names for the step. This will be invoked only if getIncludeFieldChecker(int) returns null.

Parameters:

step - Step

Returns:

Default implementation returns null.

enter

protected void enter(int step)

Description copied from class: SteppedView

This method is invoked when you enter into this step.

Overrides:

enter in class SteppedView

Parameters:

step - Step

getObjectClass

public final Class<T> getObjectClass()

Get the class of the object.

Specified by:

getObjectClass in interface ObjectSetter<T extends StoredObject>

Returns:

Class of the object.

setObject

public void setObject(T object)

Set the object (to all the steps).

Specified by:

setObject in interface ObjectSetter<T extends StoredObject>

Parameters:

object - Object to set

getObject

public T getObject()

Get the currenct object value.

Returns:

Current object value.

getObjectId

public Id getObjectId()

Get the Id of the current object value.

Returns:

Id of the current object or null if the object value is null.