public interface FileAccess extends Dataset
Modifier and Type | Method and Description |
---|---|
void |
addFile(java.lang.String filename,
java.lang.String permissions)
Adds a file with the specified permission "r", "w" or "rw" to this
dataset.
|
java.util.Enumeration |
getFilenames()
Retrieves the list of files in this dataset
|
long |
getPosition(java.lang.String fileName)
Retrieves the position of filePointer for the given dataset
|
boolean |
isPartOfDataset(java.lang.String fileName)
Checks to see if the file is part of a given dataset
|
int |
read(java.lang.String filename,
byte[] bytesToRead)
Attempts to read a set of bytes from the underlying file.
|
int |
read(java.lang.String fileName,
java.nio.ByteBuffer readBuffer)
Attempts to read a set of bytes from the underlying file.
|
void |
removeFile(java.lang.String filename)
Removes a file from this dataset.
|
void |
setPosition(java.lang.String fileName,
long newPosition)
Sets the position of filePointer for one of the file in the given
dataset.
|
long |
size(java.lang.String fileName)
Returns the current size of the file in question
|
int |
write(java.lang.String fileName,
byte[] bytesToWrite)
Writes a byte[] to a give file.
|
int |
write(java.lang.String fileName,
java.nio.ByteBuffer writeBuffer)
Write the specified Buffer to the file corresponding to the specified
file.
|
close, getBytes, getDataAvailabilityNotifier, getDatasetType, getDescription, getIdentifier, getLastModificationTime, initializeDataset, isAvailable, isDataAvailable, isInitialized, needsInitialization, supportsDataAvailabilityNotifications
boolean isPartOfDataset(java.lang.String fileName)
fileName
- The name of the filetrue
if the file is a part of the dataset;
false
otherwise.long size(java.lang.String fileName) throws DatasetException, java.io.IOException
fileName
- The name of the fileDatasetException
- If there are problems retrieving the FileChannel
corresponding to the filejava.io.IOException
- If there are IO problems in completing the operation.long getPosition(java.lang.String fileName) throws DatasetException, java.io.IOException
fileName
- The name of the file.DatasetException
- If there are problems retrieving the FileChannel
corresponding to the filejava.io.IOException
- If there are IO problems in performing the operationvoid setPosition(java.lang.String fileName, long newPosition) throws DatasetException, java.io.IOException
fileName
- The filenewPosition
- The new position for the pointerDatasetException
- If there are problems retrieving the FileChannel
corresponding to the filejava.io.IOException
- If there are IO problems in performing the operationint read(java.lang.String filename, byte[] bytesToRead) throws DatasetException, java.io.IOException
filename
- The file to be readbytesToRead
- The byte[] to be read intoDatasetException
- If there are problems retrieving the FileChannel
corresponding to the filejava.io.IOException
- If there are IO problems in performing the operationint read(java.lang.String fileName, java.nio.ByteBuffer readBuffer) throws DatasetException, java.io.IOException
fileName
- The file to be readreadBuffer
- The buffer to be read intoDatasetException
- If there are problems retrieving the FileChannel
corresponding to the filejava.io.IOException
- If there are IO problems in performing the operationint write(java.lang.String fileName, java.nio.ByteBuffer writeBuffer) throws DatasetException, java.io.IOException
fileName
- The file to be written towriteBuffer
- The buffer holding the bytes to be writtenDatasetException
- If there are problems retrieving the FileChannel
corresponding to the filejava.io.IOException
- If there are IO problems in performing the operationint write(java.lang.String fileName, byte[] bytesToWrite) throws DatasetException, java.io.IOException
fileName
- The file to be written tobytesToWrite
- The byte[] to be written.DatasetException
- If there are problems retrieving the FileChannel
corresponding to the filejava.io.IOException
- If there are IO problems in performing the operationvoid addFile(java.lang.String filename, java.lang.String permissions) throws DatasetException
filename
- The name of the filepermissions
- The permissions associated with this filejava.lang.NullPointerException
- If the specified filename is NULLDatasetException
- If there are problems adding this filevoid removeFile(java.lang.String filename) throws DatasetException
filename
- The name of the filejava.lang.NullPointerException
- If the specified filename is NULLDatasetException
- If there are problems removing this filejava.util.Enumeration getFilenames()