omero.grid

Interface _ManagedRepositoryOperationsNC

All Superinterfaces:

_RepositoryOperationsNC

All Known Subinterfaces:

ManagedRepository

All Known Implementing Classes:

_ManagedRepositoryDisp, _ManagedRepositoryTie

public interface _ManagedRepositoryOperationsNC
extends _RepositoryOperationsNC

FS-enabled repository which can convert uploaded files into Images by using Bio-Formats to import them.

Method Summary

Modifier and Type	Method and Description
ImportProcessPrx	importFileset(Fileset fs, ImportSettings settings) Returns an ImportProcess which can be used to upload files.
ImportProcessPrx	importPaths(java.util.List<java.lang.String> filePaths) For clients without access to Bio-Formats, the simplified importPaths method allows passing solely the absolute path of the files to be uploaded (no directories) and all configuration happens server-side.
java.util.List<ChecksumAlgorithm>	listChecksumAlgorithms() Return the list of checksum algorithms supported by this repository for verifying the integrity of uploaded files.
java.util.List<ImportProcessPrx>	listImports() List imports that are currently running in this importer.
java.util.List<java.lang.Long>	setChecksumAlgorithm(ChecksumAlgorithm hasher, java.util.List<java.lang.Long> ids) Set the checksum algorithm for the original files identified by the given IDs and calculate their checksum accordingly.
ChecksumAlgorithm	suggestChecksumAlgorithm(java.util.List<ChecksumAlgorithm> supported) Suggest a checksum algorithm to use for ImportSettings.checksumAlgorithm according to the preferences set by the server administrator.
java.util.List<java.lang.Long>	verifyChecksums(java.util.List<java.lang.Long> ids) Verify the checksum for the original files identified by the given IDs.

Methods inherited from interface omero.grid._RepositoryOperationsNC

deletePaths, file, fileById, fileExists, list, listFiles, makeDir, mimetype, register, root, treeList

Method Detail

importFileset

ImportProcessPrx importFileset(Fileset fs,
                               ImportSettings settings)
                        throws ServerError

Returns an ImportProcess which can be used to upload files. On _ImportProcessOperations.verifyUpload(java.util.List<java.lang.String>, Ice.Current), an Handle will be returned which can be watched for knowing when the server-side import is complete. Client paths set in the fileset entries must /-separate their components. Once the upload is complete, the ImportProcess must be closed. Once _HandleOperations.getResponse(Ice.Current) returns a non-null value, the handle instance can and must be closed.

Throws:

ServerError

importPaths

ImportProcessPrx importPaths(java.util.List<java.lang.String> filePaths)
                      throws ServerError

For clients without access to Bio-Formats, the simplified importPaths method allows passing solely the absolute path of the files to be uploaded (no directories) and all configuration happens server-side. Much of the functionality provided via Fileset and ImportSettings is of course lost.

Throws:

ServerError

listImports

java.util.List<ImportProcessPrx> listImports()
                                      throws ServerError

List imports that are currently running in this importer. These will be limited based on user/group membership for the Fileset object which is being created by the import. If the user has write permissions for the fileset, then the import will be included.

Throws:

ServerError

listChecksumAlgorithms

java.util.List<ChecksumAlgorithm> listChecksumAlgorithms()

Return the list of checksum algorithms supported by this repository for verifying the integrity of uploaded files. They are named as ""algorithm-integer"", integer being the bit width of the resulting hash code. It is possible for the same algorithm to be offered with different bit widths. They are listed in descending order of preference, as set by the server administrator, and any of them may be specified for ImportSettings.checksumAlgorithm.

suggestChecksumAlgorithm

ChecksumAlgorithm suggestChecksumAlgorithm(java.util.List<ChecksumAlgorithm> supported)

Suggest a checksum algorithm to use for ImportSettings.checksumAlgorithm according to the preferences set by the server administrator. Provide a list of the algorithms supported by the client, and the server will report which of them is most preferred by the server, or return null if none of them are supported.

verifyChecksums

java.util.List<java.lang.Long> verifyChecksums(java.util.List<java.lang.Long> ids)
                                        throws ServerError

Verify the checksum for the original files identified by the given IDs. The files must be in this repository. Returns the IDs of the original files whose checksums do not match the file on disk.

Throws:

ServerError

setChecksumAlgorithm

java.util.List<java.lang.Long> setChecksumAlgorithm(ChecksumAlgorithm hasher,
                                                    java.util.List<java.lang.Long> ids)
                                             throws ServerError

Set the checksum algorithm for the original files identified by the given IDs and calculate their checksum accordingly. The files must be in this repository. Existing checksums are checked before being changed. If a checksum does not match, ServerError will be thrown; in this case some other files may already have had their checksum algorithm set. Returns the IDs of the original files that did not already have a checksum set for the given algorithm.

Throws:

ServerError