play.data

Class DynamicForm

java.lang.Object

play.data.Form<DynamicForm.Dynamic>

play.data.DynamicForm

public class DynamicForm
extends Form<DynamicForm.Dynamic>

A dynamic form. This form is backed by a simple HashMap<String,String>

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DynamicForm.Dynamic Simple data structure used by DynamicForm.

Nested classes/interfaces inherited from class play.data.Form

Form.Display, Form.Field

Field Summary

Fields inherited from class play.data.Form

logger

Constructor Summary

Constructors

Constructor and Description
DynamicForm(java.util.Map<java.lang.String,java.lang.String> data, java.util.List<ValidationError> errors, java.util.Optional<DynamicForm.Dynamic> value, MessagesApi messagesApi, Formatters formatters, javax.validation.ValidatorFactory validatorFactory, com.typesafe.config.Config config) Creates a new dynamic form.
DynamicForm(java.util.Map<java.lang.String,java.lang.String> data, java.util.List<ValidationError> errors, java.util.Optional<DynamicForm.Dynamic> value, MessagesApi messagesApi, Formatters formatters, javax.validation.ValidatorFactory validatorFactory, com.typesafe.config.Config config, Lang lang) Creates a new dynamic form.
DynamicForm(java.util.Map<java.lang.String,java.lang.String> data, java.util.Map<java.lang.String,Http.MultipartFormData.FilePart<?>> files, java.util.List<ValidationError> errors, java.util.Optional<DynamicForm.Dynamic> value, MessagesApi messagesApi, Formatters formatters, javax.validation.ValidatorFactory validatorFactory, com.typesafe.config.Config config) Creates a new dynamic form.
DynamicForm(java.util.Map<java.lang.String,java.lang.String> data, java.util.Map<java.lang.String,Http.MultipartFormData.FilePart<?>> files, java.util.List<ValidationError> errors, java.util.Optional<DynamicForm.Dynamic> value, MessagesApi messagesApi, Formatters formatters, javax.validation.ValidatorFactory validatorFactory, com.typesafe.config.Config config, Lang lang) Creates a new dynamic form.
DynamicForm(MessagesApi messagesApi, Formatters formatters, javax.validation.ValidatorFactory validatorFactory, com.typesafe.config.Config config) Creates a new empty dynamic form.

Method Summary

Modifier and Type	Method and Description
DynamicForm	bind(Lang lang, TypedMap attrs, com.fasterxml.jackson.databind.JsonNode data, long maxChars, java.lang.String... allowedFields) Binds Json data to this form - that is, handles form submission.
DynamicForm	bind(Lang lang, TypedMap attrs, com.fasterxml.jackson.databind.JsonNode data, java.lang.String... allowedFields) Deprecated.
DynamicForm	bind(Lang lang, TypedMap attrs, java.util.Map<java.lang.String,java.lang.String> data, java.util.Map<java.lang.String,Http.MultipartFormData.FilePart<?>> files, java.lang.String... allowedFields) Binds data to this form - that is, handles form submission.
DynamicForm	bind(Lang lang, TypedMap attrs, java.util.Map<java.lang.String,java.lang.String> data, java.lang.String... allowedFields) Binds data to this form - that is, handles form submission.
DynamicForm	bindFromRequest(Http.Request request, java.lang.String... allowedFields) Binds request data to this form - that is, handles form submission.
DynamicForm	bindFromRequestData(Lang lang, TypedMap attrs, java.util.Map<java.lang.String,java.lang.String[]> requestData, java.util.Map<java.lang.String,Http.MultipartFormData.FilePart<?>> requestFileData, java.lang.String... allowedFields) Binds request data to this form - that is, handles form submission.
DynamicForm	discardingErrors()
java.util.Optional<ValidationError>	error(java.lang.String key)
Form.Field	field(java.lang.String key, Lang lang) Retrieves a field.
<A> Http.MultipartFormData.FilePart<A>	file(java.lang.String key) Gets the concrete value only if the submission was a success.
java.util.Map<java.lang.String,Http.MultipartFormData.FilePart<?>>	files()
DynamicForm	fill(java.util.Map<java.lang.String,java.lang.Object> value) Fills the form with existing data.
java.lang.String	get(java.lang.String key) Gets the concrete value only if the submission was a success.
java.util.Map<java.lang.String,java.lang.String>	rawData()
java.util.Optional<java.lang.Object>	value(java.lang.String key) Gets the concrete value
DynamicForm	withDirectFieldAccess(boolean directFieldAccess) Sets if during binding fields of the form should be accessed directly or via getters.
DynamicForm	withError(java.lang.String key, java.lang.String error)
DynamicForm	withError(java.lang.String key, java.lang.String error, java.util.List<java.lang.Object> args)
DynamicForm	withError(ValidationError error)
DynamicForm	withGlobalError(java.lang.String error)
DynamicForm	withGlobalError(java.lang.String error, java.util.List<java.lang.Object> args)
DynamicForm	withLang(Lang lang) A copy of this form with the given lang set which is used for formatting when retrieving a field (via Form.field(String) or Form.apply(String)) and for translations in Form.errorsAsJson().

