パッケージ jakarta.servlet

インターフェース ServletConnection


  • public interface ServletConnection
    サーブレットコンテナーへの接続に関する情報を提供します。このインターフェースは、主にデバッグを目的としており、コンテナーから見た生の情報を提供します。メソッドの Javadoc で特に明記されていない限り、リバースプロキシまたは同様の構成の存在に対する調整は行われません。
    導入:
    Servlet 6.0
    • メソッドのサマリー

      すべてのメソッド   インスタンスメソッド   抽象メソッド  
      修飾子と型 メソッド 説明
      StringSEgetConnectionId()
      この ServletConnection の取得元である ServletRequest に使用されている JVM へのネットワーク接続の一意の (JVM の有効期間内の) 識別子文字列を取得します。
      StringSEgetProtocol()
      TLS または同様の暗号化が存在する場合は、削除した後にサーバーに提示されるプロトコルの名前を取得します。
      StringSEgetProtocolConnectionId()
      使用中のプロトコルで定義されているように、この ServletConnection の取得元である ServletRequest に使用されているサーバーへのネットワーク接続の接続 ID を取得します。
      booleanisSecure()
      サーバーへの受信ネットワーク接続で暗号化が使用されたかどうかを確認します。
    • メソッドの詳細

      • getConnectionId

        StringSE getConnectionId()
        この ServletConnection の取得元である ServletRequest に使用されている JVM へのネットワーク接続の一意の (JVM の有効期間内の) 識別子文字列を取得します。

        この文字列には定義された形式はありません。形式は実装に依存します。

        戻り値:
        ネットワーク接続の一意の識別子
      • getProtocol

        StringSE getProtocol()
        TLS または同様の暗号化が存在する場合は、削除した後にサーバーに提示されるプロトコルの名前を取得します。これは、アプリケーションから見たプロトコルと同じではない場合があります。例: リバースプロキシは AJP を提示する場合がありますが、アプリケーションには HTTP 1.1 が表示されます。

        プロトコルのエントリが ALPN 名の IANA レジストリにある場合は、識別シーケンスを文字列形式で返す必要があります。登録された識別シーケンスは、関連付けられたプロトコルにのみ使用する必要があります。他のプロトコルの戻り値は実装に依存します。未知のプロトコルは、文字列 "unknown" を返す必要があります。

        戻り値:
        TLS または同様の暗号化の復号化後にサーバーに提示されるプロトコルの名前 (存在する場合)。
      • getProtocolConnectionId

        StringSE getProtocolConnectionId()
        使用中のプロトコルで定義されているように、この ServletConnection の取得元である ServletRequest に使用されているサーバーへのネットワーク接続の接続 ID を取得します。一部のプロトコルでは、そのような識別子が定義されていないことに注意してください。

        プロトコルが提供する接続識別子の例は次のとおりです。

        HTTP 1.x
        なし。空の文字列を返す必要があります
        HTTP 2
        なし。空の文字列を返す必要があります
        HTTP 3
        QUIC 接続 ID
        AJP
        なし。空の文字列を返す必要があります
        戻り値:
        定義されている場合は接続識別子、それ以外の場合は空の文字列
      • isSecure

        boolean isSecure()
        サーバーへの受信ネットワーク接続で暗号化が使用されたかどうかを確認します。リバースプロキシが使用されている場合、アプリケーションは、X-Forwarded-Proto などのヘッダーの使用により、暗号化が使用されているかどうかについて異なるビューを持つ可能性があることに注意してください。
        戻り値:
        受信ネットワーク接続が暗号化を使用した場合は true、それ以外の場合は false