• Oracle Technology Network
• ソフトウェアのダウンロード
• ドキュメント

検索

目次

トランスポート

JPDA内では、デバッガ・アプリケーションはJava Debug Interface (JDI)インタフェースとコネクタ抽象を使用してターゲットVMへの接続を確立します。デバッガ・アプリケーションによって使用されるコネクタは、トランスポートをカプセル化します。ターゲットVMでは、デバッガとの通信にJava Debug Wire Protocolをサポートするエージェントが使用されます。このエージェント(ターゲットVMに組み込むか、実行時ライブラリからロード可能)は、デバッガと通信するためにトランスポートをカプセル化します。

TCP/IPに基づくソケット・トランスポートと共用メモリー・トランスポートの2つのトランスポート実装は、リファレンス実装とともに出荷されます。仕様では、特定のトランスポートの実装を必要としません。この実装とともに提供されるトランスポートのほかにも、アーキテクチャに含まれるサービス・プロバイダ・インタフェースを使用して、別のトランスポートを開発および配備できます。

ソケット・トランスポート

コマンドと応答パケットは、JDWPトランスポート・インタフェースを使用して、JDWP仕様に従ってストリームに書き込まれます。JDWPを介して多数の小さなパケットを送信できるため、TCP_NO_DELAYソケット・オプションにより、小さなパケットが送信される前にソケット実装によってバッファされる場合に発生する可能性のある遅延を回避することによって、一部のソケット実装でパフォーマンスを向上させることができます。可能な場合は未送信のデータが送信されるように、ソケットは適切に閉じられます。

ソケット・トランスポートは、dt_socketという一意の文字列で識別されます。この名前は、ターゲットVMを呼び出すときに、ソケット・トランスポートを選択するために使用できます。デバッガ・アプリケーションでは、対応するコネクタによってソケット・トランスポートがカプセル化されます。

クライアントがサーバーに接続しているコンテキストでは、ソケット・トランスポート・アドレスの形式は、「<name>:<port>」になります。<name>はホスト名です。また、<port>は接続または待機しているソケット・ポート番号です。サーバーがクライアントの接続を待機しているコンテキストでは、アドレスはポート番号だけで構成されます(ホスト名は明示されません)。

共用メモリー・トランスポート

共用メモリー・トランスポートは、dt_shmemという一意の文字列で識別されます。この名前は、ターゲットVMを呼び出すときに、ソケット・トランスポートを選択するために使用できます。デバッガ・アプリケーションでは、対応するコネクタによって共用メモリー・トランスポートがカプセル化されます。

共用メモリーのトランスポート・アドレスは、Microsoft Windowsのファイル・マッピング・オブジェクトの名前として使用できます。この名前の文字列には、バックスラッシュを除く任意の文字を含めることができます。

コネクタ

実装されるコネクタをユーザーが選択および構成できるように、JDIクライアント・アプリケーションを作成することもできますが、特定のコネクタに関する情報をデバッガに組み込んでおくと、ユーザーが使いやすい構成になります。JPDAで提供されているJDBの実装例では、この方法が採用されています。

JDIリファレンス実装では、使用可能なトランスポートの種類および接続モード(起動、待機、および接続)に対応するいくつかのコネクタが提供されています。それらのコネクタについて、このあとのセクションで説明します。これらのコネクタのリストは、JDIメソッドVirtualMachineManager.allConnectors()によって返されます。また、各接続コネクタ、待機コネクタ、および起動コネクタは、対応するVirtualMachineManagerメソッドattachingConnectors()、listeningConnectors()、およびlaunchingConnectors()によって返されるリストに含まれます。

コマンド行起動コネクタ

このコネクタは、「com.sun.jdi.CommandLineLaunch」という名前で一意に識別されます。
 

Rawコマンド行起動コネクタ

このコネクタは、「com.sun.jdi.RawCommandLineLaunch」という名前で一意に識別されます。
 

ソケット接続コネクタ

