CrossOrigin (Spring Framework API)

```
@TargetSE(valueSE={TYPESE,METHODSE})
 @RetentionSE(valueSE=RUNTIMESE)
 @DocumentedSE
public @interface CrossOrigin
```
特定のハンドラークラスまたはハンドラーメソッド、あるいはその両方でクロスオリジンリクエストを許可するためのアノテーション。適切な HandlerMapping が構成されている場合に処理されます。
Spring Web MVC と Spring WebFlux はどちらも、それぞれのモジュールの RequestMappingHandlerMapping を通じてこのアノテーションをサポートしています。アノテーションの各型とメソッドレベルのペアからの値が CorsConfiguration に追加され、次に CorsConfiguration.applyPermitDefaultValues() を介してデフォルト値が適用されます。
グローバル構成とローカル構成を組み合わせるためのルールは、一般的に追加的です。すべてのグローバルおよびすべてのローカルの起源。allowCredentials や maxAge など、単一の値しか受け入れられない属性の場合、ローカルはグローバル値をオーバーライドします。詳細については、CorsConfiguration.combine(CorsConfiguration) を参照してください。
導入:
4.2
作成者:
Russell Allen, Sebastien Deleuze, Sam Brannen, Ruslan Akhundov

フィールドのサマリー

フィールド
修飾子と型	フィールドと説明
`static boolean`	`DEFAULT_ALLOW_CREDENTIALS` 使用すべきではありません。 Spring 5.0 現在、`CorsConfiguration.applyPermitDefaultValues()` を推奨
`static StringSE[]`	`DEFAULT_ALLOWED_HEADERS` 使用すべきではありません。 Spring 5.0 現在、`CorsConfiguration.applyPermitDefaultValues()` を推奨
`static long`	`DEFAULT_MAX_AGE` 使用すべきではありません。 Spring 5.0 現在、`CorsConfiguration.applyPermitDefaultValues()` を推奨
`static StringSE[]`	`DEFAULT_ORIGINS` 使用すべきではありません。 Spring 5.0 現在、`CorsConfiguration.applyPermitDefaultValues()` を推奨

オプション要素の概要

オプション要素
修飾子と型	オプションの要素と説明
`StringSE`	`allowCredentials` ブラウザーが、ドメイン間リクエストとともに Cookie などの資格情報をアノテーション付きエンドポイントに送信するかどうか。
`StringSE[]`	`allowedHeaders` 実際のリクエストで許可されるリクエストヘッダーのリスト。`"*"` を使用すると、すべてのヘッダーを許可できます。
`StringSE`	`allowPrivateNetwork` プライベートネットワークアクセスがサポートされているかどうか。
`StringSE[]`	`exposedHeaders` ユーザーエージェントが実際のレスポンスでクライアントにアクセスを許可するレスポンスヘッダーのリスト。おそらく `"*"` がすべてのヘッダーを公開します。
`long`	`maxAge` プリフライトレスポンスのキャッシュ期間の最大経過時間（秒単位）。
`RequestMethod[]`	`methods` サポートされる HTTP リクエストメソッドのリスト。
`StringSE[]`	`originPatterns` より柔軟な原点パターンをサポートする `origins()` の代替。
`StringSE[]`	`origins` クロスオリジンリクエストが許可されているオリジンのリスト。
`StringSE[]`	`value` `origins()` のエイリアス。

- フィールドの詳細
  - DEFAULT_ORIGINS
```
@DeprecatedSE
public static final StringSE[] DEFAULT_ORIGINS
```
    Spring 5.0 以降は非推奨。CorsConfiguration.applyPermitDefaultValues() に置き換えられました。
- - DEFAULT_ALLOWED_HEADERS
```
@DeprecatedSE
public static final StringSE[] DEFAULT_ALLOWED_HEADERS
```
    Spring 5.0 以降は非推奨。CorsConfiguration.applyPermitDefaultValues() に置き換えられました。
- - DEFAULT_ALLOW_CREDENTIALS
```
@DeprecatedSE
public static final boolean DEFAULT_ALLOW_CREDENTIALS
```
    Spring 5.0 以降は非推奨。CorsConfiguration.applyPermitDefaultValues() に置き換えられました。
