CorsConfiguration (Spring Framework 5.2.9.RELEASE API)

java.lang.ObjectSE
- org.springframework.web.cors.CorsConfiguration

```
public class CorsConfiguration
extends ObjectSE
```
CORS 構成のコンテナーと、特定のリクエストの実際のオリジン、HTTP メソッド、ヘッダーをチェックするメソッド。
デフォルトでは、新しく作成された CorsConfiguration はクロスオリジンリクエストを許可しないため、何を許可するかを明示的に構成する必要があります。applyPermitDefaultValues() を使用して初期化モデルを反転し、GET、HEAD、POST リクエストに対するすべてのクロスオリジンリクエストを許可するオープンデフォルトから始めます。
導入:
4.2
作成者:
Sebastien Deleuze, Rossen Stoyanchev, Juergen Hoeller, Sam Brannen
関連事項:
CORS 仕様

フィールドのサマリー
フィールド
修飾子と型フィールドと説明
static StringSE ALL
すべてのオリジン、メソッド、またはヘッダーを表すワイルドカード。

フィールド
修飾子と型	フィールドと説明
`static StringSE`	`ALL` すべてのオリジン、メソッド、またはヘッダーを表すワイルドカード。

コンストラクターのサマリー

コンストラクター
コンストラクターと説明
`CorsConfiguration()` デフォルトでは、どのオリジンでもクロスオリジンリクエストが許可されていない新しい `CorsConfiguration` インスタンスを作成します。
`CorsConfiguration(CorsConfiguration other)` 指定された `CorsConfiguration` からすべての値をコピーして、新しい `CorsConfiguration` インスタンスを構築します。

メソッドのサマリー

すべてのメソッドインスタンスメソッド具象メソッド
修飾子と型	メソッドと説明
`void`	`addAllowedHeader(StringSE allowedHeader)` 許可する実際のリクエストヘッダーを追加します。
`void`	`addAllowedMethod(HttpMethod method)` 許可する HTTP メソッドを追加します。
`void`	`addAllowedMethod(StringSE method)` 許可する HTTP メソッドを追加します。
`void`	`addAllowedOrigin(StringSE origin)` 許可するオリジンを追加します。
`void`	`addExposedHeader(StringSE exposedHeader)` 公開するレスポンスヘッダーを追加します。
`CorsConfiguration`	`applyPermitDefaultValues()` デフォルトでは、新しく作成された `CorsConfiguration` はクロスオリジンリクエストを許可しないため、何を許可するかを明示的に構成する必要があります。
`ListSE<StringSE>`	`checkHeaders(ListSE<StringSE> requestHeaders)` 提供されたリクエストヘッダー（またはプリフライトリクエストの `Access-Control-Request-Headers` にリストされているヘッダー）を、構成された許可されたヘッダーと照合します。
`ListSE<HttpMethod>`	`checkHttpMethod(HttpMethod requestMethod)` HTTP リクエストメソッド（またはプリフライトリクエストの `Access-Control-Request-Method` ヘッダーのメソッド）を、構成された許可されたメソッドと照合します。
`StringSE`	`checkOrigin(StringSE requestOrigin)` 構成された許可された発信元に対してリクエストの発信元を確認します。
`CorsConfiguration`	`combine(CorsConfiguration other)` 提供された `CorsConfiguration` の null 以外のプロパティをこれと組み合わせます。
`BooleanSE`	`getAllowCredentials()` 構成済みの `allowCredentials` フラグを返します。ない場合は `null` を返します。
`ListSE<StringSE>`	`getAllowedHeaders()` 許可された実際のリクエストヘッダーを返します。ない場合は `null` を返します。
`ListSE<StringSE>`	`getAllowedMethods()` 許可された HTTP メソッド、または `null` を返します。この場合、`"GET"` および `"HEAD"` のみが許可されます。
`ListSE<StringSE>`	`getAllowedOrigins()` 許可するように構成されたオリジンを返します。許可しない場合は `null` を返します。
`ListSE<StringSE>`	`getExposedHeaders()` 公開する構成済みのレスポンスヘッダーを返します。存在しない場合は `null` を返します。
`LongSE`	`getMaxAge()` 構成された `maxAge` 値を返します。ない場合は `null` 値を返します。
`void`	`setAllowCredentials(BooleanSE allowCredentials)` ユーザー資格情報がサポートされているかどうか。
`void`	`setAllowedHeaders(ListSE<StringSE> allowedHeaders)` プリフライトリクエストが実際のリクエスト中に使用できるようにリストできるヘッダーのリストを設定します。
`void`	`setAllowedMethods(ListSE<StringSE> allowedMethods)` 許可する HTTP メソッドを設定します。
`void`	`setAllowedOrigins(ListSE<StringSE> allowedOrigins)` 許可するオリジンを設定します。
`void`	`setExposedHeaders(ListSE<StringSE> exposedHeaders)` 単純なヘッダー以外のレスポンスヘッダーのリストを設定します（つまり
`void`	`setMaxAge(DurationSE maxAge)` 期間として、プリフライトリクエストからのレスポンスをクライアントがキャッシュできる期間を設定します。
`void`	`setMaxAge(LongSE maxAge)` プリフライトリクエストからのレスポンスをクライアントがキャッシュできる期間を秒単位で構成します。

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

