org.waarp.common.file.filesystembased

Class FilesystemBasedFileImpl

java.lang.Object

org.waarp.common.file.AbstractFile

org.waarp.common.file.filesystembased.FilesystemBasedFileImpl

All Implemented Interfaces:

FileInterface

Direct Known Subclasses:

CommonFileImpl, FilesystemBasedFtpFile, R66File

public abstract class FilesystemBasedFileImpl
extends AbstractFile

File implementation for Filesystem Based

Field Summary

Fields

Modifier and Type	Field and Description
protected String	currentFile Current file if any
protected File	currentRealFile Current Real File if any
protected boolean	isAppend Is this file in append mode
protected SessionInterface	session SessionInterface

Fields inherited from class org.waarp.common.file.AbstractFile

isReady

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	FilesystemBasedFileImpl(SessionInterface session, FilesystemBasedDirImpl dir, String path) Special constructor for possibly external file
protected	FilesystemBasedFileImpl(SessionInterface session, FilesystemBasedDirImpl dir, String path, boolean append)

Method Summary

Modifier and Type	Method and Description
boolean	abortFile() Try to abort the current transfer if any
boolean	canRead()
static boolean	canRead(File file) Adapt File.canRead() to leverage synchronization error with filesystem
boolean	canWrite()
void	clear() Set empty this FtpFile, mark it unReady.
boolean	closeFile() Close the current FileInterface
boolean	delete() Delete the current FileInterface.
boolean	exists()
static boolean	exists(File file) Adapt File.exists() to leverage synchronization error with filesystem
DirInterface	getDir()
String	getFile()
protected File	getFileFromPath(String path) Get the File from this path, checking first its validity
protected FileInputStream	getFileInputStream()
protected FileOutputStream	getFileOutputStream(boolean append) Returns the FileOutputStream in Out mode associated with the current file.
long	getPosition() Return the current position in the FileInterface.
protected RandomAccessFile	getRandomFile() Returns the RandomAccessFile in Out mode associated with the current file.
protected String	getRelativePath(File file) Get the relative path (without mount point)
SessionInterface	getSession()
boolean	isDirectory() Is the current FileInterface a directory and exists
static boolean	isDirectory(File file) Adapt File.isDirectory() to leverage synchronization error with filesystem
boolean	isFile() Is the current FileInterface a file and exists
static boolean	isFile(File file) Adapt File.isFile() to leverage synchronization error with filesystem
boolean	isInReading()
boolean	isInWriting()
long	length()
DataBlock	readDataBlock() Read a new block for FileInterface
DataBlock	readDataBlock(byte[] bufferGiven) Read a new block for FileInterface
boolean	renameTo(String path) Rename the current FileInterface into a new filename from argument
void	setPosition(long position) Change the position in the file.
void	writeDataBlock(DataBlock dataBlock) Function called by the DataNetworkHandler when it receives one DataBlock (Store like command)

Methods inherited from class org.waarp.common.file.AbstractFile

checkIdentify, getMarker, restartMarker, retrieve, store

Methods inherited from class java.lang.Object

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

Field Detail

session

protected final SessionInterface session

SessionInterface

currentFile

protected String currentFile

Current file if any

currentRealFile

protected File currentRealFile

Current Real File if any

isAppend

protected boolean isAppend

Is this file in append mode

Constructor Detail

FilesystemBasedFileImpl

protected FilesystemBasedFileImpl(SessionInterface session,
                                  FilesystemBasedDirImpl dir,
                                  String path,
                                  boolean append)
                           throws CommandAbstractException

Parameters:

session -

dir - It is not necessary the directory that owns this file.

path -

append -

Throws:

CommandAbstractException

FilesystemBasedFileImpl

protected FilesystemBasedFileImpl(SessionInterface session,
                                  FilesystemBasedDirImpl dir,
                                  String path)

Special constructor for possibly external file

Parameters:

session -

dir - It is not necessary the directory that owns this file.

path -

Method Detail

clear

public final void clear()
                 throws CommandAbstractException

Description copied from interface: FileInterface

Set empty this FtpFile, mark it unReady.

Specified by:

clear in interface FileInterface

Overrides:

clear in class AbstractFile

Throws:

CommandAbstractException

getSession

public SessionInterface getSession()

Returns:

the FtpSession

getDir

public final DirInterface getDir()

Returns:

the FtpDir associated at creation with this file

getFileFromPath

protected final File getFileFromPath(String path)
                              throws CommandAbstractException

Get the File from this path, checking first its validity

Parameters:

path -

Returns:

the FileInterface

Throws:

CommandAbstractException

getRelativePath

protected final String getRelativePath(File file)

