com.zebra.sdk.printer

Class PrinterUtil

Object

com.zebra.sdk.printer.PrinterUtil

public class PrinterUtil
extends Object

Numerous utilities to simplify printer operations PrinterUtilExample.java.

Method Summary

Methods

Modifier and Type	Method and Description
static void	convertGraphic(String filePathOnPrinter, ZebraImageI image, int width, int height, java.io.OutputStream convertedGraphicOutputStream) Encodes supplied image in either ZPL or CPCL after dithering and resizing.
static void	convertGraphic(String filePathOnPrinter, ZebraImageI image, java.io.OutputStream convertedGraphicOutputStream) Encodes supplied image in either ZPL or CPCL after dithering and resizing.
static void	createBackup(String connectionString, String profilePath) Create a backup of your printer's settings, alerts, and files.
static void	createProfile(String connectionString, String profilePath) Create a profile of your printer's settings, alerts, and files for cloning to other printers.
static void	deleteFile(String connectionString, String filePath) Deletes file(s) from the printer.
static String[]	deleteFileReportDeleted(String connectionString, String filePath) Deletes file(s) from the printer and reports what files were actually removed.
static PrinterStatus	getCurrentStatus(Connection printerConnection, PrinterLanguage language) Returns a new instance of PrinterStatus that can be used to determine the status of a printer.
static void	getObjectFromPrinter(java.io.OutputStream destinationStream, String connectionString, String filePathOnPrinter) Retrieves a file from the printer's file system and writes the contents of that file to an output stream.
static byte[]	getObjectFromPrinter(String connectionString, String filePathOnPrinter) Retrieves a file from the printer's file system and returns the contents of that file as a byte[].
static void	getObjectFromPrinterViaFtp(java.io.OutputStream destination, String connectionString, String filePathOnPrinter, String ftpPassword) Retrieves a file from the printer's file system via FTP and writes the contents of that file to an output stream.
static byte[]	getObjectFromPrinterViaFtp(String connectionString, String filePathOnPrinter, String ftpPassword) Retrieves a file from the printer's file system via FTP and returns the contents of that file as a byte[].
static java.util.List<String>	getOdometerStatus(String connectionString) Retrieves status of the printer odometer which includes the total print length, head clean counter, label dot length, head new, latch open counter, and both user resettable counters. See ConnectionBuilder for the format of connectionString.
static java.util.List<TcpPortStatus>	getPortStatus(String connectionString) Retrieves a list of currently open tcp ports on the printer. See ConnectionBuilder for the format of connectionString.
static java.util.List<String>	getPrinterStatus(String connectionString) Retrieves status of the printer which includes any error messages currently set along with the number of labels remaining in queue, number of labels remaining in batch, and whether or not a label is currently being processed.
static java.util.Map<String,Setting>	getSettingsFromPrinter(String connectionString) Retrieve all settings and their attributes from the specified printer. See ConnectionBuilder for the format of connectionString.
static String[]	listFiles(String connectionString, String filter) Retrieves the names of the files which are stored on the device. See ConnectionBuilder for the format of connectionString.
static void	loadBackup(String connectionString, String backupPath) Takes settings, alerts, and files from a backup, and applies them to a printer.
static void	loadBackup(String connectionString, String backupPath, boolean isVerbose) Takes settings, alerts, and files from a backup, and applies them to a printer.
static void	loadProfile(String connectionString, String profilePath, FileDeletionOption filesToDelete) Takes settings, alerts, and files from a profile, and applies them to a printer.
static void	loadProfile(String connectionString, String profilePath, FileDeletionOption filesToDelete, boolean isVerbose) Takes settings, alerts, and files from a profile, and applies them to a printer.
static void	printConfigLabel(String connectionString) Causes the specified printer to print a configuration label. See ConnectionBuilder for the format of connectionString.
static void	printDirectoryLabel(String connectionString) Causes the specified printer to print a directory listing of all the files saved on the printer. See ConnectionBuilder for the format of connectionString.
static void	printNetworkConfigLabel(String connectionString) Causes the specified printer to print a network configuration label. See ConnectionBuilder for the format of connectionString.
static String	quickStatus(String connectionString) Retrieves the quick status of the printer. See ConnectionBuilder for the format of connectionString.
static void	resetNetwork(String connectionString) Resets the network of the specified printer.
static void	resetPrinter(String connectionString) Resets the specified printer. See ConnectionBuilder for the format of connectionString.
static void	restoreNetworkDefaults(String connectionString) Restores the printer's network settings to their factory default configuration.
static void	restorePrinterDefaults(String connectionString) Restores the printer's settings to their factory default configuration. See ConnectionBuilder for the format of connectionString.
static void	sendContents(String connectionString, java.io.InputStream data) Send contents of data directly to the device specified via connectionString using UTF-8 encoding. See ConnectionBuilder for the format of connectionString.
static void	sendContents(String connectionString, java.io.InputStream data, String encoding) Send contents of data directly to the device specified via connectionString using encoding. See ConnectionBuilder for the format of connectionString.
static void	sendContents(String connectionString, String data) Send contents of data directly to the device specified via connectionString using UTF-8 encoding.
static void	sendContents(String connectionString, String data, String encoding) Send contents of data directly to the device specified via connectionString using encoding. See ConnectionBuilder for the format of connectionString.
static void	sendJSON(String connectionString, java.io.InputStream data, String encoding) Send contents of data directly to the device specified via connectionString using encoding. See ConnectionBuilder for the format of connectionString.
static void	setClock(String connectionString, String dateTime) Set the RTC time and date on the printer. See ConnectionBuilder for the format of connectionString.
static void	storeFile(String connectionString, String filePath, String remoteName) Stores the file on the printer at the specified location and name using any required file wrappers. See ConnectionBuilder for the format of connectionString.
static void	updateFirmware(String connection, String firmwareFilePath, long timeout) Update the printer firmware.

