Package omero.grid.monitors
Interface _FileServerOperations
-
- All Known Subinterfaces:
FileServer
- All Known Implementing Classes:
_FileServerDisp
,_FileServerTie
public interface _FileServerOperations
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description boolean
fileExists(java.lang.String fileId, Ice.Current __current)
Query the existence of a file An exception will be raised if the method fails to determine the existence.float
getATime(java.lang.String fileId, Ice.Current __current)
Get atime of a file An exception will be raised if the file no longer exists or is inaccessible.java.lang.String
getBaseName(java.lang.String fileId, Ice.Current __current)
Get base name of a file, this is the name stripped of any path, e.g.FileStats[]
getBulkDirectory(java.lang.String absPath, java.lang.String filter, Ice.Current __current)
Get an absolute directory from an OMERO.fs server.float
getCTime(java.lang.String fileId, Ice.Current __current)
Get ctime of a file An exception will be raised if the file no longer exists or is inaccessible.java.lang.String[]
getDirectory(java.lang.String absPath, java.lang.String filter, Ice.Current __current)
Get an absolute directory from an OMERO.fs server.float
getMTime(java.lang.String fileId, Ice.Current __current)
Get mtime of a file An exception will be raised if the file no longer exists or is inaccessible.java.lang.String
getOwner(java.lang.String fileId, Ice.Current __current)
Get owner of a file An exception will be raised if the file no longer exists or is inaccessible.java.lang.String
getSHA1(java.lang.String fileId, Ice.Current __current)
Get SHA1 of a file An exception will be raised if the file no longer exists or is inaccessible.long
getSize(java.lang.String fileId, Ice.Current __current)
Get size of a file in bytes An exception will be raised if the file no longer exists or is inaccessible.FileStats
getStats(java.lang.String fileId, Ice.Current __current)
Get all FileStats of a file An exception will be raised if the file no longer exists or is inaccessible.boolean
isDir(java.lang.String fileId, Ice.Current __current)
Query whether file is a directory An exception will be raised if the file no longer exists or is inaccessible.boolean
isFile(java.lang.String fileId, Ice.Current __current)
Query whether file is a file An exception will be raised if the file no longer exists or is inaccessible.byte[]
readBlock(java.lang.String fileId, long offset, int size, Ice.Current __current)
readBlock should open, read size bytes from offset and then close the file.
-
-
-
Method Detail
-
getDirectory
java.lang.String[] getDirectory(java.lang.String absPath, java.lang.String filter, Ice.Current __current) throws OmeroFSError
Get an absolute directory from an OMERO.fs server. The returned list will contain just the file names for each directory entry. An exception will be raised if the path does not exist or is inaccessible to the OMERO.fs server. An exception will be raised if directory list cannot be returned for any other reason.- Parameters:
absPath
- an absolute path on the monitor's watch path (string).filter
- a filter to apply to the listing, cf. ls (string).__current
- The Current object for the invocation.- Returns:
- a directory listing (Ice::StringSeq).
- Throws:
OmeroFSError
-
getBulkDirectory
FileStats[] getBulkDirectory(java.lang.String absPath, java.lang.String filter, Ice.Current __current) throws OmeroFSError
Get an absolute directory from an OMERO.fs server. The returned list will contain the file stats for each directory entry. An exception will be raised if the path does not exist or is inaccessible to the OMERO.fs server. An exception will be raised if directory list cannot be returned for any other reason.- Parameters:
absPath
- an absolute path on the monitor's watch path (string).filter
- a filter to apply to the listing, cf. ls (string).__current
- The Current object for the invocation.- Returns:
- a directory listing (FileStatsList).
- Throws:
OmeroFSError
-
fileExists
boolean fileExists(java.lang.String fileId, Ice.Current __current) throws OmeroFSError
Query the existence of a file An exception will be raised if the method fails to determine the existence.- Parameters:
fileId
- see above.__current
- The Current object for the invocation.- Returns:
- existence of file.
- Throws:
OmeroFSError
-
getBaseName
java.lang.String getBaseName(java.lang.String fileId, Ice.Current __current) throws OmeroFSError
Get base name of a file, this is the name stripped of any path, e.g. file.ext An exception will be raised if the file no longer exists or is inaccessible.- Parameters:
fileId
- see above.__current
- The Current object for the invocation.- Returns:
- base name.
- Throws:
OmeroFSError
-
getStats
FileStats getStats(java.lang.String fileId, Ice.Current __current) throws OmeroFSError
Get all FileStats of a file An exception will be raised if the file no longer exists or is inaccessible.- Parameters:
fileId
- see above.__current
- The Current object for the invocation.- Returns:
- file stats (FileStats).
- Throws:
OmeroFSError
-
getSize
long getSize(java.lang.String fileId, Ice.Current __current) throws OmeroFSError
Get size of a file in bytes An exception will be raised if the file no longer exists or is inaccessible.- Parameters:
fileId
- see above.__current
- The Current object for the invocation.- Returns:
- byte size of file (long).
- Throws:
OmeroFSError
-
getOwner
java.lang.String getOwner(java.lang.String fileId, Ice.Current __current) throws OmeroFSError
Get owner of a file An exception will be raised if the file no longer exists or is inaccessible.- Parameters:
fileId
- see above.__current
- The Current object for the invocation.- Returns:
- owner of file (string).
- Throws:
OmeroFSError
-
getCTime
float getCTime(java.lang.String fileId, Ice.Current __current) throws OmeroFSError
Get ctime of a file An exception will be raised if the file no longer exists or is inaccessible.- Parameters:
fileId
- see above.__current
- The Current object for the invocation.- Returns:
- ctime of file (float).
- Throws:
OmeroFSError
-
getMTime
float getMTime(java.lang.String fileId, Ice.Current __current) throws OmeroFSError
Get mtime of a file An exception will be raised if the file no longer exists or is inaccessible.- Parameters:
fileId
- see above.__current
- The Current object for the invocation.- Returns:
- mtime of file (float).
- Throws:
OmeroFSError
-
getATime
float getATime(java.lang.String fileId, Ice.Current __current) throws OmeroFSError
Get atime of a file An exception will be raised if the file no longer exists or is inaccessible.- Parameters:
fileId
- see above.__current
- The Current object for the invocation.- Returns:
- atime of file (float).
- Throws:
OmeroFSError
-
isDir
boolean isDir(java.lang.String fileId, Ice.Current __current) throws OmeroFSError
Query whether file is a directory An exception will be raised if the file no longer exists or is inaccessible.- Parameters:
fileId
- see above.__current
- The Current object for the invocation.- Returns:
- true is directory (bool).
- Throws:
OmeroFSError
-
isFile
boolean isFile(java.lang.String fileId, Ice.Current __current) throws OmeroFSError
Query whether file is a file An exception will be raised if the file no longer exists or is inaccessible.- Parameters:
fileId
- see above.__current
- The Current object for the invocation.- Returns:
- true if file (bool).
- Throws:
OmeroFSError
-
getSHA1
java.lang.String getSHA1(java.lang.String fileId, Ice.Current __current) throws OmeroFSError
Get SHA1 of a file An exception will be raised if the file no longer exists or is inaccessible. An exception will be raised if the SHA1 cannot be generated for any reason.- Parameters:
fileId
- see above.__current
- The Current object for the invocation.- Returns:
- SHA1 hex hash digest of file (string).
- Throws:
OmeroFSError
-
readBlock
byte[] readBlock(java.lang.String fileId, long offset, int size, Ice.Current __current) throws OmeroFSError
readBlock should open, read size bytes from offset and then close the file. An exception will be raised if the file no longer exists or is inaccessible. An exception will be raised if the file read fails for any other reason.- Parameters:
fileId
- see above.offset
- byte offset into file from where read should begin (long).size
- number of bytes that should be read (int).__current
- The Current object for the invocation.- Returns:
- byte sequence of upto size bytes.
- Throws:
OmeroFSError
-
-