public class ResourceHandlerRegistration extends ObjectSE
コンストラクターと説明 |
---|
ResourceHandlerRegistration(ResourceLoader resourceLoader, StringSE... pathPatterns) ResourceHandlerRegistration インスタンスを作成します。 |
修飾子と型 | メソッドと説明 |
---|---|
ResourceHandlerRegistration | addResourceLocations(StringSE... resourceLocations) 静的コンテンツを提供する 1 つ以上のリソースの場所を追加します。 |
protected StringSE[] | getPathPatterns() リソースハンドラーの URL パスパターンを返します。 |
protected ResourceWebHandler | getRequestHandler() ResourceWebHandler インスタンスを返します。 |
ResourceChainRegistration | resourceChain(boolean cacheResources) 使用するリソースリゾルバーとトランスフォーマーのチェーンを構成します。 |
ResourceChainRegistration | resourceChain(boolean cacheResources, Cache cache) 使用するリソースリゾルバーとトランスフォーマーのチェーンを構成します。 |
ResourceHandlerRegistration | setCacheControl(CacheControl cacheControl) リソースハンドラーが使用する CacheControl を指定します。 |
void | setMediaTypes(MapSE<StringSE, MediaType> mediaTypes) 静的 Resource のファイル名から抽出されたファイル拡張子と、レスポンスに使用するメディア型との間にマッピングを追加します。 |
ResourceHandlerRegistration | setOptimizeLocations(boolean optimizeLocations) 起動時の存在チェックで指定した場所を最適化するかどうかを設定し、存在しないディレクトリを事前にフィルタリングして、すべてのリソースアクセスでチェックする必要がないようにします。 |
ResourceHandlerRegistration | setUseLastModified(boolean useLastModified) Resource.lastModified() 情報を使用して HTTP レスポンスを駆動するかどうかを設定します。 |
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSE
public ResourceHandlerRegistration(ResourceLoader resourceLoader, StringSE... pathPatterns)
ResourceHandlerRegistration
インスタンスを作成します。resourceLoader
- String の場所を Resource
に変換するためのリソースローダー pathPatterns
- 1 つ以上のリソース URL パスパターン public ResourceHandlerRegistration addResourceLocations(StringSE... resourceLocations)
各場所は、有効なディレクトリを指している必要があります。複数の場所をコンマ区切りのリストとして指定できます。場所は、指定された順序で特定のリソースについてチェックされます。
例: "/", "classpath:/META-INF/public-web-resources/"
を使用すると、Web アプリケーションルートと、/META-INF/public-web-resources/
ディレクトリを含むクラスパス上の任意の JAR の両方からリソースを提供でき、Web アプリケーションルートのリソースが優先されます。
ResourceHandlerRegistration
インスタンス public ResourceHandlerRegistration setCacheControl(CacheControl cacheControl)
CacheControl
を指定します。cacheControl
- 使用する CacheControl 構成 ResourceHandlerRegistration
インスタンス public ResourceHandlerRegistration setUseLastModified(boolean useLastModified)
Resource.lastModified()
情報を使用して HTTP レスポンスを駆動するかどうかを設定します。 この構成は、デフォルトで true
に設定されています。
useLastModified
- 「最終変更」リソース情報を使用する必要があるかどうか ResourceHandlerRegistration
インスタンス ResourceWebHandler.setUseLastModified(boolean)
public ResourceHandlerRegistration setOptimizeLocations(boolean optimizeLocations)
デフォルトは false
です。これは、ディレクトリの存在を事前に公開できないディレクトリエントリのない zip ファイルに対する防御のためです。ディレクトリエントリとの一貫した jar レイアウトの場合に最適化されたアクセスのために、このフラグを true
に切り替えます。
optimizeLocations
- 起動時の存在チェックでロケーションを最適化するかどうか ResourceHandlerRegistration
インスタンス ResourceWebHandler.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
インスタンス public void setMediaTypes(MapSE<StringSE,MediaType> mediaTypes)
Resource
のファイル名から抽出されたファイル拡張子と、レスポンスに使用するメディア型との間にマッピングを追加します。 マッピングは MediaTypeFactory.getMediaType(Resource)
を介して決定することもできるため、通常、この方法を使用する必要はありません。
mediaTypes
- メディア型のマッピング protected StringSE[] getPathPatterns()
protected ResourceWebHandler getRequestHandler()
ResourceWebHandler
インスタンスを返します。