com.zebra.sdk.common.card.template

Class ZebraCardTemplate

Object

com.zebra.sdk.common.card.template.ZebraCardTemplate

All Implemented Interfaces:

ZebraTemplate

public class ZebraCardTemplate
extends Object
implements ZebraTemplate

Class for managing template related operations

Constructor Summary

Constructors

Constructor and Description
ZebraCardTemplate(ZebraCardPrinter genericPrinter) Constructs a ZebraCardTemplate object.

Method Summary

Methods

Modifier and Type	Method and Description
java.util.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, java.util.Map<String,String> fieldDataMap) Returns an instance of TemplateJob containing the job specific data.
TemplateJob	generateTemplateJob(String templateName, java.util.Map<String,String> fieldDataMap) Returns an instance of TemplateJob containing the job specific data.
java.util.List<String>	getAllTemplateImageNames() Gets a list of all stored template images.
java.util.List<String>	getAllTemplateNames() Returns a list containing the stored template names.
String	getTemplate(String templateName) Returns the specified template.
java.util.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.
void	setTemplateFileDirectory(String directoryPath) Sets the directory location for retrieving/storing template files.
void	setTemplateImageFileDirectory(String directoryPath) Sets the directory location for retrieving/storing template image files.

Methods inherited from class Object

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

Constructor Detail

ZebraCardTemplate

public ZebraCardTemplate(ZebraCardPrinter genericPrinter)

Constructs a ZebraCardTemplate object.

Parameters:

genericPrinter - interface used to obtain various properties of a Zebra card printer.

Method Detail

setTemplateFileDirectory

public void setTemplateFileDirectory(String directoryPath)
                              throws IllegalArgumentException,
                                     java.io.IOException

Description copied from interface: ZebraTemplate

Sets the directory location for retrieving/storing template files.

Specified by:

setTemplateFileDirectory in interface ZebraTemplate

Parameters:

directoryPath - directory path for template files.

Throws:

IllegalArgumentException - If the directoryPath is invalid.

java.io.IOException - If there is an error accessing or creating the template file directory.

See Also:

ZebraTemplate.setTemplateFileDirectory(String)

setTemplateImageFileDirectory

public void setTemplateImageFileDirectory(String directoryPath)
                                   throws IllegalArgumentException,
                                          java.io.IOException

Description copied from interface: ZebraTemplate

Sets the directory location for retrieving/storing template image files.

Specified by:

setTemplateImageFileDirectory in interface ZebraTemplate

Parameters:

directoryPath - directory path for template image files.

Throws:

IllegalArgumentException - If the directoryPath is invalid.

java.io.IOException - If there is an error accessing or creating the template image file directory.

See Also:

ZebraTemplate.setTemplateImageFileDirectory(String)

saveTemplate

public void saveTemplate(String templateName,
                String templateData)
                  throws IllegalArgumentException,
                         java.io.IOException

Description copied from interface: ZebraTemplate

Saves the specified template.

Specified by:

saveTemplate in interface ZebraTemplate

Parameters:

templateName - the name of the template.

templateData - the XML formatted template.

Throws:

IllegalArgumentException - if specified template name already exists.

java.io.IOException - on failure to store the template.

See Also:

ZebraTemplate.saveTemplate(String, String)

deleteTemplate

public void deleteTemplate(String templateName)
                    throws IllegalArgumentException,
                           ZebraCardException,
                           java.io.IOException

Description copied from interface: ZebraTemplate

Deletes the specified template.

Specified by:

deleteTemplate in interface ZebraTemplate

Parameters:

templateName - the name of the template.

Throws:

IllegalArgumentException - if specified template name is invalid.

ZebraCardException - on failure to delete the template.

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

See Also:

ZebraTemplate.deleteTemplate(String)

getTemplate

public String getTemplate(String templateName)
                   throws IllegalArgumentException,
                          java.io.IOException

Description copied from interface: ZebraTemplate

Returns the specified template.

Specified by:

getTemplate in interface ZebraTemplate

Parameters:

templateName - the name of the template.

Returns:

the XML formatted template.

Throws:

IllegalArgumentException - if specified template name is invalid.

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

See Also:

ZebraTemplate.getTemplate(String)

getAllTemplateNames

public java.util.List<String> getAllTemplateNames()
                                           throws java.io.IOException