- - DEFAULT_MAX_AGE
```
@DeprecatedSE
public static final long DEFAULT_MAX_AGE
```
    Spring 5.0 以降は非推奨。CorsConfiguration.applyPermitDefaultValues() に置き換えられました。
- 要素の詳細
  - value
```
@AliasFor(value="origins")
public abstract StringSE[] value
```
    origins() のエイリアス。
    デフォルト:
    {}
- - origins
```
@AliasFor(value="value")
public abstract StringSE[] origins
```
    クロスオリジンリクエストが許可されているオリジンのリスト。詳しくは CorsConfiguration.setAllowedOrigins(List) を参照してください。
    デフォルトでは、originPatterns() も設定されていない限り、すべてのオリジンが許可されます。設定されている場合は、代わりに originPatterns が使用されます。
    デフォルト:
    {}
- - originPatterns
```
public abstract StringSE[] originPatterns
```
    より柔軟な原点パターンをサポートする origins() の代替。詳しくは CorsConfiguration.setAllowedOriginPatterns(List) を参照してください。
    デフォルトでは、これは設定されていません。
    導入:
    5.3
    デフォルト:
    {}
- - allowedHeaders
```
public abstract StringSE[] allowedHeaders
```
    実際のリクエストで許可されるリクエストヘッダーのリスト。おそらく "*" ですべてのヘッダーが許可されます。詳細は CorsConfiguration.setAllowedHeaders(List) を参照してください。
    デフォルトでは、リクエストされたすべてのヘッダーが許可されます。
    デフォルト:
    {}
- - exposedHeaders
```
public abstract StringSE[] exposedHeaders
```
    ユーザーエージェントが実際のレスポンスでクライアントにアクセスを許可するレスポンスヘッダーのリスト。おそらく "*" がすべてのヘッダーを公開します。詳細は CorsConfiguration.setExposedHeaders(List) を参照してください。
    デフォルトでは、公開されているヘッダーは表示されません。
    デフォルト:
    {}
- - methods
```
public abstract RequestMethod[] methods
```
    サポートされている HTTP リクエストメソッドのリスト。詳細は CorsConfiguration.setAllowedMethods(List) を参照してください。
    デフォルトでは、サポートされているメソッドは、コントローラーメソッドがマップされているメソッドと同じです。
    デフォルト:
    {}
- - allowCredentials
```
public abstract StringSE allowCredentials
```
    ブラウザーが、クロスドメインリクエストとともに Cookie などの認証情報をアノテーション付きエンドポイントに送信する必要があるかどうか。詳細は CorsConfiguration.setAllowCredentials(Boolean) を参照してください。
    注意 : このオプションは、構成されたドメインとの高レベルの信頼を確立し、Cookie や CSRF トークンなどのユーザー固有の機密情報を公開することにより、Web アプリケーションの表面攻撃を増やすことに注意してください。
    デフォルトでは、これは設定されていません。その場合、Access-Control-Allow-Credentials ヘッダーも設定されないため、資格情報は許可されません。
    デフォルト:
    ""
- - allowPrivateNetwork
```
public abstract StringSE allowPrivateNetwork
```
    プライベートネットワークアクセスがサポートされているかどうか。詳細は CorsConfiguration.setAllowPrivateNetwork(Boolean) を参照してください。
    デフォルトでは、これは設定されていません (つまり、プライベートネットワークアクセスはサポートされていません)。
    導入:
    5.3.32
    デフォルト:
    ""
- - maxAge
```
public abstract long maxAge
```
    プリフライトレスポンスのキャッシュ期間の最大経過時間（秒単位）。
    このプロパティは、プリフライトリクエストの Access-Control-Max-Age レスポンスヘッダーの値を制御します。
    これを適切な値に設定すると、ブラウザーが必要とするプリフライトリクエスト / レスポンス対話の数を減らすことができます。負の値は未定義を意味します。
    デフォルトでは、1800 秒（30 分）に設定されています。
    デフォルト:
    -1L

アノテーション型 CrossOrigin

フィールドのサマリー

オプション要素の概要

フィールドの詳細

DEFAULT_ORIGINS

DEFAULT_ALLOWED_HEADERS

DEFAULT_ALLOW_CREDENTIALS

DEFAULT_MAX_AGE

要素の詳細

value

origins

originPatterns

allowedHeaders

exposedHeaders

methods

allowCredentials

allowPrivateNetwork

maxAge