archiecobbs / nvt4j Goto Github PK

The Network Virtual Terminal for Java (NVT4J) is a library which can drive a terminal emulator connected to the application through a telnet session.

This project was imported as an abandonded orphan from Google Code and given a new home here on Github on 17-Nov-2015.

The API consists of the interface Terminal. The implementation of this class is called TerminalImpl. To allow the user to connect to the application you need to listen for a tcp connection and then wrap a TerminalImpl object around it:

ServerSocket serverSocket = new ServerSocket(8000);
Socket socket = serverSocket.accept();
Terminal terminal = new TerminalImpl(socket);

For example, to run the sample class Example.java from an xterm session, you can do this:

user@localhost$ java -classpath nvt4j.jar Example &
user@localhost$ telnet localhost 8000

NVT4J uses the Telnet LINEMODE option to put the terminal driver (xterm in this case) in what the posix standard calls 'raw' or 'non-canonical' mode, so that it can receive all user inputs asap, instead of waiting for a new-line character.

Unfortunately in pure Java there is no way to put the operating system console in raw mode. On Linux and similar systems this is done using the stty command, which is a native program which manipulates the terminal driver in the operating system.

See Downloads.

View the Javadoc API.

See the LICENSE file.

Copyright 2006 Guglielmo Lichtner

Copyright 2015 Archie L. Cobbs