Package com.avoka.fc.core.service.archive

Class MetadataTagArchiveService

java.lang.Object

com.avoka.fc.core.service.BaseService

com.avoka.fc.core.service.CayenneService

com.avoka.fc.core.service.archive.BaseArchiveService

com.avoka.fc.core.service.archive.MetadataTagArchiveService

public class MetadataTagArchiveService
extends BaseArchiveService

Provides a metadata tag archive export and import service.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	MetadataTagArchiveService.ImportOption	Various import options controlling which entities will be imported

Nested classes/interfaces inherited from class com.avoka.fc.core.service.archive.BaseArchiveService

BaseArchiveService.FormData

Field Summary

Fields

Modifier and Type	Field	Description
static String	METADATA_TAG_CONFIG_FILENAME	The metadata tag configuration file name

Fields inherited from class com.avoka.fc.core.service.archive.BaseArchiveService

ATTRIBUTE_BUILD_NUMBER, ATTRIBUTE_DB_VERSION, ATTRIBUTE_ENVIRONMENT_NAME, ATTRIBUTE_EXPORT_DATE, ATTRIBUTE_FORM_PORTAL_ANONYMOUS, ATTRIBUTE_FORM_PORTAL_AUTHENTICATED, ATTRIBUTE_SFM_VERSION, DIR_FAR, DIR_FORM, DIR_RECEIPT, DIR_SCHEMA_SEED, DIR_XML_PREFILL, ELEMENT_APPLICATION_PACKAGE, ELEMENT_APPLICATION_PACKAGES, ELEMENT_AUTHENTICATION_MODE, ELEMENT_CATEGORY_NAME, ELEMENT_CLIENT, ELEMENT_CLIENT_CODE, ELEMENT_DOCUMENT_TYPE_CLIENT, ELEMENT_DOCUMENT_TYPE_NAME, ELEMENT_FORM_ABANDON_DELIVERY, ELEMENT_FORM_DELIVERY_PROD, ELEMENT_FORM_DELIVERY_TEST, ELEMENT_FORM_FUNCTION, ELEMENT_FORM_FUNCTIONS, ELEMENT_FORM_GROUP, ELEMENT_FORM_GROUPS, ELEMENT_FORM_PORTAL, ELEMENT_FORM_PORTAL_PORTAL_NAME, ELEMENT_FORM_PORTALS, ELEMENT_FORM_VALIDATION_DELIVERY, ELEMENT_METADATA_TAG_CLIENT, ELEMENT_METADATA_TAG_NAME, ELEMENT_PARAMETER_PREFILL_MAPPING, ELEMENT_PARAMETER_PREFILL_MAPPINGS, ELEMENT_PROPERTY_PREFILL_MAPPING, ELEMENT_PROPERTY_PREFILL_MAPPINGS, ELEMENT_PROPERTY_TYPE_CLIENT, ELEMENT_PROPERTY_TYPE_NAME, ELEMENT_PROPERTY_TYPE_SCOPE, ELEMENT_SCHEMA_CONFIG_MAPPING, ELEMENT_SCHEMA_CONFIG_MAPPINGS, ELEMENT_SCHEMA_EXTRACT_MAPPING, ELEMENT_SCHEMA_EXTRACT_MAPPINGS, ELEMENT_SCHEMA_SEED, ELEMENT_SERVICE, ELEMENT_SERVICE_CLIENT_CODE, ELEMENT_SERVICE_CONNECTION, ELEMENT_SERVICE_CONNECTIONS, ELEMENT_SERVICE_NAME, ELEMENT_SERVICE_PARAMETER, ELEMENT_SERVICE_PARAMETERS, ELEMENT_SERVICE_TYPE, ELEMENT_SERVICE_VERSION, ELEMENT_SERVICES, ELEMENT_TEMPLATE_VERSION, ELEMENT_TEMPLATE_VERSION_DEPLOYMENT, ELEMENT_TEMPLATE_VERSION_DEPLOYMENTS, ELEMENT_TEMPLATE_VERSIONS, ELEMENT_VERSION_ATTACHMENT, ELEMENT_VERSION_ATTACHMENTS, ELEMENT_VERSION_CATEGORIES, ELEMENT_VERSION_CATEGORY, ELEMENT_VERSION_METADATA_VALUE, ELEMENT_VERSION_METADATA_VALUES, ELEMENT_VERSION_PROPERTY_VALUE, ELEMENT_VERSION_PROPERTY_VALUES, ELEMENT_XML_PREFILL_MAPPING, ELEMENT_XML_PREFILL_MAPPINGS, ELEMENT_XML_PREFILL_VERSION, ENCODING, FILE_FAR_DEFAULT, FILE_SCHEMA_SEED_DEFAULT, FILE_XML_PREFILL_DEFAULT, groovySecureAPI, METADATA_ENVIRONMENT_NAME, METADATA_ENVIRONMENT_TYPE, METADATA_ENVIRONMENT_TYPE_MAESTRO, METADATA_EXPORT_DATE, METADATA_EXPORT_DB_VERSION, METADATA_EXPORT_REVISION, METADATA_EXPORT_VERSION, METADATA_IMPORT_ACTION, METADATA_IMPORT_ACTION_CONFLICT, METADATA_IMPORT_ACTION_CREATE, METADATA_IMPORT_ACTION_ERROR, METADATA_IMPORT_ACTION_MESSAGE, METADATA_IMPORT_ACTION_UPDATE, oldCurrentServiceVersions, PORTAL_AUTHENTICATION_DB_VERSION, SERVICE_TYPE_CARD_PAYMENT_OBSOLETE, updatedTemplateVersionIds

