ch.systemsx.cisd.openbis.dss.generic.shared.api.v1
Interface IDssServiceRpcGeneric

All Superinterfaces:
IRpcService

public interface IDssServiceRpcGeneric
extends IRpcService

Generic functionality for interacting with the DSS.


Field Summary
static java.lang.String DSS_SERVICE_NAME
           
 
Method Summary
 java.lang.String getDownloadUrlForFileForDataSet(java.lang.String sessionToken, DataSetFileDTO fileOrFolder)
          Returns an URL from which the requested file.
 java.lang.String getDownloadUrlForFileForDataSet(java.lang.String sessionToken, java.lang.String dataSetCode, java.lang.String path)
          Returns an URL from which the requested file of the specified data set can be downloaded.
 java.io.InputStream getFileForDataSet(java.lang.String sessionToken, DataSetFileDTO fileOrFolder)
          Deprecated. use getDownloadUrlForFileForDataSet(String, DataSetFileDTO).
 java.io.InputStream getFileForDataSet(java.lang.String sessionToken, java.lang.String dataSetCode, java.lang.String path)
          Deprecated. use getDownloadUrlForFileForDataSet(String, String, String).
 java.lang.String getPathToDataSet(java.lang.String sessionToken, java.lang.String dataSetCode, java.lang.String overrideStoreRootPathOrNull)
          Get a path to the data set.
 java.lang.String getValidationScript(java.lang.String sessionToken, java.lang.String dataSetTypeOrNull)
          Get the validation script for the specified data set type.
 FileInfoDssDTO[] listFilesForDataSet(java.lang.String sessionToken, DataSetFileDTO fileOrFolder)
          Get an array of FileInfoDss objects that describe the file-system structure of the data set.
 FileInfoDssDTO[] listFilesForDataSet(java.lang.String sessionToken, java.lang.String dataSetCode, java.lang.String path, boolean isRecursive)
          Get an array of FileInfoDss objects that describe the file-system structure of the data set.
 java.lang.String putDataSet(java.lang.String sessionToken, NewDataSetDTO newDataset, java.io.InputStream inputStream)
          Upload a new data set to the DSS.
 
Methods inherited from interface ch.systemsx.cisd.common.api.IRpcService
getMajorVersion, getMinorVersion
 

Field Detail

DSS_SERVICE_NAME

static final java.lang.String DSS_SERVICE_NAME
See Also:
Constant Field Values
Method Detail

listFilesForDataSet

FileInfoDssDTO[] listFilesForDataSet(java.lang.String sessionToken,
                                     DataSetFileDTO fileOrFolder)
                                     throws ch.systemsx.cisd.base.exceptions.IOExceptionUnchecked,
                                            java.lang.IllegalArgumentException
Get an array of FileInfoDss objects that describe the file-system structure of the data set.

Parameters:
sessionToken - The session token
fileOrFolder - The file or folder to get information on
Throws:
ch.systemsx.cisd.base.exceptions.IOExceptionUnchecked - Thrown if an IOException occurs when listing the files
java.lang.IllegalArgumentException - Thrown if the dataSetCode or startPath are not valid

getFileForDataSet

@Deprecated
java.io.InputStream getFileForDataSet(java.lang.String sessionToken,
                                                 DataSetFileDTO fileOrFolder)
                                      throws ch.systemsx.cisd.base.exceptions.IOExceptionUnchecked,
                                             java.lang.IllegalArgumentException
Deprecated. use getDownloadUrlForFileForDataSet(String, DataSetFileDTO).

Get an array of FileInfoDss objects that describe the file-system structure of the data set.

Parameters:
sessionToken - The session token
fileOrFolder - The file or folder to retrieve
Throws:
ch.systemsx.cisd.base.exceptions.IOExceptionUnchecked - Thrown if an IOException occurs when listing the files
java.lang.IllegalArgumentException - Thrown if the dataSetCode or startPath are not valid

getDownloadUrlForFileForDataSet

java.lang.String getDownloadUrlForFileForDataSet(java.lang.String sessionToken,
                                                 DataSetFileDTO fileOrFolder)
                                                 throws ch.systemsx.cisd.base.exceptions.IOExceptionUnchecked,
                                                        java.lang.IllegalArgumentException
Returns an URL from which the requested file. The URL is valid only for a short time.

Parameters:
sessionToken - The session token
fileOrFolder - The file or folder to retrieve
Throws:
ch.systemsx.cisd.base.exceptions.IOExceptionUnchecked - Thrown if an IOException occurs when listing the files
java.lang.IllegalArgumentException - Thrown if the dataSetCode or startPath are not valid
Since:
1.4

listFilesForDataSet

FileInfoDssDTO[] listFilesForDataSet(java.lang.String sessionToken,
                                     java.lang.String dataSetCode,
                                     java.lang.String path,
                                     boolean isRecursive)
                                     throws ch.systemsx.cisd.base.exceptions.IOExceptionUnchecked,
                                            java.lang.IllegalArgumentException