Get the relative path (without mount point)

Parameters:

file -

Returns:

the relative path

isDirectory

public static boolean isDirectory(File file)

Adapt File.isDirectory() to leverage synchronization error with filesystem

Parameters:

file -

Returns:

as with File.isDirectory()

isDirectory

public boolean isDirectory()
                    throws CommandAbstractException

Description copied from interface: FileInterface

Is the current FileInterface a directory and exists

Returns:

True if it is a directory and it exists

Throws:

CommandAbstractException

isFile

public static boolean isFile(File file)

Adapt File.isFile() to leverage synchronization error with filesystem

Parameters:

file -

Returns:

as with File.isFile()

isFile

public boolean isFile()
               throws CommandAbstractException

Description copied from interface: FileInterface

Is the current FileInterface a file and exists

Returns:

True if it is a file and it exists

Throws:

CommandAbstractException

getFile

public final String getFile()
                     throws CommandAbstractException

Returns:

the path of the current FileInterface (without mount point if any)

Throws:

CommandAbstractException

closeFile

public boolean closeFile()
                  throws CommandAbstractException

Description copied from interface: FileInterface

Close the current FileInterface

Returns:

True if correctly closed

Throws:

CommandAbstractException

abortFile

public final boolean abortFile()
                        throws CommandAbstractException

Description copied from interface: FileInterface

Try to abort the current transfer if any

Returns:

True if everything is ok

Throws:

CommandAbstractException

length

public long length()
            throws CommandAbstractException

Returns:

the length of the current FileInterface

Throws:

CommandAbstractException

isInReading

public final boolean isInReading()

Returns:

True if the current FileInterface is in Reading process

isInWriting

public final boolean isInWriting()

Returns:

True if the current FileInterface is in Writing process

canRead

public static boolean canRead(File file)

Adapt File.canRead() to leverage synchronization error with filesystem

Parameters:

file -

Returns:

as with File.canRead()

canRead

public boolean canRead()
                throws CommandAbstractException

Returns:

True if the current FileInterface is ready for reading

Throws:

CommandAbstractException

canWrite

public boolean canWrite()
                 throws CommandAbstractException

Returns:

True if the current FileInterface is ready for writing

Throws:

CommandAbstractException

exists

public static boolean exists(File file)

Adapt File.exists() to leverage synchronization error with filesystem

Parameters:

file -

Returns:

as with File.exists()

exists

public boolean exists()
               throws CommandAbstractException

Returns:

True if the current FileInterface exists

Throws:

CommandAbstractException

delete

public boolean delete()
               throws CommandAbstractException

Description copied from interface: FileInterface

Delete the current FileInterface.

Returns:

True if OK, else False if not (or if the file never exists).

Throws:

CommandAbstractException

renameTo

public boolean renameTo(String path)
                 throws CommandAbstractException

Description copied from interface: FileInterface

Rename the current FileInterface into a new filename from argument

Parameters:

path - the new filename (path could be relative or absolute - without mount point)

Returns:

True if the operation is done successfully

Throws:

CommandAbstractException

readDataBlock

public final DataBlock readDataBlock()
                              throws FileTransferException,
                                     FileEndOfTransferException

Description copied from interface: FileInterface

Read a new block for FileInterface

Returns:

dataBlock

Throws:

FileTransferException

FileEndOfTransferException

readDataBlock

public final DataBlock readDataBlock(byte[] bufferGiven)
                              throws FileTransferException,
                                     FileEndOfTransferException

Description copied from interface: FileInterface

Read a new block for FileInterface

Parameters:

bufferGiven - use the given buffer to read

Returns:

dataBlock

Throws:

FileTransferException

FileEndOfTransferException

writeDataBlock

public final void writeDataBlock(DataBlock dataBlock)
                          throws FileTransferException

Description copied from interface: FileInterface

Function called by the DataNetworkHandler when it receives one DataBlock (Store like command)

Throws:

FileTransferException

getPosition

public final long getPosition()

Return the current position in the FileInterface. In write mode, it is the current file length.

Returns:

the position

setPosition

public final void setPosition(long position)
                       throws IOException

Change the position in the file.

Parameters:

position - the position to set

Throws:

IOException

getFileInputStream

protected FileInputStream getFileInputStream()

getRandomFile

protected RandomAccessFile getRandomFile()

Returns the RandomAccessFile in Out mode associated with the current file.

Returns:

the RandomAccessFile (OUT="rw")

getFileOutputStream

protected FileOutputStream getFileOutputStream(boolean append)

Returns the FileOutputStream in Out mode associated with the current file.

Parameters:

append - True if the FileOutputStream should be in append mode

Returns:

the FileOutputStream (OUT)