org.waarp.common.file.passthrough

Class PassthroughBasedFileImpl

java.lang.Object

org.waarp.common.file.AbstractFile

org.waarp.common.file.passthrough.PassthroughBasedFileImpl

All Implemented Interfaces:

FileInterface

public abstract class PassthroughBasedFileImpl
extends AbstractFile

File implementation for Passthrough Based. It is just an empty shell since in pass through mode, no directories or files really exist. If one wants to implement special actions, he/she just has to extend this class and override the default empty implementation.

Author:

Frederic Bregier

Field Summary

Fields

Modifier and Type	Field and Description
protected String	currentFile Current file if any
protected static PassthroughFileFactory	factory Factory for PassthroughFile
protected boolean	isAppend Is this file in append mode
protected PassthroughFile	pfile Passthrough object
protected SessionInterface	session SessionInterface

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

isReady

Constructor Summary

Constructors

Constructor and Description
PassthroughBasedFileImpl(SessionInterface session, PassthroughBasedDirImpl dir, String path, boolean append)

Method Summary

Methods

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()
void	flush() Try to flush written data if possible
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 File	getFileFromPath(String path) Get the File from this path, checking first its validity
long	getPosition() Return the current position in the FileInterface.
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

pfile

protected PassthroughFile pfile

Passthrough object

factory

protected static PassthroughFileFactory factory

Factory for PassthroughFile

Constructor Detail

PassthroughBasedFileImpl

public PassthroughBasedFileImpl(SessionInterface session,
                        PassthroughBasedDirImpl dir,
                        String path,
                        boolean append)
                         throws CommandAbstractException

Parameters:

session -

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

path -

append -

Throws:

CommandAbstractException

PassthroughException

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

flush

public void flush()

Try to flush written data if possible

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.