public interface JavaShellToolBuilder
Javaシェル・ツール・インスタンスを構成および実行するインタフェース。 ビルダーのインスタンスは、静的
builder()
メソッドを使用して作成されます。 このビルダーは、オプションで構成メソッドで構成できます。 すべての構成メソッドは、連鎖初期化で使用するビルダー・インスタンスを返します。 すべての構成メソッドは、呼び出されない場合に使用される適切なデフォルトを持っています。 0個以上の構成メソッドのコール後、ツールはrun(java.lang.String...)
をコールして起動されます。 - 導入されたバージョン:
- 9
-
メソッドのサマリー
修飾子と型メソッド説明static JavaShellToolBuilder
builder()
JDK jshellツールを起動するためのビルダーを作成します。環境変数のソースを設定します。err
(PrintStream error) エラー・チャネルを設定します。err
(PrintStream cmdErr, PrintStream userErr) エラー・チャネルを設定します。in
(InputStream cmdIn, InputStream userIn) 入力チャネルを設定します。default JavaShellToolBuilder
interactiveTerminal
(boolean terminal) 入力および出力は、ANSIのエスケープ・コードを解釈できる対話型端末に接続されるようにするには、trueに設定します。ロケールを設定します。out
(PrintStream output) 出力チャネルを設定します。out
(PrintStream cmdOut, PrintStream console, PrintStream userOut) 出力チャネルを設定します。persistence
(Map<String, String> prefsMap) 入力履歴と保持された設定を含む永続的な情報のストレージ・メカニズムを設定します。persistence
(Preferences prefs) 入力履歴と保持された設定を含む永続的な情報のストレージ・メカニズムを設定します。promptCapture
(boolean capture) プロンプトのオーバーライドを取得するコマンドを有効にするように設定します。void
このインタフェースの他のメソッドで構成されているように、Javaシェル・ツールのインスタンスを実行します。default int
このインタフェースの他のメソッドで構成されているように、Javaシェル・ツールのインスタンスを実行します。
-
メソッドの詳細
-
builder
static JavaShellToolBuilder builder()JDK jshellツールを起動するためのビルダーを作成します。- 戻り値:
- jshellツールの構成と起動に使用できるビルダー
-
in
JavaShellToolBuilder in(InputStream cmdIn, InputStream userIn) 入力チャネルを設定します。- 実装要件:
- このメソッドがコールされない場合、動作は
in(System.in, null)
のコールと同等である必要があります。 - パラメータ:
cmdIn
- コマンド入力元userIn
- ユーザー・コードを実行するための入力のソース、またはcmdInからユーザー入力を抽出するためのnull
- 戻り値:
JavaShellToolBuilder
インスタンス
-
out
JavaShellToolBuilder out(PrintStream output) 出力チャネルを設定します。out(output, output, output)
と同じです。- 実装要件:
- どちらの
out
メソッドもコールされない場合、動作はout(System.out)
のコールと同等である必要があります。 - パラメータ:
output
- コマンド・フィード・バック、コンソール対話、およびユーザー・コード出力の宛先- 戻り値:
JavaShellToolBuilder
インスタンス
-
out
JavaShellToolBuilder out(PrintStream cmdOut, PrintStream console, PrintStream userOut) 出力チャネルを設定します。- 実装要件:
- どちらの
out
メソッドもコールされない場合、動作はout(System.out, System.out, System.out)
のコールと同等である必要があります。 - パラメータ:
cmdOut
- ユーザーに対するエラー・メッセージを含むコマンド・フィード・バックの宛先console
- コンソール対話の宛先userOut
- ユーザー・コード出力の宛先。 たとえば、ユーザー・スニペットSystem.out.println("Hello")
を実行すると、Hello
はuserOutになります。- 戻り値:
JavaShellToolBuilder
インスタンス
-
err
JavaShellToolBuilder err(PrintStream error) エラー・チャネルを設定します。err(error, error)
と同じです。- 実装要件:
- どちらの
err
メソッドもコールされない場合、動作はerr(System.err)
のコールと同等である必要があります。 - パラメータ:
error
- ツール・エラーおよびユーザー・コード・エラーの宛先- 戻り値:
JavaShellToolBuilder
インスタンス
-
err
JavaShellToolBuilder err(PrintStream cmdErr, PrintStream userErr) エラー・チャネルを設定します。- 実装要件:
- どちらの
err
メソッドもコールされない場合、動作はerr(System.err, System.err, System.err)
のコールと同等である必要があります。 - パラメータ:
cmdErr
- ツールの起動先と致命的なエラーuserErr
- ユーザー・コード・エラー出力の宛先。 たとえば、ユーザー・スニペットSystem.err.println("Oops")
を実行すると、Oops
はuserErrになります。- 戻り値:
JavaShellToolBuilder
インスタンス
-
persistence
JavaShellToolBuilder persistence(Preferences prefs) 入力履歴と保持された設定を含む永続的な情報のストレージ・メカニズムを設定します。- 実装要件:
- どちらの
persistence
メソッドもコールされない場合、その動作はツールの標準永続性メカニズムを使用することです。 - パラメータ:
prefs
- 永続的情報を取得して格納するために使用されるPreferences
のインスタンス- 戻り値:
JavaShellToolBuilder
インスタンス
-
persistence
JavaShellToolBuilder persistence(Map<String, String> prefsMap) 入力履歴と保持された設定を含む永続的な情報のストレージ・メカニズムを設定します。- 実装要件:
- どちらの
persistence
メソッドもコールされない場合、その動作はツールの標準永続性メカニズムを使用することです。 - パラメータ:
prefsMap
- 永続的情報を取得して格納するために使用されるMap
のインスタンス- 戻り値:
JavaShellToolBuilder
インスタンス
-
env
JavaShellToolBuilder env(Map<String, String> vars) 環境変数のソースを設定します。- 実装要件:
- このメソッドがコールされない場合、動作は
env(System.getenv())
のコールと同等である必要があります。 - パラメータ:
vars
- 環境変数名から値へのマップ- 戻り値:
JavaShellToolBuilder
インスタンス
-
locale
JavaShellToolBuilder locale(Locale locale) ロケールを設定します。- 実装要件:
- このメソッドがコールされない場合、動作は
locale(Locale.getDefault())
のコールと同等である必要があります。 - パラメータ:
locale
- ロケール- 戻り値:
JavaShellToolBuilder
インスタンス
-
promptCapture
JavaShellToolBuilder promptCapture(boolean capture) プロンプトのオーバーライドを取得するコマンドを有効にするように設定します。- 実装要件:
- このメソッドがコールされない場合、動作は
promptCapture(false)
のコールと同等である必要があります。 - パラメータ:
capture
-true
の場合、基本プロンプトはENQ
文字で、継続プロンプトはACK
文字です。 falseの場合、プロンプトは設定コマンドまたはユーザー/set
コマンドで設定されます。- 戻り値:
JavaShellToolBuilder
インスタンス
-
interactiveTerminal
default JavaShellToolBuilder interactiveTerminal(boolean terminal) 入力および出力は、ANSIのエスケープ・コードを解釈できる対話型端末に接続されるようにするには、trueに設定します。 出力ストリームに送信される文字は端末によって解釈され、ユーザーに表示されます。出力に送信される文字の正確な順序と性質は不特定です。 出力を自動ツールで解析できる従来の単純な動作を指定するには、falseに設定します。 このJavaシェルの入力ストリームがSystem.in
の場合、この値は無視され、このメソッドでのtrue
の指定に似ていますが、System.in
に接続されている特定の端末に厳密に続きます。- 実装要件:
- このメソッドが呼び出されない場合、動作は
interactiveTerminal(false)
の呼出しと同じである必要があります。 このメソッドのデフォルト実装は、this
を返します。 - パラメータ:
terminal
-true
の場合、ANSIエスケープ・コードを解釈できる端末は、出力を解釈すると見なされます。false
の場合、より単純な出力が選択されます。- 戻り値:
JavaShellToolBuilder
インスタンス- 導入されたバージョン:
- 17
-
run
このインタフェースの他のメソッドで構成されているように、Javaシェル・ツールのインスタンスを実行します。 このコールは破壊的ではありません。このメソッドの複数のコールは、構成されたビルダーから行うことができます。 Javaシェル・ツールの終了コードは無視されます。- パラメータ:
arguments
- コマンドライン引数(オプションを含む)(存在する場合)- 例外:
Exception
- 予期しない致命的な例外
-
start
このインタフェースの他のメソッドで構成されているように、Javaシェル・ツールのインスタンスを実行します。 このコールは破壊的ではありません。このメソッドの複数のコールは、構成されたビルダーから行うことができます。- 実装要件:
- デフォルト実装は常にゼロを返します。 このインタフェースの実装は、このメソッドをオーバーライドして、終了ステータスを返します。
- パラメータ:
arguments
- コマンドライン引数(オプションを含む)(存在する場合)- 戻り値:
- ツールが明示的に(もしあれば)を終了した終了ステータス。成功した場合は0、失敗の場合は1
- 例外:
Exception
- 予期しない致命的な例外
-