インターフェース PushBuilder

メソッドの詳細

• method

  PushBuilder method(StringSE method)

  使用すべきではありません。

  プッシュに使用するメソッドを設定します。

  パラメーター:

  method - プッシュに使用されるメソッド。

  戻り値:

  このビルダー。

  例外:

  NullPointerExceptionSE - 引数が null の場合

  IllegalArgumentExceptionSE - 引数が空の文字列、または RFC 7231 で定義されているキャッシュ不可または安全でないメソッド（POST、PUT、DELETE、CONNECT、OPTIONS、TRACE）の場合。

• queryString

  PushBuilder queryString(StringSE queryString)

  使用すべきではありません。

  プッシュに使用するクエリ文字列を設定します。クエリ文字列は、path(String) の呼び出しに含まれるクエリ文字列に追加されます。重複するパラメーターは保持する必要があります。同じクエリ文字列を使用して複数の push() 呼び出しを行う場合、path(String) でクエリの代わりにこのメソッドを使用する必要があります。

  パラメーター:

  queryString - プッシュに使用されるクエリ文字列。

  戻り値:

  このビルダー。

• sessionId

  PushBuilder sessionId(StringSE sessionId)

  使用すべきではありません。

  プッシュに使用する SessionID を設定します。セッション ID は、関連付けられたリクエストと同じ方法で設定されます（つまり、関連付けられたリクエストが cookie を使用した場合は cookie として、または関連付けられたリクエストが url パラメーターを使用した場合は url パラメーターとして）。デフォルトは、リクエストされたセッション ID、または新しく作成されたセッションから新しく割り当てられたセッション ID です。

  パラメーター:

  sessionId - プッシュに使用される SessionID。

  戻り値:

  このビルダー。

• setHeader

  PushBuilder setHeader(StringSE name, StringSE value)

  使用すべきではありません。

  プッシュに使用するリクエストヘッダーを設定します。ビルダーに同じ名前の既存のヘッダーがある場合、その値は上書きされます。

  パラメーター:

  name - 設定するヘッダー名

  value - 設定するヘッダー値

  戻り値:

  このビルダー。

• addHeader

  PushBuilder addHeader(StringSE name, StringSE value)

  使用すべきではありません。

  プッシュに使用するリクエストヘッダーを追加します。

  パラメーター:

  name - 追加するヘッダー名

  value - 追加するヘッダー値

  戻り値:

  このビルダー。

• removeHeader

  PushBuilder removeHeader(StringSE name)

  使用すべきではありません。

  名前付きリクエストヘッダーを削除します。ヘッダーが存在しない場合は、何もしないでください。

  パラメーター:

  name - 削除するヘッダーの名前

  戻り値:

  このビルダー。

• path

  PushBuilder path(StringSE path)

  使用すべきではありません。

  プッシュに使用する URI パスを設定します。パスは "/" で始まる場合があり、その場合は絶対パスとして扱われます。それ以外の場合は、関連するリクエストのコンテキストパスからの相対パスです。デフォルトのパスはなく、push() を呼び出す前に path(String) を呼び出す必要があります。引数 path にクエリ文字列が存在する場合、その内容は、以前に queryString(java.lang.String) に渡された内容とマージして、重複を保持する必要があります。

  パラメーター:

  path - プッシュに使用する URI パス。クエリ文字列を含めることができます。

  戻り値:

  このビルダー。

• push

  void push()

  使用すべきではありません。

  ビルダーの現在の状態を指定してリソースをプッシュします。メソッドはノンブロッキングでなければなりません。

  PushBuilder の現在の状態に基づいてリソースをプッシュします。クライアントが基になる HTTP/2 プロトコルを使用して、プッシュされたリソースの受け入れを拒否する可能性があるため、このメソッドを呼び出しても、リソースが実際にプッシュされることは保証されません。

  ビルダーにセッション ID がある場合、プッシュされたリクエストには、必要に応じて Cookie または URI パラメーターとしてセッション ID が含まれます。Builder のクエリ文字列は、渡されたクエリ文字列とマージされます。

  このメソッドから戻る前に、ビルダーのパス、条件付きヘッダー（RFC 7232 で定義）は null になっています。他のすべてのフィールドは、別のプッシュで再利用できるようにそのまま残されます。

  例外:

  IllegalStateExceptionSE - このインスタンスで、インスタンス化から、IllegalStateException をスローしなかった push() への最後の呼び出しの間に、path(java.lang.String) への呼び出しがなかった場合。

• getMethod

  StringSE getMethod()

  使用すべきではありません。

  プッシュに使用するメソッドを返します。

  戻り値:

  プッシュに使用されるメソッド。

• getQueryString

  StringSE getQueryString()

  使用すべきではありません。

  プッシュに使用するクエリ文字列を返します。

  戻り値:

  プッシュに使用されるクエリ文字列。

• getSessionId

  StringSE getSessionId()

  使用すべきではありません。

  プッシュに使用する SessionID を返します。

  戻り値:

  プッシュに使用される SessionID。

• getHeaderNames

  SetSE<StringSE> getHeaderNames()

  使用すべきではありません。

  プッシュに使用されるヘッダーのセットを返します。

  返されたセットは PushBuilder オブジェクトによって支援されないため、返されたセットの変更は PushBuilder オブジェクトに反映されず、その逆も同様です。

  戻り値:

  プッシュに使用されるヘッダーのセット。

• getHeader

  StringSE getHeader(StringSE name)

  使用すべきではありません。

  プッシュに使用される指定された名前のヘッダーを返します。

  パラメーター:

  name - ヘッダーの名前

  戻り値:

  プッシュに使用される特定の名前のヘッダー。

• getPath

  StringSE getPath()

  使用すべきではありません。

  プッシュに使用する URI パスを返します。

  戻り値:

  プッシュに使用される URI パス。