Methods inherited from class play.data.Form

apply, apply, bind, bindFromRequestData, blankInstance, errors, errors, errorsAsJson, errorsAsJson, field, fill, fillDataWith, fillDataWith, get, get, getArgumentsForConstraint, getBackedType, getMessageForConstraintViolation, globalError, globalErrors, hasErrors, hasGlobalErrors, lang, maxJsonChars, maxJsonDepth, name, requestData, requestFileData, resolveDuplicateFilePartKeys, toString, value

Methods inherited from class java.lang.Object

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

Constructor Detail

DynamicForm

public DynamicForm(MessagesApi messagesApi,
                   Formatters formatters,
                   javax.validation.ValidatorFactory validatorFactory,
                   com.typesafe.config.Config config)

Creates a new empty dynamic form.

Parameters:

messagesApi - the messagesApi component.

formatters - the formatters component.

validatorFactory - the validatorFactory component.

config - the config component.

DynamicForm

public DynamicForm(java.util.Map<java.lang.String,java.lang.String> data,
                   java.util.List<ValidationError> errors,
                   java.util.Optional<DynamicForm.Dynamic> value,
                   MessagesApi messagesApi,
                   Formatters formatters,
                   javax.validation.ValidatorFactory validatorFactory,
                   com.typesafe.config.Config config)

Creates a new dynamic form.

Parameters:

data - the current form data (used to display the form)

errors - the collection of errors associated with this form

value - optional concrete value if the form submission was successful

messagesApi - the messagesApi component.

formatters - the formatters component.

validatorFactory - the validatorFactory component.

config - the config component.

DynamicForm

public DynamicForm(java.util.Map<java.lang.String,java.lang.String> data,
                   java.util.Map<java.lang.String,Http.MultipartFormData.FilePart<?>> files,
                   java.util.List<ValidationError> errors,
                   java.util.Optional<DynamicForm.Dynamic> value,
                   MessagesApi messagesApi,
                   Formatters formatters,
                   javax.validation.ValidatorFactory validatorFactory,
                   com.typesafe.config.Config config)

Creates a new dynamic form.

Parameters:

data - the current form data (used to display the form)

files - the current form file data

errors - the collection of errors associated with this form

value - optional concrete value if the form submission was successful

messagesApi - the messagesApi component.

formatters - the formatters component.

validatorFactory - the validatorFactory component.

config - the config component.

DynamicForm

public DynamicForm(java.util.Map<java.lang.String,java.lang.String> data,
                   java.util.List<ValidationError> errors,
                   java.util.Optional<DynamicForm.Dynamic> value,
                   MessagesApi messagesApi,
                   Formatters formatters,
                   javax.validation.ValidatorFactory validatorFactory,
                   com.typesafe.config.Config config,
                   Lang lang)

Creates a new dynamic form.

Parameters:

data - the current form data (used to display the form)

errors - the collection of errors associated with this form

value - optional concrete value if the form submission was successful

messagesApi - the messagesApi component.

formatters - the formatters component.

validatorFactory - the validatorFactory component.

config - the config component.

lang - used for formatting when retrieving a field (via Form.field(String) or Form.apply(String)) and for translations in Form.errorsAsJson()

DynamicForm

public DynamicForm(java.util.Map<java.lang.String,java.lang.String> data,
                   java.util.Map<java.lang.String,Http.MultipartFormData.FilePart<?>> files,
                   java.util.List<ValidationError> errors,
                   java.util.Optional<DynamicForm.Dynamic> value,
                   MessagesApi messagesApi,
                   Formatters formatters,
                   javax.validation.ValidatorFactory validatorFactory,
                   com.typesafe.config.Config config,
                   Lang lang)

Creates a new dynamic form.

Parameters:

data - the current form data (used to display the form)

files - the current form file data

errors - the collection of errors associated with this form

value - optional concrete value if the form submission was successful

messagesApi - the messagesApi component.

formatters - the formatters component.

validatorFactory - the validatorFactory component.

config - the config component.

lang - used for formatting when retrieving a field (via Form.field(String) or Form.apply(String)) and for translations in Form.errorsAsJson()

Method Detail

get

