程序包 cn.taketoday.context.properties.source

类 ConfigurationPropertyName

java.lang.Object

cn.taketoday.context.properties.source.ConfigurationPropertyName

所有已实现的接口:

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 an alpha-numeric character. 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:

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

从以下版本开始:

4.0

作者:

Phillip Webb, Harry Yang, Madhura Bhave

另请参阅:

• of(CharSequence)
• ConfigurationPropertySource

嵌套类概要

嵌套类

修饰符和类型	类	说明
static enum	ConfigurationPropertyName.Form	The various forms that a non-indexed element value can take.

字段概要

字段

修饰符和类型	字段	说明
static final ConfigurationPropertyName	EMPTY	An empty ConfigurationPropertyName.

方法概要

修饰符和类型	方法	说明
static ConfigurationPropertyName	adapt(CharSequence name, char separator)	Create a ConfigurationPropertyName by adapting the given source.
ConfigurationPropertyName	append(ConfigurationPropertyName suffix)	Create a new ConfigurationPropertyName by appending the given suffix.
ConfigurationPropertyName	append(String suffix)	Create a new ConfigurationPropertyName by appending the given suffix.
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.
ConfigurationPropertyName	getParent()	Return the parent of this ConfigurationPropertyName or EMPTY if there is no parent.
int	hashCode()
boolean	hasIndexedElement()	Return true if any element in the name is indexed.
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	isNumericIndex(int elementIndex)	Return if the element in the name is indexed and numeric.
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.
static ConfigurationPropertyName	ofIfValid(CharSequence name)	Return a ConfigurationPropertyName for the specified string or null if the name is not valid.
ConfigurationPropertyName	subName(int offset)	Return a new ConfigurationPropertyName by based on this name offset by specific element index.
String	toString()

从类继承的方法 java.lang.Object

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

字段详细资料

EMPTY

public static final ConfigurationPropertyName EMPTY

An empty ConfigurationPropertyName.

方法详细资料

isEmpty

public boolean isEmpty()

Returns true if this ConfigurationPropertyName is empty.

返回:

true if the name is empty

isLastElementIndexed

public boolean isLastElementIndexed()

Return if the last element in the name is indexed.

返回:

true if the last element is indexed

hasIndexedElement

public boolean hasIndexedElement()

Return true if any element in the name is indexed.

返回:

if the element has one or more indexed elements

isNumericIndex

public boolean isNumericIndex(int elementIndex)

Return if the element in the name is indexed and numeric.

参数:

elementIndex - the index of the element

返回:

true if the element is indexed and numeric

getLastElement

public String getLastElement(ConfigurationPropertyName.Form form)

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

参数:

form - the form to return

返回:

the last element

getElement

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

Return an element in the name in the given form.

参数:

elementIndex - the element index

form - the form to return

返回:

the last element

getNumberOfElements

public int getNumberOfElements()

Return the total number of elements in the name.

返回:

the number of elements

append

public ConfigurationPropertyName append(String suffix)

Create a new ConfigurationPropertyName by appending the given suffix.

参数:

suffix - the elements to append

返回:

a new ConfigurationPropertyName

抛出:

InvalidConfigurationPropertyNameException - if the result is not valid

append

public ConfigurationPropertyName append(@Nullable
 ConfigurationPropertyName suffix)

Create a new ConfigurationPropertyName by appending the given suffix.

参数:

suffix - the elements to append

返回:

a new ConfigurationPropertyName

getParent

public ConfigurationPropertyName getParent()

Return the parent of this ConfigurationPropertyName or EMPTY if there is no parent.

返回:

the parent name

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.

参数:

size - the size to chop

返回:

the chopped name

subName

public ConfigurationPropertyName subName(int offset)

Return a new ConfigurationPropertyName by based on this name offset by specific element index. For example, chop(1) on the name foo.bar will return bar.

参数:

offset - the element offset

返回:

the sub name

isParentOf

public boolean isParentOf(ConfigurationPropertyName name)

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

参数:

name - the name to check

返回:

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.

参数:

name - the name to check

返回:

true if this name is an ancestor

compareTo

public int compareTo(ConfigurationPropertyName other)

指定者:

compareTo 在接口中 Comparable<ConfigurationPropertyName>

equals

public boolean equals(Object obj)

覆盖:

equals 在类中 Object

hashCode

public int hashCode()

覆盖:

hashCode 在类中 Object

toString

public String toString()

覆盖:

toString 在类中 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.

参数:

name - the name to test

返回:

true if the name is valid

of

public static ConfigurationPropertyName of(CharSequence name)

Return a ConfigurationPropertyName for the specified string.

参数:

name - the source name

返回:

a ConfigurationPropertyName instance

抛出:

InvalidConfigurationPropertyNameException - if the name is not valid

ofIfValid

@Nullable
public static ConfigurationPropertyName ofIfValid(@Nullable
 CharSequence name)

Return a ConfigurationPropertyName for the specified string or null if the name is not valid.

参数:

name - the source name

返回:

a ConfigurationPropertyName instance

adapt

public static ConfigurationPropertyName adapt(CharSequence name,
 char separator)

Create a ConfigurationPropertyName by adapting the given source. See adapt(CharSequence, char, Function) for details.

参数:

name - the name to parse

separator - the separator used to split the name

返回:

a ConfigurationPropertyName