org.jline.console

Interface SystemRegistry

All Superinterfaces:

CommandRegistry, ConsoleOptionGetter

All Known Implementing Classes:

SystemRegistryImpl

public interface SystemRegistry
extends CommandRegistry, ConsoleOptionGetter

Aggregate command registries and dispatch command executions.

Author:

Matti Rinta-Nikkola

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	SystemRegistry.Registeries Manage systemRegistry store

Nested classes/interfaces inherited from interface org.jline.console.CommandRegistry

CommandRegistry.CommandSession

Method Summary

Modifier and Type	Method and Description
static void	add(SystemRegistry systemRegistry) Add systemRegistry to the thread map
void	cleanUp() Delete temporary console variables and reset output streams
void	close() Orderly close SystemRegistry.
CmdDesc	commandDescription(CmdLine line) Returns a command, method or syntax description for use in the JLine Widgets framework.
org.jline.reader.Completer	completer() Returns command completer that includes also console variable and script completion.
Object	consoleOption(String name) Return console option value
Object	execute(String line) Execute a command, script or evaluate scriptEngine statement
static SystemRegistry	get()
Collection<String>	getPipeNames()
void	initialize(File script) Initialize consoleEngine environment by executing console script
Object	invoke(String command, Object... args) Execute command with arguments
void	register(String command, CommandRegistry subcommandRegistry) Register subcommand registry
static void	remove() Remove systemRegistry of the current thread from the thread map
void	setCommandRegistries(CommandRegistry... commandRegistries) Set command registeries
org.jline.terminal.Terminal	terminal()
void	trace(boolean stack, Exception exception) Print exception on terminal
void	trace(Exception exception) Print exception on terminal

Methods inherited from interface org.jline.console.CommandRegistry

aggregateCompleters, commandAliases, commandDescription, commandInfo, commandNames, compileCompleters, compileCompleters, hasCommand, invoke, name

Method Detail

setCommandRegistries

void setCommandRegistries(CommandRegistry... commandRegistries)

Set command registeries

Parameters:

commandRegistries - command registeries used by the application

register

void register(String command,
              CommandRegistry subcommandRegistry)

Register subcommand registry

Parameters:

command - main command

subcommandRegistry - subcommand registry

initialize

void initialize(File script)

Initialize consoleEngine environment by executing console script

Parameters:

script - initialization script

getPipeNames

Collection<String> getPipeNames()

Returns:

pipe names defined in systemRegistry

completer

org.jline.reader.Completer completer()

Returns command completer that includes also console variable and script completion.

Returns:

command completer

commandDescription

CmdDesc commandDescription(CmdLine line)

Returns a command, method or syntax description for use in the JLine Widgets framework.

Parameters:

line - command line whose description to return

Returns:

command description for JLine TailTipWidgets to be displayed in the terminal status bar.

execute

Object execute(String line)
        throws Exception

Execute a command, script or evaluate scriptEngine statement

Parameters:

line - command line to be executed

Returns:

execution result

Throws:

Exception - in case of error

cleanUp

void cleanUp()

Delete temporary console variables and reset output streams

trace

void trace(Exception exception)

Print exception on terminal

Parameters:

exception - exception to print on terminal

trace

void trace(boolean stack,
           Exception exception)

Print exception on terminal

Parameters:

stack - print stack trace if stack true otherwise message

exception - exception to be printed

consoleOption

Object consoleOption(String name)

Return console option value

Specified by:

consoleOption in interface ConsoleOptionGetter

Parameters:

name - the option name

Returns:

option value

terminal

org.jline.terminal.Terminal terminal()

Returns:

terminal

invoke

Object invoke(String command,
              Object... args)
       throws Exception

Execute command with arguments

Parameters:

command - command to be executed

args - arguments of the command

Returns:

command execution result

Throws:

Exception - in case of error

close

void close()

Orderly close SystemRegistry.

get

static SystemRegistry get()

Returns:

systemRegistry of the current thread

add

static void add(SystemRegistry systemRegistry)

Add systemRegistry to the thread map

Parameters:

systemRegistry - the systemRegistry

remove

static void remove()

Remove systemRegistry of the current thread from the thread map