public java.lang.String get(java.lang.String key)

Gets the concrete value only if the submission was a success. If the form is invalid because of validation errors or you try to access a file field this method will return null. If you want to retrieve the value even when the form is invalid use value(String) instead. If you want to retrieve a file field use file(String) instead.

Parameters:

key - the string key.

Returns:

the value, or null if there is no match.

file

public <A> Http.MultipartFormData.FilePart<A> file(java.lang.String key)

Gets the concrete value only if the submission was a success. If the form is invalid because of validation errors or you try to access a non-file field this method will return null. If you want to retrieve the value even when the form is invalid use value(String) instead. If you want to retrieve a non-file field use get(String) instead.

Parameters:

key - the string key.

Returns:

the value, or null if there is no match.

value

public java.util.Optional<java.lang.Object> value(java.lang.String key)

Gets the concrete value

Parameters:

key - the string key.

Returns:

the value

rawData

public java.util.Map<java.lang.String,java.lang.String> rawData()

Overrides:

rawData in class Form<DynamicForm.Dynamic>

Returns:

the actual form data as unmodifiable map. Does not contain file data, use Form.files() to access files.

files

public java.util.Map<java.lang.String,Http.MultipartFormData.FilePart<?>> files()

Overrides:

files in class Form<DynamicForm.Dynamic>

Returns:

the the files as unmodifiable map. Use Form.rawData() to access other form data.

fill

public DynamicForm fill(java.util.Map<java.lang.String,java.lang.Object> value)

Fills the form with existing data.

Parameters:

value - the map of values to fill in the form.

Returns:

the modified form.

bindFromRequest

public DynamicForm bindFromRequest(Http.Request request,
                                   java.lang.String... allowedFields)

Description copied from class: Form

Binds request data to this form - that is, handles form submission.

Overrides:

bindFromRequest in class Form<DynamicForm.Dynamic>

Parameters:

request - the request to bind data from.

allowedFields - the fields that should be bound to the form, all fields if not specified.

Returns:

a copy of this form filled with the new data

bindFromRequestData

public DynamicForm bindFromRequestData(Lang lang,
                                       TypedMap attrs,
                                       java.util.Map<java.lang.String,java.lang.String[]> requestData,
                                       java.util.Map<java.lang.String,Http.MultipartFormData.FilePart<?>> requestFileData,
                                       java.lang.String... allowedFields)

Description copied from class: Form

Binds request data to this form - that is, handles form submission.

Overrides:

bindFromRequestData in class Form<DynamicForm.Dynamic>

Parameters:

lang - used for validators and formatters during binding and is part of Constraints.ValidationPayload. Later also used for formatting when retrieving a field (via Form.field(String) or Form.apply(String)) and for translations in Form.errorsAsJson(). For these methods the lang can be change via Form.withLang(Lang).

attrs - will be passed to validators via Constraints.ValidationPayload

requestData - the map of data to bind from

requestFileData - the map of file data to bind from

allowedFields - the fields that should be bound to the form, all fields if not specified.

Returns:

a copy of this form filled with the new data

bind

@Deprecated
public DynamicForm bind(Lang lang,
                                    TypedMap attrs,
                                    com.fasterxml.jackson.databind.JsonNode data,
                                    java.lang.String... allowedFields)

Deprecated.

Description copied from class: Form

Binds Json data to this form - that is, handles form submission.

Overrides:

bind in class Form<DynamicForm.Dynamic>

Parameters:

lang - used for validators and formatters during binding and is part of Constraints.ValidationPayload. Later also used for formatting when retrieving a field (via Form.field(String) or Form.apply(String)) and for translations in Form.errorsAsJson(). For these methods the lang can be change via Form.withLang(Lang).

attrs - will be passed to validators via Constraints.ValidationPayload

data - data to submit

allowedFields - the fields that should be bound to the form, all fields if not specified.

Returns:

a copy of this form filled with the new data

bind

public DynamicForm bind(Lang lang,
                        TypedMap attrs,
                        com.fasterxml.jackson.databind.JsonNode data,
                        long maxChars,
                        java.lang.String... allowedFields)

Description copied from class: Form

Binds Json data to this form - that is, handles form submission.

Overrides:

bind in class Form<DynamicForm.Dynamic>

Parameters:

lang - used for validators and formatters during binding and is part of Constraints.ValidationPayload. Later also used for formatting when retrieving a field (via Form.field(String) or Form.apply(String)) and for translations in Form.errorsAsJson(). For these methods the lang can be change via Form.withLang(Lang).

attrs - will be passed to validators via Constraints.ValidationPayload

data - data to submit

