モジュール jdk.jdi
パッケージ com.sun.jdi.connect.spi

クラスConnection

  • public abstract class Connection
extends Object
    デバッガとそのデバッグ対象のターゲットVM間の接続です。

    Connectionは、デバッガとターゲットVMとの間の双方向通信チャネルを表します。 Connectionは、TransportServiceが接続を確立し、ターゲットVMと正常にハンドシェークしたときに作成されます。 TransportServiceの実装は、信頼性の高いJDWPパケット・トランスポート・サービスを提供します。同時に、ConnectionはデバッガとターゲットVM間でJDWPパケットの信頼性の高いフローを提供します。 Connectionはストリーム指向です。つまり、Connectionに書き込まれるJDWPパケットは書き込まれた順序でターゲットVMにより読み取られます。 同様に、ターゲットVMによってConnectionに書き込まれたパケットは、書き込まれた順序でデバッガによって読み込まれます。

    接続は、オープンまたはクローズのどちらかです。 接続は作成時にオープンとなり、クローズまでオープンのままとなります。 いったんクローズされると、その状態が保持され、その接続で入出力操作を呼び出そうとすると、ClosedConnectionExceptionがスローされます。 接続は、isOpenメソッドを呼び出すことによってテストできます。

    Connectionは、複数のスレッドによる並行アクセスに対して安全ですが、どんなときも、最大1つのスレッドのみ読み取ることが可能であり、最大1つのスレッドのみ書き込むことができます。

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

    • コンストラクタの詳細

      • Connection

        public Connection()

    • メソッドの詳細

      • readPacket

        public abstract byte[] readPacket()
                           throws IOException
        ターゲットVMからパケットを読み取ります。

        ターゲットVMからJDWPパケットを読み取ろうとします。 読取り操作は、無制限にブロックされる場合があり、パケットのすべてのバイトを読み取った場合だけ戻ります。ストリーム指向の通信プロトコルに基づくトランスポート・サービスの場合は、ストリームの終わりが検出されます。

        パケットの読取りでは、パケットの長さ(lengthフィールド(パケットの最初の4バイト)の値により示される長さ)が11バイト以上であることをチェックする以外、パケットの一貫性チェックは行われません。 lengthフィールドの値が11未満の場合、IOExceptionがスローされます。

        受信したパケットの長さに等しい長さのバイト配列を返すか、ストリームの終わりが検出された場合は長さ0のbyte配列を返します。 ストリームの終わりがパケットのすべてのバイトのあとではなく一部のバイトのあとで検出された場合、I/Oエラーとみなされ、IOExceptionがスローされます。 パケットの最初のバイトは、byte配列の要素0に格納され、2番目のバイトは要素1に格納される、のように格納されます。 byte配列のバイトは、JDWP仕様に従って配置されます。 つまり、パケットのすべてのフィールドはJDWP仕様で説明するようにビッグ・エンディアンの順になります。

        このメソッドはいつでも呼び出すことができます。 別のスレッドがこの接続でreadPacketをすでに開始している場合、このメソッドの呼出しは最初の操作が完了するまでブロックされます。

        戻り値:
        ターゲットVMから読み取られたパケット
        例外:
        ClosedConnectionException - 接続がクローズされた場合、またはreadPacketの進行中に別のスレッドが接続をクローズした場合。
        IOException - パケットの長さ(最初の4バイトで示される)が11バイト未満である場合、または入出力エラーが発生した場合。

      • writePacket

        public abstract void writePacket​(byte[] pkt)
                          throws IOException
        ターゲットVMにパケットを書き込みます。

        ターゲットVMにJDWPパケットの書き込みまたは送信を試みます。 書込み操作は、ターゲットVMにパケット全体が書き込まれたあとだけ戻ります。 パケット全体の書込みは、パケット全体がターゲットVMに転送されたことを意味するのではなく、すべてのバイトがトランスポート・サービスに書き込まれたことを意味します。 たとえば、TCP/IP接続に基づくトランスポート・サービスは、ネットワーク上への転送の前にパケットの一部またはすべてをバッファする場合があります。

        このメソッドに提供されたbyte配列は、JDWP仕様に従って配置されているはずです。 つまり、パケットのすべてのフィールドはビッグ・エンディアンの順です。 最初のバイトである要素pkt[0]はlengthフィールドの最初のバイト、要素pkt[1]はlengthフィールドの2番目のバイト、のようになっています。

        パケットの書込みでは、パケットの長さをチェックする以外、パケットの一貫性チェックは行われません。 パケット長のチェックでは、lengthフィールド(パケットの最初の4バイトで示される)の値が11以上であることをチェックする必要があります。 同時に、このメソッドに提供されたbyte配列の長さ、つまりpkt.lengthは11以上である必要があり、lengthフィールドの値以上である必要があります。 byte配列の長さがlengthフィールドの値よりも大きい場合、要素pkt[length]以降のすべてのバイトは無視されます。 つまり、byte配列内のそのパケットに続く余分なバイトは無視され、ターゲットVMに転送されません。

        書込み操作はブロックされたり、すぐに終了したりする場合があります。 操作が正確にいつブロックされるかはトランスポート・サービスに依存します。 ターゲットVMにTCP/IP接続される場合は、ネットワークが混雑していたり基になるネットワーク・システムでパケットをバッファする領域が不足している場合は、writePacketメソッドがブロックされる場合があります。

        このメソッドはいつでも呼び出すことができます。 別のスレッドがこのConnectionで書込み操作をすでに開始している場合、このメソッドの以降の呼出しは最初の操作が完了するまでブロックされます。

        パラメータ:
        pkt - ターゲットVMに書き込まれるパケット。
        例外:
        ClosedConnectionException - 接続がクローズされた場合、または書込み操作の進行中に別のスレッドが接続をクローズした場合。
        IOException - 入出力エラーが発生した場合。
        IllegalArgumentException - lengthフィールドの値が無効な場合、またはbyte配列の長さが不足している場合。

      • close

        public abstract void close()
                    throws IOException
        この接続を終了します。

        接続がすでにクローズされている場合、このメソッドを呼び出しても何の効果もありません。 接続がクローズされたあとで、readPacketまたはwritePacketを呼び出そうとすると、ClosedConnectionExceptionがスローされます。

        入出力操作(readPacketまたはwritePacket)で現在ブロックされているスレッドは、ClosedConnectionExceptionをスローします)。

        このメソッドはいつでも呼び出すことができます。 ただし、ほかの何らかのスレッドがこのメソッドをすでに呼び出している場合、別の呼出しは最初の呼出しが完了するまでブロックされ、そのあと何も効果を発揮することなく戻ります。

        例外:
        IOException - 入出力エラーが発生した場合

      • isOpen

        public abstract boolean isOpen()
        この接続がオープンかどうかを通知します。
        戻り値:
        この接続が開いている場合にのみtrue