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
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.

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

saveTemplate

public void saveTemplate(String templateName,
                String templateData)
                  throws IllegalArgumentException,
                         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.

IOException - on failure to store the template.

See Also:

ZebraTemplate.saveTemplate(String, String)

deleteTemplate

public void deleteTemplate(String templateName)
                    throws IllegalArgumentException,
                           ZebraCardException,
                           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.

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,
                          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.

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

See Also:

ZebraTemplate.getTemplate(String)

getAllTemplateNames

public List<String> getAllTemplateNames()
                                 throws 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:

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

See Also:

ZebraTemplate.getAllTemplateNames()

getTemplateFields

public List<String> getTemplateFields(String templateName)
                               throws IllegalArgumentException,
                                      ZebraCardException,
                                      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.

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 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:

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 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:

IOException - if specified image is not found.

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

See Also:

ZebraTemplate.getTemplateImageData(String)

getAllTemplateImageNames

public List<String> getAllTemplateImageNames()
                                      throws 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:

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

See Also:

ZebraTemplate.getAllTemplateImageNames()

deleteTemplateImage

public void deleteTemplateImage(String imageName)
                         throws ZebraCardException,
                                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.

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,
                              Map<String,String> fieldDataMap)
                                throws ConnectionException,
                                       SettingsException,
                                       ZebraCardException,
                                       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.

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

See Also:

ZebraTemplate.generateTemplateJob(String, Map)

generateTemplateDataJob

public TemplateJob generateTemplateDataJob(String templateData,
                                  Map<String,String> fieldDataMap)
                                    throws ConnectionException,
                                           SettingsException,
                                           ZebraCardException,
                                           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.

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

See Also:

ZebraTemplate.generateTemplateDataJob(String, Map)

convertDataDocumentToDataMap

public 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)