クラス ContentNegotiationManagerFactoryBean

メソッドの詳細

• setStrategies

  public void setStrategies(@Nullable ListSE<ContentNegotiationStrategy> strategies)

  使用する戦略の正確なリストを設定します。

  注意 : このメソッドの使用は、デフォルトの固定された戦略セットをカスタマイズするこのクラスの他のすべての setter の使用と相互に排他的です。詳細については、クラスレベルのドキュメントを参照してください。

  パラメーター:

  strategies - 使用する戦略

  導入:

  5.0

• setFavorParameter

  public void setFavorParameter(boolean favorParameter)

  リクエストされたメディア型を判別するためにリクエストパラメーター（デフォルトでは「フォーマット」）を使用する必要があるかどうか。このオプションを機能させるには、media type mappings を登録する必要があります。

  デフォルトでは、これは false に設定されています。

  関連事項:

  • setParameterName(String)

• setParameterName

  public void setParameterName(StringSE parameterName)

  setFavorParameter(boolean) がオンのときに使用するクエリパラメーター名を設定します。

  デフォルトのパラメーター名は "format" です。

• setMediaTypes

  public void setMediaTypes(PropertiesSE mediaTypes)

  キーから MediaType へのマッピングを追加します。キーは小文字に正規化され、パス拡張子、ファイル名拡張子から抽出されたか、クエリパラメーターとして渡された可能性があります。

  parameter strategy が動作するにはこのようなマッピングが必要です。

  注意 : ここで登録されたマッピングは、ContentNegotiationManager.getMediaTypeMappings() 経由でアクセスでき、パラメーターおよびパス拡張戦略だけでなく、他の用途にも使用できます。例: Spring MVC 構成では、たとえば @EnableWebMvc または <mvc:annotation-driven> の場合、メディア型 マッピングは次の場所にもプラグインされます。

  • ResourceHttpRequestHandler で提供される静的リソースのメディア型を決定します。
  • ContentNegotiatingViewResolver でレンダリングされたビューのメディア型を決定します。
  • RFD 攻撃検出の安全な拡張機能をリストします（詳細については、Spring Framework のリファレンスドキュメントを確認してください）。

  パラメーター:

  mediaTypes - メディア型のマッピング

  関連事項:

  • addMediaType(String, MediaType)
  • addMediaTypes(Map)

• addMediaType

  public void addMediaType(StringSE key, MediaType mediaType)

  プログラムによる登録のための setMediaTypes(Properties) の代替。

• addMediaTypes

  public void addMediaTypes(@Nullable MapSE<StringSE, MediaType> mediaTypes)

  プログラムによる登録のための setMediaTypes(Properties) の代替。

• setUseRegisteredExtensionsOnly

  public void setUseRegisteredExtensionsOnly(boolean useRegisteredExtensionsOnly)

  setFavorParameter(boolean) が設定されている場合、このプロパティは、登録された MediaType マッピングのみを使用するか、MediaTypeFactory などを介して動的な解決を許可するかを決定します。

  デフォルトではこれは設定されておらず、その場合動的解決はオンになります。

• setIgnoreAcceptHeader

  public void setIgnoreAcceptHeader(boolean ignoreAcceptHeader)

  "Accept" リクエストヘッダーのチェックを無効にするかどうか。

  デフォルトでは、この値は false に設定されています。

• setDefaultContentType

  public void setDefaultContentType(MediaType contentType)

  コンテンツ型がリクエストされない場合に使用するデフォルトのコンテンツ型を設定します。

  デフォルトでは、これは設定されていません。

  関連事項:

  • setDefaultContentTypeStrategy(ContentNegotiationStrategy)

• setDefaultContentTypes

  public void setDefaultContentTypes(ListSE<MediaType> contentTypes)

  コンテンツ型がリクエストされない場合に使用するデフォルトのコンテンツ型を設定します。

  デフォルトでは、これは設定されていません。

  導入:

  5.0

  関連事項:

  • setDefaultContentTypeStrategy(ContentNegotiationStrategy)

• setDefaultContentTypeStrategy

  public void setDefaultContentTypeStrategy(ContentNegotiationStrategy strategy)

  コンテンツ型がリクエストされていないときに使用するコンテンツ型を決定するために使用するカスタム ContentNegotiationStrategy を設定します。

  デフォルトでは、これは設定されていません。

  導入:

  4.1.2

  関連事項:

  • setDefaultContentType(MediaType)

• afterPropertiesSet

  public void afterPropertiesSet()

  インターフェースからコピーされた説明: InitializingBean

  すべての Bean プロパティを設定し、BeanFactoryAware、ApplicationContextAware などを満たした後、包含 BeanFactory によって呼び出されます。

  このメソッドにより、Bean インスタンスは、すべての Bean プロパティが設定されたときに、その全体的な構成の検証と最終的な初期化を実行できます。

  次で指定:

  インターフェース InitializingBean の afterPropertiesSet 

• build

  public ContentNegotiationManager build()

  ContentNegotiationManager インスタンスを作成して初期化します。

  導入:

  5.0

• getObject

  public @Nullable ContentNegotiationManager getObject()

  インターフェースからコピーされた説明: FactoryBean

  このファクトリによって管理されるオブジェクトのインスタンス（おそらく共有または独立）を返します。

  BeanFactory と同様に、これにより、シングルトンとプロトタイプの両方の設計パターンをサポートできます。

  この FactoryBean が呼び出し時にまだ完全に初期化されていない場合（たとえば、循環参照に関係しているため）、対応する FactoryBeanNotInitializedException をスローします。

  FactoryBeans は null オブジェクトを返すことができます。Bean ファクトリはこれを通常の値と見なし、この場合は FactoryBeanNotInitializedException をスローしません。ただし、FactoryBean 実装では、必要に応じて FactoryBeanNotInitializedException 自体をスローすることが推奨されます。

  次で指定:

  インターフェース FactoryBean<ContentNegotiationManager> の getObject 

  戻り値:

  Bean のインスタンス (null にすることができます)

  関連事項:

  • FactoryBeanNotInitializedException

• getObjectType

  public ClassSE<?> getObjectType()

  インターフェースからコピーされた説明: FactoryBean

  この FactoryBean が作成するオブジェクトの型を返します。事前にわからない場合は null を返します。

  これにより、たとえばオートワイヤーなどで、オブジェクトをインスタンス化せずに特定の型の Bean を確認できます。

  シングルトンオブジェクトを作成する実装の場合、このメソッドはシングルトンの作成を可能な限り回避し、事前に型を推定する必要があります。プロトタイプの場合は、ここで意味のある型を返すことも推奨されます。

  このメソッドは、この FactoryBean が完全に初期化される前に呼び出すことができます。初期化中に作成された状態に依存しないでください。もちろん、利用可能な場合はそのような状態を引き続き使用できます。

  注意 : オートワイヤーは、ここで null を返す FactoryBeans を単に無視します。FactoryBean の現在の状態を使用して、このメソッドを適切に実装することを強くお勧めします。

  次で指定:

  インターフェース FactoryBean<ContentNegotiationManager> の getObjectType 

  戻り値:

  この FactoryBean が作成するオブジェクトの型、または呼び出し時に不明な場合は null 

  関連事項:

  • ListableBeanFactory.getBeansOfType(Class)