Methods inherited from class Object

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

Method Detail

sendContents

public static void sendContents(String connectionString,
                String data)
                         throws ConnectionException,
                                java.io.IOException

Send contents of data directly to the device specified via connectionString using UTF-8 encoding.
See ConnectionBuilder for the format of connectionString.

Parameters:

connectionString - The connection string.

data - Data to send to the printer.

Throws:

java.io.IOException - if there is an error encoding data.

ConnectionException - if there is an error communicating with the printer.

sendContents

public static void sendContents(String connectionString,
                String data,
                String encoding)
                         throws ConnectionException,
                                java.io.IOException

Send contents of data directly to the device specified via connectionString using encoding.
See ConnectionBuilder for the format of connectionString.

Parameters:

connectionString - The connection string.

data - Data to send to the printer.

encoding - A character-encoding name (eg. UTF-8).

Throws:

ConnectionException - if there is an error communicating with the printer.

java.io.IOException - if there is an error encoding data.

sendContents

public static void sendContents(String connectionString,
                java.io.InputStream data)
                         throws ConnectionException,
                                java.io.IOException

Send contents of data directly to the device specified via connectionString using UTF-8 encoding.
See ConnectionBuilder for the format of connectionString.

Parameters:

connectionString - The connection string.

data - Data to send to the printer.

Throws:

ConnectionException - if there is an error communicating with the printer.

java.io.IOException - if there is an error reading from data.

sendContents

public static void sendContents(String connectionString,
                java.io.InputStream data,
                String encoding)
                         throws ConnectionException,
                                java.io.IOException

Send contents of data directly to the device specified via connectionString using encoding.
See ConnectionBuilder for the format of connectionString.

Parameters:

connectionString - The connection string.

data - Data to send to the printer.

encoding - A character-encoding name (eg. UTF-8).

Throws:

ConnectionException - if there is an error communicating with the printer.

java.io.IOException - if there is an error reading from data.

sendJSON

public static void sendJSON(String connectionString,
            java.io.InputStream data,
            String encoding)
                     throws ConnectionException,
                            java.io.IOException

Send contents of data directly to the device specified via connectionString using encoding.
See ConnectionBuilder for the format of connectionString.

Parameters:

connectionString - The connection string.

data - Data to send to the printer.

encoding - A character-encoding name (eg. UTF-8).

Throws:

ConnectionException - if there is an error communicating with the printer.

java.io.IOException - if there is an error reading from data.

getPortStatus

public static java.util.List<TcpPortStatus> getPortStatus(String connectionString)
                                                   throws ConnectionException,
                                                          ZebraPrinterLanguageUnknownException,
                                                          NotALinkOsPrinterException

