org.n52.sos.config

Interface SettingDefinition<S extends SettingDefinition<S,T>,T>

Type Parameters:

S - The type of the implementing class

T - The type of the value

All Superinterfaces:

Cloneable, Comparable<Ordered<?>>, Ordered<S>

All Known Implementing Classes:

AbstractSettingDefinition, BooleanSettingDefinition, ChoiceSettingDefinition, FileSettingDefinition, IntegerSettingDefinition, MultilingualStringSettingDefinition, NumericSettingDefinition, StringSettingDefinition, TimeInstantSettingDefinition, UriSettingDefinition

public interface SettingDefinition<S extends SettingDefinition<S,T>,T>
extends Ordered<S>, Cloneable

Interface for setting definitions that can be used within the Service. Defined settings will be presented in the administrator and installer view.

Since:

4.0.0

Author:

Christian Autermann

See Also:

SettingDefinitionProvider, SettingDefinitionGroup, SettingsManager, FileSettingDefinition, BooleanSettingDefinition, IntegerSettingDefinition, NumericSettingDefinition, StringSettingDefinition,

Method Summary

Modifier and Type	Method and Description
T	getDefaultValue()
String	getDescription()
SettingDefinitionGroup	getGroup()
String	getKey()
String	getTitle()
SettingType	getType()
boolean	hasDefaultValue()
boolean	hasDescription()
boolean	hasGroup()
boolean	hasTitle()
boolean	isOptional()
S	setDefaultValue(T defaultValue) Sets the default value of this setting.
S	setDescription(String description) Sets the description of this setting definition, which should further describe the purpose of this setting.
S	setGroup(SettingDefinitionGroup group) Sets the group of this definition.
S	setKey(String key) Sets the unique identifier of this setting definition, which can be referenced by configurable classes.
S	setOptional(boolean optional) Sets whether this setting is optional or can be null.
S	setTitle(String title) Sets the title of this setting definition, which will be presented to the user.

Methods inherited from interface org.n52.sos.config.Ordered

getOrder, setOrder

Methods inherited from interface java.lang.Comparable

compareTo

Method Detail

getKey

String getKey()

Returns:

the unique key of this definition

getTitle

String getTitle()

Returns:

the title of this definition

getDescription

String getDescription()

Returns:

the description of this definition

isOptional

boolean isOptional()

Returns:

wether this setting is optional or required.

getDefaultValue

T getDefaultValue()

Returns:

the default value (or null if there is none)

getGroup

SettingDefinitionGroup getGroup()

Returns:

the group of this definition

hasTitle

boolean hasTitle()

Returns:

if this definition has a non empty title

hasDescription

boolean hasDescription()

Returns:

if this definition has a non empty description

hasDefaultValue

boolean hasDefaultValue()

Returns:

if this definition has a default value

hasGroup

boolean hasGroup()

Returns:

if this definition has a group

setKey

S setKey(String key)

Sets the unique identifier of this setting definition, which can be referenced by configurable classes.

Parameters:

key - the unique key

Returns:

this (for method chaining)

setTitle

S setTitle(String title)

Sets the title of this setting definition, which will be presented to the user.

Parameters:

title - the title

Returns:

this (for method chaining)

setDescription

S setDescription(String description)

Sets the description of this setting definition, which should further describe the purpose of this setting. Can contain XHTML markup.

Parameters:

description - the description

Returns:

this (for method chaining)

setOptional

S setOptional(boolean optional)

Sets whether this setting is optional or can be null. By default all settings are required.

Parameters:

optional - if this setting is optional

Returns:

this (for method chaining)

setDefaultValue

S setDefaultValue(T defaultValue)

Sets the default value of this setting. All required settings should have a default setting to allow a smoother integration of new settings in old configurations.

Parameters:

defaultValue - the default value

Returns:

this (for method chaining)

setGroup

S setGroup(SettingDefinitionGroup group)

Sets the group of this definition. If no group is set, the setting will be moved to a default group.

Parameters:

group - the group

Returns:

this (for method chaining)

getType

SettingType getType()

Returns:

the type of the value of this definition