```
public interface JavaShellToolBuilder
```
用于配置和运行Java Shell工具实例的接口。使用静态的builder()方法创建构建器的实例。可以选择使用该构建器配置配置方法。所有配置方法返回构建器实例以用于链接初始化。所有的配置方法都有明确的默认值，如果没有调用它们将被使用。在零个或多个调用配置方法之后，该工具将启动并调用run(java.lang.String...) 。

从以下版本开始：

9

方法摘要

所有方法静态方法接口方法抽象方法 Default Methods
Modifier and Type	方法	描述
`static JavaShellToolBuilder`	`builder()`	创建一个用于启动JDK jshell工具的构建器。
`JavaShellToolBuilder`	`env(Map<String,String> vars)`	设置环境变量的源。
`JavaShellToolBuilder`	`err(PrintStream error)`	设置错误通道。
`JavaShellToolBuilder`	`err(PrintStream cmdErr, PrintStream userErr)`	设置错误通道。
`JavaShellToolBuilder`	`in(InputStream cmdIn, InputStream userIn)`	设置输入通道。
`JavaShellToolBuilder`	`locale(Locale locale)`	设置区域设置。
`JavaShellToolBuilder`	`out(PrintStream output)`	设置输出通道。
`JavaShellToolBuilder`	`out(PrintStream cmdOut, PrintStream console, PrintStream userOut)`	设置输出通道。
`JavaShellToolBuilder`	`persistence(Map<String,String> prefsMap)`	设置包含输入历史记录和保留设置的持久信息的存储机制。
`JavaShellToolBuilder`	`persistence(Preferences prefs)`	设置包含输入历史记录和保留设置的持久信息的存储机制。
`JavaShellToolBuilder`	`promptCapture(boolean capture)`	设置为启用命令捕获提示覆盖。
`void`	`run(String... arguments)`	运行该接口中其他方法配置的Java Shell工具实例。

- 方法详细信息
  - builder
```
static JavaShellToolBuilder builder()
```
    创建一个用于启动JDK jshell工具的构建器。
    
    结果
    
    一个可用于配置和启动jshell工具的构建器
  - in
```
JavaShellToolBuilder in(InputStream cmdIn,
                        InputStream userIn)
```
    设置输入通道。
    
    实现要求：
    
    如果没有调用此方法，行为应该等同于调用 in(System.in, null) 。
    
    参数
    
    cmdIn - 命令输入源
    
    userIn - 运行用户代码的输入源，或 null从cmdIn中提取用户输入
    
    结果
    
    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实例
  - run
```
void run(String... arguments)
  throws 异常
```
    运行该接口中其他方法配置的Java Shell工具实例。此调用不是破坏性的，可以从配置的构建器进行多个此方法的调用。
    
    参数
    
    arguments - 命令行参数（包括选项）（如果有）
    
    异常
    
    异常 - 意外的致命异常

Interface JavaShellToolBuilder

方法摘要

方法详细信息

builder

in

out

out

err

err

persistence

persistence

env

locale

promptCapture

run