PropertyPlaceholderConfigurer (Spring Framework API)

java.lang.ObjectSE
- org.springframework.core.io.support.PropertiesLoaderSupport
- - org.springframework.beans.factory.config.PropertyResourceConfigurer
  - - org.springframework.beans.factory.config.PlaceholderConfigurerSupport
    - - org.springframework.beans.factory.config.PropertyPlaceholderConfigurer

実装されたすべてのインターフェース:
Aware, BeanFactoryAware, BeanNameAware, BeanFactoryPostProcessor, Ordered, PriorityOrdered
既知の直属サブクラス
PreferencesPlaceholderConfigurer
使用すべきではありません。
5.2 以降。代わりに org.springframework.context.support.PropertySourcesPlaceholderConfigurer を使用してください。org.springframework.context.support.PropertySourcesPlaceholderConfigurer は、Environment および PropertySource メカニズムを利用することにより柔軟性があります。
```
@DeprecatedSE
public class PropertyPlaceholderConfigurer
extends PlaceholderConfigurerSupport
```
${...} プレースホルダーを local properties および / またはシステムプロパティと環境変数に対して解決する PlaceholderConfigurerSupport サブクラス。
PropertyPlaceholderConfigurer は、次の場合に使用するのに適切です。
- spring-context モジュールは使用できません（つまり、ApplicationContext ではなく Spring の BeanFactory API を使用しています）。
- 既存の構成では、"systemPropertiesMode" および / または "systemPropertiesModeName" プロパティを使用します。ユーザーは、これらの設定の使用をやめて、コンテナーの Environment を介してプロパティソースの検索順序を設定することをお勧めします。ただし、PropertyPlaceholderConfigurer を引き続き使用することにより、機能の正確な保存を維持できます。
導入:
02.10.2003
作成者:
Juergen Hoeller, Chris Beams
関連事項:
setSystemPropertiesModeName(java.lang.String), PlaceholderConfigurerSupport, PropertyOverrideConfigurer

フィールドサマリー

フィールド
修飾子と型	フィールドと説明
`static int`	`SYSTEM_PROPERTIES_MODE_FALLBACK` 使用すべきではありません。指定されたプロパティで解決できない場合は、システムプロパティを確認します。
`static int`	`SYSTEM_PROPERTIES_MODE_NEVER` 使用すべきではありません。システムプロパティを確認しないでください。
`static int`	`SYSTEM_PROPERTIES_MODE_OVERRIDE` 使用すべきではありません。指定されたプロパティを試す前に、まずシステムプロパティを確認してください。

クラス org.springframework.beans.factory.config.PlaceholderConfigurerSupport から継承されたフィールド
DEFAULT_PLACEHOLDER_PREFIX, DEFAULT_PLACEHOLDER_SUFFIX, DEFAULT_VALUE_SEPARATOR, ignoreUnresolvablePlaceholders, nullValue, placeholderPrefix, placeholderSuffix, trimValues, valueSeparator

クラス org.springframework.core.io.support.PropertiesLoaderSupport から継承されたフィールド
localOverride, localProperties, logger

インターフェース org.springframework.core.Ordered から継承されたフィールド
HIGHEST_PRECEDENCE, LOWEST_PRECEDENCE

コンストラクターのサマリー
コンストラクター
コンストラクターと説明
PropertyPlaceholderConfigurer()
使用すべきではありません。

コンストラクター
コンストラクターと説明
`PropertyPlaceholderConfigurer()` 使用すべきではありません。

メソッドのサマリー

すべてのメソッドインスタンスメソッド具象メソッド非推奨のメソッド
修飾子と型	メソッドと説明
`protected void`	`processProperties(ConfigurableListableBeanFactory beanFactoryToProcess, PropertiesSE props)` 使用すべきではありません。指定された Bean ファクトリの各 Bean 定義にアクセスし、${...} プロパティのプレースホルダーを指定されたプロパティの値で置き換えようとします。
`protected StringSE`	`resolvePlaceholder(StringSE placeholder, PropertiesSE props)` 使用すべきではありません。指定されたプロパティを使用して、指定されたプレースホルダーを解決します。
`protected StringSE`	`resolvePlaceholder(StringSE placeholder, PropertiesSE props, int systemPropertiesMode)` 使用すべきではありません。特定のプロパティを使用して特定のプレースホルダーを解決し、特定のモードに従ってシステムプロパティチェックを実行します。
`protected StringSE`	`resolveSystemProperty(StringSE key)` 使用すべきではありません。指定されたキーを JVM システムプロパティとして解決します。また、一致するシステムプロパティが見つからない場合は、オプションでシステム環境変数としても解決します。
`void`	`setSearchSystemEnvironment(boolean searchSystemEnvironment)` 使用すべきではありません。一致するシステムプロパティが見つからない場合、一致するシステム環境変数を検索するかどうかを設定します。
`void`	`setSystemPropertiesMode(int systemPropertiesMode)` 使用すべきではありません。システムプロパティのチェック方法を設定します: フォールバック、オーバーライド、なし。
`void`	`setSystemPropertiesModeName(StringSE constantName)` 使用すべきではありません。対応する定数の名前でシステムプロパティモードを設定します。

