|
Groovy Documentation | |||||||
FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectgrails.build.logging.GrailsConsole
public class GrailsConsole extends java.lang.Object
Utility class for delivering console output in a nicely formatted way.
Field Summary | |
---|---|
static java.lang.String |
CATEGORY_SEPARATOR
|
static java.lang.String |
ENABLE_INTERACTIVE
|
static java.lang.String |
ENABLE_TERMINAL
|
static java.lang.String |
ERROR
|
static java.lang.String |
HISTORYFILE
|
static java.lang.String |
LINE_SEPARATOR
|
static java.lang.String |
PROMPT
|
static java.lang.Character |
SECURE_MASK_CHAR
|
static java.lang.String |
SPACE
|
static java.lang.String |
STACKTRACE_FILTERED_MESSAGE
|
static java.lang.String |
STACKTRACE_MESSAGE
|
static java.lang.String |
WARNING
|
Constructor Summary | |
protected GrailsConsole()
|
Method Summary | |
---|---|
void
|
addStatus(java.lang.String msg)
Keeps doesn't replace the status message |
protected java.io.OutputStream
|
ansiWrap(java.io.OutputStream out)
Hook method that allows controlling whether or not output streams should be wrapped by AnsiConsole.wrapOutputStream. |
void
|
append(java.lang.String msg)
|
protected jline.ConsoleReader
|
createConsoleReader()
|
static GrailsConsole
|
createInstance()
|
protected jline.Terminal
|
createTerminal()
Creates the instance of Terminal used directly in GrailsConsole. |
void
|
echoStatus()
Replays the last status message |
void
|
error(java.lang.String msg)
Prints an error message |
void
|
error(java.lang.String msg, java.lang.Throwable error)
|
void
|
error(java.lang.Throwable error)
Use to log an error |
void
|
error(java.lang.String label, java.lang.String message)
|
void
|
flush()
|
java.util.Stack
|
getCategory()
|
java.io.InputStream
|
getInput()
|
static GrailsConsole
|
getInstance()
|
java.lang.String
|
getLastMessage()
@return The last message logged |
java.io.PrintStream
|
getOut()
|
jline.ConsoleReader
|
getReader()
|
jline.Terminal
|
getTerminal()
|
void
|
indicateProgress()
|
void
|
indicateProgress(int number, int total)
Indicate progress for a number and total |
void
|
indicateProgress(int number)
Indicates progress by number |
void
|
indicateProgressPercentage(long number, long total)
Indicates progress as a percentage for the given number and total |
void
|
info(java.lang.String msg)
Synonym for #log |
boolean
|
isAnsiEnabled()
|
boolean
|
isStacktrace()
|
boolean
|
isVerbose()
|
void
|
log(java.lang.String msg)
Logs a message below the current status message |
protected jline.History
|
prepareHistory()
Prepares a history file to be used by the ConsoleReader. |
java.lang.String
|
secureUserInput(java.lang.String msg)
|
void
|
setAnsiEnabled(boolean ansiEnabled)
|
void
|
setLastMessage(java.lang.String lastMessage)
|
void
|
setStacktrace(boolean stacktrace)
@param stacktrace Sets whether to show stack traces on errors |
void
|
setVerbose(boolean verbose)
@param verbose Sets whether verbose output should be used |
java.lang.String
|
showPrompt()
Shows the prompt to request user input |
void
|
updateStatus(java.lang.String msg)
Updates the current state message |
java.lang.String
|
userInput(java.lang.String msg)
Replacement for AntBuilder.input() to eliminate dependency of GrailsScriptRunner on the Ant libraries. |
java.lang.String
|
userInput(java.lang.String message, java.lang.String[] validResponses)
Replacement for AntBuilder.input() to eliminate dependency of GrailsScriptRunner on the Ant libraries. |
void
|
verbose(java.lang.String msg)
|
void
|
warn(java.lang.String msg)
|
void
|
warning(java.lang.String msg)
|
Methods inherited from class java.lang.Object | |
---|---|
java.lang.Object#wait(), java.lang.Object#wait(long), java.lang.Object#wait(long, int), java.lang.Object#equals(java.lang.Object), java.lang.Object#toString(), java.lang.Object#hashCode(), java.lang.Object#getClass(), java.lang.Object#notify(), java.lang.Object#notifyAll() |
Field Detail |
---|
public static final java.lang.String CATEGORY_SEPARATOR
public static final java.lang.String ENABLE_INTERACTIVE
public static final java.lang.String ENABLE_TERMINAL
public static final java.lang.String ERROR
public static final java.lang.String HISTORYFILE
public static final java.lang.String LINE_SEPARATOR
public static final java.lang.String PROMPT
public static final java.lang.Character SECURE_MASK_CHAR
public static final java.lang.String SPACE
public static final java.lang.String STACKTRACE_FILTERED_MESSAGE
public static final java.lang.String STACKTRACE_MESSAGE
public static final java.lang.String WARNING
Constructor Detail |
---|
protected GrailsConsole()
Method Detail |
---|
public void addStatus(java.lang.String msg)
msg
- The message
protected java.io.OutputStream ansiWrap(tStream(out); java.io.OutputStream out)
public void append(java.lang.String msg)
protected jline.ConsoleReader createConsoleReader()
public static GrailsConsole createInstance()
protected jline.Terminal createTerminal()
public void echoStatus()
public void error(java.lang.String msg)
msg
- The error message
public void error(java.lang.String msg, java.lang.Throwable error)
public void error(java.lang.Throwable error)
error
- The error
public void error(java.lang.String label, java.lang.String message)
public void flush()
public java.util.Stack getCategory()
public java.io.InputStream getInput()
public static GrailsConsole getInstance()
public java.lang.String getLastMessage()
public java.io.PrintStream getOut()
public jline.ConsoleReader getReader()
public jline.Terminal getTerminal()
public void indicateProgress()
public void indicateProgress(int number, int total)
number
- The current numbertotal
- The total number
public void indicateProgress(int number)
number
- The number
public void indicateProgressPercentage(long number, long total)
number
- The numbertotal
- The total
public void info(java.lang.String msg)
msg
- The message to log
public boolean isAnsiEnabled()
public boolean isStacktrace()
public boolean isVerbose()
public void log(java.lang.String msg)
msg
- The message to log
protected jline.History prepareHistory()
public java.lang.String secureUserInput(java.lang.String msg)
public void setAnsiEnabled(boolean ansiEnabled)
public void setLastMessage(java.lang.String lastMessage)
public void setStacktrace(boolean stacktrace)
stacktrace
- Sets whether to show stack traces on errors
public void setVerbose(boolean verbose)
verbose
- Sets whether verbose output should be used
public java.lang.String showPrompt()
public void updateStatus(java.lang.String msg)
msg
- The message
public java.lang.String userInput(java.lang.String msg)
msg
- The message/question to display.
public java.lang.String userInput(java.lang.String message, java.lang.String[] validResponses)
null
.
message
- The message/question to display.validResponses
- An array of responses that the user is
allowed to enter. Displayed after the message.null
if the user never entered a valid string.
public void verbose(java.lang.String msg)
public void warn(java.lang.String msg)
public void warning(java.lang.String msg)
Groovy Documentation