org.beryx.textio.web

Class WebTextTerminal

java.lang.Object

org.beryx.textio.web.WebTextTerminal

All Implemented Interfaces:

TextTerminal, DataApi

public class WebTextTerminal
extends Object
implements TextTerminal, DataApi

A TextTerminal that allows accessing the application via a browser. It works only in conjunction with a web server supporting the DataApi (such as SparkDataServer) and a web component that accesses this API (typically via textterm.js).

Field Summary

Fields

Modifier and Type	Field and Description
static long	DEFAULT_TIMEOUT_HAS_ACTION
static long	DEFAULT_TIMEOUT_NOT_EMPTY

Constructor Summary

Constructors

Constructor and Description
WebTextTerminal()

Method Summary

Modifier and Type	Method and Description
void	dispose() This method is typically called at the end of a text-based input/output session in order to allow the terminal to release its screen resources.
TextTerminalData	getTextTerminalData() This method is called by the web component while polling for data
void	postUserInput(String newInput) This method is called by the web component to post the user input
void	println() Terminates the current line by writing the line separator string.
void	rawPrint(String message) Prints the message in its raw form.
String	read(boolean masking) Reads a line of text
protected void	setAction(TextTerminalData.Action action)
void	setOnDispose(Runnable onDispose)
void	setTimeoutHasAction(long timeoutHasAction)
void	setTimeoutNotEmpty(long timeoutNotEmpty)

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.beryx.textio.TextTerminal

print, print, printf, printf, println, println, rawPrint

Field Detail

DEFAULT_TIMEOUT_NOT_EMPTY

public static final long DEFAULT_TIMEOUT_NOT_EMPTY

See Also:

Constant Field Values

DEFAULT_TIMEOUT_HAS_ACTION

public static final long DEFAULT_TIMEOUT_HAS_ACTION

See Also:

Constant Field Values

Constructor Detail

WebTextTerminal

public WebTextTerminal()

Method Detail

setTimeoutNotEmpty

public void setTimeoutNotEmpty(long timeoutNotEmpty)

setTimeoutHasAction

public void setTimeoutHasAction(long timeoutHasAction)

dispose

public void dispose()

Description copied from interface: TextTerminal

This method is typically called at the end of a text-based input/output session in order to allow the terminal to release its screen resources. The terminal should be able to rebuild the released resources when a print or read method is subsequently called. The default implementation does nothing.

Specified by:

dispose in interface TextTerminal

setOnDispose

public void setOnDispose(Runnable onDispose)

read

public String read(boolean masking)

Description copied from interface: TextTerminal

Reads a line of text

Specified by:

read in interface TextTerminal

Parameters:

masking - true, if the input should be masked (for example to enter a password)

Returns:

the entered text

setAction

protected void setAction(TextTerminalData.Action action)

rawPrint

public void rawPrint(String message)

Description copied from interface: TextTerminal

Prints the message in its raw form. This method expects a single line of text. The behavior is undefined if the string contains line separators.

Specified by:

rawPrint in interface TextTerminal

println

public void println()

Description copied from interface: TextTerminal

Terminates the current line by writing the line separator string.

Specified by:

println in interface TextTerminal

getTextTerminalData

public TextTerminalData getTextTerminalData()

Description copied from interface: DataApi

This method is called by the web component while polling for data

Specified by:

getTextTerminalData in interface DataApi

postUserInput

public void postUserInput(String newInput)

Description copied from interface: DataApi

This method is called by the web component to post the user input

Specified by:

postUserInput in interface DataApi