1. WebConnectionインターフェースとは

javax.servlet.http.WebConnectionは、Java Servlet APIの中で比較的特殊な位置づけにあるインターフェースです。ServletコンテナとHTTPクライアントとの間の接続を、より直接的に操作できる低レベルなインターフェースで、Servlet 3.1以降で利用可能です。

通常のServlet開発ではあまり直接触れる機会がありませんが、非同期処理やカスタムプロトコルの処理など、パフォーマンス重視の高度な実装を行う場合には活用されます。

このインターフェースは、特にHttpUpgradeHandlerと連携して使われることが多く、HTTPのアップグレード処理（WebSocketなど）を制御する際に重要です。

2. WebConnectionが使われる主な場面

WebConnectionインターフェースは、以下のような場面で使用されます。

HTTP接続のアップグレード処理（例：WebSocket）
Servletとクライアント間でのストリーム制御
非同期通信の実装時にIOストリームを取得

たとえば、WebSocketのようにHTTP通信を別のプロトコルへアップグレードする処理では、HTTPヘッダーの制御や、バイナリデータの送受信が必要になります。このときWebConnectionを使って、入出力ストリームを直接操作することができます。

3. WebConnectionインターフェースの基本メソッド

WebConnectionには、主に以下の2つのメソッドがあります。

ServletInputStream getInputStream()：クライアントから送られてきたデータを読み取るための入力ストリームを取得します。
ServletOutputStream getOutputStream()：サーバーからクライアントへデータを送信するための出力ストリームを取得します。

どちらもIOExceptionをスローする可能性があるため、try-catchブロックで扱うことが一般的です。

4. WebConnectionの使用例

以下は、ServletでWebConnectionを利用してHTTP接続をアップグレードし、ストリームを操作する例です。


import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.*;

import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;

@WebServlet("/upgrade")
public class UpgradeServlet extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest req, HttpServletResponse resp)
            throws ServletException, IOException {

        req.upgrade(MyUpgradeHandler.class);
    }
}

class MyUpgradeHandler implements HttpUpgradeHandler {
    @Override
    public void init(WebConnection wc) {
        try (InputStream in = wc.getInputStream();
             OutputStream out = wc.getOutputStream()) {

            byte[] buffer = new byte[1024];
            int len = in.read(buffer);
            out.write(("受信しました: " + new String(buffer, 0, len)).getBytes());

        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    @Override
    public void destroy() {
        // リソース解放処理
    }
}

このコードでは、HTTP通信をアップグレードして、サーバーがクライアントとストリーム通信を開始しています。getInputStream()とgetOutputStream()を使って、リクエストデータの読み取りとレスポンスデータの書き込みを行っています。