Package org.jline.terminal
Class TerminalBuilder
- java.lang.Object
-
- org.jline.terminal.TerminalBuilder
-
public final class TerminalBuilder extends java.lang.Object
Builder class to create terminals.
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
TerminalBuilder.SystemOutput
-
Field Summary
Fields Modifier and Type Field Description private Attributes
attributes
private int
codepage
private java.lang.Boolean
color
private java.lang.Boolean
dumb
private java.nio.charset.Charset
encoding
private java.lang.Boolean
exec
private java.io.InputStream
in
private java.lang.Boolean
jansi
private java.lang.Boolean
jna
private java.lang.String
name
private boolean
nativeSignals
private java.io.OutputStream
out
private boolean
paused
static java.lang.String
PROP_CODEPAGE
static java.lang.String
PROP_COLOR_DISTANCE
static java.lang.String
PROP_DISABLE_ALTERNATE_CHARSET
static java.lang.String
PROP_DUMB
static java.lang.String
PROP_DUMB_COLOR
static java.lang.String
PROP_ENCODING
static java.lang.String
PROP_EXEC
static java.lang.String
PROP_JANSI
static java.lang.String
PROP_JNA
static java.lang.String
PROP_NON_BLOCKING_READS
static java.lang.String
PROP_OUTPUT
static java.lang.String
PROP_OUTPUT_ERR
static java.lang.String
PROP_OUTPUT_ERR_OUT
static java.lang.String
PROP_OUTPUT_OUT
static java.lang.String
PROP_OUTPUT_OUT_ERR
static java.lang.String
PROP_TYPE
private Terminal.SignalHandler
signalHandler
private Size
size
private java.lang.Boolean
system
private static java.util.concurrent.atomic.AtomicReference<Terminal>
SYSTEM_TERMINAL
private TerminalBuilder.SystemOutput
systemOutput
private static java.util.concurrent.atomic.AtomicReference<Terminal>
TERMINAL_OVERRIDE
private java.lang.String
type
private static int
UTF8_CODE_PAGE
-
Constructor Summary
Constructors Modifier Constructor Description private
TerminalBuilder()
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description TerminalBuilder
attributes(Attributes attributes)
Attributes to use when creating a non system terminal, i.e.Terminal
build()
static TerminalBuilder
builder()
Creates a new terminal builder instance.TerminalBuilder
codepage(int codepage)
Deprecated.JLine now writes Unicode output independently from the selected code page.TerminalBuilder
color(boolean color)
private Terminal
doBuild()
TerminalBuilder
dumb(boolean dumb)
TerminalBuilder
encoding(java.lang.String encoding)
Set the encoding to use for reading/writing from the console.TerminalBuilder
encoding(java.nio.charset.Charset encoding)
Set theCharset
to use for reading/writing from the console.TerminalBuilder
exec(boolean exec)
private static java.lang.Boolean
getBoolean(java.lang.String name, java.lang.Boolean def)
private static java.nio.charset.Charset
getCodepageCharset(int codepage)
private static java.lang.String
getParentProcessCommand()
TerminalBuilder
jansi(boolean jansi)
TerminalBuilder
jna(boolean jna)
private static <S> S
load(java.lang.Class<S> clazz)
TerminalBuilder
name(java.lang.String name)
TerminalBuilder
nativeSignals(boolean nativeSignals)
TerminalBuilder
paused(boolean paused)
Initial paused state of the terminal (defaults to false).private static TerminalProvider.Stream
select(java.util.Map<TerminalProvider.Stream,java.lang.Boolean> system, TerminalProvider.Stream... streams)
private TerminalProvider.Stream
select(java.util.Map<TerminalProvider.Stream,java.lang.Boolean> system, TerminalBuilder.SystemOutput systemOutput)
static void
setTerminalOverride(Terminal terminal)
Deprecated.TerminalBuilder
signalHandler(Terminal.SignalHandler signalHandler)
TerminalBuilder
size(Size size)
Initial size to use when creating a non system terminal, i.e.TerminalBuilder
streams(java.io.InputStream in, java.io.OutputStream out)
TerminalBuilder
system(boolean system)
TerminalBuilder
systemOutput(TerminalBuilder.SystemOutput systemOutput)
Indicates which standard stream should be used when displaying to the terminal.static Terminal
terminal()
Returns the default system terminal.TerminalBuilder
type(java.lang.String type)
-
-
-
Field Detail
-
PROP_ENCODING
public static final java.lang.String PROP_ENCODING
- See Also:
- Constant Field Values
-
PROP_CODEPAGE
public static final java.lang.String PROP_CODEPAGE
- See Also:
- Constant Field Values
-
PROP_TYPE
public static final java.lang.String PROP_TYPE
- See Also:
- Constant Field Values
-
PROP_JNA
public static final java.lang.String PROP_JNA
- See Also:
- Constant Field Values
-
PROP_JANSI
public static final java.lang.String PROP_JANSI
- See Also:
- Constant Field Values
-
PROP_EXEC
public static final java.lang.String PROP_EXEC
- See Also:
- Constant Field Values
-
PROP_DUMB
public static final java.lang.String PROP_DUMB
- See Also:
- Constant Field Values
-
PROP_DUMB_COLOR
public static final java.lang.String PROP_DUMB_COLOR
- See Also:
- Constant Field Values
-
PROP_OUTPUT
public static final java.lang.String PROP_OUTPUT
- See Also:
- Constant Field Values
-
PROP_OUTPUT_OUT
public static final java.lang.String PROP_OUTPUT_OUT
- See Also:
- Constant Field Values
-
PROP_OUTPUT_ERR
public static final java.lang.String PROP_OUTPUT_ERR
- See Also:
- Constant Field Values
-
PROP_OUTPUT_OUT_ERR
public static final java.lang.String PROP_OUTPUT_OUT_ERR
- See Also:
- Constant Field Values
-
PROP_OUTPUT_ERR_OUT
public static final java.lang.String PROP_OUTPUT_ERR_OUT
- See Also:
- Constant Field Values
-
PROP_NON_BLOCKING_READS
public static final java.lang.String PROP_NON_BLOCKING_READS
- See Also:
- Constant Field Values
-
PROP_COLOR_DISTANCE
public static final java.lang.String PROP_COLOR_DISTANCE
- See Also:
- Constant Field Values
-
PROP_DISABLE_ALTERNATE_CHARSET
public static final java.lang.String PROP_DISABLE_ALTERNATE_CHARSET
- See Also:
- Constant Field Values
-
SYSTEM_TERMINAL
private static final java.util.concurrent.atomic.AtomicReference<Terminal> SYSTEM_TERMINAL
-
TERMINAL_OVERRIDE
private static final java.util.concurrent.atomic.AtomicReference<Terminal> TERMINAL_OVERRIDE
-
name
private java.lang.String name
-
in
private java.io.InputStream in
-
out
private java.io.OutputStream out
-
type
private java.lang.String type
-
encoding
private java.nio.charset.Charset encoding
-
codepage
private int codepage
-
system
private java.lang.Boolean system
-
systemOutput
private TerminalBuilder.SystemOutput systemOutput
-
jna
private java.lang.Boolean jna
-
jansi
private java.lang.Boolean jansi
-
exec
private java.lang.Boolean exec
-
dumb
private java.lang.Boolean dumb
-
color
private java.lang.Boolean color
-
attributes
private Attributes attributes
-
size
private Size size
-
nativeSignals
private boolean nativeSignals
-
signalHandler
private Terminal.SignalHandler signalHandler
-
paused
private boolean paused
-
UTF8_CODE_PAGE
private static final int UTF8_CODE_PAGE
- See Also:
- Constant Field Values
-
-
Method Detail
-
terminal
public static Terminal terminal() throws java.io.IOException
Returns the default system terminal. Terminals should be closed properly using theCloseable.close()
method in order to restore the original terminal state.This call is equivalent to:
builder().build()
- Returns:
- the default system terminal
- Throws:
java.io.IOException
- if an error occurs
-
builder
public static TerminalBuilder builder()
Creates a new terminal builder instance.- Returns:
- a builder
-
name
public TerminalBuilder name(java.lang.String name)
-
streams
public TerminalBuilder streams(java.io.InputStream in, java.io.OutputStream out)
-
system
public TerminalBuilder system(boolean system)
-
systemOutput
public TerminalBuilder systemOutput(TerminalBuilder.SystemOutput systemOutput)
Indicates which standard stream should be used when displaying to the terminal. The default is to use the system output stream. Building a system terminal will fail if one of the stream specified is not linked to the controlling terminal.- Parameters:
systemOutput
- The mode to choose the output stream.- Returns:
- The builder.
-
jna
public TerminalBuilder jna(boolean jna)
-
jansi
public TerminalBuilder jansi(boolean jansi)
-
exec
public TerminalBuilder exec(boolean exec)
-
dumb
public TerminalBuilder dumb(boolean dumb)
-
type
public TerminalBuilder type(java.lang.String type)
-
color
public TerminalBuilder color(boolean color)
-
encoding
public TerminalBuilder encoding(java.lang.String encoding) throws java.nio.charset.UnsupportedCharsetException
Set the encoding to use for reading/writing from the console. Ifnull
(the default value), JLine will automatically select aCharset
, usually the default system encoding. However, on some platforms (e.g. Windows) it may use a different one depending on theTerminal
implementation.Use
Terminal.encoding()
to get theCharset
that should be used for aTerminal
.- Parameters:
encoding
- The encoding to use or null to automatically select one- Returns:
- The builder
- Throws:
java.nio.charset.UnsupportedCharsetException
- If the given encoding is not supported- See Also:
Terminal.encoding()
-
encoding
public TerminalBuilder encoding(java.nio.charset.Charset encoding)
Set theCharset
to use for reading/writing from the console. Ifnull
(the default value), JLine will automatically select aCharset
, usually the default system encoding. However, on some platforms (e.g. Windows) it may use a different one depending on theTerminal
implementation.Use
Terminal.encoding()
to get theCharset
that should be used to read/write from aTerminal
.- Parameters:
encoding
- The encoding to use or null to automatically select one- Returns:
- The builder
- See Also:
Terminal.encoding()
-
codepage
@Deprecated public TerminalBuilder codepage(int codepage)
Deprecated.JLine now writes Unicode output independently from the selected code page. Using this option will only make it emulate the selected code page forTerminal.input()
andTerminal.output()
.- Parameters:
codepage
- the codepage- Returns:
- The builder
-
attributes
public TerminalBuilder attributes(Attributes attributes)
Attributes to use when creating a non system terminal, i.e. when the builder has been given the input and output streams using thestreams(InputStream, OutputStream)
method or whensystem(boolean)
has been explicitly called withfalse
.- Parameters:
attributes
- the attributes to use- Returns:
- The builder
- See Also:
size(Size)
,system(boolean)
-
size
public TerminalBuilder size(Size size)
Initial size to use when creating a non system terminal, i.e. when the builder has been given the input and output streams using thestreams(InputStream, OutputStream)
method or whensystem(boolean)
has been explicitly called withfalse
.- Parameters:
size
- the initial size- Returns:
- The builder
- See Also:
attributes(Attributes)
,system(boolean)
-
nativeSignals
public TerminalBuilder nativeSignals(boolean nativeSignals)
-
signalHandler
public TerminalBuilder signalHandler(Terminal.SignalHandler signalHandler)
-
paused
public TerminalBuilder paused(boolean paused)
Initial paused state of the terminal (defaults to false). By default, the terminal is started, but in some cases, one might want to make sure the input stream is not consumed before needed, in which case the terminal needs to be created in a paused state.- Parameters:
paused
- the initial paused state- Returns:
- The builder
- See Also:
Terminal.pause()
-
build
public Terminal build() throws java.io.IOException
- Throws:
java.io.IOException
-
doBuild
private Terminal doBuild() throws java.io.IOException
- Throws:
java.io.IOException
-
select
private TerminalProvider.Stream select(java.util.Map<TerminalProvider.Stream,java.lang.Boolean> system, TerminalBuilder.SystemOutput systemOutput)
-
select
private static TerminalProvider.Stream select(java.util.Map<TerminalProvider.Stream,java.lang.Boolean> system, TerminalProvider.Stream... streams)
-
getParentProcessCommand
private static java.lang.String getParentProcessCommand()
-
getBoolean
private static java.lang.Boolean getBoolean(java.lang.String name, java.lang.Boolean def)
-
load
private static <S> S load(java.lang.Class<S> clazz)
-
getCodepageCharset
private static java.nio.charset.Charset getCodepageCharset(int codepage)
-
setTerminalOverride
@Deprecated public static void setTerminalOverride(Terminal terminal)
Deprecated.Allows an application to override the result ofbuild()
. The intended use case is to allow a container or server application to control an embedded application that uses a LineReader that uses Terminal constructed with TerminalBuilder.build but provides no public api for setting theLineReader
of theTerminal
. For example, the sbt build tool uses aLineReader
to implement an interactive shell. One of its supported commands isconsole
which invokes the scala REPL. The scala REPL also uses aLineReader
and it is necessary to override theTerminal
used by the the REPL to share the sameTerminal
instance used by sbt.When this method is called with a non-null
Terminal
, all subsequent calls tobuild()
will return the providedTerminal
regardless of how theTerminalBuilder
was constructed. The default behavior ofTerminalBuilder
can be restored by calling setTerminalOverride with a nullTerminal
Usage of setTerminalOverride should be restricted to cases where it isn't possible to update the api of the nested application to accept a
instance
.- Parameters:
terminal
- theTerminal
to globally override
-
-