Package com.tailf.ned

Class TelnetSession

Object

com.tailf.ned.TelnetSession

All Implemented Interfaces:

CliSession

public class TelnetSession
extends Object
implements CliSession

A telnet transport. Example:

 TelnetSession c = new TelnetSession("127.0.0.1", 23);
 

Constructor Summary

Constructors

Constructor	Description
TelnetSession(NedWorker worker)	Constructor for Telnet session object.
TelnetSession(NedWorker worker, int readTimeout, NedTracer tracer, NedConnectionBase conn)	Constructor with an extra argument for a readTimeout timer.
TelnetSession(NedWorker worker, NedTracer tracer, NedConnectionBase conn)	Constructor for Telnet session object.
TelnetSession(NedWorker worker, String username, int readTimeout, NedTracer tracer, NedConnectionBase conn)	Constructor with extra user name argument.

Method Summary

Modifier and Type	Method	Description
void	close()
String	expect(String str)	Read from socket until Pattern is encountered.
NedExpectResult	expect(String[] str)
NedExpectResult	expect(String[] str, boolean include, int timeout)
NedExpectResult	expect(String[] str, boolean include, int timeout, NedWorker worker)
NedExpectResult	expect(String[] str, NedWorker worker)
String	expect(String str, boolean include, boolean full, int timeout)	Read from socket until Pattern is encountered.
String	expect(String str, boolean include, boolean full, int timeout, NedWorker worker)
String	expect(String str, boolean include, int timeout)	Read from socket until Pattern is encountered.
String	expect(String str, boolean include, int timeout, NedWorker worker)
String	expect(String str, int timeout)	Read from socket until Pattern is encountered.
String	expect(String str, int timeout, NedWorker worker)
String	expect(String str, NedWorker worker)
String	expect(Pattern p)
NedExpectResult	expect(Pattern[] p)
NedExpectResult	expect(Pattern[] p, boolean include, int timeout)
NedExpectResult	expect(Pattern[] p, boolean include, int timeout, boolean full)
NedExpectResult	expect(Pattern[] p, boolean include, int timeout, boolean full, NedWorker worker)
NedExpectResult	expect(Pattern[] p, boolean include, int timeout, NedWorker worker)
NedExpectResult	expect(Pattern[] p, NedWorker worker)
String	expect(Pattern p, boolean include, int timeout)
String	expect(Pattern p, boolean include, int timeout, NedWorker worker)
String	expect(Pattern p, NedWorker worker)
void	flush()	Signals that the final chunk of data has be printed to the output transport stream.
Socket	getSocket()	Needed by users that need to monitor a socket for EOF .
void	print(String s)	Prints text to the output stream.
void	println(String s)	Print text to the output stream.
boolean	ready()	Tell whether this transport is ready to be read.
boolean	ready(int timeout)
boolean	serverSideClosed()	given a live session, check if the server side has closed it's end of the socket.
void	setScreenSize(int width, int length)
void	setTracer(NedTracer tracer)
void	write(String s)

Methods inherited from class java.lang.Object

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

Constructor Details

TelnetSession

public TelnetSession(NedWorker worker)
              throws IOException

Constructor for Telnet session object. This method creates a a new telnet session on top of an existing connection. Telnet objects implement the Transport interface and they are passed into the constructor of the NetconfSession class.

Parameters:

worker - current NedWorker object

Throws:

IOException

TelnetSession

public TelnetSession(NedWorker worker,
 NedTracer tracer,
 NedConnectionBase conn)
              throws IOException

Constructor for Telnet session object. This method creates a a new telnet connection.

Parameters:

worker - current NedWorker object

tracer - Ned tracer

conn - NedConnection object

Throws:

IOException

TelnetSession

public TelnetSession(NedWorker worker,
 int readTimeout,
 NedTracer tracer,
 NedConnectionBase conn)
              throws IOException

Constructor with an extra argument for a readTimeout timer.

Parameters:

worker - current NedWorker object

readTimeout - timeout in milliseconds

tracer - Ned tracer

conn - NedConnection object

Throws:

IOException

TelnetSession

public TelnetSession(NedWorker worker,
 String username,
 int readTimeout,
 NedTracer tracer,
 NedConnectionBase conn)
              throws IOException

Constructor with extra user name argument.

Parameters:

worker - current NedWorker object

username -

readTimeout - timeout in milliseconds

tracer - Ned tracer

conn - NedConnection object

Throws:

IOException

Method Details

setScreenSize

public void setScreenSize(int width,
 int length)
                   throws IOException

Throws:

IOException

expect

public String expect(String str,
 boolean include,
 int timeout)
              throws IOException

Read from socket until Pattern is encountered.

Specified by:

expect in interface CliSession

Parameters:

str - is a regular expression pattern which is match against each line read.

include - controls if the pattern should be include in the returned string or not.

Returns:

the characters read.

Throws:

IOException

expect

public String expect(Pattern p,
 boolean include,
 int timeout)
              throws IOException

Throws:

IOException

expect

public String expect(String str,
 boolean include,
 int timeout,
 NedWorker worker)
              throws IOException

Throws:

IOException

expect

