org.harctoolbox.harchardware.comm

Class UdpSocketPort

java.lang.Object

org.harctoolbox.harchardware.comm.UdpSocketPort

All Implemented Interfaces:

Closeable, AutoCloseable, IHarcHardware, IStringCommand

public class UdpSocketPort
extends Object
implements IStringCommand, IHarcHardware

Constructor Summary

Constructors

Constructor and Description
UdpSocketPort(String hostIp, int portNumber, int timeout, boolean verbose)

Method Summary

Modifier and Type	Method and Description
void	close()
String	getVersion() Returns the hardware version (not the version of the driver software).
boolean	isValid() Tries to identify instances that are not valid.
static void	main(String[] args)
void	open() Opens the device with previously set parameters.
String	readString() Reads a line of text.
boolean	ready() Tells whether this stream is ready to be read.
void	sendString(String str)
void	setDebug(int debug) Sets a debug parameter.
void	setTimeout(int timeout) Set timeout in milliseconds.
void	setVerbosity(boolean verbose) Sets a verbosity flag, causing commands to be executed verbosely.

Methods inherited from class java.lang.Object

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

Constructor Detail

UdpSocketPort

public UdpSocketPort(String hostIp,
                     int portNumber,
                     int timeout,
                     boolean verbose)
              throws UnknownHostException

Throws:

UnknownHostException

Method Detail

close

public void close()
           throws IOException

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Throws:

IOException

sendString

public void sendString(String str)
                throws IOException

Specified by:

sendString in interface IStringCommand

Throws:

IOException

readString

public String readString()
                  throws IOException

Description copied from interface: IStringCommand

Reads a line of text. A line is considered to be terminated by any one of a line feed ('\n'), a carriage return ('\r'), or a carriage return followed immediately by a linefeed.

Specified by:

readString in interface IStringCommand

Returns:

A String containing the contents of the line, not including any line-termination characters, or null if no input available.

Throws:

IOException

isValid

public boolean isValid()

Description copied from interface: IHarcHardware

Tries to identify instances that are not valid. Exact meaning can vary.

Specified by:

isValid in interface IHarcHardware

Returns:

validity of the instance.

getVersion

public String getVersion()

Description copied from interface: IHarcHardware

Returns the hardware version (not the version of the driver software). May be null if no relevant information available.

Specified by:

getVersion in interface IHarcHardware

Returns:

Version string. Semantics can vary.

setTimeout

public void setTimeout(int timeout)

Description copied from interface: IHarcHardware

Set timeout in milliseconds. Exact semantics may be dependent on the hardware.

Specified by:

setTimeout in interface IHarcHardware

Parameters:

timeout - Timeout in milliseconds.

setVerbosity

public void setVerbosity(boolean verbose)

Description copied from interface: IHarcHardware

Sets a verbosity flag, causing commands to be executed verbosely. Exact semantic depends on the implementation.

Specified by:

setVerbosity in interface IHarcHardware

Parameters:

verbose - on or off

setDebug

public void setDebug(int debug)

Description copied from interface: IHarcHardware

Sets a debug parameter. Exact semantic depends on the implementation.

Specified by:

setDebug in interface IHarcHardware

main

public static void main(String[] args)

open

public void open()

Description copied from interface: IHarcHardware

Opens the device with previously set parameters.

Specified by:

open in interface IHarcHardware

ready

public boolean ready()

Description copied from interface: IStringCommand

Tells whether this stream is ready to be read. A buffered character stream is ready if the buffer is not empty, or if the underlying character stream is ready.

Specified by:

ready in interface IStringCommand

Returns:

True if the next read() is guaranteed not to block for input, false otherwise. Note that returning false does not guarantee that the next read will block.