Description copied from interface: ZebraTemplate

Returns a list containing the stored template names.

Specified by:

getAllTemplateNames in interface ZebraTemplate

Returns:

a list containing the stored template names.

Throws:

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

See Also:

ZebraTemplate.getAllTemplateNames()

getTemplateFields

public java.util.List<String> getTemplateFields(String templateName)
                                         throws IllegalArgumentException,
                                                ZebraCardException,
                                                java.io.IOException

Description copied from interface: ZebraTemplate

Returns the template fields from the specified XML template.

Specified by:

getTemplateFields in interface ZebraTemplate

Parameters:

templateName - the name of the template.

Returns:

a list containing the template field names and values.

Throws:

IllegalArgumentException - if specified template name is null or empty.

ZebraCardException - on failure to read the stored template data.

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

See Also:

ZebraTemplate.getTemplateFields(String)

saveTemplateImage

public void saveTemplateImage(String imageName,
                     byte[] imageData)
                       throws java.io.IOException,
                              IllegalArgumentException

Description copied from interface: ZebraTemplate

Saves the specified template image.

Specified by:

saveTemplateImage in interface ZebraTemplate

Parameters:

imageName - the name of the image.

imageData - the image data.

Throws:

java.io.IOException - on failure to save image data.

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

See Also:

ZebraTemplate.saveTemplateImage(String, byte[])

getTemplateImageData

public byte[] getTemplateImageData(String imageName)
                            throws java.io.IOException,
                                   IllegalArgumentException

Description copied from interface: ZebraTemplate

Returns the raw image data from the specified image name.

Specified by:

getTemplateImageData in interface ZebraTemplate

Parameters:

imageName - the name of the image.

Returns:

the image data.

Throws:

java.io.IOException - if specified image is not found.

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

See Also:

ZebraTemplate.getTemplateImageData(String)

getAllTemplateImageNames

public java.util.List<String> getAllTemplateImageNames()
                                                throws java.io.IOException

Description copied from interface: ZebraTemplate

Gets a list of all stored template images.

Specified by:

getAllTemplateImageNames in interface ZebraTemplate

Returns:

a list containing the template image file names.

Throws:

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

See Also:

ZebraTemplate.getAllTemplateImageNames()

deleteTemplateImage

public void deleteTemplateImage(String imageName)
                         throws ZebraCardException,
                                java.io.IOException

Description copied from interface: ZebraTemplate

Deletes the specified template image.

Specified by:

deleteTemplateImage in interface ZebraTemplate

Parameters:

imageName - image name.

Throws:

ZebraCardException - on failure to delete the specified image.

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

See Also:

ZebraTemplate.deleteTemplateImage(String)

generateTemplateJob

public TemplateJob generateTemplateJob(String templateName,
                              java.util.Map<String,String> fieldDataMap)
                                throws ConnectionException,
                                       SettingsException,
                                       ZebraCardException,
                                       java.io.IOException

Description copied from interface: ZebraTemplate

Returns an instance of TemplateJob containing the job specific data.

Specified by:

generateTemplateJob in interface ZebraTemplate

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.

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

ZebraCardException - on template job generation error.

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

See Also:

ZebraTemplate.generateTemplateJob(String, Map)

generateTemplateDataJob

public TemplateJob generateTemplateDataJob(String templateData,
                                  java.util.Map<String,String> fieldDataMap)
                                    throws ConnectionException,
                                           SettingsException,
                                           ZebraCardException,
                                           java.io.IOException

Description copied from interface: ZebraTemplate

Returns an instance of TemplateJob containing the job specific data.

Specified by:

generateTemplateDataJob in interface ZebraTemplate

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.

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

ZebraCardException - on template job generation error.

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

See Also:

ZebraTemplate.generateTemplateDataJob(String, Map)

convertDataDocumentToDataMap

public java.util.Map<String,String> convertDataDocumentToDataMap(String dataDocument)
                                                          throws IllegalArgumentException,
                                                                 ZebraCardException

Description copied from interface: ZebraTemplate

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

Specified by:

convertDataDocumentToDataMap in interface ZebraTemplate

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:

IllegalArgumentException - on invalid dataDocument value or format.

ZebraCardException - on data parsing error.

See Also:

ZebraTemplate.convertDataDocumentToDataMap(String)