メソッドの詳細

• getMethod

  StringSE getMethod()

  リクエストメソッドを取得します。GET、POST など

  戻り値:

  リクエストメソッド。

  関連事項:

  HttpMethod

• selectVariant

  Variant selectVariant(ListSE<Variant> variants)

  リクエストに最も一致する表現バリアントを選択します。リストに一致するバリアントがない場合、null を返します。

  より明示的なバリアントは、それほど明示的でないバリアントより先に選択されます。可変ヘッダーは、提供されたリストから計算され、自動的にレスポンスに追加されます。

  パラメーター:

  variants - 利用可能なすべての表現バリアントを説明するバリアントのリスト。

  戻り値:

  リクエストに最も一致するバリアント、または一致しない場合は null。

  例外:

  IllegalArgumentExceptionSE - バリアントが空または null の場合。

  IllegalStateExceptionSE - リクエストの範囲外で呼び出された場合。

  関連事項:

  Variant.VariantListBuilder

• evaluatePreconditions

  Response.ResponseBuilder evaluatePreconditions(EntityTag eTag)

  渡された値に基づいてリクエストの前提条件を評価します。

  パラメーター:

  eTag - リソースの現在の状態の ETag

  戻り値:

  前提条件が満たされている場合は null、前提条件が満たされていない場合は適切なステータスが設定された ResponseBuilder。返される ResponseBuilder には、前提条件の評価がどれも失敗していない限り、eTag の値が設定された ETag ヘッダーが含まれます。その場合、ETag ヘッダーは含まれず、返される ResponseBuilder のステータスコードは Response.Status.PRECONDITION_FAILED に設定されます。

  例外:

  IllegalArgumentExceptionSE - eTag が null の場合。

  IllegalStateExceptionSE - リクエストの範囲外で呼び出された場合。

• evaluatePreconditions

  Response.ResponseBuilder evaluatePreconditions(DateSE lastModified)

  渡された値に基づいてリクエストの前提条件を評価します。

  パラメーター:

  lastModified - リソースの変更日を指定する日付

  戻り値:

  前提条件が満たされている場合は null、前提条件が満たされていない場合は適切なステータスが設定された ResponseBuilder。

  例外:

  IllegalArgumentExceptionSE - lastModified が null の場合。

  IllegalStateExceptionSE - リクエストの範囲外で呼び出された場合。

• evaluatePreconditions

  Response.ResponseBuilder evaluatePreconditions(DateSE lastModified,
                                                 EntityTag eTag)

  渡された値に基づいてリクエストの前提条件を評価します。

  パラメーター:

  lastModified - リソースの変更日を指定する日付

  eTag - リソースの現在の状態の ETag

  戻り値:

  前提条件が満たされている場合は null、前提条件が満たされていない場合は適切なステータスが設定された ResponseBuilder。返される ResponseBuilder には、前提条件の評価がどれも失敗していない限り、eTag の値が設定された ETag ヘッダーが含まれます。その場合、ETag ヘッダーは含まれず、返される ResponseBuilder のステータスコードは Response.Status.PRECONDITION_FAILED に設定されます。

  例外:

  IllegalArgumentExceptionSE - lastModified または eTag が null の場合。

  IllegalStateExceptionSE - リクエストの範囲外で呼び出された場合。

• evaluatePreconditions

  Response.ResponseBuilder evaluatePreconditions()

  現在存在しないリソースのリクエスト前提条件を評価します。このメソッドの主な用途は、If-Match: * および If-None-Match: * 前提条件をサポートすることです。

  前提条件 If-None-Match: * と If-None-Match: something の両方が常に満たされていると見なされ、メソッド固有の追加のセマンティクスを適用するのはアプリケーションの責任であることに注意してください。例: 存在しないリソース上の PUT は成功する可能性がありますが、存在しないリソース上の GET は 404 レスポンスになる可能性があります。404 レスポンスを生成するのはアプリケーションの責任です。

  戻り値:

  前提条件が満たされている場合は null、前提条件が満たされていない場合は適切なステータスが設定された ResponseBuilder。

  例外:

  IllegalStateExceptionSE - リクエストの範囲外で呼び出された場合。

  導入:

  1.1