このコネクタは、「com.sun.jdi.SocketAttach」という名前で一意に識別されます。
 

共用メモリー接続コネクタ

このコネクタは、「com.sun.jdi.SharedMemoryAttach」という名前で一意に識別されます。
 

ソケット待機コネクタ

このコネクタでは、複数のターゲットVMからの接続を受け入れることができます。

このコネクタは、「com.sun.jdi.SocketListen」という名前で一意に識別されます。
 

共用メモリー待機コネクタ

このコネクタでは、複数のターゲットVMからの接続を受け入れることができます。

このコネクタは、「com.sun.jdi.SharedMemoryListen」という名前で一意に識別されます。
 

プロセス接続コネクタ

SAコア接続コネクタ

        
${JAVA_HOME}/bin/rmiregistry -J-Xbootclasspath/p:${JAVA_HOME}/lib/sa-jdi.jar

${JAVA_HOME}/bin/java \ 
    -classpath ${JAVA_HOME}/lib/sa-jdi.jar \
    sun.jvm.hotspot.jdi.SADebugServer \
    <pid> \
    [uniqueID]

${JAVA_HOME}/bin/java \
    -classpath ${JAVA_HOME}/lib/sa-jdi.jar \
    sun.jvm.hotspot.jdi.SADebugServer \
    <pathname to the java executable that produced the core file>\
    <pathname of the corefile to debug> \
     [uniqueID]

Oracle VMの呼出しオプション

OracleのVM実装には、デバッグ用のJDWPエージェントをロードするコマンド行オプションが必要です。JDWPエージェントをロードしたり、そのオプションを指定したりするために-agentlib:jdwpオプションが使用されます。

-agentlib:jdwpオプションは、次のように指定されます。

-agentlib:jdwp=<サブオプション>

JDWPのJPDAリファレンス実装をロードする。このライブラリは、ターゲットVMに配置されており、ターゲットVMと対話するときはJVM TIおよびJNIが使用される。別のデバッガ・アプリケーションと通信するときは、トランスポートとJDWPプロトコルが使用される。個別のサブオプションについては、「-Xrunjdwpのサブオプション」で説明されています。

-agentlib:jdwpおよび -Xrunjdwpサブオプション

    -agentlib:jdwp=<name1>[=<value1>],<name2>[=<value2>]...

または

    -Xrunjdwp:<name1>[=<value1>],<name2>[=<value2>]...

次の表では、使用可能なオプションについて説明します。

例

-agentlib:jdwp=transport=dt_socket,server=y,address=8000

ポート8000上でソケット接続を待機する。メイン・クラスがロードされる前にこのVMを中断する(デフォルトではsuspend=y)。デバッガ・アプリケーションが接続されたあと、そのアプリケーションがJDWPコマンドを送信してVMを再開する。

-agentlib:jdwp=transport=dt_socket,server=y,address=localhost:8000,timeout=5000

ループバック・アドレス上のポート8000でのみソケット接続を待機する。デバッガが5秒以内に接続しない場合は終了する。メイン・クラスがロードされる前にこのVMを中断する(デフォルトではsuspend=y)。デバッガ・アプリケーションが接続されたあと、そのアプリケーションがJDWPコマンドを送信してVMを再開する。

-agentlib:jdwp=transport=dt_shmem,server=y,suspend=n

使用可能な共用メモリー・トランスポートのアドレスを選択して、標準出力に出力する。そのアドレスで共用メモリー接続を待機する。デバッガ・アプリケーションが接続される前に、VMは実行を開始する。

-agentlib:jdwp=transport=dt_socket,address=myhost:8000

実行中のデバッガ・アプリケーションに対して、ホストmyhostのポート8000にソケットを介して接続する。メイン・クラスがロードされる前に、このVMを中断する。

-agentlib:jdwp=transport=dt_shmem,address=mysharedmemory

トランスポート・アドレス「mysharedmemory」の共用メモリーを介して、実行中のデバッガ・アプリケーションに接続する。メイン・クラスがロードされる前に、このVMを中断する。

