org.springframework.boot.context.properties.source

Class ConfigurationPropertyName

java.lang.Object

org.springframework.boot.context.properties.source.ConfigurationPropertyName

All Implemented Interfaces:

Comparable<ConfigurationPropertyName>

public final class ConfigurationPropertyName
extends Object
implements Comparable<ConfigurationPropertyName>

A configuration property name composed of elements separated by dots. User created names may contain the characters "a-z" "0-9") and "-", they must be lower-case and must start with a letter. The "-" is used purely for formatting, i.e. "foo-bar" and "foobar" are considered equivalent.

The "[" and "]" characters may be used to indicate an associative index(i.e. a Map key or a Collection index. Indexes names are not restricted and are considered case-sensitive.

Here are some typical examples:

• spring.main.banner-mode
• server.hosts[0].name
• log[org.springboot].level

Since:

2.0.0

Author:

Phillip Webb, Madhura Bhave

See Also:

of(CharSequence), ConfigurationPropertySource

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ConfigurationPropertyName.Form The various forms that a non-indexed element value can take.

Field Summary

Fields

Modifier and Type	Field and Description
static ConfigurationPropertyName	EMPTY An empty ConfigurationPropertyName.

Method Summary

Modifier and Type	Method and Description
ConfigurationPropertyName	append(String elementValue) Create a new ConfigurationPropertyName by appending the given element value.
ConfigurationPropertyName	chop(int size) Return a new ConfigurationPropertyName by chopping this name to the given size.
int	compareTo(ConfigurationPropertyName other)
boolean	equals(Object obj)
String	getElement(int elementIndex, ConfigurationPropertyName.Form form) Return an element in the name in the given form.
String	getLastElement(ConfigurationPropertyName.Form form) Return the last element in the name in the given form.
int	getNumberOfElements() Return the total number of elements in the name.
int	hashCode()
boolean	isAncestorOf(ConfigurationPropertyName name) Returns true if this element is an ancestor (immediate or nested parent) of the specified name.
boolean	isEmpty() Returns true if this ConfigurationPropertyName is empty.
boolean	isLastElementIndexed() Return if the last element in the name is indexed.
boolean	isParentOf(ConfigurationPropertyName name) Returns true if this element is an immediate parent of the specified name.
static boolean	isValid(CharSequence name) Returns if the given name is valid.
static ConfigurationPropertyName	of(CharSequence name) Return a ConfigurationPropertyName for the specified string.
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

EMPTY

public static final ConfigurationPropertyName EMPTY

An empty ConfigurationPropertyName.

Method Detail

isEmpty

public boolean isEmpty()

Returns true if this ConfigurationPropertyName is empty.

Returns:

true if the name is empty

isLastElementIndexed

public boolean isLastElementIndexed()

Return if the last element in the name is indexed.

Returns:

true if the last element is indexed

getLastElement

public String getLastElement(ConfigurationPropertyName.Form form)

Return the last element in the name in the given form.

Parameters:

form - the form to return

Returns:

the last element

getElement

public String getElement(int elementIndex,
                         ConfigurationPropertyName.Form form)

Return an element in the name in the given form.

Parameters:

elementIndex - the element index

form - the form to return

Returns:

the last element

getNumberOfElements

public int getNumberOfElements()

Return the total number of elements in the name.

Returns:

the number of elements

append

public ConfigurationPropertyName append(String elementValue)

Create a new ConfigurationPropertyName by appending the given element value.

Parameters:

elementValue - the single element value to append

Returns:

a new ConfigurationPropertyName

chop

public ConfigurationPropertyName chop(int size)

Return a new ConfigurationPropertyName by chopping this name to the given size. For example, chop(1) on the name foo.bar will return foo.

Parameters:

size - the size to chop

Returns:

the chopped name

isParentOf

public boolean isParentOf(ConfigurationPropertyName name)

Returns true if this element is an immediate parent of the specified name.

Parameters:

name - the name to check

Returns:

true if this name is an ancestor

isAncestorOf

public boolean isAncestorOf(ConfigurationPropertyName name)

Returns true if this element is an ancestor (immediate or nested parent) of the specified name.

Parameters:

name - the name to check

Returns:

true if this name is an ancestor

compareTo

public int compareTo(ConfigurationPropertyName other)

Specified by:

compareTo in interface Comparable<ConfigurationPropertyName>

toString

public String toString()

Overrides:

toString in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

isValid

public static boolean isValid(CharSequence name)

Returns if the given name is valid. If this method returns true then the name may be used with of(CharSequence) without throwing an exception.

Parameters:

name - the name to test

Returns:

true if the name is valid

of

public static ConfigurationPropertyName of(CharSequence name)

Return a ConfigurationPropertyName for the specified string.

Parameters:

name - the source name

Returns:

a ConfigurationPropertyName instance

Throws:

IllegalArgumentException - if the name is not valid