クラス org.springframework.beans.factory.config.PlaceholderConfigurerSupport から継承されたメソッド
doProcessProperties, setBeanFactory, setBeanName, setIgnoreUnresolvablePlaceholders, setNullValue, setPlaceholderPrefix, setPlaceholderSuffix, setTrimValues, setValueSeparator

クラス org.springframework.beans.factory.config.PropertyResourceConfigurer から継承されたメソッド
convertProperties, convertProperty, convertPropertyValue, getOrder, postProcessBeanFactory, setOrder

クラス org.springframework.core.io.support.PropertiesLoaderSupport から継承されたメソッド
loadProperties, mergeProperties, setFileEncoding, setIgnoreResourceNotFound, setLocalOverride, setLocation, setLocations, setProperties, setPropertiesArray, setPropertiesPersister

クラス java.lang.ObjectSE から継承されたメソッド
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSE

- フィールドの詳細
  - SYSTEM_PROPERTIES_MODE_NEVER
```
public static final int SYSTEM_PROPERTIES_MODE_NEVER
```
    使用すべきではありません。
    システムプロパティを確認しないでください。
    関連事項:
    定数フィールド値
  - SYSTEM_PROPERTIES_MODE_FALLBACK
```
public static final int SYSTEM_PROPERTIES_MODE_FALLBACK
```
    使用すべきではありません。
    指定されたプロパティで解決できない場合は、システムプロパティを確認します。これがデフォルトです。
    関連事項:
    定数フィールド値
  - SYSTEM_PROPERTIES_MODE_OVERRIDE
```
public static final int SYSTEM_PROPERTIES_MODE_OVERRIDE
```
    使用すべきではありません。
    指定されたプロパティを試す前に、まずシステムプロパティを確認してください。これにより、システムプロパティが他のプロパティソースをオーバーライドできます。
    関連事項:
    定数フィールド値
- コンストラクターの詳細
  - PropertyPlaceholderConfigurer
```
public PropertyPlaceholderConfigurer()
```
    使用すべきではありません。
- メソッドの詳細
  - setSystemPropertiesModeName
```
public void setSystemPropertiesModeName(StringSE constantName)
                                 throws IllegalArgumentExceptionSE
```
    使用すべきではありません。
    対応する定数の名前でシステムプロパティモードを設定します。"SYSTEM_PROPERTIES_MODE_OVERRIDE"。
    パラメーター:
    constantName - 定数の名前
    例外:
    IllegalArgumentExceptionSE
    関連事項:
    setSystemPropertiesMode(int)
  - setSystemPropertiesMode
```
public void setSystemPropertiesMode(int systemPropertiesMode)
```
    使用すべきではありません。
    システムプロパティを確認する方法を設定します: フォールバックとして、オーバーライドとして、または決して。例:${user.dir} を "user.dir" システムプロパティに解決します。
    デフォルトは「フォールバック」です: 指定されたプロパティでプレースホルダーを解決できない場合、システムプロパティが試行されます。「オーバーライド」は、指定されたプロパティを試す前に、最初にシステムプロパティをチェックします。「決して」は、システムプロパティをまったくチェックしません。
    関連事項:
    SYSTEM_PROPERTIES_MODE_NEVER, SYSTEM_PROPERTIES_MODE_FALLBACK, SYSTEM_PROPERTIES_MODE_OVERRIDE, setSystemPropertiesModeName(java.lang.String)
  - setSearchSystemEnvironment
```
public void setSearchSystemEnvironment(boolean searchSystemEnvironment)
```
    使用すべきではありません。
    一致するシステムプロパティが見つからない場合、一致するシステム環境変数を検索するかどうかを設定します。JVM システムプロパティをチェックした直後に、"systemPropertyMode" がアクティブ（つまり「フォールバック」または「オーバーライド」）の場合にのみ適用されます。
    デフォルトは "true" です。この設定をオフにして、システム環境変数に対してプレースホルダーを解決しないようにします。一般に、JVM システムプロパティとして外部値を渡すことをお勧めします。これは、既存の環境変数であっても、起動スクリプトで簡単に実現できます。
    関連事項:
    setSystemPropertiesMode(int), System.getProperty(String)SE, System.getenv(String)SE
  - resolvePlaceholder