Retrieves a list of currently open tcp ports on the printer.
See ConnectionBuilder for the format of connectionString.

Parameters:

connectionString - The connection string.

Returns:

The port status.

Throws:

ConnectionException - if there is an error connecting to the device.

ZebraPrinterLanguageUnknownException - if the printer language could not be determined.

NotALinkOsPrinterException - This feature is only available on Link-OS™ printers.

getOdometerStatus

public static java.util.List<String> getOdometerStatus(String connectionString)
                                                throws ConnectionException,
                                                       ZebraPrinterLanguageUnknownException,
                                                       NotALinkOsPrinterException

Retrieves status of the printer odometer which includes the total print length, head clean counter, label dot length, head new, latch open counter, and both user resettable counters.
See ConnectionBuilder for the format of connectionString.

Parameters:

connectionString - The connection string.

Returns:

The odometer status.

Throws:

ConnectionException - if there is an error connecting to the device.

ZebraPrinterLanguageUnknownException - if the printer language could not be determined.

NotALinkOsPrinterException - This feature is only available on Link-OS™ printers.

getPrinterStatus

public static java.util.List<String> getPrinterStatus(String connectionString)
                                               throws ConnectionException,
                                                      ZebraPrinterLanguageUnknownException,
                                                      NotALinkOsPrinterException

Retrieves status of the printer which includes any error messages currently set along with the number of labels remaining in queue, number of labels remaining in batch, and whether or not a label is currently being processed.
See ConnectionBuilder for the format of connectionString.

Parameters:

connectionString - The connection string.

Returns:

The printer status.

Throws:

ConnectionException - if there is an error connecting to the device.

ZebraPrinterLanguageUnknownException - if the printer language could not be determined.

NotALinkOsPrinterException - This feature is only available on Link-OS™ printers.

quickStatus

public static String quickStatus(String connectionString)
                          throws ConnectionException,
                                 ZebraPrinterLanguageUnknownException,
                                 NotALinkOsPrinterException

Retrieves the quick status of the printer.
See ConnectionBuilder for the format of connectionString.

Parameters:

connectionString - The connection string.

Returns:

Highest level error or "Ready to Print"

Throws:

ConnectionException - if there is an error connecting to the device.

ZebraPrinterLanguageUnknownException - if the printer language could not be determined.

NotALinkOsPrinterException - This feature is only available on Link-OS™ printers.

setClock

public static void setClock(String connectionString,
            String dateTime)
                     throws ConnectionException,
                            ZebraPrinterLanguageUnknownException,
                            ZebraIllegalArgumentException,
                            NotALinkOsPrinterException

Set the RTC time and date on the printer.
See ConnectionBuilder for the format of connectionString.

Parameters:

connectionString - The connection string.

dateTime - Format MM-dd-yyyy HH:mm:ss

Throws:

ConnectionException - if there is an error communicating with the printer.

ZebraPrinterLanguageUnknownException - if the printer language can not be determined.

ZebraIllegalArgumentException - if the format of dateTime is invalid.

NotALinkOsPrinterException - This feature is only available on Link-OS™ printers.

deleteFileReportDeleted

public static String[] deleteFileReportDeleted(String connectionString,
                               String filePath)
                                        throws ConnectionException,
                                               ZebraPrinterLanguageUnknownException,
                                               ZebraIllegalArgumentException,
                                               NotALinkOsPrinterException

Deletes file(s) from the printer and reports what files were actually removed. The filePath may also contain wildcards.
See ConnectionBuilder for the format of connectionString.

Parameters:

connectionString - The connection string. (May be null)

filePath - The location of the file on the printer. Wildcards are also accepted. (e.g. "E:FORMAT.ZPL", "E:*.*")

Returns:

An array of the files which were deleted.

Throws:

ConnectionException - if there is an error connecting to the device.

ZebraPrinterLanguageUnknownException - if the printer language cannot be determined.

ZebraIllegalArgumentException - if there is an error parsing the directory data returned by the device.

NotALinkOsPrinterException - This feature is only available on Link-OS™ printers.

deleteFile

public static void deleteFile(String connectionString,
              String filePath)
                       throws ConnectionException,
                              ZebraPrinterLanguageUnknownException,
                              NotALinkOsPrinterException