- フィールドの詳細
  - ALL
```
public static final StringSE ALL
```
    すべてのオリジン、メソッド、またはヘッダーを表すワイルドカード。
    関連事項:
    定数フィールド値
- コンストラクターの詳細
  - CorsConfiguration
```
public CorsConfiguration()
```
    デフォルトでは、どのオリジンでもクロスオリジンリクエストが許可されていない新しい CorsConfiguration インスタンスを作成します。
    関連事項:
    applyPermitDefaultValues()
  - CorsConfiguration
```
public CorsConfiguration(CorsConfiguration other)
```
    指定された CorsConfiguration からすべての値をコピーして、新しい CorsConfiguration インスタンスを構築します。
- メソッドの詳細
  - setAllowedOrigins
```
public void setAllowedOrigins(@Nullable
                              ListSE<StringSE> allowedOrigins)
```
    許可するオリジンを設定します。"https://domain1.com"。
    特別な値 "*" はすべてのドメインを許可します。
    デフォルトでは、これは設定されていません。
  - getAllowedOrigins
```
@Nullable
public ListSE<StringSE> getAllowedOrigins()
```
    許可するように構成されたオリジンを返します。許可しない場合は null を返します。
    関連事項:
    addAllowedOrigin(String), setAllowedOrigins(List)
  - addAllowedOrigin
```
public void addAllowedOrigin(StringSE origin)
```
    許可するオリジンを追加します。
  - setAllowedMethods
```
public void setAllowedMethods(@Nullable
                              ListSE<StringSE> allowedMethods)
```
    許可する HTTP メソッドを設定します。"GET"、"POST"、"PUT" など
    特別な値 "*" はすべてのメソッドを許可します。
    設定しない場合、"GET" と "HEAD" のみが許可されます。
    デフォルトでは、これは設定されていません。
    注意 : CORS チェックは、クライアントから発信されたアドレスを反映するために、存在する場合、「Forwarded」（RFC 7239）、「X-Forwarded-Host」、「X-Forwarded-Port」、および「X-Forwarded-Proto」ヘッダーの値を使用します。ForwardedHeaderFilter を使用して、抽出して使用するか、このようなヘッダーを破棄するかを中央から選択することを検討してください。このフィルターの詳細については、Spring Framework リファレンスを参照してください。
  - getAllowedMethods
```
@Nullable
public ListSE<StringSE> getAllowedMethods()
```
    許可された HTTP メソッド、または null を返します。この場合、"GET" および "HEAD" のみが許可されます。
    関連事項:
    addAllowedMethod(HttpMethod), addAllowedMethod(String), setAllowedMethods(List)
  - addAllowedMethod
```
public void addAllowedMethod(HttpMethod method)
```
    許可する HTTP メソッドを追加します。
  - addAllowedMethod
```
public void addAllowedMethod(StringSE method)
```
    許可する HTTP メソッドを追加します。
  - setAllowedHeaders
```
public void setAllowedHeaders(@Nullable
                              ListSE<StringSE> allowedHeaders)
```
    プリフライトリクエストが実際のリクエスト中に使用できるようにリストできるヘッダーのリストを設定します。
    特別な値 "*" を使用すると、実際のリクエストで任意のヘッダーを送信できます。
    ヘッダー名が Cache-Control、Content-Language、Expires、Last-Modified または Pragma のいずれかである場合、ヘッダー名をリストする必要はありません。
    デフォルトでは、これは設定されていません。
  - getAllowedHeaders
```
@Nullable
public ListSE<StringSE> getAllowedHeaders()
```
    許可された実際のリクエストヘッダーを返します。ない場合は null を返します。
    関連事項:
    addAllowedHeader(String), setAllowedHeaders(List)
  - addAllowedHeader
```
public void addAllowedHeader(StringSE allowedHeader)
```
    許可する実際のリクエストヘッダーを追加します。
  - setExposedHeaders
```
public void setExposedHeaders(@Nullable
                              ListSE<StringSE> exposedHeaders)
```
    実際のレスポンスが持つ可能性があり、公開できる単純なヘッダー（つまり、Cache-Control、Content-Language、Content-Type、Expires、Last-Modified または Pragma）以外のレスポンスヘッダーのリストを設定します。
    "*" は有効な公開ヘッダー値ではないことに注意してください。
    デフォルトでは、これは設定されていません。
  - getExposedHeaders
```
@Nullable
public ListSE<StringSE> getExposedHeaders()
```
    公開する構成済みのレスポンスヘッダーを返します。存在しない場合は null を返します。
    関連事項:
    addExposedHeader(String), setExposedHeaders(List)
  - addExposedHeader
```
public void addExposedHeader(StringSE exposedHeader)
```
    公開するレスポンスヘッダーを追加します。
    "*" は有効な公開ヘッダー値ではないことに注意してください。
  - setAllowCredentials
