パッケージ jakarta.servlet

インターフェース ServletConnection


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

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

    • 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