Deletes file(s) from the printer. The filePath may also contain wildcards.
See ConnectionBuilder for the format of connectionString.

Parameters:

connectionString - The connection string. (May be null)

filePath - the location of the file on the printer. Wildcards are also accepted. (e.g. "E:FORMAT.ZPL", "E:*.*")

Throws:

ConnectionException - if there is an error connecting to the device.

ZebraPrinterLanguageUnknownException - if the printer language cannot be determined.

NotALinkOsPrinterException - This feature is only available on Link-OS™ printers.

listFiles

public static String[] listFiles(String connectionString,
                 String filter)
                          throws ConnectionException,
                                 ZebraIllegalArgumentException,
                                 ZebraPrinterLanguageUnknownException,
                                 NotALinkOsPrinterException

Retrieves the names of the files which are stored on the device.
See ConnectionBuilder for the format of connectionString.

Parameters:

connectionString - The connection string. (May be null)

filter - Filter for returned files. (e.g. "E:*.ZPL", "*:*.*", "R:MYFILE.*")

Returns:

List of file names on the printer.

Throws:

ConnectionException - if there is an error connecting to the device.

ZebraPrinterLanguageUnknownException - if the printer language cannot be determined.

ZebraIllegalArgumentException - if there is an error parsing the directory data returned by the device.

NotALinkOsPrinterException - This feature is only available on Link-OS™ printers.

getObjectFromPrinter

public static byte[] getObjectFromPrinter(String connectionString,
                          String filePathOnPrinter)
                                   throws ConnectionException,
                                          ZebraPrinterLanguageUnknownException,
                                          NotALinkOsPrinterException,
                                          ZebraIllegalArgumentException

Retrieves a file from the printer's file system and returns the contents of that file as a byte[]. Will retrieve the following file extensions: .FNT, .ZPL, .GRF, .DAT, .BAS, .STO, .PNG, .LBL, .TTF, .PCX, .BMP, .IMG, .TTE, .WML, .CSV, .HTM, .BAE, .TXT.
See ConnectionBuilder for the format of connectionString.

Parameters:

connectionString - The connection string.

filePathOnPrinter - file to retrieve. (e.g. "R:MYFILE.PNG")

Returns:

byte[] File contents.

Throws:

ConnectionException - if there is an error connecting to the device, or the ftp password is not correct.

ZebraPrinterLanguageUnknownException - if the printer language could not be determined.

NotALinkOsPrinterException - This feature is only available on Link-OS™ printers.

ZebraIllegalArgumentException - if the filename is invalid or does not exist.

getObjectFromPrinter

public static void getObjectFromPrinter(java.io.OutputStream destinationStream,
                        String connectionString,
                        String filePathOnPrinter)
                                 throws ConnectionException,
                                        ZebraPrinterLanguageUnknownException,
                                        NotALinkOsPrinterException,
                                        ZebraIllegalArgumentException

Retrieves a file from the printer's file system and writes the contents of that file to an output stream. Will retrieve the following file extensions: .FNT, .ZPL, .GRF, .DAT, .BAS, .STO, .PNG, .LBL, .TTF, .PCX, .BMP, .IMG, .TTE, .WML, .CSV, .HTM, .BAE, .TXT.
See ConnectionBuilder for the format of connectionString.

Parameters:

destinationStream - Stream to receive file contents.

connectionString - The connection string.

filePathOnPrinter - file to retrieve. (e.g. "R:MYFILE.PNG")

Throws:

ConnectionException - if there is an error connecting to the device, or the ftp password is not correct.

ZebraPrinterLanguageUnknownException - if the printer language could not be determined.

NotALinkOsPrinterException - This feature is only available on Link-OS™ printers.

ZebraIllegalArgumentException - if the filename is invalid or does not exist.

getObjectFromPrinterViaFtp

public static byte[] getObjectFromPrinterViaFtp(String connectionString,
                                String filePathOnPrinter,
                                String ftpPassword)
                                         throws ConnectionException,
                                                ZebraPrinterLanguageUnknownException,
                                                NotALinkOsPrinterException,
                                                ZebraIllegalArgumentException