```
@Nullable
protected StringSE resolvePlaceholder(StringSE placeholder,
                                              PropertiesSE props,
                                              int systemPropertiesMode)
```
    使用すべきではありません。
    特定のプロパティを使用して特定のプレースホルダーを解決し、特定のモードに従ってシステムプロパティチェックを実行します。
    デフォルトの実装は、システムプロパティチェックの前後に resolvePlaceholder (placeholder, props) に委譲します。
    サブクラスは、システムプロパティチェックのカスタマイズされたポイントを含む、カスタムの解決戦略に対してこれをオーバーライドできます。
    パラメーター:
    placeholder - 解決するプレースホルダー
    props - この設定のマージされたプロパティ
    systemPropertiesMode - このクラスの定数に応じたシステムプロパティモード
    戻り値:
    解決された値。ない場合は null
    関連事項:
    setSystemPropertiesMode(int), System.getProperty(java.lang.String)SE, resolvePlaceholder(String, java.util.Properties)
  - resolvePlaceholder
```
@Nullable
protected StringSE resolvePlaceholder(StringSE placeholder,
                                              PropertiesSE props)
```
    使用すべきではありません。
    指定されたプロパティを使用して、指定されたプレースホルダーを解決します。デフォルトの実装では、対応するプロパティキーをチェックするだけです。
    サブクラスは、カスタマイズされたプレースホルダーからキーへのマッピングまたはカスタム解決戦略に対して、これをオーバーライドできます。おそらく、フォールバックとして指定されたプロパティを使用するだけです。
    システムプロパティモードに従って、このメソッドが呼び出される前に、システムプロパティがそれぞれチェックされることに注意してください。
    パラメーター:
    placeholder - 解決するプレースホルダー
    props - この設定のマージされたプロパティ
    戻り値:
    null の解決された値（ない場合）
    関連事項:
    setSystemPropertiesMode(int)
  - resolveSystemProperty
```
@Nullable
protected StringSE resolveSystemProperty(StringSE key)
```
    使用すべきではありません。
    指定されたキーを JVM システムプロパティとして解決します。また、一致するシステムプロパティが見つからない場合は、オプションでシステム環境変数としても解決します。
    パラメーター:
    key - システムプロパティキーとして解決するプレースホルダー
    戻り値:
    システムプロパティ値、または見つからない場合は null
    関連事項:
    setSearchSystemEnvironment(boolean), System.getProperty(String)SE, System.getenv(String)SE
  - processProperties
```
protected void processProperties(ConfigurableListableBeanFactory beanFactoryToProcess,
                                 PropertiesSE props)
                          throws BeansException
```
    使用すべきではありません。
    指定された Bean ファクトリの各 Bean 定義にアクセスし、${...} プロパティのプレースホルダーを指定されたプロパティの値で置き換えようとします。
    次で指定:
    クラス PropertyResourceConfigurer の processProperties
    パラメーター:
    beanFactoryToProcess - アプリケーションコンテキストで使用される BeanFactory
    props - 適用するプロパティ
    例外:
    BeansException - エラーの場合

クラス PropertyPlaceholderConfigurer

フィールドサマリー

クラス org.springframework.beans.factory.config.PlaceholderConfigurerSupport から継承されたフィールド

クラス org.springframework.core.io.support.PropertiesLoaderSupport から継承されたフィールド

インターフェース org.springframework.core.Ordered から継承されたフィールド

コンストラクターのサマリー

メソッドのサマリー

クラス org.springframework.beans.factory.config.PlaceholderConfigurerSupport から継承されたメソッド

クラス org.springframework.beans.factory.config.PropertyResourceConfigurer から継承されたメソッド

クラス org.springframework.core.io.support.PropertiesLoaderSupport から継承されたメソッド

クラス java.lang.ObjectSE から継承されたメソッド

フィールドの詳細

SYSTEM_PROPERTIES_MODE_NEVER

SYSTEM_PROPERTIES_MODE_FALLBACK

SYSTEM_PROPERTIES_MODE_OVERRIDE

コンストラクターの詳細

PropertyPlaceholderConfigurer

メソッドの詳細

setSystemPropertiesModeName

setSystemPropertiesMode

setSearchSystemEnvironment

resolvePlaceholder

resolvePlaceholder

resolveSystemProperty

processProperties