Engines::fileTransfer Interface Reference

Interface of fileTransfer. The fileTransfer and fileRef interfaces provide a file transfer service between different computers. More...

Inheritance diagram for Engines::fileTransfer:

Public Member Functions
long	open (in string fileName)
	Open the file transfer.
long	openW (in string fileName)
	Open the file transfer in write mode for file fileName.
void	close (in long fileId)
	Close the file transfer.
fileBlock	getBlock (in long fileId)
	Get a file data block.
void	putBlock (in long fileId, in fileBlock block)
	Put a file data block.

---

Detailed Description

Interface of fileTransfer. The fileTransfer and fileRef interfaces provide a file transfer service between different computers.

---

Member Function Documentation

long Engines::fileTransfer::open

(

in string

fileName

)

Open the file transfer.

open method returns a key (fileId) that identifies the structure (ex: C FILE), associated to the original file on the server. The structure is created by a container for transfer of files availables on the computer which runs the container. Each open gives a unique fileId, to allow concurrent reads of the same File.

long Engines::fileTransfer::openW

(

in string

fileName

)

Open the file transfer in write mode for file fileName.

Parameters:

fileName

the file to copy into with putBlock

Returns:

the id to use with putBlock

void Engines::fileTransfer::close

(

in long

fileId

)

Close the file transfer.

when the file transfer is finished, close method releases structures created by open method, identified by fileId.

fileBlock Engines::fileTransfer::getBlock

(

in long

fileId

)

Get a file data block.

Get successive blocks of octets from the original file. The last block is empty, and identifies the end of file.

void Engines::fileTransfer::putBlock	(	in long	fileId,
		in fileBlock	block
	)

Put a file data block.

Parameters:

	fileId	identification of the file obtained by openW
	block	a data block to copy into the file identified by fileId