com.zebra.sdk.remote.comm

Class RemoteStatusConnection

Object

com.zebra.sdk.comm.ConnectionA

com.zebra.sdk.comm.ConnectionStatusA

com.zebra.sdk.remote.comm.RemoteStatusConnection

All Implemented Interfaces:

Connection, ConnectionWithWriteLogging, StatusConnection, StatusConnectionWithWriteLogging

public class RemoteStatusConnection
extends ConnectionStatusA

Establishes a status only Remote connection to a device.

package test.zebra.sdk.comm.examples;
 
 import com.zebra.sdk.comm.Connection;
 import com.zebra.sdk.comm.ConnectionException;
 import com.zebra.sdk.printer.SGD;
 import com.zebra.sdk.remote.comm.RemoteStatusConnection;
 
 public class RemoteStatusConnectionExample {
 
     // This example assumes Link-OS printers are connected via Web Sockets to a server which is running a Zebra servlet
     // instance.
     public static void main(String[] args) throws Exception {
         new RemoteStatusConnectionExample().sendJSONOverStatusChannel("myPrinterUUID");
     }
 
     private void sendJSONOverStatusChannel(String theIpAddress) throws ConnectionException {
         // Instantiate a remote status connection to the printer specified by UUID using the default Zebra Web
         // services port (11995).
         // Note: The printer must be connected to a server which is running a Zebra servlet instance.
         Connection thePrinterConn = new RemoteStatusConnection(theIpAddress);
 
         try {
             // Open the connection - physical connection is established here.
             thePrinterConn.open();
 
             // This sends down JSON to the status channel to retrieve the 'appl.name' setting
             String firmwareVersion = SGD.GET("appl.name", thePrinterConn);
 
             System.out.println("The firmware version is : " + firmwareVersion);
         } catch (ConnectionException e) {
             // Handle communications error here.
             e.printStackTrace();
         } finally {
             // Close the connection to release resources.
             thePrinterConn.close();
         }
     }
 }
 

Constructor Summary

Constructors

Constructor and Description
RemoteStatusConnection(String uniqueId) Initializes a new instance of the RemoteStatusConnection class using the default Zebra Web services port (11995). This constructor will use the default timeouts for Connection.read().
RemoteStatusConnection(String uniqueId, int rmiServerPort) Initializes a new instance of the RemoteStatusConnection class using the specified rmiServerPort.
RemoteStatusConnection(String uniqueId, int rmiServerPort, int maxTimeoutForRead, int timeToWaitForMoreData) Initializes a new instance of the RemoteStatusConnection class using the specified rmiServerPort.

Method Summary

Methods

Modifier and Type	Method and Description
int	bytesAvailable() Returns an estimate of the number of bytes that can be read from this connection without blocking.
void	close() Closes this connection and releases any system resources associated with the connection.
ConnectionReestablisher	getConnectionReestablisher(long thresholdTime) Returns a ConnectionReestablisher which allows for easy recreation of a connection which may have been closed.
int	getRmiServerPort() Returns the RMI server port.
String	getSimpleConnectionName() Return the remote connection unique id of the status port as the description.
String	getUniqueId() Returns the unique ID of the device.
boolean	isConnected() Returns true if the connection is open.
void	open() Opens the connection to a device.
byte[]	read() Reads all the available data from the connection.
byte[]	read(int maxBytesToRead) Reads maxBytesToRead of the available data from the connection.
int	readChar() Reads the next byte of data from the connection, similar to a Java InputStream.
String	toString() See the classes which implement this method for the format of the description string.
void	write(byte[] data) Writes data.length bytes from the specified byte array to this output stream.
void	write(byte[] data, int offset, int length) Writes length bytes from data starting at offset.

Methods inherited from class com.zebra.sdk.comm.ConnectionA