Retrieves a file from the printer's file system via FTP and returns the contents of that file as a byte[]. Will retrieve the following file extensions: .FNT, .ZPL, .GRF, .DAT, .BAS, .STO, .PNG, .LBL, .TTF, .PCX, .BMP, .IMG, .TTE, .WML, .CSV, .HTM, .BAE, .TXT.
See ConnectionBuilder for the format of connectionString.

Parameters:

connectionString - The connection string.

filePathOnPrinter - File to retrieve. (e.g. "R:MYFILE.PNG")

ftpPassword - Password to use for ftp, if null a default password will be used.

Returns:

byte[] File contents.

Throws:

ConnectionException - if there is an error connecting to the device, or the ftp password is not correct.

ZebraPrinterLanguageUnknownException - if the printer language could not be determined.

NotALinkOsPrinterException - This feature is only available on Link-OS™ printers.

ZebraIllegalArgumentException - if the filename is invalid or does not exist.

getObjectFromPrinterViaFtp

public static void getObjectFromPrinterViaFtp(java.io.OutputStream destination,
                              String connectionString,
                              String filePathOnPrinter,
                              String ftpPassword)
                                       throws ConnectionException,
                                              ZebraPrinterLanguageUnknownException,
                                              NotALinkOsPrinterException,
                                              ZebraIllegalArgumentException

Retrieves a file from the printer's file system via FTP and writes the contents of that file to an output stream. Will retrieve the following file extensions: .FNT, .ZPL, .GRF, .DAT, .BAS, .STO, .PNG, .LBL, .TTF, .PCX, .BMP, .IMG, .TTE, .WML, .CSV, .HTM, .BAE, .TXT.
See ConnectionBuilder for the format of connectionString.

Parameters:

destination - Stream to receive the file contents.

connectionString - The connection string.

filePathOnPrinter - File to retrieve. (e.g. "R:MYFILE.PNG")

ftpPassword - password to use for ftp, if null a default password will be used.

Throws:

ConnectionException - if there is an error connecting to the device, or the ftp password is not correct.

ZebraPrinterLanguageUnknownException - if the printer language could not be determined.

NotALinkOsPrinterException - This feature is only available on Link-OS™ printers.

ZebraIllegalArgumentException - if the filename is invalid or does not exist.

updateFirmware

public static void updateFirmware(String connection,
                  String firmwareFilePath,
                  long timeout)
                           throws ConnectionException,
                                  ZebraPrinterLanguageUnknownException,
                                  ZebraIllegalArgumentException,
                                  DiscoveryException,
                                  java.util.concurrent.TimeoutException,
                                  java.io.FileNotFoundException

Update the printer firmware.

Download Firmware Here
See ConnectionBuilder for the format of connection.

Parameters:

connection - The connection string.

firmwareFilePath - File path of firmware file.

timeout - Timeout in milliseconds. The minimum allowed timeout is 5 minutes (300000ms) due to the need to reset the printer after flashing the firmware. If a timeout value less than the minimum is provided, the minimum will be used instead.

Throws:

ConnectionException - if the connection can not be opened or is closed prematurely.

ZebraPrinterLanguageUnknownException - if the printer language can not be determined.

ZebraIllegalArgumentException - if an invalid firmware file is specified for the printer.

DiscoveryException - if an error occurs while waiting for the printer to come back online.

java.util.concurrent.TimeoutException - if the maximum timeout is reached prior to the printer coming back online with the new firmware.

java.io.FileNotFoundException - if the firmware file cannot be found or cannot be opened.

convertGraphic

public static void convertGraphic(String filePathOnPrinter,
                  ZebraImageI image,
                  java.io.OutputStream convertedGraphicOutputStream)
                           throws ZebraIllegalArgumentException,
                                  java.io.IOException

Encodes supplied image in either ZPL or CPCL after dithering and resizing.

Parameters:

filePathOnPrinter - The printer file path you wish to store the image to.

image - ZebraImage to be dithered and resized.

convertedGraphicOutputStream - OutputStream to store encoded image data.

Throws:

ZebraIllegalArgumentException - if the file type is not supported or an invalid image is supplied.

java.io.IOException - Could not read/write to file.

convertGraphic

public static void convertGraphic(String filePathOnPrinter,
                  ZebraImageI image,
                  int width,
                  int height,
                  java.io.OutputStream convertedGraphicOutputStream)
                           throws ZebraIllegalArgumentException,
                                  java.io.IOException

