クラス UrlBasedCorsConfigurationSource

java.lang.ObjectSE
org.springframework.web.cors.UrlBasedCorsConfigurationSource
実装されたすべてのインターフェース:
CorsConfigurationSource

public class UrlBasedCorsConfigurationSource extends ObjectSE implements CorsConfigurationSource
URL パスパターンを使用してリクエストの CorsConfiguration を選択する CorsConfigurationSource

パターンマッチングは、PathMatcher または事前に解析された PathPattern を使用して実行できます。構文はほとんど同じですが、後者は Web の使用に合わせて調整され、より効率的です。選択は、resolved 文字列 lookupPath または parsed RequestPath (PathMatcher にフォールバックあり)の存在に依存しますが、フォールバックを無効にすることができます。詳細については、setAllowInitLookupPath(boolean) を参照してください。

導入:
4.2
作成者:
Sebastien Deleuze, Rossen Stoyanchev
関連事項:
  • コンストラクターの詳細

    • UrlBasedCorsConfigurationSource

      public UrlBasedCorsConfigurationSource()
      PathPatternParser.defaultInstance を使用したデフォルトのコンストラクター。
    • UrlBasedCorsConfigurationSource

      public UrlBasedCorsConfigurationSource(PathPatternParser parser)
      パターンを解析する PathPatternParser を持つコンストラクター。
      パラメーター:
      parser - 使用するパーサー
      導入:
      5.3
  • メソッドの詳細

    • setAlwaysUseFullPath

      @DeprecatedSE public void setAlwaysUseFullPath(boolean alwaysUseFullPath)
      使用すべきではありません。
      5.3 以降、setUrlPathHelper(UrlPathHelper) を使用することをお勧めします。詳細については、setAllowInitLookupPath(boolean) を参照してください。
      構成された UrlPathHelper 上の same property へのショートカット。
    • setUrlDecode

      @DeprecatedSE public void setUrlDecode(boolean urlDecode)
      使用すべきではありません。
      5.3 以降、setUrlPathHelper(UrlPathHelper) を使用することをお勧めします。詳細については、setAllowInitLookupPath(boolean) を参照してください。
      構成された UrlPathHelper 上の same property へのショートカット。
    • setRemoveSemicolonContent

      @DeprecatedSE public void setRemoveSemicolonContent(boolean removeSemicolonContent)
      使用すべきではありません。
      5.3 以降、setUrlPathHelper(UrlPathHelper) を使用することをお勧めします。詳細については、setAllowInitLookupPath(boolean) を参照してください。
      構成された UrlPathHelper 上の same property へのショートカット。
    • setUrlPathHelper

      public void setUrlPathHelper(UrlPathHelper urlPathHelper)
      lookupPath を解決するように UrlPathHelper を構成します。これは、lookupPath が事前に解決されることが予想される場合、または解析済みの PathPatterns が代わりに使用される場合は必要ない場合があります。その詳細については、setAllowInitLookupPath(boolean) を参照してください。

      デフォルトでは、これは UrlPathHelper.defaultInstance です。

    • setAllowInitLookupPath

      public void setAllowInitLookupPath(boolean allowInitLookupPath)
      有効にすると、esolved 文字列 lookupPath も parsed RequestPath もない場合、configured UrlPathHelper を使用して文字列 lookupPath を解決します。これにより、PathMatcher または解析済みの PathPattern との URL パターンマッチングの使用が決定されます。

      Spring MVC では、解決された String lookupPath または解析された RequestPath のいずれかが、DispatcherServlet 処理内で常に使用可能です。ただし、CorsFilter などのサーブレット Filter では、そうである場合とそうでない場合があります。

      デフォルトでは、これは true に設定されています。この場合、遅延 lookupPath 初期化が許可されます。アプリケーションが解析済みの PathPatterns を使用している場合は、これを false に設定します。この場合、RequestPath は ServletRequestPathFilter を介して以前に解析できます。

      パラメーター:
      allowInitLookupPath - 遅延初期化を無効にし、まだ解決されていない場合は失敗するかどうか
      導入:
      5.3
    • setLookupPathAttributeName

      @DeprecatedSE public void setLookupPathAttributeName(StringSE name)
      使用すべきではありません。
      5.3 現在、UrlPathHelper.PATH_ATTRIBUTE を推奨
      UrlPathHelper.getLookupPathForRequest(HttpServletRequest) によって抽出された lookupPath を保持する属性の名前を構成します。

      デフォルトでは、これは UrlPathHelper.PATH_ATTRIBUTE です。

      パラメーター:
      name - チェックするリクエスト属性
      導入:
      5.2
    • setPathMatcher

      public void setPathMatcher(PathMatcher pathMatcher)
      パターンマッチングに使用する PathMatcher を構成します。

      これは、カスタマイズされた AntPathMatcher またはカスタム PathMatcher が必要な場合にのみ使用する必要がある高度なプロパティです。

      デフォルトでは、これは AntPathMatcher です。

      注意 PathMatcher を設定すると、parsed RequestPath が使用可能な場合でも、文字列パターンマッチングの使用が強制されます。

    • setCorsConfigurations

      public void setCorsConfigurations(@Nullable MapSE<StringSE,CorsConfiguration> corsConfigurations)
      CORS 構成マッピングを設定します。

      パターン構文については、AntPathMatcherPathPattern、および使用できるクラスレベルの Javadoc を参照してください。一般に、構文は PathPattern とほぼ同じであり、Web での使用に合わせて調整されています。

      パラメーター:
      corsConfigurations - 使用するマッピング
      関連事項:
    • registerCorsConfiguration

      public void registerCorsConfiguration(StringSE pattern, CorsConfiguration config)
      一度に 1 つのマッピングを登録する setCorsConfigurations(Map) の変種。
      パラメーター:
      pattern - マッピングパターン
      config - パターンに使用する CORS 構成
      関連事項:
    • getCorsConfigurations

      public MapSE<StringSE,CorsConfiguration> getCorsConfigurations()
      すべての構成済み CORS マッピングを返します。
    • getCorsConfiguration

      @Nullable public CorsConfiguration getCorsConfiguration(HttpServletRequestEE request)
      インターフェースからコピーされた説明: CorsConfigurationSource
      受信リクエストに基づいて CorsConfiguration を返します。
      次で指定:
      インターフェース CorsConfigurationSourcegetCorsConfiguration 
      戻り値:
      関連する CorsConfiguration、または存在しない場合は null