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 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()
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()
protected boolean	get(FileChannel fileChannelOut) Write the FileInterface to the fileChannelOut, thus bypassing the limitation of the file size to 2^32 bytes.
DirInterface	getDir()
String	getFile()
protected FileChannel	getFileChannel() Returns the FileChannel in In mode associated with the current file.
protected File	getFileFromPath(String path) Get the File from this path, checking first its validity
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
boolean	isFile() Is the current FileInterface a file and exists
boolean	isInReading()
boolean	isInWriting()
long	length()
DataBlock	readDataBlock() 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

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 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 DirInterface getDir()

Returns:

the FtpDir associated at creation with this file

getFileFromPath

protected 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 String getRelativePath(File file)

Get the relative path (without mount point)

Parameters:

file -

Returns:

the relative path

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 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 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 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 boolean isInReading()
                    throws CommandAbstractException

Returns:

True if the current FileInterface is in Reading process

Throws:

CommandAbstractException

isInWriting

public boolean isInWriting()
                    throws CommandAbstractException

Returns:

True if the current FileInterface is in Writing process

Throws:

CommandAbstractException

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 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 DataBlock readDataBlock()
                        throws FileTransferException,
                               FileEndOfTransferException

Description copied from interface: FileInterface

Read a new block for FileInterface

Returns:

dataBlock

Throws:

FileTransferException

FileEndOfTransferException

writeDataBlock

public 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 long getPosition()

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

Returns:

the position

setPosition

public void setPosition(long position)
                 throws IOException

Change the position in the file.

Parameters:

position - the position to set

Throws:

IOException

get

protected boolean get(FileChannel fileChannelOut)

Write the FileInterface to the fileChannelOut, thus bypassing the limitation of the file size to 2^32 bytes.

This call closes the fileChannelOut with fileChannelOut.close() if the operation is in success.

Parameters:

fileChannelOut -

Returns:

True if OK, False in error.

getFileChannel

protected FileChannel getFileChannel()

Returns the FileChannel in In mode associated with the current file.

Returns:

the FileChannel (IN mode)

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)