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

Class ServiceArchiveService

  • public class ServiceArchiveService
extends BaseArchiveService
    Provides a service archive export and import service.

    • Field Detail

      • SERVICE_CONFIG_FILENAME

        public static final String SERVICE_CONFIG_FILENAME
        The service configuration file name
        See Also:
        Constant Field Values

      • METADATA_SERVICE_NAME

        public static final String METADATA_SERVICE_NAME
        The name of the metadata value storing the name of the service or set of services to be imported
        See Also:
        Constant Field Values

      • METADATA_MULTIPLE_SERVICES_FLAG

        public static final String METADATA_MULTIPLE_SERVICES_FLAG
        The name of the metadata value flag storing whether the archive contains multiple or just a single service
        See Also:
        Constant Field Values

      • METADATA_CLIENT_CODE

        public static final String METADATA_CLIENT_CODE
        The name of the metadata value storing the organization for which services were exported (if applicable)
        See Also:
        Constant Field Values

    • Constructor Detail

      • ServiceArchiveService

        public ServiceArchiveService()

    • Method Detail

      • setNewClientCode

        public void setNewClientCode​(String newClientCode)
        Set the client code of the import target client. Note: This client code will be ignored if importAsGlobal is set to true (it defaults to false, but can be flipped using ServiceConnectionArchiveService#setImportAsGlobalConnection(boolean)).
        Parameters:
        newClientCode - the client code (optional; if not specified, the client in the archive will be used)

      • getImportMetadata

        public Map<String,​String> getImportMetadata​(byte[] importData)
                                           throws Exception
        Description copied from class: BaseArchiveService
        Retrieve the set of metadata values describing an 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:
        Exception - if an error occurs while the metadata is being loaded

      • getImportMetadata

        public Map<String,​String> getImportMetadata​(byte[] importData,
                                                  String newClientCode)
                                           throws Exception
        Retrieve metadata describing the archive contents and expected import outcome.
        Parameters:
        importData - the archive byte data (required)
        newClientCode - the client code that the new services shall be imported to (optional)
        Returns:
        a map of import metadata
        Throws:
        Exception - if an error occurs

      • writeExportData

        protected void writeExportData​(Object object,
                               ZipOutputStream zos,
                               Map<String,​String> additionalHeaders)
                        throws Exception
        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:
        Exception - if an error occurs

      • processImportFile

        protected void processImportFile​(String fileName,
                                 byte[] fileData)
                          throws Exception
        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:
        Exception - if an error occurs

      • performImport

        protected void performImport​(ImportAction importAction,
                             Set<? extends Enum> importOptions,
                             Map<String,​Object> parameters)
                      throws Exception
        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
        Throws:
        Exception - If an error occurs. The caller is responsible for rolling back the transaction to avoid contaminating the database.

      • 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 of type Pair> 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