Constructor Summary

Constructors

Constructor	Description
MetadataTagArchiveService()

Method Summary

Modifier and Type	Method	Description
protected void	exportAuditLogger(Object object)	Create an entry in the audit log when an export is performed
protected String	getEntityName()	Return the name identifying the individual entity being exported (e.g.
Map<String,String>	getImportMetadata(byte[] importData)	Retrieve the set of metadata values describing a metadata tag archive that is being imported.
IJMImportOption	getImportOptionEnum()	Return a value from the import option enum, if this service has import options.
protected void	importAuditLogger(ImportAction importAction)	Create an entry in the audit log when an import is performed
protected void	performImport(ImportAction importAction, Set<? extends Enum> importOptions, Map<String,Object> parameters)	Performs the act of importing the data contained in the archive to the SFM database.
protected void	processImportFile(String fileName, byte[] fileData)	For a given file in the imported archive, the service stores its contents as it sees fit, preserving what it will need to recreate entities later.
void	validateImportData(byte[] importData)	Validate a form archive before it is imported.
protected void	writeExportData(Object object, ZipOutputStream zos, Map<String,String> additionalHeaders)	Does the actual export of the data without having to worry about handling errors or preparing and closing the stream

Methods inherited from class com.avoka.fc.core.service.archive.BaseArchiveService

addDeploymentSchedule, addForm, addFormFunctions, addFormGroups, addFormPortals, addParameterPrefillMaps, addPropertyPrefillMaps, addSchemaExtractMaps, addSchemaSeed, addService, addServiceConnection, addTemplateVersion, addTemplateVersionData, addVersionAttachments, addVersionCategories, addVersionMetadataValues, addVersionPropertyValues, addXmlPrefillMaps, copyFromElementToEntity, copyFromElementToEntity, createChildProperty, createChildValue, exportData, exportData, findFileInArchive, getByteArrayForElement, getByteArrayForZipEntry, getDefaultImportOptions, getElementForByteArray, getFormData, getFormVersionKey, getFormVersionKey, importApplicationPackages, importApplicationPackages, importArchive, importArchive, importDeploymentPlan, importFormFunctions, importFormGroups, importFormPortals, importOldSchemaConfigMaps, importParameterPrefillMaps, importPropertyPrefillMaps, importSchemaExtractMaps, importSchemaSeed, importServiceConnection, importServiceDefinition, importServiceParameters, importTemplateVersionData, importTemplateVersions, importTemplateVersions, importVersionAttachments, importVersionCategories, importVersionMetadata, importVersionProperties, importXmlPrefillMaps, isGroovySecureAPI, postExport, postImport, readApplicationPackageReference, readClientCodeReference, readMetadataAttributes, readServiceName, readServiceReference, setGroovySecureAPI, updateUnifiedAppFlagAndDoc, writeApplicationPackageReference, writeClientCodeReference, writeHeaderAttributes, writeServiceReference

Methods inherited from class com.avoka.fc.core.service.CayenneService

commitChanges, deleteObject, deleteObjects, findObject, getDataContext, getDataDomain, getObjectForPK, getObjectStore, newObject, performNamedQuery, performNamedQuery, performNamedQuery, performNonSelectingQuery, performNonSelectingQuery, performNonSelectingQuery, performNonSelectingQuery, performQuery, performQuery, refetchEntity, refetchObject, registerNewObject, rollbackChanges, toMap, toMap

Methods inherited from class com.avoka.fc.core.service.BaseService

getLogger

Methods inherited from class java.lang.Object

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

Field Detail

METADATA_TAG_CONFIG_FILENAME

public static final String METADATA_TAG_CONFIG_FILENAME

The metadata tag configuration file name

See Also:

Constant Field Values

Constructor Detail

MetadataTagArchiveService

public MetadataTagArchiveService()

Method Detail

validateImportData

public void validateImportData(byte[] importData)
                        throws ImportValidationException,
                               IOException

Validate a form archive before it is imported.

Specified by:

validateImportData in class BaseArchiveService

Parameters:

importData - the import archive as a byte array

Throws:

ImportValidationException - if the archive can be parsed, but does not contain the expected archive files

IOException - if an error occurs loading the import archive contents

getImportMetadata

public Map<String,String> getImportMetadata(byte[] importData)
                                           throws ImportValidationException,
                                                  IOException

Retrieve the set of metadata values describing a metadata tag archive that is being imported.

Specified by:

getImportMetadata in class BaseArchiveService

Parameters:

importData - the import archive as a byte array

Returns:

a map of metadata names and their values

Throws:

IOException - if an error occurs while parsing the import archive

ImportValidationException - if the XML file describing the form was not found in the archive

getImportOptionEnum

public IJMImportOption getImportOptionEnum()

Return a value from the import option enum, if this service has import options. Can be used to call IJMImportOption.defaultForImportAction(String)

Overrides:

getImportOptionEnum in class BaseArchiveService

Returns:

one of the import options

writeExportData

protected void writeExportData(Object object,
                               ZipOutputStream zos,
                               Map<String,String> additionalHeaders)
                        throws IOException,
                               ParserConfigurationException

Description copied from class: BaseArchiveService

Does the actual export of the data without having to worry about handling errors or preparing and closing the stream

Specified by:

writeExportData in class BaseArchiveService

Parameters:

object - the non-null object to be exported

zos - the stream to be written to

additionalHeaders - the map of additional headers to be included in metadata

Throws:

IOException

ParserConfigurationException

processImportFile

protected void processImportFile(String fileName,
                                 byte[] fileData)
                          throws UnsupportedEncodingException

Description copied from class: BaseArchiveService

For a given file in the imported archive, the service stores its contents as it sees fit, preserving what it will need to recreate entities later. This operation happens before the database transaction wrapping the actual import to the SFM database.

Specified by:

processImportFile in class BaseArchiveService

Parameters:

fileName - the full file name of the ZIP file entry (e.g. form/TestForm.pdf)

fileData - the file data of the ZIP file entry

Throws:

UnsupportedEncodingException

performImport

protected void performImport(ImportAction importAction,
                             Set<? extends Enum> importOptions,
                             Map<String,Object> parameters)

Description copied from class: BaseArchiveService

Performs the act of importing the data contained in the archive to the SFM database. When this method will be called, the caller is expected to have established a transaction, and will also handle errors thrown by this method.

Specified by:

performImport in class BaseArchiveService

Parameters:

importAction - the import action related to this import

importOptions - the set of import options that should be applied

parameters - optional parameters to be used during import

getEntityName

protected String getEntityName()

Description copied from class: BaseArchiveService

Return the name identifying the individual entity being exported (e.g. for a client, the client's name)

Specified by:

getEntityName in class BaseArchiveService

Returns:

the entity name

exportAuditLogger

protected void exportAuditLogger(Object object)

Create an entry in the audit log when an export is performed

Specified by:

exportAuditLogger in class BaseArchiveService

Parameters:

object - Object that was exported (Optional)

Since:

17.10.2

importAuditLogger

protected void importAuditLogger(ImportAction importAction)

Create an entry in the audit log when an import is performed

Specified by:

importAuditLogger in class BaseArchiveService

Parameters:

object - ImportAction containing action performed (required)

Since:

17.10.2