クラスRemoteExecutionControl

java.lang.Object

jdk.jshell.execution.DirectExecutionControl

jdk.jshell.execution.RemoteExecutionControl

すべての実装されたインタフェース:

AutoCloseable, ExecutionControl

public class RemoteExecutionControl extends DirectExecutionControl implements ExecutionControl

リモート・エージェントは実行プロセス(メインのJShellプロセスとは別に)で実行されます。 このエージェントは、メインのJShellプロセスからソケットにコードをロードし、コード、および外部プロセスによって制御される停止サポートを追加するDirectExecutionControlの特殊化を実行します。 JdiDefaultExecutionControlで動作するように設計されています。

導入されたバージョン:

9

ネストされたクラスのサマリー

インタフェースで宣言されたネストされたクラス/インタフェース ExecutionControl

ExecutionControl.ClassBytecodes, ExecutionControl.ClassInstallException, ExecutionControl.EngineTerminationException, ExecutionControl.ExecutionControlException, ExecutionControl.InternalException, ExecutionControl.NotImplementedException, ExecutionControl.ResolutionException, ExecutionControl.RunException, ExecutionControl.StoppedException, ExecutionControl.UserException

修飾子と型	インタフェース	説明
static final class	ExecutionControl.ClassBytecodes	クラス名とクラス・バイト・コードをバンドルします。
static class	ExecutionControl.ClassInstallException	クラス・インストール(ロードまたは再定義)で問題が発生しました。
static class	ExecutionControl.EngineTerminationException	禁止されていない実行エンジンの終了が発生しました。
static class	ExecutionControl.ExecutionControlException	すべてのExecutionControl例外の抽象ベース。
static class	ExecutionControl.InternalException	内部問題が発生しました。
static class	ExecutionControl.NotImplementedException	コマンドは実装されていません。
static class	ExecutionControl.ResolutionException	未解決の参照を含むDeclarationSnippetが検出されたことを示す例外。
static class	ExecutionControl.RunException	実行中のユーザー・コードに固有の例外の抽象ベース。
static class	ExecutionControl.StoppedException	ExecutionControl.invoke(java.lang.String, java.lang.String) (または理論的にはExecutionControl.varValue(java.lang.String, java.lang.String))がExecutionControl.stop()によって中断されたことを示す例外。
static class	ExecutionControl.UserException	「通常の」ユーザー例外が発生しました。

コンストラクタのサマリー

コンストラクタ

コンストラクタ	説明
RemoteExecutionControl()	デフォルトのクラス・ロードを使用してインスタンスを作成します。
RemoteExecutionControl(LoaderDelegate loaderDelegate)	インスタンスを作成し、指定した委任にローダー操作を委任します。

メソッドのサマリー

修飾子と型	メソッド	説明
protected void	clientCodeEnter()	ユーザー・コードにエントリをマークします。
static void	main(String[] args)	エージェントを起動し、コマンドライン引数で指定されたソケットを介してJShellコアに接続します。
void	redefine(ExecutionControl.ClassBytecodes[] cbcs)	リモート・エンドでの処理の再定義は、再定義されたクラスの登録のみです
String	varValue(String className, String varName)	変数の値を返します。

クラスで宣言されたメソッド DirectExecutionControl

addToClasspath, classesRedefined, clientCodeLeave, close, extensionCommand, findClass, invoke, invoke, load, stop, throwConvertedInvocationException, throwConvertedOtherException, valueString

修飾子と型	メソッド	説明
void	addToClasspath(String cp)	実行クラス・パスにパスを追加します。
protected void	classesRedefined(ExecutionControl.ClassBytecodes[] cbcs)	クラスが再定義されたことを通知します。
protected void	clientCodeLeave()	ユーザー・コードからの出発をマークします。
void	close()	この実行エンジンを停止します。
Object	extensionCommand(String command, Object arg)	非標準コマンド(新しいバージョンの標準コマンド)を実行します。
protected Class<?>	findClass(String name)	指定されたバイナリ名を持つクラスを検索します。
protected String	invoke(Method doitMethod)	指定された"doit-method"(パラメータのない静的メソッド)を呼び出します。
String	invoke(String className, String methodName)	指定されたラッパー・クラスのメソッドをコールして、実行可能スニペットを起動します。
void	load(ExecutionControl.ClassBytecodes[] cbcs)	新しいクラスをロードしようとします。
void	stop()	実行中の呼出しを中断します。
protected String	throwConvertedInvocationException(Throwable cause)	ユーザー・コードの受信例外をExecutionControl.ExecutionControlExceptionのサブタイプのインスタンスに変換し、変換された例外をスローします。
protected String	throwConvertedOtherException(Throwable ex)	エージェント・コード内の受信例外をExecutionControl.ExecutionControlExceptionのサブタイプのインスタンスに変換し、変換された例外をスローします。
protected static String	valueString(Object value)	Objectの値をExecutionControl.invoke(String, String)またはExecutionControl.varValue(String, String)からStringに変換します。