Encodes supplied image in either ZPL or CPCL after dithering and resizing.

Parameters:

filePathOnPrinter - The printer file path you wish to store the image to.

image - ZebraImage to be dithered and resized.

width - Width of the resulting image. If 0 the image is not resized.

height - Height of the resulting image. If 0 the image is not resized.

convertedGraphicOutputStream - OutputStream to store converted image data encoded with the printers native language.

Throws:

ZebraIllegalArgumentException - if the file type is not supported or an invalid image is supplied.

java.io.IOException - Could not read/write to file.

createProfile

public static void createProfile(String connectionString,
                 String profilePath)
                          throws java.io.IOException,
                                 ZebraIllegalArgumentException,
                                 ConnectionException,
                                 ZebraPrinterLanguageUnknownException,
                                 NotALinkOsPrinterException

Create a profile of your printer's settings, alerts, and files for cloning to other printers. A profile contains setting values which can be used to clone another printer to match the original configuration. Some settings (such as I.P. address) which could conflict with the original printer will not be contained in the profile
See ConnectionBuilder for the format of connectionString.

Parameters:

connectionString - The connection string.

profilePath - The location of where to store the profile.

Throws:

ConnectionException - if there is an error connecting to the device.

ZebraPrinterLanguageUnknownException - if the printer language could not be determined.

java.io.IOException - if there is an issue creating the profile.

ZebraIllegalArgumentException - Could not interpret the response from the printer.

NotALinkOsPrinterException - This feature is only available on Link-OS™ printers.

See Also:

ProfileUtil.createProfile(String)

createBackup

public static void createBackup(String connectionString,
                String profilePath)
                         throws ConnectionException,
                                java.io.IOException,
                                ZebraPrinterLanguageUnknownException,
                                ZebraIllegalArgumentException,
                                NotALinkOsPrinterException

Create a backup of your printer's settings, alerts, and files. A backup contains a snapshot of all pertinent settings to fully restore your printer.
See ConnectionBuilder for the format of connectionString.

Parameters:

connectionString - The connection string.

profilePath - The location of where to store the profile. The extension must be .zprofile; if it is not, the method will change it to .zprofile for you.

Throws:

ConnectionException - if there is an error connecting to the device.

ZebraPrinterLanguageUnknownException - if the printer language could not be determined.

java.io.IOException - if there is an issue creating the profile.

ZebraIllegalArgumentException - Could not interpret the response from the printer.

NotALinkOsPrinterException - This feature is only available on Link-OS™ printers.

See Also:

ProfileUtil.createBackup(String)

loadProfile

public static void loadProfile(String connectionString,
               String profilePath,
               FileDeletionOption filesToDelete)
                        throws ConnectionException,
                               java.io.IOException,
                               ZebraPrinterLanguageUnknownException,
                               NotALinkOsPrinterException

Takes settings, alerts, and files from a profile, and applies them to a printer. Before doing so, it deletes the files described by filesToDelete from the printer.
See ConnectionBuilder for the format of connectionString.

Parameters:

connectionString - The connection string.

profilePath - Path to the profile to load. (e.g. /home/user/profile.zprofile)

filesToDelete - An enum describing which files to delete.

Throws:

ConnectionException - if there is an error connecting to the device.

ZebraPrinterLanguageUnknownException - if the printer language could not be determined.

java.io.IOException - if there is an issue loading the profile.

NotALinkOsPrinterException - This feature is only available on Link-OS™ printers.

loadProfile

public static void loadProfile(String connectionString,
               String profilePath,
               FileDeletionOption filesToDelete,
               boolean isVerbose)
                        throws ConnectionException,
                               java.io.IOException,
                               ZebraPrinterLanguageUnknownException,
                               NotALinkOsPrinterException

Takes settings, alerts, and files from a profile, and applies them to a printer. Before doing so, it deletes the files described by filesToDelete from the printer.
See ConnectionBuilder for the format of connectionString.

Parameters:

connectionString - The connection string.

profilePath - Path to the profile to load. (e.g. /home/user/profile.zprofile)

filesToDelete - An enum describing which files to delete.

isVerbose - Increases the amount of detail presented to the user.

