Class WindowsTerminal

java.lang.Object

jline.TerminalSupport

jline.WindowsTerminal

All Implemented Interfaces:

Terminal

Direct Known Subclasses:

AnsiWindowsTerminal

public class WindowsTerminal
extends TerminalSupport

Terminal implementation for Microsoft Windows. Terminal initialization in init() is accomplished by extracting the jline_version.dll, saving it to the system temporary directoy (determined by the setting of the java.io.tmpdir System property), loading the library, and then calling the Win32 APIs SetConsoleMode and GetConsoleMode to disable character echoing.

By default, the wrapInIfNeeded(java.io.InputStream) method will attempt to test to see if the specified InputStream is System.in or a wrapper around FileDescriptor.in, and if so, will bypass the character reading to directly invoke the readc() method in the JNI library. This is so the class can read special keys (like arrow keys) which are otherwise inaccessible via the System.in stream. Using JNI reading can be bypassed by setting the jline.WindowsTerminal.directConsole system property to false.

Since:

2.0

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	WindowsTerminal.ConsoleMode	Console mode

Field Summary

Fields

Modifier and Type	Field	Description
static final String	ANSI
static final String	DIRECT_CONSOLE
private boolean	directConsole
private int	originalMode

Fields inherited from class TerminalSupport

DEFAULT_HEIGHT, DEFAULT_WIDTH

Constructor Summary

Constructors

Constructor	Description
WindowsTerminal()

Method Summary

Modifier and Type	Method	Description
void	disableInterruptCharacter()
void	enableInterruptCharacter()
private static int	getConsoleMode()
private static int	getConsoleOutputCodepage()
Boolean	getDirectConsole()	Whether or not to allow the use of the JNI console interaction.
int	getHeight()
String	getOutputEncoding()
int	getWidth()
private static int	getWindowsTerminalHeight()
private static int	getWindowsTerminalWidth()
void	init()
protected boolean	isSystemIn(InputStream in)
private byte[]	readConsoleInput()
void	restore()	Restore the original terminal configuration, which can be used when shutting down the console reader.
private static void	setConsoleMode(int mode)
void	setDirectConsole(boolean flag)	Whether or not to allow the use of the JNI console interaction.
void	setEchoEnabled(boolean enabled)
InputStream	wrapInIfNeeded(InputStream in)	When using native support, return the InputStream to use for reading characters else return the input stream passed as a parameter.

Methods inherited from class TerminalSupport

hasWeirdWrap, isAnsiSupported, isEchoEnabled, isSupported, reset, setAnsiSupported, wrapOutIfNeeded

Methods inherited from class Object

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

Field Details

DIRECT_CONSOLE

public static final String DIRECT_CONSOLE

ANSI

public static final String ANSI

directConsole

private boolean directConsole

originalMode

private int originalMode

Constructor Details

WindowsTerminal

public WindowsTerminal()
                throws Exception

Throws:

Exception

Method Details

init

public void init()
          throws Exception

Specified by:

init in interface Terminal

Overrides:

init in class TerminalSupport

Throws:

Exception

restore

public void restore()
             throws Exception

Restore the original terminal configuration, which can be used when shutting down the console reader. The ConsoleReader cannot be used after calling this method.

Specified by:

restore in interface Terminal

Overrides:

restore in class TerminalSupport

Throws:

Exception

getWidth

public int getWidth()

Specified by:

getWidth in interface Terminal

Overrides:

getWidth in class TerminalSupport

getHeight

public int getHeight()

Specified by:

getHeight in interface Terminal

Overrides:

getHeight in class TerminalSupport

setEchoEnabled

public void setEchoEnabled(boolean enabled)

Specified by:

setEchoEnabled in interface Terminal

Overrides:

setEchoEnabled in class TerminalSupport

disableInterruptCharacter

public void disableInterruptCharacter()

Specified by:

disableInterruptCharacter in interface Terminal

Overrides:

disableInterruptCharacter in class TerminalSupport

enableInterruptCharacter

public void enableInterruptCharacter()

Specified by:

enableInterruptCharacter in interface Terminal

Overrides:

enableInterruptCharacter in class TerminalSupport

setDirectConsole

public void setDirectConsole(boolean flag)

Whether or not to allow the use of the JNI console interaction.

getDirectConsole

public Boolean getDirectConsole()

Whether or not to allow the use of the JNI console interaction.

wrapInIfNeeded

public InputStream wrapInIfNeeded(InputStream in)
                           throws IOException

Description copied from interface: Terminal

When using native support, return the InputStream to use for reading characters else return the input stream passed as a parameter.

Specified by:

wrapInIfNeeded in interface Terminal

Overrides:

wrapInIfNeeded in class TerminalSupport

Throws:

IOException

isSystemIn

protected boolean isSystemIn(InputStream in)
                      throws IOException

Throws:

IOException

getOutputEncoding

public String getOutputEncoding()

Specified by:

getOutputEncoding in interface Terminal

Overrides:

getOutputEncoding in class TerminalSupport

getConsoleMode

private static int getConsoleMode()

setConsoleMode

private static void setConsoleMode(int mode)

readConsoleInput

private byte[] readConsoleInput()

getConsoleOutputCodepage

private static int getConsoleOutputCodepage()

getWindowsTerminalWidth

private static int getWindowsTerminalWidth()

getWindowsTerminalHeight

private static int getWindowsTerminalHeight()