AbstractMappingContentNegotiationStrategy (Spring Framework API)

java.lang.ObjectSE
- org.springframework.web.accept.MappingMediaTypeFileExtensionResolver
- - org.springframework.web.accept.AbstractMappingContentNegotiationStrategy

実装されているすべてのインターフェース:
ContentNegotiationStrategy, MediaTypeFileExtensionResolver
既知の直属サブクラス
ParameterContentNegotiationStrategy, PathExtensionContentNegotiationStrategy
```
public abstract class AbstractMappingContentNegotiationStrategy
extends MappingMediaTypeFileExtensionResolver
implements ContentNegotiationStrategy
```
メディア型へのリクエストを解決する手順を含む ContentNegotiationStrategy 実装の基本クラス。
最初に、リクエストからキー（例: "json"、"pdf" ）を抽出する必要があります（例: ファイル拡張子、クエリパラメーター）。次に、そのようなマッピングを格納する基本クラス MappingMediaTypeFileExtensionResolver を介して、キーをメディア型に解決する必要があります。
handleNoMatch(org.springframework.web.context.request.NativeWebRequest, java.lang.String) メソッドを使用すると、サブクラスでメディア型を検索する追加の方法をプラグインできます（たとえば、Java Activation フレームワークまたは ServletContext.getMimeType(java.lang.String)EE を使用）。基本クラスを介して解決されたメディア型は、基本クラス MappingMediaTypeFileExtensionResolver に追加されます（つまり、新しいルックアップ用にキャッシュされます）。
導入:
3.2
作成者:
Rossen Stoyanchev

フィールドのサマリー
フィールド
修飾子と型フィールドと説明
protected Log logger
- インターフェース org.springframework.web.accept.ContentNegotiationStrategy から継承されたフィールド
  MEDIA_TYPE_ALL_LIST

フィールド
修飾子と型	フィールドと説明
`protected Log`	`logger`

コンストラクターの概要

コンストラクター
コンストラクターと説明
`AbstractMappingContentNegotiationStrategy(MapSE<StringSE, MediaType> mediaTypes)` ファイル拡張子とメディア型の指定されたマップでインスタンスを作成します。

メソッドのサマリー

すべてのメソッドインスタンスメソッド抽象メソッド具象メソッド
修飾子と型	メソッドと説明
`protected abstract StringSE`	`getMediaTypeKey(NativeWebRequest request)` メディア型の検索に使用するリクエストからキーを抽出します。
`protected void`	`handleMatch(StringSE key, MediaType mediaType)` キーが `MappingMediaTypeFileExtensionResolver.lookupMediaType(java.lang.String)` を介して正常に解決されたときに処理を提供するためにオーバーライドします。
`protected MediaType`	`handleNoMatch(NativeWebRequest request, StringSE key)` キーが経由で解決されない場合の処理を提供するためにオーバーライドします。
`boolean`	`isIgnoreUnknownExtensions()`
`boolean`	`isUseRegisteredExtensionsOnly()`
`ListSE<MediaType>`	`resolveMediaTypeKey(NativeWebRequest webRequest, StringSE key)` すでに抽出されたキーを受け入れる `resolveMediaTypes(NativeWebRequest)` の代替。
`ListSE<MediaType>`	`resolveMediaTypes(NativeWebRequest webRequest)` 指定されたリクエストをメディア型のリストに解決します。
`void`	`setIgnoreUnknownExtensions(boolean ignoreUnknownExtensions)` 不明なファイル拡張子を持つリクエストを無視するかどうか。
`void`	`setUseRegisteredExtensionsOnly(boolean useRegisteredExtensionsOnly)` 登録されたマッピングのみを使用してファイル拡張子を検索するか、動的解決を使用するか（例:

クラス org.springframework.web.accept.MappingMediaTypeFileExtensionResolver から継承されたメソッド
addMapping, getAllFileExtensions, getAllMediaTypes, getMediaTypes, lookupMediaType, resolveFileExtensions

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

- フィールドの詳細
  - logger
```
protected final Log logger
```
- コンストラクターの詳細
  - AbstractMappingContentNegotiationStrategy
