付録

リファレンスドキュメントのこのパートでは、コア Spring Framework 内の複数のモジュールに適用されるトピックについて説明します。

Spring のプロパティ

SpringProperties (Javadoc) は、Spring Framework の特定の低レベルの側面を制御するプロパティの静的ホルダーです。ユーザーは、JVM システムプロパティを介して、または SpringProperties.setProperty(String key, String value) メソッドを介してプログラムでこれらのプロパティを構成できます。デプロイ環境でカスタム JVM システムプロパティが許可されていない場合は、後者が必要になることがあります。別の方法として、これらのプロパティは、クラスパスのルートにある spring.properties ファイルで構成できます。たとえば、アプリケーションの JAR ファイル内にデプロイされます。

次の表に、現在サポートされているすべての Spring プロパティを示します。

表 1: サポートされている Spring プロパティ
名前 説明

spring.aop.ajc.ignore

Spring に、Spring AOP プロキシの ajc コンパイルされたアスペクトを無視するように指示し、ウィービングと AspectJ 自動プロキシの両方が有効になっているシナリオで従来の Spring の動作を復元します。詳細については、AbstractAspectJAdvisorFactory (Javadoc) を参照してください。

spring.aot.enabled

アプリケーションが AOT で生成されたアーティファクトを使用して実行される必要があることを示します。詳細については、事前の最適化および AotDetector (Javadoc) を参照してください。

spring.beaninfo.ignore

JavaBeans Introspector を呼び出すときに、Introspector.IGNORE_ALL_BEANINFO モードを使用するように Spring に指示します。詳細については、StandardBeanInfoFactory (Javadoc) を参照してください。

spring.cache.reactivestreams.ignore

Spring のキャッシュインフラストラクチャに、Reactive Streams、特に @Cacheable メソッドの戻り値の型宣言内の Reactor の Mono/Flux の存在を無視するように指示します。詳細については、CacheAspectSupport (Javadoc) を参照してください。

spring.classformat.ignore

特にサポートされていないクラスファイルバージョンの場合、クラスパスのスキャン中にクラス形式の例外を無視するように Spring に指示します。詳細については、ClassPathScanningCandidateComponentProvider (Javadoc) を参照してください。

spring.context.checkpoint

共通コンテキストチェックポイントを指定するプロパティ。詳細については、起動時の自動チェックポイント / 復元および DefaultLifecycleProcessor (Javadoc) を参照してください。

spring.context.exit

コンテキストが特定のフェーズに到達したときに JVM を終了するためのプロパティ。詳細については、起動時の自動チェックポイント / 復元および DefaultLifecycleProcessor (Javadoc) を参照してください。

spring.context.expression.maxLength

XML Bean 定義、@Value などで使用される Spring 式言語式の最大長。

spring.expression.compiler.mode

Spring 式言語の式をコンパイルするときに使用するモード。

spring.expression.maxOperations

Spring 式言語式の評価中に許可されるデフォルトの最大演算回数。

spring.getenv.ignore

Spring Environment プロパティ（たとえば、構成文字列のプレースホルダー）が解決できない場合は、オペレーティングシステムの環境変数を無視するように Spring に指示します。詳細については、AbstractEnvironment (Javadoc) を参照してください。

spring.http.response.flush.enabled

ServletServerHttpResponse#getBody() から返される OutputStream 上でフラッシュ処理を実行するように Spring MVC ServletServerHttpResponse を設定します。デフォルトでは、このようなフラッシュ呼び出しは無視され、実際にネットワークにレスポンスをフラッシュするのは ServletServerHttpResponse#flush() のみです。

spring.jdbc.getParameterType.ignore

java.sql.ParameterMetaData.getParameterType を完全に無視するように Spring に指示します。オブジェクトのリストを使用したバッチ操作の注記を参照してください。

spring.jndi.ignore

Spring に、デフォルトの JNDI 環境を無視するように指示します。これは、このような JNDI フォールバック検索で何も見つからないシナリオの最適化として、繰り返される JNDI ルックアップのオーバーヘッドを回避するためです。詳細については、JndiLocatorDelegate (Javadoc) を参照してください。

spring.locking.strict

Bean の作成時に、6.2 がデフォルトで適用する厳密なロックと緩やかなロックの組み合わせではなく、厳密なロックを適用するよう Spring に指示します。詳細は DefaultListableBeanFactory (Javadoc) を参照してください。

spring.objenesis.ignore

Objenesis を使用しようとせずに、Objenesis を無視するように Spring に指示します。詳細については、SpringObjenesis (Javadoc) を参照してください。

spring.placeholder.escapeCharacter.default

プロパティプレースホルダサポートのデフォルトのエスケープ文字です。設定されていない場合は、'\' が使用されます。カスタムエスケープ文字または空文字列を設定すると、エスケープ文字のサポートが無効になります。PropertySourcesPlaceholderConfigurer および AbstractPropertyResolver のサブクラスでは、デフォルトのエスケープ文字を明示的にオーバーライドできます。詳細は AbstractPropertyResolver (Javadoc) を参照してください。

spring.test.aot.processing.failOnError

Spring TestContext フレームワークでの AOT 処理中に発生したエラーが、プロセス全体を失敗させる例外を引き起こすかどうかを制御するブールフラグ。テストの事前サポートを参照してください。

spring.test.constructor.autowire.mode

@TestConstructor がテストクラスに存在しない場合に使用するデフォルトのテストコンストラクターオートワイヤーモード。 デフォルトのテストコンストラクターオートワイヤーモードの変更を参照してください。

spring.test.context.cache.maxSize

Spring TestContext フレームワークのコンテキストキャッシュの最大サイズ。コンテキストキャッシングを参照してください。

spring.test.context.cache.pause

Spring TestContext フレームワークのコンテキストキャッシュの一時停止モード。コンテキストの一時停止を参照してください。

spring.test.context.failure.threshold

Spring TestContext フレームワークに ApplicationContext をロードしようとしたときに発生したエラーの失敗しきい値。コンテキスト障害のしきい値を参照してください。

spring.test.extension.context.scope

@Nested テストクラス階層で SpringExtension が使用するデフォルトの拡張コンテキストスコープ。@SpringExtensionConfig を参照してください。

spring.test.enclosing.configuration

@NestedTestConfiguration がテストクラスに存在しない場合に使用するデフォルトの包含構成継承モード。 デフォルトの包含構成継承モードの変更を参照してください。