Class JansiTerminalProvider
- java.lang.Object
-
- org.jline.terminal.impl.jansi.JansiTerminalProvider
-
- All Implemented Interfaces:
TerminalProvider
public class JansiTerminalProvider extends java.lang.Object implements TerminalProvider
-
-
Constructor Summary
Constructors Constructor Description JansiTerminalProvider()
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description Ptycurrent(SystemStream systemStream)static intgetJansiMajorVersion()static intgetJansiMinorVersion()static booleanisAtLeast(int major, int minor)booleanisSystemStream(SystemStream stream)Checks if the specified system stream is available on this platform.java.lang.Stringname()Returns the name of this terminal provider.TerminalnewTerminal(java.lang.String name, java.lang.String type, java.io.InputStream in, java.io.OutputStream out, java.nio.charset.Charset encoding, java.nio.charset.Charset stdinEncoding, java.nio.charset.Charset stdoutEncoding, java.nio.charset.Charset stderrEncoding, Terminal.SignalHandler signalHandler, boolean paused, Attributes attributes, Size size)Deprecated.TerminalnewTerminal(java.lang.String name, java.lang.String type, java.io.InputStream in, java.io.OutputStream out, java.nio.charset.Charset encoding, java.nio.charset.Charset inputEncoding, java.nio.charset.Charset outputEncoding, Terminal.SignalHandler signalHandler, boolean paused, Attributes attributes, Size size)Creates a new terminal with custom input and output streams.Ptyopen(Attributes attributes, Size size)TerminalposixSysTerminal(java.lang.String name, java.lang.String type, boolean ansiPassThrough, java.nio.charset.Charset encoding, boolean nativeSignals, Terminal.SignalHandler signalHandler, boolean paused, SystemStream systemStream)TerminalposixSysTerminal(java.lang.String name, java.lang.String type, boolean ansiPassThrough, java.nio.charset.Charset encoding, java.nio.charset.Charset stdinEncoding, java.nio.charset.Charset stdoutEncoding, java.nio.charset.Charset stderrEncoding, boolean nativeSignals, Terminal.SignalHandler signalHandler, boolean paused, SystemStream systemStream)java.lang.StringsystemStreamName(SystemStream stream)Returns the name of the specified system stream on this platform.intsystemStreamWidth(SystemStream stream)Returns the width (number of columns) of the specified system stream.TerminalsysTerminal(java.lang.String name, java.lang.String type, boolean ansiPassThrough, java.nio.charset.Charset encoding, java.nio.charset.Charset inputEncoding, java.nio.charset.Charset outputEncoding, boolean nativeSignals, Terminal.SignalHandler signalHandler, boolean paused, SystemStream systemStream)Creates a terminal connected to a system stream.TerminalsysTerminal(java.lang.String name, java.lang.String type, boolean ansiPassThrough, java.nio.charset.Charset encoding, java.nio.charset.Charset stdinEncoding, java.nio.charset.Charset stdoutEncoding, java.nio.charset.Charset stderrEncoding, boolean nativeSignals, Terminal.SignalHandler signalHandler, boolean paused, SystemStream systemStream)Deprecated.java.lang.StringtoString()static voidverifyAtLeast(int major, int minor)TerminalwinSysTerminal(java.lang.String name, java.lang.String type, boolean ansiPassThrough, java.nio.charset.Charset encoding, boolean nativeSignals, Terminal.SignalHandler signalHandler, boolean paused, SystemStream systemStream)TerminalwinSysTerminal(java.lang.String name, java.lang.String type, boolean ansiPassThrough, java.nio.charset.Charset encoding, java.nio.charset.Charset stdinEncoding, java.nio.charset.Charset stdoutEncoding, java.nio.charset.Charset stderrEncoding, boolean nativeSignals, Terminal.SignalHandler signalHandler, boolean paused, SystemStream systemStream)-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface org.jline.terminal.spi.TerminalProvider
getConsoleCodepage, newTerminal, sysTerminal
-
-
-
-
Method Detail
-
getJansiMajorVersion
public static int getJansiMajorVersion()
-
getJansiMinorVersion
public static int getJansiMinorVersion()
-
isAtLeast
public static boolean isAtLeast(int major, int minor)
-
verifyAtLeast
public static void verifyAtLeast(int major, int minor)
-
name
public java.lang.String name()
Description copied from interface:TerminalProviderReturns the name of this terminal provider.The provider name is a unique identifier that can be used to request this specific provider when creating terminals. Common provider names include "ffm", "jni", "jansi", "jna", "exec", and "dumb".
- Specified by:
namein interfaceTerminalProvider- Returns:
- the name of this terminal provider
-
current
public Pty current(SystemStream systemStream) throws java.io.IOException
- Throws:
java.io.IOException
-
open
public Pty open(Attributes attributes, Size size) throws java.io.IOException
- Throws:
java.io.IOException
-
sysTerminal
public Terminal sysTerminal(java.lang.String name, java.lang.String type, boolean ansiPassThrough, java.nio.charset.Charset encoding, java.nio.charset.Charset inputEncoding, java.nio.charset.Charset outputEncoding, boolean nativeSignals, Terminal.SignalHandler signalHandler, boolean paused, SystemStream systemStream) throws java.io.IOException
Description copied from interface:TerminalProviderCreates a terminal connected to a system stream.This method creates a terminal that is connected to one of the standard system streams (standard input, standard output, or standard error). Such terminals typically represent the actual terminal window or console that the application is running in.
- Specified by:
sysTerminalin interfaceTerminalProvider- Parameters:
name- the name of the terminaltype- the terminal type (e.g., "xterm", "dumb")ansiPassThrough- whether to pass through ANSI escape sequencesencoding- the general character encoding to useinputEncoding- the character encoding to use for inputoutputEncoding- the character encoding to use for outputnativeSignals- whether to use native signal handlingsignalHandler- the signal handler to usepaused- whether the terminal should start in a paused statesystemStream- the system stream to connect to- Returns:
- a new terminal connected to the specified system stream
- Throws:
java.io.IOException- if an I/O error occurs
-
sysTerminal
@Deprecated public Terminal sysTerminal(java.lang.String name, java.lang.String type, boolean ansiPassThrough, java.nio.charset.Charset encoding, java.nio.charset.Charset stdinEncoding, java.nio.charset.Charset stdoutEncoding, java.nio.charset.Charset stderrEncoding, boolean nativeSignals, Terminal.SignalHandler signalHandler, boolean paused, SystemStream systemStream) throws java.io.IOException
Deprecated.Description copied from interface:TerminalProviderCreates a terminal connected to a system stream.This method creates a terminal that is connected to one of the standard system streams (standard input, standard output, or standard error). Such terminals typically represent the actual terminal window or console that the application is running in.
- Specified by:
sysTerminalin interfaceTerminalProvider- Parameters:
name- the name of the terminaltype- the terminal type (e.g., "xterm", "dumb")ansiPassThrough- whether to pass through ANSI escape sequencesencoding- the general character encoding to usestdinEncoding- the character encoding to use for standard inputstdoutEncoding- the character encoding to use for standard outputstderrEncoding- the character encoding to use for standard errornativeSignals- whether to use native signal handlingsignalHandler- the signal handler to usepaused- whether the terminal should start in a paused statesystemStream- the system stream to connect to- Returns:
- a new terminal connected to the specified system stream
- Throws:
java.io.IOException- if an I/O error occurs
-
winSysTerminal
public Terminal winSysTerminal(java.lang.String name, java.lang.String type, boolean ansiPassThrough, java.nio.charset.Charset encoding, boolean nativeSignals, Terminal.SignalHandler signalHandler, boolean paused, SystemStream systemStream) throws java.io.IOException
- Throws:
java.io.IOException
-
winSysTerminal
public Terminal winSysTerminal(java.lang.String name, java.lang.String type, boolean ansiPassThrough, java.nio.charset.Charset encoding, java.nio.charset.Charset stdinEncoding, java.nio.charset.Charset stdoutEncoding, java.nio.charset.Charset stderrEncoding, boolean nativeSignals, Terminal.SignalHandler signalHandler, boolean paused, SystemStream systemStream) throws java.io.IOException
- Throws:
java.io.IOException
-
posixSysTerminal
public Terminal posixSysTerminal(java.lang.String name, java.lang.String type, boolean ansiPassThrough, java.nio.charset.Charset encoding, boolean nativeSignals, Terminal.SignalHandler signalHandler, boolean paused, SystemStream systemStream) throws java.io.IOException
- Throws:
java.io.IOException
-
posixSysTerminal
public Terminal posixSysTerminal(java.lang.String name, java.lang.String type, boolean ansiPassThrough, java.nio.charset.Charset encoding, java.nio.charset.Charset stdinEncoding, java.nio.charset.Charset stdoutEncoding, java.nio.charset.Charset stderrEncoding, boolean nativeSignals, Terminal.SignalHandler signalHandler, boolean paused, SystemStream systemStream) throws java.io.IOException
- Throws:
java.io.IOException
-
newTerminal
public Terminal newTerminal(java.lang.String name, java.lang.String type, java.io.InputStream in, java.io.OutputStream out, java.nio.charset.Charset encoding, java.nio.charset.Charset inputEncoding, java.nio.charset.Charset outputEncoding, Terminal.SignalHandler signalHandler, boolean paused, Attributes attributes, Size size) throws java.io.IOException
Description copied from interface:TerminalProviderCreates a new terminal with custom input and output streams.This method creates a terminal that is connected to the specified input and output streams. Such terminals can be used for various purposes, such as connecting to remote terminals over network connections or creating virtual terminals for testing.
- Specified by:
newTerminalin interfaceTerminalProvider- Parameters:
name- the name of the terminaltype- the terminal type (e.g., "xterm", "dumb")in- the input stream to read fromout- the output stream to write toencoding- the general character encoding to useinputEncoding- the character encoding to use for inputoutputEncoding- the character encoding to use for outputsignalHandler- the signal handler to usepaused- whether the terminal should start in a paused stateattributes- the initial terminal attributessize- the initial terminal size- Returns:
- a new terminal connected to the specified streams
- Throws:
java.io.IOException- if an I/O error occurs
-
newTerminal
@Deprecated public Terminal newTerminal(java.lang.String name, java.lang.String type, java.io.InputStream in, java.io.OutputStream out, java.nio.charset.Charset encoding, java.nio.charset.Charset stdinEncoding, java.nio.charset.Charset stdoutEncoding, java.nio.charset.Charset stderrEncoding, Terminal.SignalHandler signalHandler, boolean paused, Attributes attributes, Size size) throws java.io.IOException
Deprecated.Description copied from interface:TerminalProviderCreates a new terminal with custom input and output streams.This method creates a terminal that is connected to the specified input and output streams. Such terminals can be used for various purposes, such as connecting to remote terminals over network connections or creating virtual terminals for testing.
- Specified by:
newTerminalin interfaceTerminalProvider- Parameters:
name- the name of the terminaltype- the terminal type (e.g., "xterm", "dumb")in- the input stream to read fromout- the output stream to write toencoding- the general character encoding to usestdinEncoding- the character encoding to use for standard inputstdoutEncoding- the character encoding to use for standard outputstderrEncoding- the character encoding to use for standard errorsignalHandler- the signal handler to usepaused- whether the terminal should start in a paused stateattributes- the initial terminal attributessize- the initial terminal size- Returns:
- a new terminal connected to the specified streams
- Throws:
java.io.IOException- if an I/O error occurs
-
isSystemStream
public boolean isSystemStream(SystemStream stream)
Description copied from interface:TerminalProviderChecks if the specified system stream is available on this platform.This method determines whether the specified system stream (standard input, standard output, or standard error) is available for use on the current platform. Some platforms or environments may restrict access to certain system streams.
- Specified by:
isSystemStreamin interfaceTerminalProvider- Parameters:
stream- the system stream to check- Returns:
trueif the system stream is available,falseotherwise
-
systemStreamName
public java.lang.String systemStreamName(SystemStream stream)
Description copied from interface:TerminalProviderReturns the name of the specified system stream on this platform.This method returns a platform-specific name or identifier for the specified system stream. The name may be used for display purposes or for accessing the stream through platform-specific APIs.
- Specified by:
systemStreamNamein interfaceTerminalProvider- Parameters:
stream- the system stream- Returns:
- the name of the system stream on this platform
-
systemStreamWidth
public int systemStreamWidth(SystemStream stream)
Description copied from interface:TerminalProviderReturns the width (number of columns) of the specified system stream.This method determines the width of the terminal associated with the specified system stream. The width is measured in character cells and represents the number of columns available for display.
- Specified by:
systemStreamWidthin interfaceTerminalProvider- Parameters:
stream- the system stream- Returns:
- the width of the system stream in character columns
-
toString
public java.lang.String toString()
- Overrides:
toStringin classjava.lang.Object
-
-