エクステンションのデバッグ

エクステンション (SOE または SOI) のデバッグでは、サービス プロセスの実行が必要になるため、いくつかの課題に直面します。 ArcGIS Server Manager には、Java エクステンションのデバッグに役立ついくつかの設定が用意されています。 これらの設定については以下で詳しく説明します。

Java および .NET エクステンションのデバッグに関する詳細なヘルプについては、ArcGIS Enterprise SDK のドキュメントをご参照ください。

デバッグ ワークフロー

エクステンションをデバッグするには、次の操作を行う必要があります。

1. ArcGIS Server Manager を使用して、エクステンションを配置します。
2. ArcGIS Server Manager を使用して、エクステンションのデバッグを有効にし、デバッグの設定を構成します。 これらの内容については以下で詳しく説明します。
3. エクステンション コードの任意の場所にブレークポイントを設定します。
4. サービスを停止した後、開始します。
5. すぐに、サービスを実行しているオペレーティング システムのプロセスにデバッガをアタッチします。 ブレークポイントがエクステンションの初期化コードの中にある場合、サービスが起動したときにブレークポイントに到達します。 それ以外の場合は、エクステンションを使用したときにブレークポイントに到達します。
6. ArcGIS Server Manager を使用して、デバッグを無効にします。

ArcGIS Server Manager でのデバッグ設定の構成

デバッグを容易にするために、ArcGIS Server Manager ではエクステンションの振舞いを変更することができます。 サービスの起動を中断して、エクステンションの Initialize メソッドが呼び出される前にデバッガをサービス プロセスにアタッチできます。 また、サービスのデバッグ中に使用されるさまざまなポートを指定することもできます。

ArcGIS Server Manager でこれらのデバッグ設定にアクセスするには、次の手順に従います。

1. ArcGIS Server Manager にサイン インして、[サイト] をクリックします。
2. [GIS サーバー] > [エクステンション] の順にクリックします。
3. [デバッグ設定] をクリックして、[エクステンションのデバッグを有効化] をオンにします。 これにより、ダイアログ ボックスの他のオプションが有効になります。
4. 必要に応じて、[サービスの起動の一時停止] をオンにして、サービスの起動を遅らせる秒数を指定します。

   一部のエクステンション コードは、サービスの起動時に 1 回だけ実行されます。 このコードは通常、IObjectConstruct インターフェイスの Construct メソッドに置かれています。 サービスの起動を中断すると、Construct メソッドを実行する前にデバッガをサービス プロセスにアタッチする時間が得られます。それにより、そのメソッドのコードに設定したブレークポイントに到達させることが可能になります。

5. 必要に応じて、デバッグするときに使用するさまざまなポートを指定することができます。
6. [保存] をクリックします。

これで、サービスの停止と開始を行い、サービスを実行しているオペレーティング システムのプロセスにデバッガをアタッチして、エクステンションをデバッグできます。 サービスの起動を中断するタイム ウィンドウを設定した場合は、そのウィンドウに達する前にデバッガをサービス プロセスにアタッチする必要があります。そうしないと、エクステンションの Construct メソッドに設定したいずれのブレークポイントにも到達しません。

デバッグ処理の間は、必要な回数だけサービスの停止と開始を行えます。

注意:

エクステンションのデバッグが終了したら、デバッグの設定に戻り、[エクステンションのデバッグを有効化] をオフにします。 これを行わずに、サービスの起動を中断する設定を構成した場合は、サービスを起動するたびに遅れが生じます。