Throws:

ConnectionException - if there is an error connecting to the device.

ZebraPrinterLanguageUnknownException - if the printer language could not be determined.

java.io.IOException - if there is an issue loading the profile.

NotALinkOsPrinterException - This feature is only available on Link-OS™ printers.

loadBackup

public static void loadBackup(String connectionString,
              String backupPath)
                       throws ConnectionException,
                              java.io.IOException,
                              ZebraPrinterLanguageUnknownException,
                              NotALinkOsPrinterException

Takes settings, alerts, and files from a backup, and applies them to a printer. This method will also delete all files on your printer before applying the backup.
See ConnectionBuilder for the format of connectionString.

Parameters:

connectionString - The connection string.

backupPath - Path to the profile to load. (e.g. /home/user/profile.zprofile)

Throws:

ConnectionException - if there is an error connecting to the device.

ZebraPrinterLanguageUnknownException - if the printer language could not be determined.

java.io.IOException - if there is an issue loading the profile.

NotALinkOsPrinterException - This feature is only available on Link-OS™ printers.

loadBackup

public static void loadBackup(String connectionString,
              String backupPath,
              boolean isVerbose)
                       throws ConnectionException,
                              java.io.IOException,
                              ZebraPrinterLanguageUnknownException,
                              NotALinkOsPrinterException

Takes settings, alerts, and files from a backup, and applies them to a printer. This method will also delete all files on your printer before applying the backup.
See ConnectionBuilder for the format of connectionString.

Parameters:

connectionString - The connection string.

backupPath - Path to the profile to load. (e.g. /home/user/profile.zprofile)

isVerbose - Increases the amount of detail presented to the user.

Throws:

ConnectionException - if there is an error connecting to the device.

ZebraPrinterLanguageUnknownException - if the printer language could not be determined.

java.io.IOException - if there is an issue loading the profile.

NotALinkOsPrinterException - This feature is only available on Link-OS™ printers.

storeFile

public static void storeFile(String connectionString,
             String filePath,
             String remoteName)
                      throws ConnectionException,
                             ZebraPrinterLanguageUnknownException,
                             NotALinkOsPrinterException,
                             ZebraIllegalArgumentException,
                             java.io.IOException

Stores the file on the printer at the specified location and name using any required file wrappers.
See ConnectionBuilder for the format of connectionString.

Parameters:

connectionString - The connection string.

filePath - The path of the file to store.

remoteName - The path on the printer.

Throws:

ConnectionException - if there is an error connecting to the device.

ZebraPrinterLanguageUnknownException - if the printer language could not be determined.

java.io.IOException - if there is an issue storing the file.

NotALinkOsPrinterException - This feature is only available on Link-OS™ printers.

ZebraIllegalArgumentException - if there is an issue storing the file.

resetPrinter

public static void resetPrinter(String connectionString)
                         throws ConnectionException,
                                ZebraPrinterLanguageUnknownException,
                                NotALinkOsPrinterException

Resets the specified printer.
See ConnectionBuilder for the format of connectionString.

Parameters:

connectionString - The connection string.

Throws:

ConnectionException - if there is an error connecting to the device

ZebraPrinterLanguageUnknownException - if the printer language could not be determined

NotALinkOsPrinterException - This feature is only available on Link-OS™ printers.

resetNetwork

public static void resetNetwork(String connectionString)
                         throws ConnectionException,
                                ZebraPrinterLanguageUnknownException,
                                NotALinkOsPrinterException

Resets the network of the specified printer. Usually performed to enable changed network settings to take effect.
See ConnectionBuilder for the format of connectionString.

Parameters:

connectionString - The connection string.

Throws:

ConnectionException - if there is an error connecting to the device

ZebraPrinterLanguageUnknownException - if the printer language could not be determined.

NotALinkOsPrinterException - This feature is only available on Link-OS™ printers.

restorePrinterDefaults

public static void restorePrinterDefaults(String connectionString)
                                   throws ConnectionException,
                                          ZebraPrinterLanguageUnknownException,
                                          NotALinkOsPrinterException

Restores the printer's settings to their factory default configuration.
See ConnectionBuilder for the format of connectionString.

Parameters:

connectionString - The connection string.

Throws:

ConnectionException - if there is an error connecting to the device.

