Package com.adobe.granite.ui.components

Class Value

java.lang.Object

com.adobe.granite.ui.components.Value

public class Value
extends Object

A helper for the form field to access the FormData.

To set the FormData, one of the following can be used (ordered by priority):

1. Set the request attribute using FormData.push(SlingHttpServletRequest, ValueMap, NameNotFoundMode)
2. Set the request attribute using FORM_VALUESS_ATTRIBUTE as the key
3. Set the request attribute using CONTENTPATH_ATTRIBUTE as the key

Field Summary

Fields

Modifier and Type	Field	Description
static final String	CONTENTPATH_ATTRIBUTE	Deprecated. Use FormData.push(SlingHttpServletRequest, ValueMap, NameNotFoundMode) instead
static final String	FORM_VALUESS_ATTRIBUTE	Deprecated. Use FormData.push(SlingHttpServletRequest, ValueMap, NameNotFoundMode) instead

Constructor Summary

Constructors

Constructor	Description
Value(SlingHttpServletRequest request, Config config)	Instantiates a new Value.

Method Summary

Modifier and Type	Method	Description
String	get(String name)	A shortcut to get(String, Object), with empty string as default value.
<T> T	get(String name, Class<T> type)	Returns the value for the given name, converted to type T.
<T> T	get(String name, T defaultValue)	Returns the value for the given name, converted to type T.
String	getContentValue(String name)	A shortcut to getContentValue(String, Object), with empty string as default value.
<T> T	getContentValue(String name, Class<T> type)	Returns value from the given name, converted to the given type.
<T> T	getContentValue(String name, T defaultValue)	Returns value from the given name, converted to the type of given default value.
boolean	isSelected(String value, boolean isFieldOptionSelected)	A shortcut of isSelected(String, String, boolean), with name is taken from name property of the config.
boolean	isSelected(String value, boolean isFieldOptionSelected, boolean forceIgnoreFreshness)	A shortcut of isSelected(String, String, boolean, boolean), with name is taken from name property of the config.
boolean	isSelected(String name, String value, boolean isFieldOptionSelected)	An overload of isSelected(String, String, boolean, boolean) where forceIgnoreFreshness is false.
boolean	isSelected(String name, String value, boolean isFieldOptionSelected, boolean forceIgnoreFreshness)	Returns true if the given value of the field option is selected; false otherwise.
<T> T	val(String name, T fieldValue)	Returns the value for the given name, converted to type T.
<T> T	val(T fieldValue)	A shortcut of val(String, Object), with name is taken from name property of the config.

Methods inherited from class java.lang.Object

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

Field Details

FORM_VALUESS_ATTRIBUTE

@Deprecated
public static final String FORM_VALUESS_ATTRIBUTE

Deprecated.

Use FormData.push(SlingHttpServletRequest, ValueMap, NameNotFoundMode) instead

The Servlet attribute key to store the ValueMap of the form values.

See Also:

• Constant Field Values

CONTENTPATH_ATTRIBUTE

@Deprecated
public static final String CONTENTPATH_ATTRIBUTE

Deprecated.

Use FormData.push(SlingHttpServletRequest, ValueMap, NameNotFoundMode) instead

The Servlet attribute key to store the path to the resource holding the form values.

See Also:

• Constant Field Values

Constructor Details

Value

public Value(@Nonnull
 SlingHttpServletRequest request,
 @Nonnull
 Config config)

Instantiates a new Value.

Parameters:

request - The request storing the FormData

config - The config of the form field component

Method Details

get

@Nonnull
public String get(@CheckForNull
 String name)

A shortcut to get(String, Object), with empty string as default value.

Parameters:

name - The name of the field

Returns:

The value converted to type T, or the value of value property, or the given default value, depending on the conditions described at get(String, Object).

get

@Nonnull
public <T> T get(@CheckForNull
 String name,
 @Nonnull
 T defaultValue)

Returns the value for the given name, converted to type T.

In the FormData.NameNotFoundMode.CHECK_FRESHNESS mode, if the given name is not found and the FormData is fresh, then the given fieldValue is returned. Otherwise, the given defaultValue is returned.

In the FormData.NameNotFoundMode.IGNORE_FRESHNESS mode, if the given name is not found, then the given fieldValue is returned.

If the FormData is null or ignoreData property of the config is true, this method returns value property of the config.

Type Parameters:

T - The type of the value

Parameters:

name - The name of the field

defaultValue - The default value

Returns:

The value converted to type T, or the value of value property, or the given default value, depending on the conditions described above.

get

@CheckForNull
public <T> T get(@CheckForNull
 String name,
 @Nonnull
 Class<T> type)

Returns the value for the given name, converted to type T.

In the FormData.NameNotFoundMode.CHECK_FRESHNESS mode, if the given name is not found and the FormData is fresh, then the given fieldValue is returned. Otherwise, null is returned.

In the FormData.NameNotFoundMode.IGNORE_FRESHNESS mode, if the given name is not found, then the given fieldValue is returned.

