Package de.xima.fc.form.common.models
Interface IXBaseValidationParams
-
- All Superinterfaces:
Serializable
- All Known Subinterfaces:
IXGlobalValidationParams,IXValidationParams
- All Known Implementing Classes:
XGlobalValidationParams,XValidationParams
public interface IXBaseValidationParams extends Serializable
Base interface with common methods for bothIXValidationParamsandIXGlobalValidationParams.- Since:
- 6.6.3
- Author:
- XIMA MEDIA GmbH
-
-
Method Summary
All Methods Instance Methods Abstract Methods Default Methods Modifier and Type Method Description longgetClientId()Map<String,? extends IFormContainerMetaData>getDynContainerMap()Map<String,List<String[]>>getFieldValuesMap()IXFormRenderConfiggetFormRenderConfig()Map<Serializable,Serializable>getFRQSessionAttributes()StringgetI18nValue(String i18nKey)default LocalegetLocale()List<String[]>getValues(String key)booleanisServerValidationRequiredBySubmitAction()Gets whether the submit buttons that was used to submit the form requires server-side validation.booleanisShouldValidate()Whether server-side validation should be performed.booleanisValuesEmpty(List<String[]> values)
-
-
-
Method Detail
-
getClientId
long getClientId()
- Returns:
- The ID of the current client to which the form belongs.
-
getFieldValuesMap
Map<String,List<String[]>> getFieldValuesMap()
- Returns:
- A map with all values that were submitted. The key is the name of a form field.
-
getDynContainerMap
Map<String,? extends IFormContainerMetaData> getDynContainerMap()
- Returns:
- A map with the meta data for repeated elements. The key is the name of a form field.
-
getFormRenderConfig
IXFormRenderConfig getFormRenderConfig()
- Returns:
- The current form render config for accessing the global configuration of the validation process.
-
getFRQSessionAttributes
Map<Serializable,Serializable> getFRQSessionAttributes()
- Returns:
- All attributes from the current form request session.
-
getI18nValue
String getI18nValue(String i18nKey)
- Parameters:
i18nKey- I18n key for the localized message.- Returns:
- The localized message for the given key, retrieved from the built-in resource bundle. Plugin resource bundles are not considered.
-
getLocale
default Locale getLocale()
- Returns:
- The current locale to be used for creating error messages.
-
getValues
List<String[]> getValues(String key)
- Parameters:
key- Name of a form field.- Returns:
- All values that were submitted for the given for the given form field name. The list contains multiple
items when the form field is repeated; the array contains multiple items when the form field submitted
multiple values (e.g. a select element with
multipleset).
-
isValuesEmpty
boolean isValuesEmpty(List<String[]> values)
- Parameters:
values- List of values of a form field.- Returns:
trueif the values are all empty, orfalseotherwise.
-
isShouldValidate
boolean isShouldValidate()
Whether server-side validation should be performed. Server-validation may be disabled due to one of several reasons.For the form in general:
- The form action does not require validation. When designing a form, the user can choose whether the form
should be validated when a submit button is pressed. This returns
truewhen a submit button was pressed that requires the form to be validated, andfalse.
- Server validation is disabled for the form element in the form designer.
- The element is not rendered due to a state or user group condition.
- The element is disabled due to a state or user group condition.
- The element is hidden, e.g. due to a hidden-if condition.
false. However, there are some use cases when validation needs to be performed no matter the circumstances. In that case, this flag may be ignored.- Returns:
- Whether the form element should be validated.
- The form action does not require validation. When designing a form, the user can choose whether the form
should be validated when a submit button is pressed. This returns
-
isServerValidationRequiredBySubmitAction
boolean isServerValidationRequiredBySubmitAction()
Gets whether the submit buttons that was used to submit the form requires server-side validation. For example, the submit button actionsubmit+checkrequires validation, the actionsubmitdoes not.- Returns:
- true if the submit button action requires server-side validation, false otherwise.
- Since:
- 8.5.6
-
-