public String expect(Pattern p,
 boolean include,
 int timeout,
 NedWorker worker)
              throws IOException

Throws:

IOException

expect

public String expect(String str)
              throws IOException

Read from socket until Pattern is encountered.

Specified by:

expect in interface CliSession

Parameters:

str - is a regular expression pattern which is match against each line read.

Returns:

the characters read.

Throws:

IOException

expect

public String expect(Pattern p)
              throws SSHSessionException,
IOException

Specified by:

expect in interface CliSession

Throws:

SSHSessionException

IOException

expect

public String expect(String str,
 NedWorker worker)
              throws IOException

Specified by:

expect in interface CliSession

Throws:

IOException

expect

public String expect(Pattern p,
 NedWorker worker)
              throws SSHSessionException,
IOException

Specified by:

expect in interface CliSession

Throws:

SSHSessionException

IOException

expect

public String expect(String str,
 int timeout)
              throws IOException

Read from socket until Pattern is encountered.

Specified by:

expect in interface CliSession

Parameters:

str - is a regular expression pattern which is match against each line read.

timeout - indicates the read timeout

Returns:

the characters read.

Throws:

IOException

expect

public NedExpectResult expect(String[] str)
                       throws IOException

Specified by:

expect in interface CliSession

Throws:

IOException

expect

public NedExpectResult expect(Pattern[] p)
                       throws SSHSessionException,
IOException

Specified by:

expect in interface CliSession

Throws:

SSHSessionException

IOException

expect

public NedExpectResult expect(String[] str,
 boolean include,
 int timeout)
                       throws IOException

Specified by:

expect in interface CliSession

Throws:

IOException

expect

public NedExpectResult expect(Pattern[] p,
 boolean include,
 int timeout)
                       throws IOException

Specified by:

expect in interface CliSession

Throws:

IOException

expect

public String expect(String str,
 int timeout,
 NedWorker worker)
              throws IOException

Specified by:

expect in interface CliSession

Throws:

IOException

expect

public NedExpectResult expect(String[] str,
 NedWorker worker)
                       throws IOException

Specified by:

expect in interface CliSession

Throws:

IOException

expect

public NedExpectResult expect(Pattern[] p,
 NedWorker worker)
                       throws SSHSessionException,
IOException

Specified by:

expect in interface CliSession

Throws:

SSHSessionException

IOException

expect

public NedExpectResult expect(String[] str,
 boolean include,
 int timeout,
 NedWorker worker)
                       throws IOException

Specified by:

expect in interface CliSession

Throws:

IOException

expect

public NedExpectResult expect(Pattern[] p,
 boolean include,
 int timeout,
 NedWorker worker)
                       throws IOException

Specified by:

expect in interface CliSession

Throws:

IOException

expect

public NedExpectResult expect(Pattern[] p,
 boolean include,
 int timeout,
 boolean full)
                       throws IOException

Throws:

IOException

expect

public NedExpectResult expect(Pattern[] p,
 boolean include,
 int timeout,
 boolean full,
 NedWorker worker)
                       throws IOException

Throws:

IOException

expect

public String expect(String str,
 boolean include,
 boolean full,
 int timeout)
              throws IOException

Read from socket until Pattern is encountered.

Specified by:

expect in interface CliSession

Parameters:

str - is a regular expression pattern which is match against each line read.

include - controls if the pattern should be include in the returned string or not.

full - controls if the pattern should be matched against the entire line, or if a positive match is accepted whenever the pattern matches any substring on a line.

Returns:

the characters read.

Throws:

IOException

expect

public String expect(String str,
 boolean include,
 boolean full,
 int timeout,
 NedWorker worker)
              throws IOException

Specified by:

expect in interface CliSession

Throws:

IOException

close

public void close()

Specified by:

close in interface CliSession

write

public void write(String s)
           throws IOException

Throws:

IOException

print

public void print(String s)
           throws IOException

Prints text to the output stream.

Specified by:

print in interface CliSession

Parameters:

s - Text to send to the stream.

Throws:

IOException

println

public void println(String s)
             throws IOException

Print text to the output stream. A newline char is appended to end of the output stream.

Specified by:

println in interface CliSession

Parameters:

s - Text to send to the stream.

Throws:

IOException

flush

public void flush()
           throws IOException

Signals that the final chunk of data has be printed to the output transport stream. This method furthermore flushes the transport output stream buffer.

Specified by:

flush in interface CliSession

Throws:

IOException

getSocket

public Socket getSocket()

Needed by users that need to monitor a socket for EOF . This will return the underlying socket object.

ready

public boolean ready()
              throws IOException

Tell whether this transport is ready to be read.

Returns:

true if there is something to read, false otherwise. This function can typically be used to poll a socket and see there is data to be read. Note that this method does not detect that the socket is in half-closed state and in such case will return false after timeout.

Throws:

IOException

ready

public boolean ready(int timeout)
              throws IOException

Throws:

IOException

serverSideClosed

public boolean serverSideClosed()

given a live session, check if the server side has closed it's end of the socket. Note that it does not detect that the socket in half-closed state.

Specified by:

serverSideClosed in interface CliSession

setTracer

public void setTracer(NedTracer tracer)

Specified by:

setTracer in interface CliSession