Package com.zebra.sdk.comm

Class TlsStatusConnection

Object
com.zebra.sdk.comm.ConnectionA
com.zebra.sdk.comm.TlsConnection
com.zebra.sdk.comm.TlsStatusConnection
All Implemented Interfaces:
Connection, ConnectionWithWriteLogging, com.zebra.sdk.comm.internal.ConnectionI, IpAddressable, StatusConnection, StatusConnectionWithWriteLogging
public class TlsStatusConnection extends TlsConnection implements StatusConnectionWithWriteLogging
Establishes a status only TLS 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.comm.TlsConfig;
 import com.zebra.sdk.comm.TlsStatusConnection;
 import com.zebra.sdk.printer.SGD;
 
 public class TlsStatusConnectionExample {
 
     public static void main(String[] args) throws Exception {
         new TlsStatusConnectionExample().sendJSONOverStatusChannel("1.2.3.4");
     }
 
     private void sendJSONOverStatusChannel(String theIpAddress) throws ConnectionException {
         // Instantiate connection for ZPL TCP port at given address
         Connection thePrinterConn = new TlsStatusConnection(theIpAddress, TlsStatusConnection.DEFAULT_STATUS_TLS_PORT, TlsConfig.trustAll());
 
         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();
         }
     }
 }

  • Field Details

    • DEFAULT_STATUS_TLS_PORT

      public static final int DEFAULT_STATUS_TLS_PORT
      The default Status TLS port for ZPL devices.
      See Also:

  • Constructor Details

    • TlsStatusConnection

      public TlsStatusConnection(String address, TlsConfig tlsConfig)
      Initializes a new status only instance of the TlsStatusConnection class using the default status port of 9243. 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:
      TlsStatusConnection(String, int, TlsConfig, int, int).
      Parameters:
      address - the IP Address or DNS Hostname.
      tlsConfig - TLS configuration including certificates and protocols.

    • TlsStatusConnection

      public TlsStatusConnection(String address, int port, TlsConfig tlsConfig)
      Initializes a new status only instance of the TlsConnection 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:
      TlsStatusConnection(String, int, TlsConfig).
      Parameters:
      address - the IP Address or DNS Hostname.
      port - the port number.
      tlsConfig - TLS configuration including certificates and protocols.

    • TlsStatusConnection

      public TlsStatusConnection(String address, int port, TlsConfig tlsConfig, int maxTimeoutForRead, int timeToWaitForMoreData)
      Initializes a new status only instance of the TlsConnection class. 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:
      address - the IP Address or DNS Hostname.
      port - the port number.
      tlsConfig - TLS configuration including certificates and protocols.
      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 Details