Get an array of FileInfoDss objects that describe the file-system structure of the data set.

Parameters:
sessionToken - The session token
dataSetCode - The data set to retrieve file information about
path - The path within the data set to retrieve file information about
isRecursive - Should the result include information for sub folders?
Throws:
ch.systemsx.cisd.base.exceptions.IOExceptionUnchecked - Thrown if an IOException occurs when listing the files
java.lang.IllegalArgumentException - Thrown if the dataSetCode or startPath are not valid

getFileForDataSet

@Deprecated
java.io.InputStream getFileForDataSet(java.lang.String sessionToken,
                                                 java.lang.String dataSetCode,
                                                 java.lang.String path)
                                      throws ch.systemsx.cisd.base.exceptions.IOExceptionUnchecked,
                                             java.lang.IllegalArgumentException
Deprecated. use getDownloadUrlForFileForDataSet(String, String, String).

Get an array of FileInfoDss objects that describe the file-system structure of the data set.

Parameters:
sessionToken - The session token
dataSetCode - The data set to retrieve file from
path - The path within the data set to retrieve file information about
Throws:
ch.systemsx.cisd.base.exceptions.IOExceptionUnchecked - Thrown if an IOException occurs when listing the files
java.lang.IllegalArgumentException - Thrown if the dataSetCode or startPath are not valid

getDownloadUrlForFileForDataSet

java.lang.String getDownloadUrlForFileForDataSet(java.lang.String sessionToken,
                                                 java.lang.String dataSetCode,
                                                 java.lang.String path)
                                                 throws ch.systemsx.cisd.base.exceptions.IOExceptionUnchecked,
                                                        java.lang.IllegalArgumentException
Returns an URL from which the requested file of the specified data set can be downloaded. The URL is valid only for a short time.

Parameters:
sessionToken - The session token
dataSetCode - The data set to retrieve file from
path - The path within the data set to retrieve file information about
Throws:
ch.systemsx.cisd.base.exceptions.IOExceptionUnchecked - Thrown if an IOException occurs when listing the files
java.lang.IllegalArgumentException - Thrown if the dataSetCode or startPath are not valid
Since:
1.4

putDataSet

java.lang.String putDataSet(java.lang.String sessionToken,
                            NewDataSetDTO newDataset,
                            java.io.InputStream inputStream)
                            throws ch.systemsx.cisd.base.exceptions.IOExceptionUnchecked,
                                   java.lang.IllegalArgumentException
Upload a new data set to the DSS.

Parameters:
sessionToken - The session token
newDataset - The new data set that should be registered
inputStream - An input stream on the file or folder to register
Returns:
The code of the newly-added data set
Throws:
ch.systemsx.cisd.base.exceptions.IOExceptionUnchecked - Thrown if an IOException occurs when listing the files
java.lang.IllegalArgumentException - Thrown if the dataSetCode or startPath are not valid

getPathToDataSet

java.lang.String getPathToDataSet(java.lang.String sessionToken,
                                  java.lang.String dataSetCode,
                                  java.lang.String overrideStoreRootPathOrNull)
                                  throws ch.systemsx.cisd.base.exceptions.IOExceptionUnchecked,
                                         java.lang.IllegalArgumentException
Get a path to the data set. This can be used by clients that run on the same machine as the DSS for more efficient access to a data set.

NOTE: This method shouldn't be called for a container data set. No file would exist with the returned path.

Parameters:
sessionToken - The session token
dataSetCode - The data set to retrieve file from
overrideStoreRootPathOrNull - The path to replace the store path (see return comment).
Returns:
An absolute path to the data set. If overrideStorePathOrNull is specified, it replaces the DSS's notion of the store path. Otherwise the return value will begin with the DSS's storeRootPath.
Throws:
ch.systemsx.cisd.base.exceptions.IOExceptionUnchecked - if an IOException occurs when listing the files.
java.lang.IllegalArgumentException - if dataSetCode is a container dataset.
Since:
1.1

getValidationScript

java.lang.String getValidationScript(java.lang.String sessionToken,
                                     java.lang.String dataSetTypeOrNull)
                                     throws ch.systemsx.cisd.base.exceptions.IOExceptionUnchecked,
                                            java.lang.IllegalArgumentException
Get the validation script for the specified data set type.

Parameters:
sessionToken - The session token
dataSetTypeOrNull - The data set type the script should validate, or null to request the generic validation script.
Returns:
The string of the python (jython) script for the validation or null if there is no applicable validation script.
Throws:
ch.systemsx.cisd.base.exceptions.IOExceptionUnchecked - Thrown if an IOException occurs when accessing the script
java.lang.IllegalArgumentException - Thrown if the data set type or startPath are not valid
Since:
1.2