addWriteLogStream, getManufacturer, getMaxDataToWrite, getMaxTimeoutForRead, getTimeToWaitForMoreData, read, read, sendAndWaitForResponse, sendAndWaitForResponse, sendAndWaitForValidResponse, sendAndWaitForValidResponse, setMaxDataToWrite, setMaxTimeoutForRead, setReadTimeout, setTimeToWaitForMoreData, waitForData, write

Methods inherited from class Object

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

Methods inherited from interface com.zebra.sdk.comm.StatusConnectionWithWriteLogging

addWriteLogStream

Methods inherited from interface com.zebra.sdk.comm.Connection

getMaxTimeoutForRead, getTimeToWaitForMoreData, read, sendAndWaitForResponse, sendAndWaitForResponse, sendAndWaitForValidResponse, sendAndWaitForValidResponse, setMaxTimeoutForRead, setTimeToWaitForMoreData, waitForData, write

Constructor Detail

RemoteStatusConnection

public RemoteStatusConnection(String uniqueId)

Initializes a new instance of the RemoteStatusConnection class using the default Zebra Web services port (11995).
This constructor will use the default timeouts for Connection.read(). The default timeout is a maximum of 5 seconds for any data to be received. If no more data is available after 1 second the read operation is assumed to be complete.
To specify timeouts other than the defaults, use:
RemoteStatusConnection(String, int, int, int)

Parameters:

uniqueId - the UUID of the device.

See Also:

RemoteStatusConnection(String, int) to specify a non default RMI port.

RemoteStatusConnection

public RemoteStatusConnection(String uniqueId,
                      int rmiServerPort)

Initializes a new instance of the RemoteStatusConnection class using the specified rmiServerPort. This constructor will use the default timeouts for Connection.read(). The default timeout is a maximum of 5 seconds for any data to be received. If no more data is available after 1 second the read operation is assumed to be complete.
To specify timeouts other than the defaults, use:
RemoteStatusConnection(String, int, int, int)

Parameters:

uniqueId - the UUID of the device.

rmiServerPort - the port the RMI server is running on.

RemoteStatusConnection

public RemoteStatusConnection(String uniqueId,
                      int rmiServerPort,
                      int maxTimeoutForRead,
                      int timeToWaitForMoreData)

Initializes a new instance of the RemoteStatusConnection class using the specified rmiServerPort. This constructor will use the specified timeouts for Connection.read(). The timeout is a maximum of maxTimeoutForRead milliseconds for any data to be received. If no more data is available after timeToWaitForMoreData milliseconds the read operation is assumed to be complete.

Parameters:

uniqueId - the UUID of the device.

rmiServerPort - the port the RMI server is running on.

maxTimeoutForRead - the maximum time, in milliseconds, to wait for any data to be received.

timeToWaitForMoreData - the maximum time, in milliseconds, to wait in-between reads after the initial read.

Method Detail

open

public void open()
          throws ConnectionException

Description copied from interface: Connection

Opens the connection to a device. If the open method is called when this connection has already been opened, this call is ignored. When a handle to the connection is no longer needed, you must call Connection.close() to free up system resources.

Specified by:

open in interface Connection

Overrides:

open in class ConnectionA

Throws:

ConnectionException - if the connection cannot be established.

See Also:

Connection.open()

close

public void close()
           throws ConnectionException

Description copied from interface: Connection

Closes this connection and releases any system resources associated with the connection. If the connection is already closed then invoking this method has no effect.

Specified by:

close in interface Connection

Overrides:

close in class ConnectionA

Throws:

ConnectionException - if an I/O error occurs.

See Also:

RemoteConnection.close()

write

public void write(byte[] data)
           throws ConnectionException

Description copied from interface: Connection

Writes data.length bytes from the specified byte array to this output stream. The connection must be open before this method is called. If write is called when a connection is closed, a ConnectionException is thrown.

Specified by:

write in interface Connection

Overrides:

write in class ConnectionA

Parameters:

data - the data.

Throws:

ConnectionException - if an I/O error occurs.

See Also:

Connection.write(byte[])

write

public void write(byte[] data,
         int offset,
         int length)
           throws ConnectionException

