com.zebra.sdk.comm

Class MultichannelTcpConnection

Object

com.zebra.sdk.comm.MultichannelConnection

com.zebra.sdk.comm.MultichannelTcpConnection

All Implemented Interfaces:

Connection, ConnectionWithWriteLogging

public class MultichannelTcpConnection
extends MultichannelConnection

Establishes a Multichannel TCP connection to a device MultichannelTcpConnectionExample.java

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAULT_MULTICHANNEL_PRINTING_PORT The default Multichannel printing port for Link-OS devices.
static int	DEFAULT_MULTICHANNEL_STATUS_PORT The default Multichannel status port for Link-OS devices.

Constructor Summary

Constructors

Constructor and Description
MultichannelTcpConnection(DiscoveredPrinter discoveredPrinter, int maxTimeoutForRead, int timeToWaitForMoreData) Initializes a new instance of the MultichannelTcpConnection class.
MultichannelTcpConnection(DiscoveredPrinter discoveredPrinter, int printingChannelMaxTimeoutForRead, int printingChannelTimeToWaitForMoreData, int statusChannelMaxTimeoutForRead, int statusChannelTimeToWaitForMoreData) Initializes a new instance of the MultichannelTcpConnection class.
MultichannelTcpConnection(String ipAddress, int printingPort, int statusPort) Initializes a new instance of the MultichannelTcpConnection class.
MultichannelTcpConnection(String ipAddress, int printingPort, int statusPort, int maxTimeoutForRead, int timeToWaitForMoreData) Initializes a new instance of the MultichannelTcpConnection class.
MultichannelTcpConnection(String ipAddress, int printingPort, int statusPort, int printingChannelMaxTimeoutForRead, int printingChannelTimeToWaitForMoreData, int statusChannelMaxTimeoutForRead, int statusChannelTimeToWaitForMoreData) Initializes a new instance of the MultichannelTcpConnection class.

Method Summary

Methods

Modifier and Type	Method and Description
ConnectionReestablisher	getConnectionReestablisher(long thresholdTime) Returns a ConnectionReestablisher which allows for easy recreation of a connection which may have been closed.
String	getSimpleConnectionName() Return the IP address as the description.
String	toString() Returns TCP_MULTI:[address]:[port number]. The address and port number are the parameters which were passed into the constructor.

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

addWriteLogStream, bytesAvailable, close, closePrintingChannel, closeStatusChannel, getMaxTimeoutForRead, getPrintingChannel, getStatusChannel, getTimeToWaitForMoreData, isConnected, open, openPrintingChannel, openStatusChannel, read, read, readChar, sendAndWaitForResponse, sendAndWaitForResponse, sendAndWaitForValidResponse, sendAndWaitForValidResponse, setMaxTimeoutForRead, setTimeToWaitForMoreData, waitForData, write, write, write

Methods inherited from class Object

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

Field Detail

DEFAULT_MULTICHANNEL_PRINTING_PORT

public static final int DEFAULT_MULTICHANNEL_PRINTING_PORT

The default Multichannel printing port for Link-OS devices.

See Also:

Constant Field Values

DEFAULT_MULTICHANNEL_STATUS_PORT

public static final int DEFAULT_MULTICHANNEL_STATUS_PORT

The default Multichannel status port for Link-OS devices.

See Also:

Constant Field Values

Constructor Detail

MultichannelTcpConnection

public MultichannelTcpConnection(DiscoveredPrinter discoveredPrinter,
                         int maxTimeoutForRead,
                         int timeToWaitForMoreData)

Initializes a new instance of the MultichannelTcpConnection class. This constructor will use the specified timeouts for Connection.read() for both channels. 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. If you wish to specify different timeouts for each channel, use MultichannelTcpConnection(DiscoveredPrinter, int, int, int, int).

Parameters:

discoveredPrinter - the discovered printer.

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.

MultichannelTcpConnection

public MultichannelTcpConnection(DiscoveredPrinter discoveredPrinter,
                         int printingChannelMaxTimeoutForRead,
                         int printingChannelTimeToWaitForMoreData,
                         int statusChannelMaxTimeoutForRead,
                         int statusChannelTimeToWaitForMoreData)

