public abstract class AbstractPropertyResolver extends ObjectSE implements ConfigurablePropertyResolver
コンストラクターと説明 |
---|
AbstractPropertyResolver() |
修飾子と型 | メソッドと説明 |
---|---|
boolean | containsProperty(StringSE key) 指定されたプロパティキーが解決に使用できるかどうかを返します。 |
protected <T> T | convertValueIfNecessary(ObjectSE value, ClassSE<T> targetType) 必要に応じて、指定された値を指定されたターゲット型に変換します。 |
ConfigurableConversionService | getConversionService() プロパティの型変換を実行するときに使用される ConfigurableConversionService を返します。 |
StringSE | getProperty(StringSE key) 指定されたキーに関連付けられているプロパティ値を返します。キーを解決できない場合は null を返します。 |
<T> T | getProperty(StringSE key, ClassSE<T> targetType, T defaultValue) 指定されたキーに関連付けられているプロパティ値を返します。キーを解決できない場合は defaultValue を返します。 |
StringSE | getProperty(StringSE key, StringSE defaultValue) 指定されたキーに関連付けられているプロパティ値を返します。キーを解決できない場合は defaultValue を返します。 |
protected abstract StringSE | getPropertyAsRawString(StringSE key) 指定されたプロパティを生の文字列として取得します。 |
StringSE | getRequiredProperty(StringSE key) 指定されたキーに関連付けられているプロパティ値を返します(決して null はありません)。 |
<T> T | getRequiredProperty(StringSE key, ClassSE<T> valueType) 指定されたキーに関連付けられたプロパティ値を、指定された targetType ( null ではない) に変換して返します。 |
protected StringSE | resolveNestedPlaceholders(StringSE value) 指定された文字列内のプレースホルダーを解決し、 setIgnoreUnresolvableNestedPlaceholders(boolean) の値を延期して、解決できないプレースホルダーが例外を発生させるか無視するかを決定します。 |
StringSE | resolvePlaceholders(StringSE text) 指定されたテキストの ${...} プレースホルダーを解決し、 PropertyResolver.getProperty(java.lang.String) によって解決された対応するプロパティ値に置き換えます。 |
StringSE | resolveRequiredPlaceholders(StringSE text) 指定されたテキストの ${...} プレースホルダーを解決し、 PropertyResolver.getProperty(java.lang.String) によって解決された対応するプロパティ値に置き換えます。 |
void | setConversionService(ConfigurableConversionService conversionService) プロパティで型変換を実行するときに使用する ConfigurableConversionService を設定します。 |
void | setIgnoreUnresolvableNestedPlaceholders(boolean ignoreUnresolvableNestedPlaceholders) 特定のプロパティの値内にネストされた解決できないプレースホルダーに遭遇したときに例外をスローするかどうかを設定します。 |
void | setPlaceholderPrefix(StringSE placeholderPrefix) このリゾルバーで置き換えられたプレースホルダーが開始する必要がある接頭辞を設定します。 |
void | setPlaceholderSuffix(StringSE placeholderSuffix) このリゾルバーで置き換えられたプレースホルダーが終了する必要があるサフィックスを設定します。 |
void | setRequiredProperties(StringSE... requiredProperties) ConfigurablePropertyResolver.validateRequiredProperties() によって検証される、存在する必要があるプロパティを指定します。 |
void | setValueSeparator(StringSE valueSeparator) このリゾルバーによって置き換えられたプレースホルダーとそれに関連付けられたデフォルト値の間の区切り文字を指定します。そのような特殊文字を値のセパレーターとして処理する必要がない場合は、 null を指定します。 |
void | validateRequiredProperties() ConfigurablePropertyResolver.setRequiredProperties(java.lang.String...) で指定された各プロパティが存在し、null 以外の値に解決されることを確認します。 |
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSE
getProperty
protected final Log logger
public ConfigurableConversionService getConversionService()
ConfigurablePropertyResolver
ConfigurableConversionService
を返します。 返される変換サービスの構成可能な性質により、個々の Converter
インスタンスを簡単に追加および削除できます。
ConfigurableConversionService cs = env.getConversionService(); cs.addConverter(new FooConverter());
public void setConversionService(ConfigurableConversionService conversionService)
ConfigurablePropertyResolver
ConfigurableConversionService
を設定します。 注意 : ConversionService
を完全に置き換える代わりに、ConfigurablePropertyResolver.getConversionService()
にドリルして #addConverter
などのメソッドを呼び出すことにより、個々の Converter
インスタンスを追加または削除することを検討してください。
public void setPlaceholderPrefix(StringSE placeholderPrefix)
デフォルトは "${" です。
ConfigurablePropertyResolver
の setPlaceholderPrefix
SystemPropertyUtils.PLACEHOLDER_PREFIX
public void setPlaceholderSuffix(StringSE placeholderSuffix)
デフォルトは "}" です。
ConfigurablePropertyResolver
の setPlaceholderSuffix
SystemPropertyUtils.PLACEHOLDER_SUFFIX
public void setValueSeparator(@Nullable StringSE valueSeparator)
null
を指定します。デフォルトは ":" です。
ConfigurablePropertyResolver
の setValueSeparator
SystemPropertyUtils.VALUE_SEPARATOR
public void setIgnoreUnresolvableNestedPlaceholders(boolean ignoreUnresolvableNestedPlaceholders)
false
値は、厳密な解決、つまり例外がスローされることを示します。true
値は、解決できないネストされたプレースホルダーが、解決されていない ${...} 形式で渡されることを示します。 デフォルトは false
です。
ConfigurablePropertyResolver
の setIgnoreUnresolvableNestedPlaceholders
public void setRequiredProperties(StringSE... requiredProperties)
ConfigurablePropertyResolver
ConfigurablePropertyResolver.validateRequiredProperties()
によって検証される、存在する必要があるプロパティを指定します。ConfigurablePropertyResolver
の setRequiredProperties
public void validateRequiredProperties()
ConfigurablePropertyResolver
ConfigurablePropertyResolver.setRequiredProperties(java.lang.String...)
で指定された各プロパティが存在し、null
以外の値に解決されることを確認します。ConfigurablePropertyResolver
の validateRequiredProperties
public boolean containsProperty(StringSE key)
PropertyResolver
null
でないかどうかを返します。PropertyResolver
の containsProperty
@Nullable public StringSE getProperty(StringSE key)
PropertyResolver
null
を返します。PropertyResolver
の getProperty
key
- 解決するプロパティ名 PropertyResolver.getProperty(String, String)
, PropertyResolver.getProperty(String, Class)
, PropertyResolver.getRequiredProperty(String)
public StringSE getProperty(StringSE key, StringSE defaultValue)
PropertyResolver
defaultValue
を返します。PropertyResolver
の getProperty
key
- 解決するプロパティ名 defaultValue
- 値が見つからない場合に返すデフォルト値 PropertyResolver.getRequiredProperty(String)
, PropertyResolver.getProperty(String, Class)
public <T> T getProperty(StringSE key, ClassSE<T> targetType, T defaultValue)
PropertyResolver
defaultValue
を返します。PropertyResolver
の getProperty
key
- 解決するプロパティ名 targetType
- プロパティ値の予想される型 defaultValue
- 値が見つからない場合に返すデフォルト値 PropertyResolver.getRequiredProperty(String, Class)
public StringSE getRequiredProperty(StringSE key) throws IllegalStateExceptionSE
PropertyResolver
null
はありません)。PropertyResolver
の getRequiredProperty
IllegalStateExceptionSE
- キーを解決できない場合 PropertyResolver.getRequiredProperty(String, Class)
public <T> T getRequiredProperty(StringSE key, ClassSE<T> valueType) throws IllegalStateExceptionSE
PropertyResolver
null
ではない) に変換して返します。PropertyResolver
の getRequiredProperty
IllegalStateExceptionSE
- 指定されたキーを解決できない場合 public StringSE resolvePlaceholders(StringSE text)
PropertyResolver
PropertyResolver.getProperty(java.lang.String)
によって解決された対応するプロパティ値に置き換えます。デフォルト値のない解決できないプレースホルダーは無視され、変更されずに渡されます。PropertyResolver
の resolvePlaceholders
text
- 解決する文字列 null
)PropertyResolver.resolveRequiredPlaceholders(java.lang.String)
public StringSE resolveRequiredPlaceholders(StringSE text) throws IllegalArgumentExceptionSE
PropertyResolver
PropertyResolver.getProperty(java.lang.String)
によって解決された対応するプロパティ値に置き換えます。デフォルト値のない解決できないプレースホルダーは、IllegalArgumentException をスローします。PropertyResolver
の resolveRequiredPlaceholders
null
)IllegalArgumentExceptionSE
- 指定されたテキストが null
である場合、または解決できないプレースホルダーがある場合 protected StringSE resolveNestedPlaceholders(StringSE value)
setIgnoreUnresolvableNestedPlaceholders(boolean)
の値を延期して、解決できないプレースホルダーが例外を発生させるか無視するかを決定します。getProperty(java.lang.String)
とそのバリアントから呼び出され、ネストされたプレースホルダーを暗黙的に解決します。対照的に、resolvePlaceholders(java.lang.String)
と resolveRequiredPlaceholders(java.lang.String)
はこのメソッドに委譲せず、これらの各メソッドで指定されているように、解決できないプレースホルダーを独自に処理します。
setIgnoreUnresolvableNestedPlaceholders(boolean)
@Nullable protected <T> T convertValueIfNecessary(ObjectSE value, @Nullable ClassSE<T> targetType)
value
- 元のプロパティ値 targetType
- プロパティ取得用に指定されたターゲット型