If the FormData is null or ignoreData property of the config is true, this method returns value property of the config.

Type Parameters:

T - The type of the value

Parameters:

name - The name of the field

type - The class of the type

Returns:

The value converted to type T, or the value of value property, or null, depending on the conditions described above.

val

@CheckForNull
public <T> T val(@Nonnull
 T fieldValue)

A shortcut of val(String, Object), with name is taken from name property of the config.

Type Parameters:

T - The type of the value

Parameters:

fieldValue - The value of the field

Returns:

The value converted to type T, or the given fieldValue, or null, depending on the conditions described at val(String, Object).

val

@CheckForNull
public <T> T val(@CheckForNull
 String name,
 @Nonnull
 T fieldValue)

Returns the value for the given name, converted to type T.

In the FormData.NameNotFoundMode.CHECK_FRESHNESS mode, if the given name is not found and the FormData is fresh, then the given fieldValue is returned. Otherwise, null is returned.

In the FormData.NameNotFoundMode.IGNORE_FRESHNESS mode, if the given name is not found, then the given fieldValue is returned.

If the FormData is null or ignoreData property of the config is true, this method returns the given fieldValue.

The key difference compared to get(String, Object) is that this method will return the given fieldValue instead of value from value property of the config.

Type Parameters:

T - The type of the value

Parameters:

name - The name of the field

fieldValue - The value of the field

Returns:

The value converted to type T, or the given fieldValue, or null, depending on the conditions described above.

isSelected

public boolean isSelected(@CheckForNull
 String value,
 boolean isFieldOptionSelected)

A shortcut of isSelected(String, String, boolean), with name is taken from name property of the config.

Parameters:

value - The value of the field option to compare against

isFieldOptionSelected - true if the field option is selected; false otherwise.

Returns:

Whether the given value is selected or not, or the given isFieldOptionSelected, depending on the conditions described at isSelected(String, String, boolean).

isSelected

public boolean isSelected(@CheckForNull
 String value,
 boolean isFieldOptionSelected,
 boolean forceIgnoreFreshness)

A shortcut of isSelected(String, String, boolean, boolean), with name is taken from name property of the config.

Parameters:

value - The value of the field option to compare against

isFieldOptionSelected - true if the field option is selected; false otherwise.

forceIgnoreFreshness - true to force to be FormData.NameNotFoundMode.IGNORE_FRESHNESS; false otherwise.

Returns:

Whether the given value is selected or not, or the given isFieldOptionSelected, depending on the conditions described at isSelected(String, String, boolean).

isSelected

public boolean isSelected(@CheckForNull
 String name,
 @CheckForNull
 String value,
 boolean isFieldOptionSelected)

An overload of isSelected(String, String, boolean, boolean) where forceIgnoreFreshness is false.

Parameters:

name - The name of the field

value - The value of the field option to compare against

isFieldOptionSelected - true if the field option is selected; false otherwise.

Returns:

Whether the given value is selected or not, or the given isFieldOptionSelected, depending on the conditions described above.

isSelected

public boolean isSelected(@CheckForNull
 String name,
 @CheckForNull
 String value,
 boolean isFieldOptionSelected,
 boolean forceIgnoreFreshness)

Returns true if the given value of the field option is selected; false otherwise.

In the FormData.NameNotFoundMode.CHECK_FRESHNESS mode, if the given name is not found and the FormData is fresh, then the given isFieldOptionSelected is returned, false otherwise.

In the FormData.NameNotFoundMode.IGNORE_FRESHNESS mode, if the given name is not found, then the given isFieldOptionSelected is returned.

If the FormData is null or ignoreData property of the config is true, the given isFieldOptionSelected is returned.

Parameters:

name - The name of the field

value - The value of the field option to compare against

isFieldOptionSelected - true if the field option is selected; false otherwise.

forceIgnoreFreshness - true to force to be FormData.NameNotFoundMode.IGNORE_FRESHNESS; false otherwise.

Returns:

Whether the given value is selected or not, or the given isFieldOptionSelected, depending on the conditions described above.

getContentValue

@Nonnull
public String getContentValue(@CheckForNull
 String name)

A shortcut to getContentValue(String, Object), with empty string as default value.

Parameters:

name - The name of the field

Returns:

The value converted to String, or an empty String if non existing or can't be converted.

getContentValue

@Nonnull
public <T> T getContentValue(@CheckForNull
 String name,
 @Nonnull
 T defaultValue)

Returns value from the given name, converted to the type of given default value.

Type Parameters:

T - The type of the value

Parameters:

name - The name of the field

defaultValue - The default value

Returns:

The value converted to type T, or the default value if non existing or can't be converted.

getContentValue

@CheckForNull
public <T> T getContentValue(@CheckForNull
 String name,
 @Nonnull
 Class<T> type)

Returns value from the given name, converted to the given type.

Type Parameters:

T - The type of the value

Parameters:

name - The name of the value to return

type - The return type

Returns:

The named value converted to type T, or null if non existing or can't be converted.