public class ResourceHandlerRegistration extends ObjectSE
コンストラクターと説明 |
---|
ResourceHandlerRegistration(StringSE... pathPatterns) ResourceHandlerRegistration インスタンスを作成します。 |
修飾子と型 | メソッドと説明 |
---|---|
ResourceHandlerRegistration | addResourceLocations(Resource... locations) 事前に解決された Resource 参照に基づいて、静的リソースを提供する場所を構成します。 |
ResourceHandlerRegistration | addResourceLocations(StringSE... locations) 静的コンテンツを提供する 1 つ以上のリソースの場所を追加します。 |
protected StringSE[] | getPathPatterns() リソースハンドラーの URL パスパターンを返します。 |
protected ResourceHttpRequestHandler | getRequestHandler() ResourceHttpRequestHandler インスタンスを返します。 |
ResourceChainRegistration | resourceChain(boolean cacheResources) 使用するリソースリゾルバーとトランスフォーマーのチェーンを構成します。 |
ResourceChainRegistration | resourceChain(boolean cacheResources, Cache cache) 使用するリソースリゾルバーとトランスフォーマーのチェーンを構成します。 |
ResourceHandlerRegistration | setCacheControl(CacheControl cacheControl) リソースハンドラーが使用する CacheControl を指定します。 |
ResourceHandlerRegistration | setCachePeriod(IntegerSE cachePeriod) リソースハンドラーによって提供されるリソースのキャッシュ期間を秒単位で指定します。 |
ResourceHandlerRegistration | setOptimizeLocations(boolean optimizeLocations) 起動時の存在チェックで指定した場所を最適化するかどうかを設定し、存在しないディレクトリを事前にフィルタリングして、すべてのリソースアクセスでチェックする必要がないようにします。 |
ResourceHandlerRegistration | setUseLastModified(boolean useLastModified) Resource.lastModified() 情報を使用して HTTP レスポンスを駆動するかどうかを設定します。 |
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSE
public ResourceHandlerRegistration(StringSE... pathPatterns)
ResourceHandlerRegistration
インスタンスを作成します。pathPatterns
- 1 つ以上のリソース URL パスパターン public ResourceHandlerRegistration addResourceLocations(StringSE... locations)
例: {"/"
、"classpath:/META-INF/public-web-resources/"
} では、Web アプリケーションルートと、/META-INF/public-web-resources/
ディレクトリを含むクラスパス上の JAR の両方からリソースを提供できます。Web アプリケーションルートのリソースが優先されます。
URL-based resources
(ファイル、HTTP URL など)の場合、このメソッドは、URL に関連付けられた文字セットを示す特別なプレフィックスをサポートしているため、それに追加された相対パスを正しくエンコードできます。[charset=Windows-31J]https://example.org/path
。
ResourceHandlerRegistration
インスタンス public ResourceHandlerRegistration addResourceLocations(Resource... locations)
Resource
参照に基づいて、静的リソースを提供する場所を構成します。locations
- 使用するリソースの場所 ResourceHandlerRegistration
インスタンス public ResourceHandlerRegistration setCachePeriod(IntegerSE cachePeriod)
cachePeriod
- リソースをキャッシュする時間(秒)ResourceHandlerRegistration
インスタンス public ResourceHandlerRegistration setCacheControl(CacheControl cacheControl)
CacheControl
を指定します。 ここでカスタム値を設定すると、setCachePeriod(java.lang.Integer)
で設定された構成が上書きされます。
cacheControl
- 使用する CacheControl 構成 ResourceHandlerRegistration
インスタンス public ResourceHandlerRegistration setUseLastModified(boolean useLastModified)
Resource.lastModified()
情報を使用して HTTP レスポンスを駆動するかどうかを設定します。 この構成は、デフォルトで true
に設定されています。
useLastModified
- 「最終変更」リソース情報を使用する必要があるかどうか ResourceHandlerRegistration
インスタンス ResourceHttpRequestHandler.setUseLastModified(boolean)
public ResourceHandlerRegistration setOptimizeLocations(boolean optimizeLocations)
デフォルトは false
です。これは、ディレクトリの存在を事前に公開できないディレクトリエントリのない zip ファイルに対する防御のためです。ディレクトリエントリとの一貫した jar レイアウトの場合に最適化されたアクセスのために、このフラグを true
に切り替えます。
optimizeLocations
- 起動時の存在チェックでロケーションを最適化するかどうか ResourceHandlerRegistration
インスタンス ResourceHttpRequestHandler.setOptimizeLocations(boolean)
public ResourceChainRegistration resourceChain(boolean cacheResources)
このメソッドが呼び出されない場合、デフォルトでは、構成された場所にあるリソースへの URL パスを照合するために、単純な PathResourceResolver
のみが使用されます。
cacheResources
- リソース解決の結果をキャッシュするかどうか。本番環境ではこれを "true" に設定することをお勧めします (特にバージョン戦略を適用する場合、開発では "false" )ResourceHandlerRegistration
インスタンス public ResourceChainRegistration resourceChain(boolean cacheResources, Cache cache)
このメソッドが呼び出されない場合、デフォルトでは、構成された場所にあるリソースへの URL パスを照合するために、単純な PathResourceResolver
のみが使用されます。
cacheResources
- リソース解決の結果をキャッシュするかどうか。本番環境ではこれを "true" に設定することをお勧めします(特にバージョン戦略を適用する場合は開発で "false" を使用することをお勧めします)cache
- 解決および変換されたリソースの保存に使用するキャッシュ。デフォルトでは、ConcurrentMapCache
が使用されます。リソースは直列化できず、アプリケーションホストに依存する可能性があるため、分散キャッシュを使用するのではなく、メモリ内キャッシュを使用する必要があります。ResourceHandlerRegistration
インスタンス protected StringSE[] getPathPatterns()
protected ResourceHttpRequestHandler getRequestHandler()
ResourceHttpRequestHandler
インスタンスを返します。