ds.granules.dataset

Interface FileAccess

All Superinterfaces:

Dataset, ds.funnel.data.format.FormatMarshaller

All Known Implementing Classes:

FileDatasetImplLegacy

Deprecated.

@Deprecated
public interface FileAccess
extends Dataset

The interface for accessing a dataset comprising files.

Author:

Shrideep Pallickara

Nested Class Summary

Nested classes/interfaces inherited from interface ds.granules.dataset.Dataset

Dataset.DatasetType

Method Summary

Methods

Modifier and Type	Method and Description
void	addFile(String filename, String permissions) Deprecated. Adds a file with the specified permission "r", "w" or "rw" to this dataset.
Enumeration<Object>	getFilenames() Deprecated. Retrieves the list of files in this dataset
long	getPosition(String fileName) Deprecated. Retrieves the position of filePointer for the given dataset
boolean	isPartOfDataset(String fileName) Deprecated. Checks to see if the file is part of a given dataset
int	read(String filename, byte[] bytesToRead) Deprecated. Attempts to read a set of bytes from the underlying file.
int	read(String fileName, ByteBuffer readBuffer) Deprecated. Attempts to read a set of bytes from the underlying file.
void	removeFile(String filename) Deprecated. Removes a file from this dataset.
void	setPosition(String fileName, long newPosition) Deprecated. Sets the position of filePointer for one of the file in the given dataset.
long	size(String fileName) Deprecated. Returns the current size of the file in question
int	write(String fileName, byte[] bytesToWrite) Deprecated. Writes a byte[] to a give file.
int	write(String fileName, ByteBuffer writeBuffer) Deprecated. Write the specified Buffer to the file corresponding to the specified file.

Methods inherited from interface ds.granules.dataset.Dataset

close, getDataAvailabilityNotifier, getDatasetIdentifier, getDatasetType, getDescription, getLastModificationTime, initializeDataset, isAvailable, isDataAvailable, isInitialized, supportsDataAvailabilityNotifications

Methods inherited from interface ds.funnel.data.format.FormatMarshaller

marshall

Method Detail

isPartOfDataset

boolean isPartOfDataset(String fileName)

Deprecated.

Checks to see if the file is part of a given dataset

Parameters:

fileName - The name of the file

Returns:

true if the file is a part of the dataset; false otherwise.

size

long size(String fileName)
          throws DatasetException,
                 IOException

Deprecated.

Returns the current size of the file in question

Parameters:

fileName - The name of the file

Returns:

The current size of the file

Throws:

DatasetException - If there are problems retrieving the FileChannel corresponding to the file

IOException - If there are IO problems in completing the operation.

getPosition

long getPosition(String fileName)
                 throws DatasetException,
                        IOException

Deprecated.

Retrieves the position of filePointer for the given dataset

Parameters:

fileName - The name of the file.

Returns:

The position of filePointer for the given dataset

Throws:

DatasetException - If there are problems retrieving the FileChannel corresponding to the file

IOException - If there are IO problems in performing the operation

setPosition

void setPosition(String fileName,
               long newPosition)
                 throws DatasetException,
                        IOException

Deprecated.

Sets the position of filePointer for one of the file in the given dataset.

Parameters:

fileName - The file

newPosition - The new position for the pointer

Throws:

DatasetException - If there are problems retrieving the FileChannel corresponding to the file

IOException - If there are IO problems in performing the operation

read

int read(String filename,
       byte[] bytesToRead)
         throws DatasetException,
                IOException

Deprecated.

Attempts to read a set of bytes from the underlying file.

Parameters:

filename - The file to be read

bytesToRead - The byte[] to be read into

Returns:

The number of bytes read, possibly zero, or -1 if the channel has reached end-of-stream

Throws:

DatasetException - If there are problems retrieving the FileChannel corresponding to the file

IOException - If there are IO problems in performing the operation

read

int read(String fileName,
       ByteBuffer readBuffer)
         throws DatasetException,
                IOException

Deprecated.

Attempts to read a set of bytes from the underlying file.

Parameters:

fileName - The file to be read

readBuffer - The buffer to be read into

Returns:

The number of bytes read, possibly zero, or -1 if the channel has reached end-of-stream

Throws:

DatasetException - If there are problems retrieving the FileChannel corresponding to the file

IOException - If there are IO problems in performing the operation

write

int write(String fileName,
        ByteBuffer writeBuffer)
          throws DatasetException,
                 IOException

Deprecated.

Write the specified Buffer to the file corresponding to the specified file.

Parameters:

fileName - The file to be written to

writeBuffer - The buffer holding the bytes to be written

Returns:

The number of bytes written, possibly zero

Throws:

DatasetException - If there are problems retrieving the FileChannel corresponding to the file

IOException - If there are IO problems in performing the operation

write

int write(String fileName,
        byte[] bytesToWrite)
          throws DatasetException,
                 IOException

Deprecated.

Writes a byte[] to a give file.

Parameters:

fileName - The file to be written to

bytesToWrite - The byte[] to be written.

Returns:

The number of bytes written, possibly zero

Throws:

DatasetException - If there are problems retrieving the FileChannel corresponding to the file

IOException - If there are IO problems in performing the operation

addFile

void addFile(String filename,
           String permissions)
             throws DatasetException

Deprecated.

Adds a file with the specified permission "r", "w" or "rw" to this dataset.

Parameters:

filename - The name of the file

permissions - The permissions associated with this file

Throws:

NullPointerException - If the specified filename is NULL

DatasetException - If there are problems adding this file

removeFile

void removeFile(String filename)
                throws DatasetException

Deprecated.

Removes a file from this dataset.

Parameters:

filename - The name of the file

Throws:

NullPointerException - If the specified filename is NULL

DatasetException - If there are problems removing this file

getFilenames

Enumeration<Object> getFilenames()

Deprecated.

Retrieves the list of files in this dataset

Returns:

An enumeration of the files in this dataset.