universum.studios.android.form

Class FormEditableLayout

java.lang.Object

universum.studios.android.form.BaseFormComponent<EditLayout,CharSequence>

universum.studios.android.form.FormEditableLayout

All Implemented Interfaces:

FormComponent<EditLayout,CharSequence>

public class FormEditableLayout
extends BaseFormComponent<EditLayout,CharSequence>

A BaseFormComponent implementation which wraps form EditLayout into component that can be validated by FormValidator when validating a form in which is such a layout presented.

Author:

Martin Albedinsky

See Also:

FormEditable

Constructor Summary

Constructors

Constructor and Description
FormEditableLayout(EditLayout editable) Same as FormEditableLayout(EditLayout, String) with FormEditable.NOT_EMPTY_REG_EXP for regExp parameter.
FormEditableLayout(EditLayout editable, int regExpResId) Same as FormEditableLayout(EditLayout, String) for regular expression resource id.
FormEditableLayout(EditLayout editable, String regExp) Creates a new instance of FormEditable component for the given editable view with the specified regular expression.
FormEditableLayout(int id) Same as FormEditableLayout(int, String) with FormEditable.NOT_EMPTY_REG_EXP for regExp parameter.
FormEditableLayout(int id, int regExpResId) Creates a new instance of FormEditableLayout component for an an editable input layout with the specified id.
FormEditableLayout(int id, String regExp) Creates a new instance of FormEditableLayout component for an editable input layout with the specified id and the specified regular expression.

Method Summary

Modifier and Type	Method and Description
void	clearError() Clears the current error (if any) of this form component specified via FormComponent.setError(CharSequence).
Editable	getEditableInput() Returns the current editable value of the attached text field view.
CharSequence	getInput() Returns the current input presented by an attached view of this form component.
boolean	hasInputChanged() Checks whether the current value of this form component has changed since its last validation.
protected void	onAttachedToValidator(FormValidator validator) Invoked whenever this form component is assigned to the passed validator.
protected boolean	onValidate(CharSequence input) Invoked whenever BaseFormComponent.validate() is called.
void	setError(CharSequence errorMessage) Sets an error for this form component.

Methods inherited from class universum.studios.android.form.BaseFormComponent

attachToValidator, findComponent, findComponentTraversal, getId, getLastValidatedInput, getResources, getValidator, getView, hasError, isAttachedToValidator, obtainString, obtainText, onComponentViewAttached, resetCurrentState, setHasError, validate

Methods inherited from class java.lang.Object

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

Constructor Detail

FormEditableLayout

public FormEditableLayout(@IdRes
                          int id)

Same as FormEditableLayout(int, String) with FormEditable.NOT_EMPTY_REG_EXP for regExp parameter.

FormEditableLayout

public FormEditableLayout(@IdRes
                          int id,
                          @NonNull
                          String regExp)

Creates a new instance of FormEditableLayout component for an editable input layout with the specified id and the specified regular expression.

Parameters:

id - Id used to find the editable layout within the form view hierarchy of the associated FormValidator via FormValidator.findViewById(int).

regExp - The desired regular expression that is used to validate editable value obtained from the editable view during the validation process.

FormEditableLayout

public FormEditableLayout(@IdRes
                          int id,
                          @StringRes
                          int regExpResId)

Creates a new instance of FormEditableLayout component for an an editable input layout with the specified id.

Parameters:

id - Id used to find the editable layout within the form view hierarchy of the associated FormValidator via FormValidator.findViewById(int).

regExpResId - Resource id of the desired regular expression that is used to validate editable value obtained from the editable view during the validation process.

FormEditableLayout

public FormEditableLayout(@NonNull
                          EditLayout editable)

Same as FormEditableLayout(EditLayout, String) with FormEditable.NOT_EMPTY_REG_EXP for regExp parameter.

FormEditableLayout

public FormEditableLayout(@NonNull
                          EditLayout editable,
                          @StringRes
                          int regExpResId)

Same as FormEditableLayout(EditLayout, String) for regular expression resource id.

Parameters:

regExpResId - Resource id of the desired regular expression.

FormEditableLayout

public FormEditableLayout(@NonNull
                          EditLayout editable,
                          @NonNull
                          String regExp)

Creates a new instance of FormEditable component for the given editable view with the specified regular expression.

Parameters:

editable - Editable input layout, which should be validated.

regExp - The desired regular expression used to validate editable value obtained from the editable view during the validation process.

See Also:

BaseFormComponent.BaseFormComponent(int, View)

Method Detail

hasInputChanged

public boolean hasInputChanged()

Description copied from interface: FormComponent

Checks whether the current value of this form component has changed since its last validation.

Basically, whenever this returns true this component should be validated, otherwise there is no need given the fact that its value did not change.

Specified by:

hasInputChanged in interface FormComponent<EditLayout,CharSequence>

Overrides:

hasInputChanged in class BaseFormComponent<EditLayout,CharSequence>

Returns:

True if the current value is different from the one that has been last time validated via FormComponent.validate(), false otherwise.

onValidate

protected boolean onValidate(@NonNull
                             CharSequence input)

Description copied from class: BaseFormComponent

Invoked whenever BaseFormComponent.validate() is called. Note, that there will be BaseFormComponent.resetCurrentState() always called before this.

Specified by:

onValidate in class BaseFormComponent<EditLayout,CharSequence>

Parameters:

input - Current input of this form component to be validated.

Returns:

Should return true if the current form component's view state passed validation requirements, false otherwise.

See Also:

FormComponent.getInput()

getInput

@NonNull
public CharSequence getInput()

Description copied from interface: FormComponent

Returns the current input presented by an attached view of this form component. Type of input is determined by a specific form component type and may vary.

Returns:

Current input of this form component presented by its view.

getEditableInput

@Nullable
public Editable getEditableInput()

Returns the current editable value of the attached text field view.

Returns:

Current editable, or null if view of this component is null.

setError

public void setError(@NonNull
                     CharSequence errorMessage)

Description copied from interface: FormComponent

Sets an error for this form component.

Note, that a specific implementations can ignore this call and also depends on the specific implementation how the requested error parameter will be shown.

Parameters:

errorMessage - The desired error message.

See Also:

FormComponent.clearError()

clearError

public void clearError()

Description copied from interface: FormComponent

Clears the current error (if any) of this form component specified via FormComponent.setError(CharSequence).

Specified by:

clearError in interface FormComponent<EditLayout,CharSequence>

Overrides:

clearError in class BaseFormComponent<EditLayout,CharSequence>

onAttachedToValidator

protected void onAttachedToValidator(@NonNull
                                     FormValidator validator)

Description copied from class: BaseFormComponent

Invoked whenever this form component is assigned to the passed validator.

Overrides:

onAttachedToValidator in class BaseFormComponent<EditLayout,CharSequence>

Parameters:

validator - An instance of FormValidator to which was this form component newly assigned.