org.jscsi.target.storage

Class FileStorageModule

java.lang.Object

org.jscsi.target.storage.FileStorageModule

All Implemented Interfaces:

IStorageModule

Deprecated.

@Deprecated
public class FileStorageModule
extends Object
implements IStorageModule

This file storage is used for faster access within the treetank iscsi module.

Author:

Andreas Rain

Field Summary

Fields inherited from interface org.jscsi.target.storage.IStorageModule

VIRTUAL_BLOCK_SIZE

Constructor Summary

Constructors

Constructor and Description
FileStorageModule(String pBaseDir, long pStorageSize, int pFileSize) Deprecated.

Method Summary

Methods

Modifier and Type	Method and Description
int	checkBounds(long logicalBlockAddress, int transferLengthInBlocks) Deprecated. This method can be used for checking if a (series of) I/O operations will result in an IOException due to trying to access blocks outside the medium's boundaries.
void	close() Deprecated. Closing the storage.
long	getSizeInBlocks() Deprecated. Returns the storage space size in bytes divided by the block size in bytes (rounded down).
void	read(byte[] bytes, long storageIndex) Deprecated. Reading bytes from file
void	write(byte[] bytes, long storageIndex) Deprecated. Writing into a file.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

FileStorageModule

public FileStorageModule(String pBaseDir,
                 long pStorageSize,
                 int pFileSize)
                  throws IOException

Deprecated.

Parameters:

pBaseDir - - The root directory for the filestorage (will be created if not exists)

pStorageSize - - The size of the storage

pFileSize - - The size of each file

Throws:

IOException

Method Detail

read

public void read(byte[] bytes,
        long storageIndex)
          throws IOException

Deprecated.

Reading bytes from file

Specified by:

read in interface IStorageModule

Parameters:

bytes -

storageIndex -

Throws:

IOException

write

public void write(byte[] bytes,
         long storageIndex)
           throws IOException

Deprecated.

Writing into a file.

Specified by:

write in interface IStorageModule

Parameters:

bytes -

storageIndex -

Throws:

IOException

checkBounds

public int checkBounds(long logicalBlockAddress,
              int transferLengthInBlocks)

Deprecated.

This method can be used for checking if a (series of) I/O operations will result in an IOException due to trying to access blocks outside the medium's boundaries.

The SCSI standard requires checking for these boundary violations right after receiving a read or write command, so that an appropriate error message can be returned to the initiator. Therefore this method must be called prior to each read or write sequence.

The values returned by this method and their meaning with regard to the interval [0, IStorageModule.getSizeInBlocks() - 1] are shown in the following table:

Return Value	Meaning
0	no boundaries are violated
1	the logicalBlockAddress parameter lies outside of the interval
2	the interval [logicalBlockAddress, logicalBlockAddress + transferLengthInBlocks] lies outside of the interval, or transferLengthInBlocks is negative

Note that the parameters of this method are referring to blocks, not to byte indices.

Specified by:

checkBounds in interface IStorageModule

Parameters:

logicalBlockAddress - the index of the first block of data to be read or written

transferLengthInBlocks - the total number of consecutive blocks about to be read or written

Returns:

see table in description

getSizeInBlocks

public long getSizeInBlocks()

Deprecated.

Returns the storage space size in bytes divided by the block size in bytes (rounded down).

Specified by:

getSizeInBlocks in interface IStorageModule

Returns:

the virtual amount of storage blocks available

close

public void close()
           throws IOException

Deprecated.

Closing the storage.

Specified by:

close in interface IStorageModule

Throws:

IOException - to be closed