services.gui

Class ImportExportService

java.lang.Object

services.gui.ImportExportService

@Singleton
public class ImportExportService
extends java.lang.Object

Service class for JATOS Controllers (not Publix).

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	SESSION_UNZIPPED_STUDY_DIR

Method Summary

Modifier and Type	Method and Description
void	cleanupAfterStudyImport()
java.io.File	createStudyExportZipFile(Study study) Returns a JATOS study archive (suffix .jzip).
com.fasterxml.jackson.databind.node.ObjectNode	importStudy(User signedinUser, java.io.File file) Import a uploaded JATOS study archive (.jzip file) There are 5 possible cases: (udir - name of uploaded study asset dir, cdir - name of current study asset dir)
java.lang.Long	importStudyConfirmed(User signedinUser, boolean keepProperties, boolean keepAssets, boolean keepCurrentAssetsName, boolean renameAssets)

Methods inherited from class java.lang.Object

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

Field Detail

SESSION_UNZIPPED_STUDY_DIR

public static final java.lang.String SESSION_UNZIPPED_STUDY_DIR

See Also:

Constant Field Values

Method Detail

importStudy

public com.fasterxml.jackson.databind.node.ObjectNode importStudy(User signedinUser,
                                                                  java.io.File file)
                                                           throws java.io.IOException,
                                                                  ForbiddenException

Import a uploaded JATOS study archive (.jzip file) There are 5 possible cases: (udir - name of uploaded study asset dir, cdir - name of current study asset dir)

1) study exists - udir exists - udir == cdir : ask confirmation to overwrite study and/or dir 2) study exists - udir exists - udir != cdir : ask confirmation to overwrite study and/or (dir && rename to cdir) 3) study exists - !udir exists : shouldn't happen, ask confirmation to overwrite study 4) !study exists - udir exists : ask to rename dir (generate new dir name) 5) !study exists - !udir exists : new study - write both

Throws:

java.io.IOException

ForbiddenException

importStudyConfirmed

public java.lang.Long importStudyConfirmed(User signedinUser,
                                           boolean keepProperties,
                                           boolean keepAssets,
                                           boolean keepCurrentAssetsName,
                                           boolean renameAssets)
                                    throws java.io.IOException,
                                           ForbiddenException,
                                           NotFoundException

Throws:

java.io.IOException

ForbiddenException

NotFoundException

cleanupAfterStudyImport

public void cleanupAfterStudyImport()

createStudyExportZipFile

public java.io.File createStudyExportZipFile(Study study)
                                      throws java.io.IOException

Returns a JATOS study archive (suffix .jzip). It basically zips a study and returns the File object with the name 'study.jzip' (located in the system's temp directory). The JATOS study archive will contain the study assets' directory and the study's JSON data (a .jas file).

Throws:

java.io.IOException