-agentlib:jdwp=transport=dt_socket,server=y,address=8000,onthrow=java.io.IOException,launch=/usr/local/bin/debugstub

java.io.IOExceptionのインスタンスがこのVMでスローされるのを待機する。このVMを中断する(デフォルトではsuspend=y)。ポート8000上でソケット接続を待機する。「/usr/local/bin/debugstub dt_socket myhost:8000」を実行する。このプログラムによって、別のウィンドウでデバッガ・プロセスが起動されてこのVMに接続され、デバッグが開始される。

-agentlib:jdwp=transport=dt_shmem,server=y,onuncaught=y,launch=d:\bin\debugstub.exe

uncaught例外がこのVMでスローされるのを待機する。VMを中断する。共用メモリー・トランスポートのアドレスを選択し、そのアドレスで接続を待機する。「d:\bin\debugstub.exe dt_shmem <address>」を実行する。<address>は、選択された共用メモリー・アドレス。このプログラムによって、別のウィンドウでデバッガ・プロセスが起動されてこのVMに接続され、デバッグが開始される。

Plug-inアプレットのデバッグ

JDIの起動コネクタは、Plug-inアプレットのデバッグには使用できません。

JDBとの接続

JDBでは、-attachオプションを指定すると、リファレンス実装の接続コネクタ(Microsoft Windows上では共用メモリー、SolarisおよびLinuxプラットフォーム上ではソケット)にアクセスできます。-listenオプションを指定すると、リファレンス実装の待機コネクタ(Microsoft Windows上では共用メモリー、SolarisおよびLinuxプラットフォーム上ではソケット)にアクセスできます。コマンド行にクラス名と引数を直接指定すると、コマンド行起動コネクタにアクセスできます。

たとえば、

jdb -attach myhost:8000

上のように入力すると、ソケット接続コネクタを使用して簡単にターゲットVMに接続できます(Solarisオペレーティング環境の場合)。

jdb Hello 1 2 3

上のように入力すると、コマンド行起動コネクタを使用して簡単にターゲットVMを起動できます。

ただし、JDBには -connectオプションも用意されています。これにより、コネクタ名と、任意の名前/値の引数ペアのセットを指定することによって任意のコネクタを処理できます。たとえば、上記の2つのコマンド行は、次のコマンド行と同じことです。

jdb -connect com.sun.jdi.SocketAttach:hostname=myhost,port=8000
jdb -connect "com.sun.jdi.CommandLineLaunch:main=Hello 1 2 3"

これらのコマンド行は、最初の例よりも複雑ですが、-connectオプションを指定すれば任意のコネクタを使用できます。これらの操作から、JDIデバッガでは、任意のコネクタを使用できることがわかります。また、よく使われるコネクタを使用するための簡単なインタフェースも提供されています。

サービス・プロバイダ・インタフェース

JPDAに含まれているサービス・プロバイダ・インタフェースを使うと、コネクタやトランスポートの実装を開発および配置できます。これらのサービス・プロバイダ・インタフェースにより、デバッガや他のツール・ベンダーで新しいコネクタ実装を開発し、Oracleが提供するソケットおよび共用メモリー・トランスポートを超える別のトランスポート・メカニズムを提供できます。JDIのサービス・プロバイダ・インタフェースは、 com.sun.jdi.connect.spiパッケージで指定されます。

JDIのサービス・プロバイダ・インタフェースに加え、Oracleの実装には、Java Debug Wire Protocol Transport Interfaceと呼ばれるトランスポート・ライブラリ・インタフェースも含まれています。トランスポート・ライブラリは、ターゲットVMのJDWPエージェントによってロードされ、デバッガとの接続の確立、およびデバッガとVM間のJDWPパケットのトランスポートに使用されます。

サービス・プロバイダ・インタフェースに関する詳細は、「Java Platform Debugger Architecture - サービス・プロバイダ・インタフェース」のドキュメントを参照してください。