パッケージ jakarta.servlet
インターフェース ServletConnection
public interface ServletConnection
サーブレットコンテナーへの接続に関する情報を提供します。このインターフェースは、主にデバッグを目的としており、コンテナーから見た生の情報を提供します。メソッドの Javadoc で特に明記されていない限り、リバースプロキシまたは同様の構成の存在に対する調整は行われません。- 導入:
- Servlet 6.0
メソッドのサマリー
すべてのメソッド インスタンスメソッド 抽象メソッド 修飾子と型 メソッド 説明 StringSE
getConnectionId()
このServletConnection
の取得元であるServletRequest
に使用されている JVM へのネットワーク接続の一意の (JVM の有効期間内の) 識別子文字列を取得します。StringSE
getProtocol()
TLS または同様の暗号化が存在する場合は、削除した後にサーバーに提示されるプロトコルの名前を取得します。StringSE
getProtocolConnectionId()
使用中のプロトコルで定義されているように、このServletConnection
の取得元であるServletRequest
に使用されているサーバーへのネットワーク接続の接続 ID を取得します。boolean
isSecure()
サーバーへの受信ネットワーク接続で暗号化が使用されたかどうかを確認します。
メソッドの詳細
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