maxChars - the maximum number of chars allowed to be used in the intermediate map representation of the JSON. `parse.DefaultMaxTextLength` is recommended to passed for this parameter.

allowedFields - the fields that should be bound to the form, all fields if not specified.

Returns:

a copy of this form filled with the new data

bind

public DynamicForm bind(Lang lang,
                        TypedMap attrs,
                        java.util.Map<java.lang.String,java.lang.String> data,
                        java.lang.String... allowedFields)

Description copied from class: Form

Binds data to this form - that is, handles form submission.

Overrides:

bind in class Form<DynamicForm.Dynamic>

Parameters:

lang - used for validators and formatters during binding and is part of Constraints.ValidationPayload. Later also used for formatting when retrieving a field (via Form.field(String) or Form.apply(String)) and for translations in Form.errorsAsJson(). For these methods the lang can be change via Form.withLang(Lang).

attrs - will be passed to validators via Constraints.ValidationPayload

data - data to submit

allowedFields - the fields that should be bound to the form, all fields if not specified.

Returns:

a copy of this form filled with the new data

bind

public DynamicForm bind(Lang lang,
                        TypedMap attrs,
                        java.util.Map<java.lang.String,java.lang.String> data,
                        java.util.Map<java.lang.String,Http.MultipartFormData.FilePart<?>> files,
                        java.lang.String... allowedFields)

Description copied from class: Form

Binds data to this form - that is, handles form submission.

Overrides:

bind in class Form<DynamicForm.Dynamic>

Parameters:

lang - used for validators and formatters during binding and is part of Constraints.ValidationPayload. Later also used for formatting when retrieving a field (via Form.field(String) or Form.apply(String)) and for translations in Form.errorsAsJson(). For these methods the lang can be change via Form.withLang(Lang).

attrs - will be passed to validators via Constraints.ValidationPayload

data - data to submit

allowedFields - the fields that should be bound to the form, all fields if not specified.

Returns:

a copy of this form filled with the new data

field

public Form.Field field(java.lang.String key,
                        Lang lang)

Description copied from class: Form

Retrieves a field.

Overrides:

field in class Form<DynamicForm.Dynamic>

Parameters:

key - field name

lang - used for formatting

Returns:

the field (even if the field does not exist you get a field)

error

public java.util.Optional<ValidationError> error(java.lang.String key)

Overrides:

error in class Form<DynamicForm.Dynamic>

Parameters:

key - the field name associated with the error.

Returns:

an error by key

withError

public DynamicForm withError(ValidationError error)

Overrides:

withError in class Form<DynamicForm.Dynamic>

Parameters:

error - the ValidationError to add to the returned form.

Returns:

a copy of this form with the given error added.

withError

public DynamicForm withError(java.lang.String key,
                             java.lang.String error,
                             java.util.List<java.lang.Object> args)

Overrides:

withError in class Form<DynamicForm.Dynamic>

Parameters:

key - the error key

error - the error message

args - the error arguments

Returns:

a copy of this form with the given error added.

withError

public DynamicForm withError(java.lang.String key,
                             java.lang.String error)

Overrides:

withError in class Form<DynamicForm.Dynamic>

Parameters:

key - the error key

error - the error message

Returns:

a copy of this form with the given error added.

withGlobalError

public DynamicForm withGlobalError(java.lang.String error,
                                   java.util.List<java.lang.Object> args)

Overrides:

withGlobalError in class Form<DynamicForm.Dynamic>

Parameters:

error - the global error message

args - the global error arguments

Returns:

a copy of this form with the given global error added.

withGlobalError

public DynamicForm withGlobalError(java.lang.String error)

Overrides:

withGlobalError in class Form<DynamicForm.Dynamic>

Parameters:

error - the global error message

Returns:

a copy of this form with the given global error added.

discardingErrors

public DynamicForm discardingErrors()

Overrides:

discardingErrors in class Form<DynamicForm.Dynamic>

Returns:

a copy of this form but with the errors discarded.

withLang

public DynamicForm withLang(Lang lang)

Description copied from class: Form

A copy of this form with the given lang set which is used for formatting when retrieving a field (via Form.field(String) or Form.apply(String)) and for translations in Form.errorsAsJson().

Overrides:

withLang in class Form<DynamicForm.Dynamic>

withDirectFieldAccess

public DynamicForm withDirectFieldAccess(boolean directFieldAccess)

Description copied from class: Form

Sets if during binding fields of the form should be accessed directly or via getters.

Overrides:

withDirectFieldAccess in class Form<DynamicForm.Dynamic>

Parameters:

directFieldAccess - true enables direct field access during form binding, false disables it and uses getters instead. If null falls back to config default.