```
public void setAllowCredentials(@Nullable
                                BooleanSE allowCredentials)
```
    ユーザー資格情報がサポートされているかどうか。
    デフォルトでは、これは設定されていません（つまり、ユーザー資格情報はサポートされていません）。
  - getAllowCredentials
```
@Nullable
public BooleanSE getAllowCredentials()
```
    構成済みの allowCredentials フラグを返します。ない場合は null を返します。
    関連事項:
    setAllowCredentials(Boolean)
  - setMaxAge
```
public void setMaxAge(DurationSE maxAge)
```
    期間として、プリフライトリクエストからのレスポンスをクライアントがキャッシュできる期間を設定します。
    導入:
    5.2
    関連事項:
    setMaxAge(Long)
  - setMaxAge
```
public void setMaxAge(@Nullable
                      LongSE maxAge)
```
    プリフライトリクエストからのレスポンスをクライアントがキャッシュできる期間を秒単位で構成します。
    デフォルトでは、これは設定されていません。
  - getMaxAge
```
@Nullable
public LongSE getMaxAge()
```
    構成された maxAge 値を返します。ない場合は null 値を返します。
    関連事項:
    setMaxAge(Long)
  - applyPermitDefaultValues
```
public CorsConfiguration applyPermitDefaultValues()
```
    デフォルトでは、新しく作成された CorsConfiguration はクロスオリジンリクエストを許可しないため、何を許可するかを明示的に構成する必要があります。
    このメソッドを使用して、GET、HEAD、POST リクエストのすべてのクロスオリジンリクエストを許可するオープンデフォルトで開始するように初期化モデルを切り替えます。ただし、このメソッドはすでに設定されている既存の値をオーバーライドしないことに注意してください。
    まだ設定されていない場合は、次のデフォルトが適用されます。
    - すべてのオリジンを許可。
    - 「単純な」メソッド GET、HEAD および POST を許可します。
    - すべてのヘッダーを許可します。
    - 最大経過時間を 1800 秒（30 分）に設定します。
  - combine
```
@Nullable
public CorsConfiguration combine(@Nullable
                                           CorsConfiguration other)
```
    提供された CorsConfiguration の null 以外のプロパティをこれと組み合わせます。
    allowCredentials や maxAge などの単一の値を組み合わせる場合、this プロパティは、null でない other プロパティがある場合はそれによってオーバーライドされます。
    allowedOrigins、allowedMethods、allowedHeaders や exposedHeaders のようなリストの組み合わせは、追加的な方法で行われます。例： ["GET", "POST"] と ["PATCH"] を組み合わせると ["GET", "POST", "PATCH"] になりますが、["GET", "POST"] と ["*"] を組み合わせると ["*"] になることに注意してください。
    applyPermitDefaultValues() によって設定されたデフォルトの許可値は、明示的に定義された値によって上書きされることに注意してください。
    戻り値:
    結合された CorsConfiguration、または提供された構成が null の場合は this 構成
  - checkOrigin
```
@Nullable
public StringSE checkOrigin(@Nullable
                                    StringSE requestOrigin)
```
    構成された許可された発信元に対してリクエストの発信元を確認します。
    パラメーター:
    requestOrigin - チェックする原点
    戻り値:
    レスポンスに使用する起点、またはリクエストの起点が許可されていないことを意味する null
  - checkHttpMethod
```
@Nullable
public ListSE<HttpMethod> checkHttpMethod(@Nullable
                                                  HttpMethod requestMethod)
```
    HTTP リクエストメソッド（またはプリフライトリクエストの Access-Control-Request-Method ヘッダーのメソッド）を、構成された許可されたメソッドと照合します。
    パラメーター:
    requestMethod - チェックする HTTP リクエストメソッド
    戻り値:
    プリフライトリクエストのレスポンスでリストする HTTP メソッドのリスト、または指定された requestMethod が許可されていない場合は null
  - checkHeaders
```
@Nullable
public ListSE<StringSE> checkHeaders(@Nullable
                                           ListSE<StringSE> requestHeaders)
```
    提供されたリクエストヘッダー（またはプリフライトリクエストの Access-Control-Request-Headers にリストされているヘッダー）を、構成された許可されたヘッダーと照合します。
    パラメーター:
    requestHeaders - チェックするリクエストヘッダー
    戻り値:
    プリフライトリクエストのレスポンスにリストする許可されたヘッダーのリスト、または提供されたリクエストヘッダーのいずれも許可されていない場合は null

クラス CorsConfiguration

フィールドのサマリー

コンストラクターのサマリー

メソッドのサマリー

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

フィールドの詳細

ALL

コンストラクターの詳細

CorsConfiguration

CorsConfiguration

メソッドの詳細

setAllowedOrigins

getAllowedOrigins

addAllowedOrigin

setAllowedMethods

getAllowedMethods

addAllowedMethod

addAllowedMethod

setAllowedHeaders

getAllowedHeaders

addAllowedHeader

setExposedHeaders

getExposedHeaders

addExposedHeader

setAllowCredentials

getAllowCredentials

setMaxAge

setMaxAge

getMaxAge

applyPermitDefaultValues

combine

checkOrigin

checkHttpMethod

checkHeaders