Initializes a new instance of the MultichannelTcpConnection class. This constructor will use the specified timeouts for Connection.read() for the channels. The timeout is a maximum of printingChannelMaxTimeoutForRead/statusChannelMaxTimeoutForRead milliseconds for any data to be received on the printing/status channels respectively. If no more data is available after printingChannelTimeToWaitForMoreData/statusChannelTimeToWaitForMoreData milliseconds on the printing/status channels respectively the read operation is assumed to be complete.

Parameters:

discoveredPrinter - the discovered printer.

printingChannelMaxTimeoutForRead - the maximum time, in milliseconds, to wait for any data to be received on the printing channel.

printingChannelTimeToWaitForMoreData - the maximum time, in milliseconds, to wait in-between reads after the initial read on the printing channel.

statusChannelMaxTimeoutForRead - the maximum time, in milliseconds, to wait for any data to be received on the status channel.

statusChannelTimeToWaitForMoreData - the maximum time, in milliseconds, to wait in-between reads after the initial read on the status channel.

MultichannelTcpConnection

public MultichannelTcpConnection(String ipAddress,
                         int printingPort,
                         int statusPort)

Initializes a new instance of the MultichannelTcpConnection class. 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 500 milliseconds the read operation is assumed to be complete.
To specify timeouts other than the defaults, use:
MultichannelTcpConnection(String, int, int, int,int) or MultichannelTcpConnection(String, int, int, int, int, int, int).

Parameters:

ipAddress - the IP Address or DNS Hostname.

printingPort - the printing port number.

statusPort - the status port number.

MultichannelTcpConnection

public MultichannelTcpConnection(String ipAddress,
                         int printingPort,
                         int statusPort,
                         int maxTimeoutForRead,
                         int timeToWaitForMoreData)

Initializes a new instance of the MultichannelTcpConnection class. This constructor will use the specified timeouts for Connection.read() for both channels. 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. If you wish to specify different timeouts for each channel, use MultichannelTcpConnection(String, int, int, int, int, int, int).

Parameters:

ipAddress - the IP Address or DNS Hostname.

printingPort - the printing port number.

statusPort - the status port number.

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.

MultichannelTcpConnection

public MultichannelTcpConnection(String ipAddress,
                         int printingPort,
                         int statusPort,
                         int printingChannelMaxTimeoutForRead,
                         int printingChannelTimeToWaitForMoreData,
                         int statusChannelMaxTimeoutForRead,
                         int statusChannelTimeToWaitForMoreData)

Initializes a new instance of the MultichannelTcpConnection class. This constructor will use the specified timeouts for Connection.read() for the channels. The timeout is a maximum of printingChannelMaxTimeoutForRead/statusChannelMaxTimeoutForRead milliseconds for any data to be received on the printing/status channels respectively. If no more data is available after printingChannelTimeToWaitForMoreData/statusChannelTimeToWaitForMoreData milliseconds on the printing/status channels respectively the read operation is assumed to be complete.

Parameters:

ipAddress - the IP Address or DNS Hostname.

printingPort - the printing port number.

statusPort - the status port number.

printingChannelMaxTimeoutForRead - the maximum time, in milliseconds, to wait for any data to be received on the printing channel.

printingChannelTimeToWaitForMoreData - the maximum time, in milliseconds, to wait in-between reads after the initial read on the printing channel.

statusChannelMaxTimeoutForRead - the maximum time, in milliseconds, to wait for any data to be received on the status channel.

statusChannelTimeToWaitForMoreData - the maximum time, in milliseconds, to wait in-between reads after the initial read on the status channel.

Method Detail

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 MultichannelConnection

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:

Connection.getConnectionReestablisher(long thresholdTime)

toString

public String toString()

Returns TCP_MULTI:[address]:[port number].
The address and port number are the parameters which were passed into the constructor.

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 IP address as the description.

Returns:

a human-readable description of the connection.

See Also:

Connection.getSimpleConnectionName()