public class ConsoleReader
extends java.lang.Object
implements java.io.Closeable
Terminal.init()
for convenience
methods for issuing platform-specific setup commands.Modifier and Type | Field and Description |
---|---|
static char |
BACKSPACE |
static java.lang.String |
DEFAULT_INPUT_RC |
static java.lang.String |
INPUT_RC |
static java.lang.String |
JLINE_COMPLETION_THRESHOLD |
static java.lang.String |
JLINE_ESC_TIMEOUT |
static java.lang.String |
JLINE_EXPAND_EVENTS |
static java.lang.String |
JLINE_INPUTRC |
static java.lang.String |
JLINE_NOBELL |
static char |
KEYBOARD_BELL |
static char |
NULL_MASK |
static char |
RESET_LINE |
static int |
TAB_WIDTH |
Constructor and Description |
---|
ConsoleReader() |
ConsoleReader(java.io.InputStream in,
java.io.OutputStream out) |
ConsoleReader(java.io.InputStream in,
java.io.OutputStream out,
Terminal term) |
ConsoleReader(java.lang.String appName,
java.io.InputStream in,
java.io.OutputStream out,
Terminal term) |
ConsoleReader(java.lang.String appName,
java.io.InputStream in,
java.io.OutputStream out,
Terminal term,
java.lang.String encoding) |
Modifier and Type | Method and Description |
---|---|
java.lang.String |
accept()
The equivalent of hitting <RET>.
|
boolean |
addCompleter(Completer completer)
Add the specified
Completer to the list of handlers for tab-completion. |
void |
addTriggeredAction(char c,
java.awt.event.ActionListener listener)
Adding a triggered Action allows to give another curse of action if a character passed the pre-processing.
|
protected void |
back(int num)
Move the visual cursor backward without modifying the buffer cursor.
|
boolean |
backspace()
Issue a backspace.
|
void |
beep()
Issue an audible keyboard bell.
|
boolean |
clearScreen()
Clear the screen by issuing the ANSI "clear screen" code.
|
void |
close()
Shuts the console reader down.
|
protected boolean |
complete()
Use the completers to modify the buffer with the appropriate completions.
|
boolean |
delete()
Issue a delete.
|
void |
drawLine()
Output put the prompt + the current buffer
|
protected java.lang.String |
expandEvents(java.lang.String str)
Expand event designator such as !!
|
protected void |
finalize()
Shuts down the ConsoleReader if the JVM attempts to clean it up.
|
void |
flush()
Flush the console output stream.
|
int |
getAutoprintThreshold() |
boolean |
getBellEnabled()
Get whether the console bell is enabled
|
java.lang.String |
getCommentBegin() |
java.util.Collection<Completer> |
getCompleters()
Returns an unmodifiable list of all the completers.
|
CompletionHandler |
getCompletionHandler() |
CursorBuffer |
getCursorBuffer() |
java.lang.Character |
getEchoCharacter()
Returns the echo character.
|
boolean |
getExpandEvents() |
boolean |
getHandleLitteralNext()
Get wether literal next are handled by JLine.
|
boolean |
getHandleUserInterrupt()
Get whether user interrupt handling is enabled
|
History |
getHistory() |
java.io.InputStream |
getInput() |
static java.net.URL |
getInputRc()
Retrieve the URL for the inputrc configuration file in effect.
|
java.lang.String |
getKeyMap()
Returns the name of the current key mapping.
|
KeyMap |
getKeys() |
java.lang.String |
getLastBinding() |
java.io.Writer |
getOutput() |
java.lang.String |
getPrompt() |
Terminal |
getTerminal() |
boolean |
isCopyPasteDetectionEnabled() |
boolean |
isHistoryEnabled()
Whether or not to add new commands to the history buffer.
|
boolean |
isKeyMap(java.lang.String name) |
boolean |
isPaginationEnabled()
Whether to use pagination when the number of rows of candidates exceeds the height of the terminal.
|
boolean |
killLine()
Kill the buffer ahead of the current cursor position.
|
int |
moveCursor(int num)
Move the cursor where characters.
|
protected boolean |
moveToEnd() |
boolean |
paste()
Paste the contents of the clipboard into the console buffer
|
void |
print(java.lang.CharSequence s)
Output the specified string to the output stream (but not the buffer).
|
void |
printColumns(java.util.Collection<? extends java.lang.CharSequence> items)
Output the specified
Collection in proper columns. |
protected void |
printCompletionCandidates() |
void |
printForwardSearchStatus(java.lang.String searchTerm,
java.lang.String match) |
void |
println()
Output a platform-dependant newline.
|
void |
println(java.lang.CharSequence s) |
void |
printSearchStatus(java.lang.String searchTerm,
java.lang.String match) |
void |
putString(java.lang.CharSequence str)
Write out the specified string to the buffer and the output stream.
|
java.lang.Object |
readBinding(KeyMap keys)
Read from the input stream and decode an operation from the key map.
|
int |
readCharacter()
Read a character from the console.
|
int |
readCharacter(boolean checkForAltKeyCombo)
Read a character from the console.
|
int |
readCharacter(boolean checkForAltKeyCombo,
char... allowed) |
int |
readCharacter(char... allowed) |
java.lang.String |
readLine()
Read the next line and return the contents of the buffer.
|
java.lang.String |
readLine(java.lang.Character mask)
Read the next line with the specified character mask.
|
java.lang.String |
readLine(java.lang.String prompt) |
java.lang.String |
readLine(java.lang.String prompt,
java.lang.Character mask)
Read a line from the in
InputStream , and return the line
(without any trailing newlines). |
java.lang.String |
readLine(java.lang.String prompt,
java.lang.Character mask,
java.lang.String buffer)
Read a line from the in
InputStream , and return the line
(without any trailing newlines). |
void |
redrawLine()
Clear the line and redraw it.
|
boolean |
removeCompleter(Completer completer)
Remove the specified
Completer from the list of handlers for tab-completion. |
protected boolean |
resetLine()
Erase the current line.
|
void |
resetPromptLine(java.lang.String prompt,
java.lang.String buffer,
int cursorDest)
Erases the current line with the existing prompt, then redraws the line
with the provided prompt and buffer
|
void |
restoreLine(java.lang.String originalPrompt,
int cursorDest) |
int |
searchBackwards(java.lang.String searchTerm)
Search backwards in history from the current position.
|
int |
searchBackwards(java.lang.String searchTerm,
int startIndex)
Search backward in history from a given position.
|
int |
searchBackwards(java.lang.String searchTerm,
int startIndex,
boolean startsWith) |
int |
searchForwards(java.lang.String searchTerm)
Search forwards in history from the current position.
|
int |
searchForwards(java.lang.String searchTerm,
int startIndex)
Search forward in history from a given position.
|
int |
searchForwards(java.lang.String searchTerm,
int startIndex,
boolean startsWith) |
void |
setAutoprintThreshold(int threshold) |
void |
setBellEnabled(boolean enabled)
Set whether the console bell is enabled.
|
void |
setCommentBegin(java.lang.String commentBegin)
Sets the string that will be used to start a comment when the
insert-comment key is struck.
|
void |
setCompletionHandler(CompletionHandler handler) |
void |
setCopyPasteDetection(boolean onoff)
Enables or disables copy and paste detection.
|
boolean |
setCursorPosition(int position)
Move the cursor position to the specified absolute index.
|
void |
setEchoCharacter(java.lang.Character c)
Set the echo character.
|
void |
setExpandEvents(boolean expand) |
void |
setHandleLitteralNext(boolean handleLitteralNext)
Set wether literal next are handled by JLine.
|
void |
setHandleUserInterrupt(boolean enabled)
Set whether user interrupts (ctrl-C) are handled by having JLine
throw
UserInterruptException from readLine() . |
void |
setHistory(History history) |
void |
setHistoryEnabled(boolean enabled)
Whether or not to add new commands to the history buffer.
|
boolean |
setKeyMap(java.lang.String name)
Sets the current keymap by name.
|
void |
setPaginationEnabled(boolean enabled)
Whether to use pagination when the number of rows of candidates exceeds the height of the terminal.
|
void |
setParenBlinkTimeout(int timeout) |
void |
setPrompt(java.lang.String prompt) |
void |
shutdown()
Deprecated.
Use
close() instead. |
boolean |
yank() |
boolean |
yankPop() |
public static final java.lang.String JLINE_NOBELL
public static final java.lang.String JLINE_ESC_TIMEOUT
public static final java.lang.String JLINE_INPUTRC
public static final java.lang.String INPUT_RC
public static final java.lang.String DEFAULT_INPUT_RC
public static final java.lang.String JLINE_EXPAND_EVENTS
public static final char BACKSPACE
public static final char RESET_LINE
public static final char KEYBOARD_BELL
public static final char NULL_MASK
public static final int TAB_WIDTH
public static final java.lang.String JLINE_COMPLETION_THRESHOLD
public ConsoleReader() throws java.io.IOException
java.io.IOException
public ConsoleReader(java.io.InputStream in, java.io.OutputStream out) throws java.io.IOException
java.io.IOException
public ConsoleReader(java.io.InputStream in, java.io.OutputStream out, Terminal term) throws java.io.IOException
java.io.IOException
public ConsoleReader(@Nullable java.lang.String appName, java.io.InputStream in, java.io.OutputStream out, @Nullable Terminal term) throws java.io.IOException
java.io.IOException
public static java.net.URL getInputRc() throws java.io.IOException
java.io.IOException
public KeyMap getKeys()
public void close()
close
in interface java.io.Closeable
close
in interface java.lang.AutoCloseable
@Deprecated public void shutdown()
close()
instead.close()
.protected void finalize() throws java.lang.Throwable
finalize
in class java.lang.Object
java.lang.Throwable
public java.io.InputStream getInput()
public java.io.Writer getOutput()
public Terminal getTerminal()
public CursorBuffer getCursorBuffer()
public void setExpandEvents(boolean expand)
public boolean getExpandEvents()
public void setCopyPasteDetection(boolean onoff)
onoff
- true if detection is enabledpublic boolean isCopyPasteDetectionEnabled()
public void setBellEnabled(boolean enabled)
enabled
- true if enabled; false otherwisepublic boolean getBellEnabled()
public void setHandleUserInterrupt(boolean enabled)
UserInterruptException
from readLine()
.
Otherwise, the JVM will handle SIGINT
as normal, which
usually causes it to exit. The default is false
.public boolean getHandleUserInterrupt()
public void setHandleLitteralNext(boolean handleLitteralNext)
public boolean getHandleLitteralNext()
public void setCommentBegin(java.lang.String commentBegin)
commentBegin
- The begin comment string.public java.lang.String getCommentBegin()
public void setPrompt(java.lang.String prompt)
public java.lang.String getPrompt()
public void setEchoCharacter(java.lang.Character c)
myConsoleReader.setEchoCharacter(new Character('*'));Setting the character to
null
will restore normal character echoing.
Setting the character to Character.valueOf(0)
will cause nothing to be echoed.c
- the character to echo to the console in place of the typed character.public java.lang.Character getEchoCharacter()
protected final boolean resetLine() throws java.io.IOException
java.io.IOException
public boolean setCursorPosition(int position) throws java.io.IOException
java.io.IOException
public void drawLine() throws java.io.IOException
java.io.IOException
public void redrawLine() throws java.io.IOException
java.io.IOException
protected java.lang.String expandEvents(java.lang.String str) throws java.io.IOException
java.io.IOException
public void putString(java.lang.CharSequence str) throws java.io.IOException
java.io.IOException
protected void back(int num) throws java.io.IOException
java.io.IOException
public void flush() throws java.io.IOException
java.io.IOException
public boolean backspace() throws java.io.IOException
java.io.IOException
protected boolean moveToEnd() throws java.io.IOException
java.io.IOException
public void setParenBlinkTimeout(int timeout)
public boolean isKeyMap(java.lang.String name)
public java.lang.String accept() throws java.io.IOException
java.io.IOException
public int moveCursor(int num) throws java.io.IOException
num
- If less than 0, move abs(where) to the left, otherwise move where to the right.java.io.IOException
public int readCharacter() throws java.io.IOException
java.io.IOException
public int readCharacter(boolean checkForAltKeyCombo) throws java.io.IOException
java.io.IOException
public int readCharacter(char... allowed) throws java.io.IOException
java.io.IOException
public int readCharacter(boolean checkForAltKeyCombo, char... allowed) throws java.io.IOException
java.io.IOException
public java.lang.Object readBinding(KeyMap keys) throws java.io.IOException
keys
- the KeyMap to use for decoding the input streamnull
if the end of
stream has been reachedjava.io.IOException
public java.lang.String getLastBinding()
public java.lang.String readLine() throws java.io.IOException
java.io.IOException
public java.lang.String readLine(java.lang.Character mask) throws java.io.IOException
java.io.IOException
public java.lang.String readLine(java.lang.String prompt) throws java.io.IOException
java.io.IOException
public java.lang.String readLine(java.lang.String prompt, java.lang.Character mask) throws java.io.IOException
InputStream
, and return the line
(without any trailing newlines).prompt
- The prompt to issue to the console, may be null.java.io.IOException
public boolean setKeyMap(java.lang.String name)
name
- The name of the keymap to switch topublic java.lang.String getKeyMap()
setKeyMap(String)
.public java.lang.String readLine(java.lang.String prompt, java.lang.Character mask, java.lang.String buffer) throws java.io.IOException
InputStream
, and return the line
(without any trailing newlines).prompt
- The prompt to issue to the console, may be null.java.io.IOException
public boolean addCompleter(Completer completer)
Completer
to the list of handlers for tab-completion.completer
- the Completer
to addpublic boolean removeCompleter(Completer completer)
Completer
from the list of handlers for tab-completion.completer
- The Completer
to removepublic java.util.Collection<Completer> getCompleters()
public void setCompletionHandler(CompletionHandler handler)
public CompletionHandler getCompletionHandler()
protected boolean complete() throws java.io.IOException
java.io.IOException
protected void printCompletionCandidates() throws java.io.IOException
java.io.IOException
public void setAutoprintThreshold(int threshold)
threshold
- the number of candidates to print without issuing a warning.public int getAutoprintThreshold()
public void setPaginationEnabled(boolean enabled)
public boolean isPaginationEnabled()
public void setHistory(History history)
public History getHistory()
public void setHistoryEnabled(boolean enabled)
public boolean isHistoryEnabled()
public void print(java.lang.CharSequence s) throws java.io.IOException
java.io.IOException
public void println(java.lang.CharSequence s) throws java.io.IOException
java.io.IOException
public void println() throws java.io.IOException
java.io.IOException
public boolean delete() throws java.io.IOException
java.io.IOException
public boolean killLine() throws java.io.IOException
java.io.IOException
public boolean yank() throws java.io.IOException
java.io.IOException
public boolean yankPop() throws java.io.IOException
java.io.IOException
public boolean clearScreen() throws java.io.IOException
java.io.IOException
public void beep() throws java.io.IOException
java.io.IOException
public boolean paste() throws java.io.IOException
java.io.IOException
public void addTriggeredAction(char c, java.awt.event.ActionListener listener)
public void printColumns(java.util.Collection<? extends java.lang.CharSequence> items) throws java.io.IOException
Collection
in proper columns.java.io.IOException
public void resetPromptLine(java.lang.String prompt, java.lang.String buffer, int cursorDest) throws java.io.IOException
prompt
- the new promptbuffer
- the buffer to be drawncursorDest
- where you want the cursor set when the line has been drawn.
-1 for end of line.java.io.IOException
public void printSearchStatus(java.lang.String searchTerm, java.lang.String match) throws java.io.IOException
java.io.IOException
public void printForwardSearchStatus(java.lang.String searchTerm, java.lang.String match) throws java.io.IOException
java.io.IOException
public void restoreLine(java.lang.String originalPrompt, int cursorDest) throws java.io.IOException
java.io.IOException
public int searchBackwards(java.lang.String searchTerm, int startIndex)
searchTerm
- substring to search for.startIndex
- the index from which on to searchpublic int searchBackwards(java.lang.String searchTerm)
searchTerm
- substring to search for.public int searchBackwards(java.lang.String searchTerm, int startIndex, boolean startsWith)
public int searchForwards(java.lang.String searchTerm, int startIndex)
searchTerm
- substring to search for.startIndex
- the index from which on to searchpublic int searchForwards(java.lang.String searchTerm)
searchTerm
- substring to search for.public int searchForwards(java.lang.String searchTerm, int startIndex, boolean startsWith)
Copyright © 2018. All Rights Reserved.