org.springframework.shell

Class Shell

java.lang.Object

org.springframework.shell.Shell

public class Shell
extends Object

Main class implementing a shell loop.

Author:

Eric Bottard, Janne Valkealahti

Field Summary

Fields

Modifier and Type	Field and Description
protected List<CompletionResolver>	completionResolvers
static Object	NO_INPUT Marker object returned to signify that there was no input to turn into a command execution.
protected static Object	UNRESOLVED Marker object to distinguish unresolved arguments from null, which is a valid value.

Constructor Summary

Constructors

Constructor and Description
Shell(ResultHandlerService resultHandlerService, CommandCatalog commandRegistry, org.jline.terminal.Terminal terminal, ShellContext shellContext, ExitCodeMappings exitCodeMappings)

Method Summary

Modifier and Type	Method and Description
List<CompletionProposal>	complete(CompletionContext context) Gather completion proposals given some (incomplete) input the user has already typed in.
Object	evaluate(Input input) Evaluate a single "line" of input from the user by trying to map words to a command and arguments.
void	run(InputProvider inputProvider) The main program loop: acquire input, try to match it to a command and evaluate.
void	setArgumentResolvers(CommandExecution.CommandExecutionHandlerMethodArgumentResolvers argumentResolvers)
void	setCompletionResolvers(List<CompletionResolver> resolvers)
void	setConversionService(org.springframework.core.convert.ConversionService shellConversionService)
void	setValidatorFactory(javax.validation.ValidatorFactory validatorFactory)

Methods inherited from class java.lang.Object

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

Field Detail

NO_INPUT

public static final Object NO_INPUT

Marker object returned to signify that there was no input to turn into a command execution.

completionResolvers

protected List<CompletionResolver> completionResolvers

UNRESOLVED

protected static final Object UNRESOLVED

Marker object to distinguish unresolved arguments from null, which is a valid value.

Constructor Detail

Shell

public Shell(ResultHandlerService resultHandlerService,
             CommandCatalog commandRegistry,
             org.jline.terminal.Terminal terminal,
             ShellContext shellContext,
             ExitCodeMappings exitCodeMappings)

Method Detail

setCompletionResolvers

@Autowired
public void setCompletionResolvers(List<CompletionResolver> resolvers)

setArgumentResolvers

@Autowired
public void setArgumentResolvers(CommandExecution.CommandExecutionHandlerMethodArgumentResolvers argumentResolvers)

setConversionService

public void setConversionService(org.springframework.core.convert.ConversionService shellConversionService)

setValidatorFactory

@Autowired(required=false)
public void setValidatorFactory(javax.validation.ValidatorFactory validatorFactory)

run

public void run(InputProvider inputProvider)
         throws Exception

The main program loop: acquire input, try to match it to a command and evaluate. Repeat until a ResultHandler causes the process to exit or there is no input.

This method has public visibility so that it can be invoked by actual commands (e.g. a script command).

Throws:

Exception

evaluate

public Object evaluate(Input input)

Evaluate a single "line" of input from the user by trying to map words to a command and arguments.

This method does not throw exceptions, it catches them and returns them as a regular result

complete

public List<CompletionProposal> complete(CompletionContext context)

Gather completion proposals given some (incomplete) input the user has already typed in. When and how this method is invoked is implementation specific and decided by the actual user interface.