public class UrlBasedCorsConfigurationSource extends ObjectSE implements CorsConfigurationSource
CorsConfiguration
を選択する CorsConfigurationSource
。 パターンマッチングは、PathMatcher
または事前に解析された PathPattern
を使用して実行できます。構文はほぼ同じですが、後者は Web での使用に合わせて調整されており、より効率的です。選択は、resolved
文字列 lookupPath または parsed
RequestPath
の存在によって決まります (PathMatcher
にフォールバックしますが、フォールバックを無効にすることもできます)。詳細については、setAllowInitLookupPath(boolean)
を参照してください。
PathPattern
, AntPathMatcher
コンストラクターと説明 |
---|
UrlBasedCorsConfigurationSource() PathPatternParser.defaultInstance を使用したデフォルトのコンストラクター。 |
UrlBasedCorsConfigurationSource(PathPatternParser parser) パターンを解析する PathPatternParser を持つコンストラクター。 |
修飾子と型 | メソッドと説明 |
---|---|
CorsConfiguration | getCorsConfiguration(HttpServletRequestEE request) 受信リクエストに基づいて CorsConfiguration を返します。 |
MapSE<StringSE, CorsConfiguration> | getCorsConfigurations() すべての構成済み CORS マッピングを返します。 |
void | registerCorsConfiguration(StringSE pattern, CorsConfiguration config) 一度に 1 つのマッピングを登録する setCorsConfigurations(Map) の変種。 |
void | setAllowInitLookupPath(boolean allowInitLookupPath) 有効にすると、 esolved 文字列 lookupPath も parsed RequestPath も存在しない場合は、configured UrlPathHelper を使用して文字列 lookupPath を解決します。 |
void | setAlwaysUseFullPath(boolean alwaysUseFullPath) 使用すべきではありません。 5.3 以降、 setUrlPathHelper(UrlPathHelper) を使用することをお勧めします。詳細については、setAllowInitLookupPath(boolean) を参照してください。 |
void | setCorsConfigurations(MapSE<StringSE, CorsConfiguration> corsConfigurations) CORS 構成マッピングを設定します。 |
void | setLookupPathAttributeName(StringSE name) 使用すべきではありません。 5.3 現在、 UrlPathHelper.PATH_ATTRIBUTE を推奨 |
void | setPathMatcher(PathMatcher pathMatcher) パターンマッチングに使用する PathMatcher を構成します。 |
void | setRemoveSemicolonContent(boolean removeSemicolonContent) 使用すべきではありません。 5.3 以降、 setUrlPathHelper(UrlPathHelper) を使用することをお勧めします。詳細については、setAllowInitLookupPath(boolean) を参照してください。 |
void | setUrlDecode(boolean urlDecode) 使用すべきではありません。 5.3 以降、 setUrlPathHelper(UrlPathHelper) を使用することをお勧めします。詳細については、setAllowInitLookupPath(boolean) を参照してください。 |
void | setUrlPathHelper(UrlPathHelper urlPathHelper) lookupPath を解決するために UrlPathHelper を設定します。 |
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSE
public UrlBasedCorsConfigurationSource()
PathPatternParser.defaultInstance
を使用したデフォルトのコンストラクター。public UrlBasedCorsConfigurationSource(PathPatternParser parser)
PathPatternParser
を持つコンストラクター。parser
- 使用するパーサー @DeprecatedSE public void setAlwaysUseFullPath(boolean alwaysUseFullPath)
setUrlPathHelper(UrlPathHelper)
を使用することをお勧めします。詳細については、setAllowInitLookupPath(boolean)
を参照してください。UrlPathHelper
上の same property
へのショートカット。@DeprecatedSE public void setUrlDecode(boolean urlDecode)
setUrlPathHelper(UrlPathHelper)
を使用することをお勧めします。詳細については、setAllowInitLookupPath(boolean)
を参照してください。UrlPathHelper
上の same property
へのショートカット。@DeprecatedSE public void setRemoveSemicolonContent(boolean removeSemicolonContent)
setUrlPathHelper(UrlPathHelper)
を使用することをお勧めします。詳細については、setAllowInitLookupPath(boolean)
を参照してください。UrlPathHelper
上の same property
へのショートカット。public void setUrlPathHelper(UrlPathHelper urlPathHelper)
UrlPathHelper
を設定して lookupPath を解決します。lookupPath が事前に解決されることが予想される場合、または解析された PathPatterns
が代わりに使用される場合は、これは必要ありません。詳細については、setAllowInitLookupPath(boolean)
を参照してください。 デフォルトでは、これは UrlPathHelper.defaultInstance
です。
public void setAllowInitLookupPath(boolean allowInitLookupPath)
esolved
文字列 lookupPath も parsed
RequestPath
も存在しない場合は、configured
UrlPathHelper
を使用して文字列 lookupPath を解決します。これにより、PathMatcher
または解析された PathPattern
を使用した URL パターンマッチングの使用が決定されます。Spring MVC では、解決された文字列 lookupPath または解析された RequestPath
のいずれかが、DispatcherServlet
処理内で常に使用可能です。ただし、CorsFilter
などのサーブレット Filter
では、そうならない場合もあります。
デフォルトでは、これは true
に設定されており、この場合、遅延 lookupPath 初期化が許可されます。アプリケーションが解析済みの PathPatterns
を使用している場合は、これを false
に設定し、この場合、ServletRequestPathFilter
を介して RequestPath
を事前に解析できます。
allowInitLookupPath
- 遅延初期化を無効にし、まだ解決されていない場合は失敗するかどうか @DeprecatedSE public void setLookupPathAttributeName(StringSE name)
UrlPathHelper.PATH_ATTRIBUTE
に切り替え。UrlPathHelper.getLookupPathForRequest(HttpServletRequest)
を介して抽出された lookupPath を保持する属性の名前を設定します。 デフォルトでは、これは UrlPathHelper.PATH_ATTRIBUTE
です。
name
- チェックするリクエスト属性 public void setPathMatcher(PathMatcher pathMatcher)
PathMatcher
を構成します。 これは、カスタマイズされた AntPathMatcher
またはカスタム PathMatcher が必要な場合にのみ使用する必要がある高度なプロパティです。
デフォルトでは、これは AntPathMatcher
です。
注意 : PathMatcher
を設定すると、parsed
RequestPath
が使用可能な場合でも、文字列パターンマッチングの使用が強制されます。
public void setCorsConfigurations(@Nullable MapSE<StringSE,CorsConfiguration> corsConfigurations)
パターン構文については、AntPathMatcher
と PathPattern
、および使用できるクラスレベルの Javadoc を参照してください。一般に、構文は PathPattern
とほぼ同じであり、Web での使用に合わせて調整されています。
corsConfigurations
- 使用するマッピング PathPattern
, AntPathMatcher
public void registerCorsConfiguration(StringSE pattern, CorsConfiguration config)
setCorsConfigurations(Map)
の変種。pattern
- マッピングパターン config
- パターンに使用する CORS 構成 PathPattern
, AntPathMatcher
public MapSE<StringSE,CorsConfiguration> getCorsConfigurations()
@Nullable public CorsConfiguration getCorsConfiguration(HttpServletRequestEE request)
CorsConfigurationSource
CorsConfiguration
を返します。CorsConfigurationSource
の getCorsConfiguration
CorsConfiguration
、または存在しない場合は null