含まれているインタフェース:: WebSocket

public static interface WebSocket.Builder

ビルダーは、HttpClient.newWebSocketBuilderを呼び出すことによって作成されます。中間の(setter-like)メソッドは、ビルダーの状態を変更し、起動されたのと同じビルダーを返します。中間メソッドが起動されない場合、適切なデフォルト値(または行動)が使用されます。 Builderは、外部同期化のない複数のスレッドでは安全ではありません。

導入されたバージョン:: 11

メソッドのサマリー

修飾子と型

メソッド

説明

CompletableFuture<WebSocket>

buildAsync(URI uri, WebSocket.Listener listener)

指定されたURIに接続され、指定されたListenerに関連付けられたWebSocketを構築します。

WebSocket.Builder

connectTimeout(Duration timeout)

WebSocket接続を確立するためのタイムアウトを設定します。

WebSocket.Builder

header(String name, String value)

指定された名前と値のペアを、オープニング・ハンドシェイク中に送信された追加のHTTPヘッダーのリストに追加します。

WebSocket.Builder

subprotocols(String mostPreferred, String... lesserPreferred)

指定されたサブプロトコルのリクエストを設定します。

メソッドの詳細
- header
  
  WebSocket.Builder header(String name, String value)
  
  指定された名前と値のペアを、オープニング・ハンドシェイク中に送信された追加のHTTPヘッダーのリストに追加します。
  「WebSocketプロトコル」に定義されているヘッダーが不正です。このメソッドが呼び出されない場合、追加のHTTPヘッダーは送信されません。
  
  パラメータ:
  
  name - ヘッダー名
  
  value - ヘッダー値
  
  戻り値:
  
  このビルダー
- connectTimeout
  
  WebSocket.Builder connectTimeout(Duration timeout)
  
  WebSocket接続を確立するためのタイムアウトを設定します。
  指定された期間内に接続が確立されない場合、WebSocketの構築はHttpTimeoutExceptionで失敗します。このメソッドが呼び出されない場合、無限のタイムアウトが仮定されます。
  
  パラメータ:
  
  timeout - タイムアウト、negative以外、ZERO以外
  
  戻り値:
  
  このビルダー
- subprotocols
  
  WebSocket.Builder subprotocols(String mostPreferred, String... lesserPreferred)
  
  指定されたサブプロトコルのリクエストを設定します。
  WebSocketが構築されると、WebSocket.getSubprotocol()を介して実際のサブ・ロールを問い合せることができます。
  サブプロトコルは、プリファレンスの順序で指定されます。最も好ましいサブプロトコルが最初に指定されます。追加のサブプロトコルがある場合、それらは最も好ましいものから最も好ましいものに列挙されます。
  サブプロトコル識別子の構文に準拠していないサブプロトコルは不正です。このメソッドが呼び出されない場合、サブプロトコルはリクエストされません。
  
  パラメータ:
  
  mostPreferred - 最も優先されるサブプロトコル
  
  lesserPreferred - あまり好ましくないサブプロトコル
  
  戻り値:
  
  このビルダー
- buildAsync
  CompletableFuture<WebSocket> buildAsync(URI uri, WebSocket.Listener listener)
  
  指定されたURIに接続され、指定されたListenerに関連付けられたWebSocketを構築します。
  CompletableFutureを返します。CompletableFutureは、結果として得られるWebSocketで正常に完了するか、例外的に次のエラーのいずれかで完了します:
  
  IOException - I/Oエラーが発生した場合
  WebSocketHandshakeException - オープニング・ハンドシェイクが失敗した場合
  HttpTimeoutException - オープン・ハンドシェークがタイムアウト内に完了しない場合
  InterruptedException - 操作が中断された場合
  SecurityException - セキュリティ・マネージャがインストールされていて、accessからuriを拒否した場合。「セキュリティ・チェック」には、リスナーが起動されるセキュリティ・コンテキストに関連する詳細情報が含まれます。
  IllegalArgumentException - このビルダーのメソッドの引数のいずれかが不正である場合
  
  パラメータ:
  
  uri - the WebSocket URI
  
  listener - リスナー
  
  戻り値:
  
  WebSocketを含むCompletableFuture

インタフェースWebSocket.Builder

メソッドのサマリー

メソッドの詳細

header

connectTimeout

subprotocols

buildAsync