ZebraPrinterLanguageUnknownException - if the printer language could not be determined.

NotALinkOsPrinterException - This feature is only available on Link-OS™ printers.

restoreNetworkDefaults

public static void restoreNetworkDefaults(String connectionString)
                                   throws ConnectionException,
                                          ZebraPrinterLanguageUnknownException,
                                          NotALinkOsPrinterException

Restores the printer's network settings to their factory default configuration. Use caution when issuing this command because you may lose connectivity with your printer if your network requires non-default settings.
See ConnectionBuilder for the format of connectionString.

Parameters:

connectionString - The connection string.

Throws:

ConnectionException - if there is an error connecting to the device.

ZebraPrinterLanguageUnknownException - if the printer language could not be determined.

NotALinkOsPrinterException - This feature is only available on Link-OS™ printers.

printConfigLabel

public static void printConfigLabel(String connectionString)
                             throws ConnectionException,
                                    ZebraPrinterLanguageUnknownException,
                                    NotALinkOsPrinterException

Causes the specified printer to print a configuration label.
See ConnectionBuilder for the format of connectionString.

Parameters:

connectionString - The connection string.

Throws:

ConnectionException - if there is an error connecting to the device.

ZebraPrinterLanguageUnknownException - if the printer language could not be determined.

NotALinkOsPrinterException - This feature is only available on Link-OS™ printers.

printNetworkConfigLabel

public static void printNetworkConfigLabel(String connectionString)
                                    throws ConnectionException,
                                           ZebraPrinterLanguageUnknownException,
                                           NotALinkOsPrinterException

Causes the specified printer to print a network configuration label.
See ConnectionBuilder for the format of connectionString.

Parameters:

connectionString - The connection string.

Throws:

ConnectionException - if there is an error connecting to the device.

ZebraPrinterLanguageUnknownException - if the printer language could not be determined.

NotALinkOsPrinterException - This feature is only available on Link-OS™ printers.

printDirectoryLabel

public static void printDirectoryLabel(String connectionString)
                                throws ConnectionException,
                                       ZebraPrinterLanguageUnknownException,
                                       NotALinkOsPrinterException

Causes the specified printer to print a directory listing of all the files saved on the printer.
See ConnectionBuilder for the format of connectionString.

Parameters:

connectionString - The connection string.

Throws:

ConnectionException - if there is an error connecting to the device.

ZebraPrinterLanguageUnknownException - if the printer language could not be determined.

NotALinkOsPrinterException - This feature is only available on Link-OS™ printers.

getSettingsFromPrinter

public static java.util.Map<String,Setting> getSettingsFromPrinter(String connectionString)
                                                            throws ConnectionException,
                                                                   ZebraPrinterLanguageUnknownException,
                                                                   NotALinkOsPrinterException,
                                                                   SettingsException

Retrieve all settings and their attributes from the specified printer.
See ConnectionBuilder for the format of connectionString.

Parameters:

connectionString - The connection string.

Returns:

A map of setting names versus Setting objects from the printer specified in the connection string.

Throws:

NotALinkOsPrinterException - This feature is only available on Link-OS™ printers.

ZebraPrinterLanguageUnknownException - if the printer language can not be determined.

ConnectionException - if there is an error connecting to the device.

SettingsException - if the settings could not be retrieved.

getCurrentStatus

public static PrinterStatus getCurrentStatus(Connection printerConnection,
                             PrinterLanguage language)
                                      throws ConnectionException

Returns a new instance of PrinterStatus that can be used to determine the status of a printer. Each invocation of this method will result in a query of the connected printer. If more than one status value is to be read, it is recommended that a copy of PrinterStatus is stored locally.

Note: This method must be invoked again to retrieve the most up-to-date status of the printer. The PrinterStatus object will only query the printer upon creation.
Note: Some Mobile printers (including the MZ series printers) will not communicate if the printer is not ready to print. On these printers, status information is not available when, for example, the printer is out of paper. This method will throw a ConnectionException if it is called when the printer cannot communicate.

Parameters:

printerConnection - Connection to the printer.

language - Printer control language to be used.

Returns:

a new instance of PrinterStatus.

Throws:

ConnectionException - if there is an issue communicating with the printer (e.g. the connection is not open.)

See Also:

PrinterStatus