付録

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

Spring のプロパティ

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

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

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

spring.aot.enabled

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

spring.beaninfo.ignore

JavaBeans Introspector を呼び出すときに、Introspector.IGNORE_ALL_BEANINFO モードを使用するように Spring に指示します。詳細については、CachedIntrospectionResults (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.getenv.ignore

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

spring.jdbc.getParameterType.ignore

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

spring.jndi.ignore

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

spring.objenesis.ignore

Objenesis を使用しようとせずに、Objenesis を無視するように Spring に指示します。詳細については、SpringObjenesis (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.failure.threshold

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

spring.test.enclosing.configuration

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