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

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(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(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	bindFromRequest(java.lang.String... allowedFields) Binds request data to this form - that is, handles form submission.
java.util.Optional<ValidationError>	error(java.lang.String key) Retrieve an error by key.
Form.Field	field(java.lang.String key) Retrieves a field.
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.Optional<ValidationError>	getError(java.lang.String key) Deprecated. Deprecated as of 2.7.0. Method has been renamed to error(String).
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	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)

Methods inherited from class play.data.Form

allErrors, apply, bind, bindFromRequest, blankInstance, discardingErrors, errors, errors, errorsAsJson, errorsAsJson, fill, get, getArgumentsForConstraint, getBackedType, getGlobalError, getMessageForConstraintViolation, globalError, globalErrors, hasErrors, hasGlobalErrors, name, requestData, toString, value, withError, withGlobalError, withGlobalError

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.

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 this method will return null. If you want to retrieve the value even when the form is invalid use value(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.

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(java.lang.String... allowedFields)

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

Overrides:

bindFromRequest in class Form<DynamicForm.Dynamic>

Parameters:

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

bindFromRequest

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

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

bind

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

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

Overrides:

bind in class Form<DynamicForm.Dynamic>

Parameters:

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)

Retrieves a field.

Overrides:

field in class Form<DynamicForm.Dynamic>

Parameters:

key - field name

Returns:

the field - even if the field does not exist you get a field

getError

@Deprecated
public java.util.Optional<ValidationError> getError(java.lang.String key)

Deprecated. Deprecated as of 2.7.0. Method has been renamed to error(String).

Retrieve an error by key.

Overrides:

getError in class Form<DynamicForm.Dynamic>

Parameters:

key - the field name associated with the error.

Returns:

an error by key

error

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

Retrieve an error by 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(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.