DtInetFileTransporter Class Reference

Collaboration diagram for DtInetFileTransporter:

Public Types
enum	DtInetFileTransportFlags { DtFileNormal = 0, DtFileCompressed = 1, DtFileEncrypted = 2 }
typedef void(*	DtInetFileTransferedCallbackFn )(const DtFilename &file, void *usr)
typedef std::map< int, DtInetFileTransportObject >	DtFileObjectMap

Public Member Functions
	DtInetFileTransporter (int port=3000, bool findFirstAvailable=false, int portRangeToTry=10, const DtFilename &tagetDirectory=".", int *status=0, bool useIpv6=false)
	Constructor.
virtual	~DtInetFileTransporter ()
	Destructor.
virtual void	tick ()
	Do periodic processing.
virtual unsigned int	port () const
	Get our listening port.
virtual void	addFileTransferedCallback (DtInetFileTransferedCallbackFn fn, void *data)
	Add/Remove callbacks to be invoked when a new file has been transfered to us.
virtual void	removeFileTransferedCallback (DtInetFileTransferedCallbackFn fn, void *data)
virtual bool	sendFile (const DtFilename &filename, const DtInetAddr &destAddr, int port)
	Sends a file to the given destAddr and port.
virtual bool	sendFile (const DtFilename &filename, const DtInetAddr &destAddr)
	Sends a file to the given destAddr using the myPort.
const DtFilename &	targetDirectory () const
	Set/Get the directory where incoming files will be stored When setting a new directory, the given directory will be created if it does not exist already.
void	setTargetDirectory (const DtFilename &f)

Static Public Member Functions
static bool	receiveFileCb (DtInetSocket *sock, void *usr)
	Invoked when a socket connects to us.

Protected Types
typedef std::map < DtInetFileTransferedCallbackFn, void * >	FileTransferedCallbackMapType

Protected Member Functions
virtual void	receiveFile (DtInetTcpSocket *sock)
	Called when a socket connects to us.
virtual int	nextFileIdentifier ()
	Returns the next unique identifier for the file to be sent.
virtual bool	readFileToBuffer (std::ifstream &inFile, std::vector< char > &fileBuffer, int fileLengthInBytes, int &retBufLen, DtInetFileTransportFlags &flags)
	Reads the file into the supplied vector buffer.
virtual void	finishFile (DtInetFileTransportObject &object)
	Writes out file and removed transport object from active file list.
virtual DtInetFileTransportObject &	transportObject (int iFileIdentifier)
	DtInetFileTransporter (const DtInetFileTransporter &)
	Copy CTOR Not Implemented.
DtInetFileTransporter &	operator= (const DtInetFileTransporter &)
	Assignment Operator Not Implemented.

Protected Attributes
FileTransferedCallbackMapType	myCallbacks
int	myPort
DtInetSocketMgr *	mySocketMgr
DtFilename	myTargetDirectory
DtFileObjectMap	myActiveFiles

Member Typedef Documentation

typedef std::map<int, DtInetFileTransportObject> DtInetFileTransporter::DtFileObjectMap

typedef void(* DtInetFileTransporter::DtInetFileTransferedCallbackFn)(const DtFilename &file, void *usr)

typedef std::map<DtInetFileTransferedCallbackFn, void*> DtInetFileTransporter::FileTransferedCallbackMapType

protected

Member Enumeration Documentation

enum DtInetFileTransporter::DtInetFileTransportFlags

Enumerator:

DtFileNormal
DtFileCompressed
DtFileEncrypted

Constructor & Destructor Documentation

DtInetFileTransporter::DtInetFileTransporter	(	int	port = 3000,
		bool	findFirstAvailable = false,
		int	portRangeToTry = 10,
		const DtFilename &	tagetDirectory = ".",
		int *	status = 0,
		bool	useIpv6 = false
	)

Constructor.

Accepts incoming data from the given port. Set findFirstAvailable to true when you want the listener to try to find the next free port if the given port is already in use. If the suggested port is not free, and findFirstAvailable is set to true, DtInetFileTransporter will try the next portRangeToTry ports. On success status returns the port which was opened for reading. On failure status returns a negative value.

virtual DtInetFileTransporter::~DtInetFileTransporter ( )

virtual

Destructor.

DtInetFileTransporter::DtInetFileTransporter ( const DtInetFileTransporter &  )

protected

Copy CTOR Not Implemented.

Member Function Documentation

virtual void DtInetFileTransporter::addFileTransferedCallback ( DtInetFileTransferedCallbackFn  fn, void *  data  )

virtual

Add/Remove callbacks to be invoked when a new file has been transfered to us.

virtual void DtInetFileTransporter::finishFile ( DtInetFileTransportObject &  object )

protectedvirtual

Writes out file and removed transport object from active file list.

virtual int DtInetFileTransporter::nextFileIdentifier ( )

protectedvirtual

Returns the next unique identifier for the file to be sent.

Used when reading in files from the network to make sure that file packets are associated with the right files

DtInetFileTransporter& DtInetFileTransporter::operator= ( const DtInetFileTransporter &  )

protected

Assignment Operator Not Implemented.

virtual unsigned int DtInetFileTransporter::port ( ) const

virtual

Get our listening port.

(Ie. the port number on which we are receiving connections)

virtual bool DtInetFileTransporter::readFileToBuffer ( std::ifstream &  inFile, std::vector< char > &  fileBuffer, int  fileLengthInBytes, int &  retBufLen, DtInetFileTransportFlags &  flags  )

protectedvirtual

Reads the file into the supplied vector buffer.

The retBufLen pointer will contain the actual size of the buffer. Set flags to any changes that are made to the file read in.

Set retBufLen to the actual size of the returned buffer. By default it will be set to fileLengthInBytes

virtual void DtInetFileTransporter::receiveFile ( DtInetTcpSocket *  sock )

protectedvirtual

Called when a socket connects to us.

This should never be called directly by users. Instead, users should register a callback to know when a file has been received.

static bool DtInetFileTransporter::receiveFileCb ( DtInetSocket *  sock, void *  usr  )

static

Invoked when a socket connects to us.

virtual void DtInetFileTransporter::removeFileTransferedCallback ( DtInetFileTransferedCallbackFn  fn, void *  data  )

virtual

virtual bool DtInetFileTransporter::sendFile ( const DtFilename &  filename, const DtInetAddr &  destAddr, int  port  )

virtual

Sends a file to the given destAddr and port.

virtual bool DtInetFileTransporter::sendFile ( const DtFilename &  filename, const DtInetAddr &  destAddr  )

virtual

Sends a file to the given destAddr using the myPort.

void DtInetFileTransporter::setTargetDirectory

(

const DtFilename &

f

)

const DtFilename& DtInetFileTransporter::targetDirectory

(

)

const

Set/Get the directory where incoming files will be stored When setting a new directory, the given directory will be created if it does not exist already.

The default is the current directory.

virtual void DtInetFileTransporter::tick ( )

virtual

Do periodic processing.

virtual DtInetFileTransportObject& DtInetFileTransporter::transportObject ( int  iFileIdentifier )

protectedvirtual

Member Data Documentation

DtFileObjectMap DtInetFileTransporter::myActiveFiles

protected

FileTransferedCallbackMapType DtInetFileTransporter::myCallbacks

protected

int DtInetFileTransporter::myPort

protected

DtInetSocketMgr* DtInetFileTransporter::mySocketMgr

protected

DtFilename DtInetFileTransporter::myTargetDirectory

protected

---

The documentation for this class was generated from the following file:

• vlInetFileTransport.h