Description copied from interface: Connection

Writes length bytes from data starting at offset. The connection must be open before this method is called. If write is called when a connection is closed, a ConnectionException is thrown.

Specified by:

write in interface Connection

Overrides:

write in class ConnectionA

Parameters:

data - the data.

offset - the start offset in the data.

length - number of bytes to write.

Throws:

ConnectionException - if an I/O error occurs.

See Also:

Connection.write(byte[], int, int)

read

public byte[] read()
            throws ConnectionException

Description copied from interface: Connection

Reads all the available data from the connection. This call is non-blocking.

 byte[] data = printerConnection.read();
 

Specified by:

read in interface Connection

Overrides:

read in class ConnectionA

Returns:

the bytes read from the connection.

Throws:

ConnectionException - if an I/O error occurs.

See Also:

Connection.read()

read

public byte[] read(int maxBytesToRead)
            throws ConnectionException

Description copied from class: ConnectionA

Reads maxBytesToRead of the available data from the connection. This call is non-blocking.

Overrides:

read in class ConnectionA

Parameters:

maxBytesToRead - number of bytes to read

Returns:

the bytes read from the connection.

Throws:

ConnectionException - if an I/O error occurs.

See Also:

ConnectionA.read(int)

readChar

public int readChar()
             throws ConnectionException

Description copied from interface: Connection

Reads the next byte of data from the connection, similar to a Java InputStream. The value byte is returned as an int in the range of 0 to 255. If no byte is available on the connection the value -1 is returned.

 int singleCharacter = printerConnection.readChar();
 

Specified by:

readChar in interface Connection

Overrides:

readChar in class ConnectionA

Returns:

the next byte from the connection

Throws:

ConnectionException - if an I/O error occurs.

See Also:

ConnectionA.readChar()

isConnected

public boolean isConnected()

Description copied from interface: Connection

Returns true if the connection is open.

Specified by:

isConnected in interface Connection

Overrides:

isConnected in class ConnectionA

Returns:

true if this connection is open.

See Also:

Connection.isConnected()

bytesAvailable

public int bytesAvailable()
                   throws ConnectionException

Description copied from interface: Connection

Returns an estimate of the number of bytes that can be read from this connection without blocking.

Specified by:

bytesAvailable in interface Connection

Overrides:

bytesAvailable in class ConnectionA

Returns:

estimated number of bytes available.

Throws:

ConnectionException - if an I/O error occurs.

See Also:

Connection.bytesAvailable()

getUniqueId

public String getUniqueId()

Returns the unique ID of the device.

Returns:

the unique ID of the device.

getRmiServerPort

public int getRmiServerPort()

Returns the RMI server port.

Returns:

the rmiServerPort

toString

public String toString()

Description copied from interface: Connection

See the classes which implement this method for the format of the description string.

Specified by:

toString in interface Connection

Overrides:

toString in class Object

Returns:

the connection description string.

See Also:

Object.toString()

getSimpleConnectionName

public String getSimpleConnectionName()

Return the remote connection unique id of the status port as the description.

Returns:

a human-readable description of the connection.

See Also:

Connection.getSimpleConnectionName()

getConnectionReestablisher

public ConnectionReestablisher getConnectionReestablisher(long thresholdTime)
                                                   throws ConnectionException

Description copied from interface: Connection

Returns a ConnectionReestablisher which allows for easy recreation of a connection which may have been closed.

• This call should be made while there is still an active connection to the printer (prior to issuing a command which will make the printer non-responsive).

Specified by:

getConnectionReestablisher in interface Connection

Overrides:

getConnectionReestablisher in class ConnectionA

Parameters:

thresholdTime - how long the Connection reestablisher will wait before attempting to reconnection to the printer

Returns:

ConnectionReestablisher

Throws:

ConnectionException - if the ConnectionReestablisher could not be created.

See Also:

ConnectionA.getConnectionReestablisher(long thresholdTime)