クラスオブジェクトで宣言されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

修飾子と型	メソッド	説明
protected Object	clone()	このオブジェクトのコピーを作成して、返します。
boolean	equals(Object obj)	このオブジェクトと他のオブジェクトが等しいかどうかを示します。
protected void	finalize()	削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。 最終決定は非推奨であり、将来のリリースで削除される可能性があります。
final Class<?>	getClass()	このObjectの実行時クラスを返します。
int	hashCode()	このオブジェクトに対するハッシュ・コード値を返します。
final void	notify()	このオブジェクトのモニターで待機中のスレッドを1つ再開します。
final void	notifyAll()	このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
String	toString()	オブジェクトの文字列表現を返します。
final void	wait()	現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
final void	wait(long timeoutMillis)	現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
final void	wait(long timeoutMillis, int nanos)	現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

コンストラクタの詳細

RemoteExecutionControl

public RemoteExecutionControl(LoaderDelegate loaderDelegate)

インスタンスを作成し、指定した委任にローダー操作を委任します。

パラメータ:

loaderDelegate - デリゲートがロード・クラスを処理

RemoteExecutionControl

public RemoteExecutionControl()

デフォルトのクラス・ロードを使用してインスタンスを作成します。

メソッドの詳細

main

public static void main(String[] args) throws Exception

エージェントを起動し、コマンドライン引数で指定されたソケットを介してJShellコアに接続します。

パラメータ:

args - 標準コマンド行引数。ソケット番号が唯一の引数であることを期待

スロー:

Exception - 予想外の例外

redefine

public void redefine(ExecutionControl.ClassBytecodes[] cbcs) throws ExecutionControl.ClassInstallException, ExecutionControl.NotImplementedException, ExecutionControl.EngineTerminationException

リモート・エンドでの処理の再定義は、再定義されたクラスの登録のみです

定義:

インタフェースExecutionControl内のredefine

パラメータ:

cbcs - 再定義するクラス名とバイトコード

スロー:

ExecutionControl.ClassInstallException - クラスの再定義中に例外が発生しました。一部またはすべてが再定義されませんでした

ExecutionControl.NotImplementedException - 実装されていない場合

ExecutionControl.EngineTerminationException - 実行エンジンが終了しました

varValue

public String varValue(String className, String varName) throws ExecutionControl.RunException, ExecutionControl.EngineTerminationException, ExecutionControl.InternalException

インタフェース: ExecutionControlからコピーされた説明

変数の値を返します。

定義:

インタフェースExecutionControl内のvarValue

オーバーライド:

クラスDirectExecutionControlのvarValue

パラメータ:

className - 変数のラッパー・クラスの名前

varName - 変数の名前

戻り値:

変数の値

スロー:

ExecutionControl.UserException - 値の書式設定によってユーザー例外が発生しました

ExecutionControl.ResolutionException - 値をフォーマットすると、未解決のスニペットを直接的または間接的に呼び出そうとしました

ExecutionControl.StoppedException - 値の書式設定がExecutionControl.stop()によって取消された場合

ExecutionControl.EngineTerminationException - 実行エンジンが終了しました

ExecutionControl.InternalException - 内部問題が発生しました

ExecutionControl.RunException

clientCodeEnter

protected void clientCodeEnter()

クラス: DirectExecutionControlからコピーされた説明

ユーザー・コードにエントリをマークします。

オーバーライド:

クラスDirectExecutionControlのclientCodeEnter