com.zebra.sdk.common.card.job.template

Interface ZebraTemplate

All Known Implementing Classes:

ZebraCardTemplate

public interface ZebraTemplate

An interface used to define functions used in template related operations.

Method Summary

Methods

Modifier and Type	Method and Description
Map<String,String>	convertDataDocumentToDataMap(String dataDocument) Converts a JSON or XML formatted template data document into a Map.
void	deleteTemplate(String templateName) Deletes the specified template.
void	deleteTemplateImage(String imageName) Deletes the specified template image.
TemplateJob	generateTemplateDataJob(String templateData, Map<String,String> fieldDataMap) Returns an instance of TemplateJob containing the job specific data.
TemplateJob	generateTemplateJob(String templateName, Map<String,String> fieldDataMap) Returns an instance of TemplateJob containing the job specific data.
List<String>	getAllTemplateImageNames() Gets a list of all stored template images.
List<String>	getAllTemplateNames() Returns a list containing the stored template names.
String	getTemplate(String templateName) Returns the specified template.
List<String>	getTemplateFields(String templateName) Returns the template fields from the specified XML template.
byte[]	getTemplateImageData(String imageName) Returns the raw image data from the specified image name.
void	saveTemplate(String templateName, String templateData) Saves the specified template.
void	saveTemplateImage(String imageName, byte[] imageData) Saves the specified template image.

Method Detail

deleteTemplate

void deleteTemplate(String templateName)
                    throws IllegalArgumentException,
                           ZebraCardException,
                           IOException

Deletes the specified template.

Parameters:

templateName - the name of the template.

Throws:

ZebraCardException - on failure to delete the template.

IllegalArgumentException - if specified template name is invalid.

IOException - if specified template is not found or an error is encountered accessing the stored template file.

saveTemplate

void saveTemplate(String templateName,
                String templateData)
                  throws IllegalArgumentException,
                         ZebraCardException,
                         IOException

Saves the specified template.

Parameters:

templateName - the name of the template.

templateData - the XML formatted template.

Throws:

IllegalArgumentException - if specified template name already exists.

IOException - on failure to store the template.

ZebraCardException

getTemplate

String getTemplate(String templateName)
                   throws IllegalArgumentException,
                          IOException

Returns the specified template.

Parameters:

templateName - the name of the template.

Returns:

the XML formatted template.

Throws:

ZebraCardException - on failure to obtain the template.

IllegalArgumentException - if specified template name is invalid.

IOException - if specified template is not found or an I/O related error occurs.

getAllTemplateNames

List<String> getAllTemplateNames()
                                 throws IOException

Returns a list containing the stored template names.

Returns:

a list containing the stored template names.

Throws:

IOException - if an I/O related error occurs while accessing the stored templates.

getTemplateFields

List<String> getTemplateFields(String templateName)
                               throws IllegalArgumentException,
                                      ZebraCardException,
                                      IOException

Returns the template fields from the specified XML template.

Parameters:

templateName - the name of the template.

Returns:

a list containing the template field names and values.

Throws:

ZebraCardException - on failure to read the stored template data.

IllegalArgumentException - if specified template name is null or empty.

IOException - if specified template is not found or an I/O related error occurs.

generateTemplateJob

TemplateJob generateTemplateJob(String templateName,
                              Map<String,String> fieldDataMap)
                                throws ZebraCardException,
                                       IOException,
                                       ConnectionException,
                                       SettingsException

Returns an instance of TemplateJob containing the job specific data.

Parameters:

templateName - the name of the template.

fieldDataMap - a map containing the template field names as the keys and the template field values for the key values.

Returns:

generated instance of TemplateJob.

Throws:

ConnectionException - if the device is busy or an error occurs communicating with the printer.

IOException - on failure to locate/access the referenced template or image files.

SettingsException - if an error occurs while generating the template job.

ZebraCardException - on template job generation error.

generateTemplateDataJob

TemplateJob generateTemplateDataJob(String templateData,
                                  Map<String,String> fieldDataMap)
                                    throws ConnectionException,
                                           SettingsException,
                                           ZebraCardException,
                                           IOException

Returns an instance of TemplateJob containing the job specific data.

Parameters:

templateData - the XML formatted template data.

fieldDataMap - a map containing the template field names as the keys and the template field values for the key values.

Returns:

generated instance of TemplateJob.

Throws:

ConnectionException - if the device is busy or an error occurs communicating with the printer.

IOException - on failure to locate/access the referenced template or image files.

SettingsException - if an error occurs while generating the template job.

ZebraCardException - on template job generation error.

deleteTemplateImage

void deleteTemplateImage(String imageName)
                         throws ZebraCardException,
                                IOException

Deletes the specified template image.

Parameters:

imageName - image name.

Throws:

ZebraCardException - on failure to delete the specified image.

IOException - if specified image is not found or an error is encountered accessing the stored image file.

getAllTemplateImageNames

List<String> getAllTemplateImageNames()
                                      throws IOException

Gets a list of all stored template images.

Returns:

a list containing the template image file names.

Throws:

IOException - if an error is encountered while accessing the stored image files.

getTemplateImageData

byte[] getTemplateImageData(String imageName)
                            throws IOException,
                                   IllegalArgumentException

Returns the raw image data from the specified image name.

Parameters:

imageName - the name of the image.

Returns:

the image data.

Throws:

IOException - if specified image is not found.

IllegalArgumentException - if the specified image name is empty or null.

saveTemplateImage

void saveTemplateImage(String imageName,
                     byte[] imageData)
                       throws IOException,
                              IllegalArgumentException

Saves the specified template image.

Parameters:

imageName - the name of the image.

imageData - the image data.

Throws:

IOException - on failure to save image data.

IllegalArgumentException - if the specified image name and/or data is empty or null.

convertDataDocumentToDataMap

Map<String,String> convertDataDocumentToDataMap(String dataDocument)
                                                throws IllegalArgumentException,
                                                       ZebraCardException

Converts a JSON or XML formatted template data document into a Map.

Parameters:

dataDocument - JSON or XML formatted template data document.

Returns:

a map containing the template field names as the keys and the template field values for the key values.

Throws:

ZebraCardException - on data parsing error.

IllegalArgumentException - on invalid dataDocument value or format.