public interface UriBuilder 事実上 UriComponentsBuilder の一般化ですが、UriComponents ではなく URISE に直接拡張するショートカットがあり、エンコードの設定、ベース URI などの一般的な関心事を実装の関心事として残しています。
通常、一度構成され、多くの URL を作成するために使用される主要コンポーネントとして機能する UriBuilderFactory を介して取得されます。
UriBuilderFactory, UriComponentsBuilder| 修飾子と型 | メソッドと説明 |
|---|---|
URISE | build(MapSE<StringSE,?> uriVariables)URISE インスタンスを構築し、URI テンプレート変数をマップの値で置き換えます。 |
URISE | build(ObjectSE... uriVariables)URISE インスタンスを構築し、URI テンプレート変数を配列の値で置き換えます。 |
UriBuilder | fragment(StringSE fragment)URI フラグメントを設定します。 |
UriBuilder | host(StringSE host)URI テンプレート変数を含む URI ホストを設定します。このビルダーのホストをクリアするには、 null にすることもできます。 |
UriBuilder | path(StringSE path) 指定したパスをこのビルダーの既存のパスに追加します。 |
UriBuilder | pathSegment(StringSE... pathSegments) 既存のパスにパスセグメントを追加します。 |
UriBuilder | port(int port)URI ポートを設定します。 |
UriBuilder | port(StringSE port)URI ポートを設定します。 |
UriBuilder | query(StringSE query) 指定されたクエリをこのビルダーの既存のクエリに追加します。 |
UriBuilder | queryParam(StringSE name, ObjectSE... values) 指定されたクエリパラメーターを既存のクエリパラメーターに追加します。 |
UriBuilder | queryParams(MultiValueMap<StringSE, StringSE> params) 指定されたクエリパラメーターを追加します。 |
UriBuilder | replacePath(StringSE path) 既存のパス値をオーバーライドして、このビルダーのパスを設定します。 |
UriBuilder | replaceQuery(StringSE query) このビルダーのクエリを設定して、既存のすべてのクエリパラメーターをオーバーライドします。 |
UriBuilder | replaceQueryParam(StringSE name, ObjectSE... values) 同じパラメーターの既存のすべてのクエリ値をオーバーライドして、クエリパラメーター値を設定します。 |
UriBuilder | replaceQueryParams(MultiValueMap<StringSE, StringSE> params) 既存のすべてのクエリ値をオーバーライドして、クエリパラメーター値を設定します。 |
UriBuilder | scheme(StringSE scheme)URI テンプレート変数を含む URI スキームを設定します。このビルダーのスキームをクリアするには、 null にすることもできます。 |
UriBuilder | userInfo(StringSE userInfo)URI テンプレート変数を含む URI ユーザー情報を設定します。このビルダーのユーザー情報をクリアするには、 null にすることもできます。 |
UriBuilder scheme(@Nullable StringSE scheme)
null にすることもできます。scheme - URI スキーム UriBuilder userInfo(@Nullable StringSE userInfo)
null にすることもできます。userInfo - URI ユーザー情報 UriBuilder host(@Nullable StringSE host)
null にすることもできます。host - URI ホスト UriBuilder port(int port)
-1 を渡すと、このビルダーのポートがクリアされます。port - URI ポート UriBuilder port(@Nullable StringSE port)
port(int) を使用します。null を渡すと、このビルダーのポートがクリアされます。port - URI ポート UriBuilder path(StringSE path)
path - URI パス UriBuilder replacePath(@Nullable StringSE path)
path - URI パス、または空のパスの場合は null UriBuilder pathSegment(StringSE... pathSegments) throws IllegalArgumentExceptionSE
path("/") を使用して、末尾のスラッシュを確認します。pathSegments - URI パスセグメント IllegalArgumentExceptionSEUriBuilder query(StringSE query)
注意 : 予約文字の存在は、URI 文字列の正しい解析を妨げる可能性があります。たとえば、クエリパラメーターに '=' または '&' 文字が含まれている場合、クエリ文字列を明確に解析することはできません。正しい解析を可能にするために、そのような値を URI 変数に置き換える必要があります。
builder.query("filter={value}").uriString("hot&cold");
query - クエリ文字列 UriBuilder replaceQuery(@Nullable StringSE query)
query - クエリ文字列、またはすべてのクエリパラメーターを削除する null UriBuilder queryParam(StringSE name, ObjectSE... values)
?foo=bar ではなく ?foo になります)。name - クエリパラメーター名 values - クエリパラメーター値 UriBuilder queryParams(MultiValueMap<StringSE,StringSE> params)
params - パラメーター UriBuilder replaceQueryParam(StringSE name, ObjectSE... values)
name - クエリパラメーター名 values - クエリパラメーター値 UriBuilder replaceQueryParams(MultiValueMap<StringSE,StringSE> params)
params - クエリパラメーター名 UriBuilder fragment(@Nullable StringSE fragment)
null になる場合もあります。fragment - URI フラグメント URISE build(ObjectSE... uriVariables)
URISE インスタンスを構築し、URI テンプレート変数を配列の値で置き換えます。uriVariables - URI 変数のマップ