```
public AbstractMappingContentNegotiationStrategy(@Nullable
                                                 MapSE<StringSE,MediaType> mediaTypes)
```
    ファイル拡張子とメディア型の指定されたマップでインスタンスを作成します。
- メソッドの詳細
  - setUseRegisteredExtensionsOnly
```
public void setUseRegisteredExtensionsOnly(boolean useRegisteredExtensionsOnly)
```
    登録されたマッピングのみを使用してファイル拡張子を検索するか、動的解決を使用するか（MediaTypeFactory などを使用）。
    デフォルトでは、これは false に設定されています。
  - isUseRegisteredExtensionsOnly
```
public boolean isUseRegisteredExtensionsOnly()
```
  - setIgnoreUnknownExtensions
```
public void setIgnoreUnknownExtensions(boolean ignoreUnknownExtensions)
```
    不明なファイル拡張子を持つリクエストを無視するかどうか。これを false に設定すると、HttpMediaTypeNotAcceptableException になります。
    デフォルトでは、これは false に設定されていますが、PathExtensionContentNegotiationStrategy でオーバーライドされて true になっています。
  - isIgnoreUnknownExtensions
```
public boolean isIgnoreUnknownExtensions()
```
  - resolveMediaTypes
```
public ListSE<MediaType> resolveMediaTypes(NativeWebRequest webRequest)
                                  throws HttpMediaTypeNotAcceptableException
```
    インターフェースからコピーされた説明: ContentNegotiationStrategy
    指定されたリクエストをメディア型のリストに解決します。返されるリストは、最初に特異性、次に品質パラメーターの順に並べられます。
    次で指定:
    インターフェース ContentNegotiationStrategy の resolveMediaTypes
    パラメーター:
    webRequest - 現在のリクエスト
    戻り値:
    リクエストされたメディア型、またはリクエストされなかった場合は ContentNegotiationStrategy.MEDIA_TYPE_ALL_LIST
    例外:
    HttpMediaTypeNotAcceptableException - リクエストされたメディア型を解析できない場合
  - resolveMediaTypeKey
```
public ListSE<MediaType> resolveMediaTypeKey(NativeWebRequest webRequest,
                                           @Nullable
                                           StringSE key)
                                    throws HttpMediaTypeNotAcceptableException
```
    すでに抽出されたキーを受け入れる resolveMediaTypes(NativeWebRequest) の代替。
    例外:
    HttpMediaTypeNotAcceptableException
    導入:
    3.2.16
  - getMediaTypeKey
```
@Nullable
protected abstract StringSE getMediaTypeKey(NativeWebRequest request)
```
    メディア型の検索に使用するリクエストからキーを抽出します。
    戻り値:
    検索キー。ない場合は null
  - handleMatch
```
protected void handleMatch(StringSE key,
                           MediaType mediaType)
```
    キーが MappingMediaTypeFileExtensionResolver.lookupMediaType(java.lang.String) を介して正常に解決されたときに処理を提供するためにオーバーライドします。
  - handleNoMatch
```
@Nullable
protected MediaType handleNoMatch(NativeWebRequest request,
                                            StringSE key)
                                     throws HttpMediaTypeNotAcceptableException
```
    オーバーライドして、キーが解決されない場合の処理を提供します。MappingMediaTypeFileExtensionResolver.lookupMediaType(java.lang.String)。サブクラスは、メディア型を決定するためにさらに手順を実行できます。このメソッドから MediaType が返された場合は、基本クラスのキャッシュに追加されます。
    例外:
    HttpMediaTypeNotAcceptableException

クラス AbstractMappingContentNegotiationStrategy

フィールドのサマリー

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

コンストラクターの概要

メソッドのサマリー

クラス org.springframework.web.accept.MappingMediaTypeFileExtensionResolver から継承されたメソッド

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

フィールドの詳細

logger

コンストラクターの詳細

AbstractMappingContentNegotiationStrategy

メソッドの詳細

setUseRegisteredExtensionsOnly

isUseRegisteredExtensionsOnly

setIgnoreUnknownExtensions

isIgnoreUnknownExtensions

resolveMediaTypes

resolveMediaTypeKey

getMediaTypeKey

handleMatch

handleNoMatch