DCPlusPlus.Sharing Class Reference

A Class that manages shares for other clients. Holds a list of shares and functions to add/remove/search for them. More...

List of all members.

Public Member Functions
void	Add (SharingEntry item)
	Add an entry to the shares list fires the added event.
void	Clear ()
	Clears the shares list.
bool	Contains (SharingEntry item)
void	CopyTo (SharingEntry[] array, int arrayIndex)
delegate void	DirectoryFinishedEventHandler (string directory)
	Prototype for the Directory Finished Event Handler.
delegate void	EntriesChangedEventHandler ()
	Prototype for the Entries Changed Event Handler.
delegate void	EntriesClearedEventHandler ()
	Prototype for the Entries Cleared Event Handler.
delegate void	EntryAddedEventHandler (SharingEntry entry)
	Prototype for the Entry Added Event Handler.
delegate void	EntryRemovedEventHandler (SharingEntry entry)
	Prototype for the Entry Removed Event Handler.
IEnumerator< SharingEntry >	GetEnumerator ()
string	GetFileListXml ()
	Get the DC++ file list.
byte[]	GetFileListXmlBZ2 ()
	Get the compressed DC++ file list.
SharingEntry	GetShareByFilename (string filename)
	Tries to find a Share identified by its filename.
SharingEntry	GetShareByFileRequest (string file_request)
	Tries to find a Share identified by its TTH or filename to search for a TTH put a TTH/ in front the Base32 encoded TTH.
SharingEntry	GetShareByTTH (string tth)
	Tries to find a share identified by its tth.
void	LoadSharesFromXml (string xml)
	Load shares from a xml string.
void	LoadSharesFromXmlFile (string filename)
	Load shares from a xml file.
bool	Remove (string filename)
	Remove an entry from the shares list fires the removed event if an entry was removed.
bool	Remove (SharingEntry item)
	Remove an entry from the shares list fires the removed event if an entry was removed.
string	SaveSharesToXml ()
	Get shares list represented as a xml string.
void	SaveSharesToXmlFile (string filename)
	Save shares to a xml file.
void	ShareDirectory (string directory)
	Asynchronously share a directory tree [Non blocking].
void	ShareFile (string filename)
	Asynchronously share a file [Non blocking].
[Test] void	TestEmptyGetFileListXml ()
	Test to see if a valid empty file list will be created.
[Test] void	TestGetFileListXml ()
	Test to see a valid file list will be created.
[Test] void	TestShareDirectory ()
	Test to see if sharing of a directory works as expected.
[Test] void	TestShareFile ()
	Test to see if sharing of a file works as expected.
[Test] void	TestShareSaveLoad ()
	Test to see if loading and saving of shares works as expected.
[Test] void	TestShareSearchRemove ()
	Test to see if searching and removing of shares works as expected.
[Test] void	TestSharingNotExistingDirectory ()
	Test to see if sharing of a non existing directory fails as expected (to check for crashes of unexpected uncatched exceptions).
[Test] void	TestTTHs ()
	Test to see if hashing of files works as expected.
void	UpdateFileLists ()
	Create the DC++ file list from our shares list.
Public Attributes
event DirectoryFinishedEventHandler	DirectoryFinished
	Event handler that gets called when sharing/hashing a directory has finished.
event EntriesChangedEventHandler	EntriesChanged
	Event handler that gets called when one or more entries were changed (deprecated , or possibly reused for its original purpose).
event EntriesClearedEventHandler	EntriesCleared
	Event handler that gets called when all shares were removed.
event EntryAddedEventHandler	EntryAdded
	Event handler that gets called when an entry was added to the shares.
event EntryRemovedEventHandler	EntryRemoved
	Event handler that gets called when an entry was removed from the shares.
Protected Attributes
string	cid = "D2QLOGUYDX3QA"
string	generator = "vpDcPlusPlus 0.2"
List< SharingEntry >	items = new List<SharingEntry>()
[XmlIgnoreAttribute] Object	share_lock = new Object()
	The lock object to make the sharing class thread safe.
long	total_bytes_shared = 0
Properties
string	CID [get, set]
	??CID?? i really need to look up what cid means and does ;-)
int	Count [get]
	Get the number of shared files.
string	Generator [get, set]
	Get/Set the file list generator name in the DC++ file list.
bool	IsReadOnly [get]
List< SharingEntry >	Items [get, set]
	List of shares (will be an unpublic property soon,because of public locks that would be needed to use Items in a loop).
[XmlIgnoreAttribute] long	TotalBytesShared [get]
	Get the total number of bytes of all files shared.
Private Member Functions
bool	CleanDirectories (DirectoryContents dc)
	Cleans the directory tree from empty directories (broken somehow).
void	FillDirectories (DirectoryContents root)
	Fill a directory contents tree from the shares list.
DirectoryContents	FindExistingDirectory (DirectoryContents dc, string directory_name)
	Find an existing directory in the directory contents tree.
string	GetDirectoryContentsString (DirectoryContents dc)
	Recursively gets all directory contents tree.
IEnumerator IEnumerable.	GetEnumerator ()
void	RecurseShareDirectoryAsync (string directory)
	Recursively share a directory tree.
string	ShareDirectoryAsync (string directory)
	Handler to recursively share a directory tree.
void	ShareDirectoryFinished (IAsyncResult result)
	Callback for the share directory Handler.
delegate string	ShareDirectoryHandler (string directory)
	Private Prototype for the Share Directory Async Handler (we return the path to ensure the correct parameter will be given to the directory finished event handler [multiple sharing threads can run at the same time ,so we need a way to differentiate them]).
SharingEntry	ShareFileAsync (string filename)
	Handler to share a file (will calculate its hash , so this may take a while or a lot longer ;-) ) TODO this will be renamed to ShareFile and vice versa for a more intuitive reading of the source code.
void	ShareFileFinished (IAsyncResult result)
	Callback for the share file Handler.
delegate SharingEntry	ShareFileHandler (string filename)
	Private Prototype for the Share File Async Handler.
Static Private Member Functions
static string	FromXmlString (string org)
	Convert a xml string back to a normal string (unquoting of invalid characters).
static string	ToXmlString (string org)
	Convert a string to a valid xml string (enquoting of invalid characters).
Private Attributes
string	file_list = ""
	DC++ formatted file list of our shares list.
byte[]	file_list_bz2
	bz2 compressed file list
bool	file_list_needs_update = true
	set to TRUE if at least one file was added/removed to indicate that the file list needs to be reconstructed
Classes
class	DirectoryContents
	Helper class for the DC++ file list construction. More...
class	SharingEntry
	A Class to hold the information needed for a shared file. More...
class	SharingEnumerator
class	SharingEnumerator2

---

Detailed Description

A Class that manages shares for other clients. Holds a list of shares and functions to add/remove/search for them.

Definition at line 23 of file Sharing.cs.

---

Member Function Documentation

void DCPlusPlus.Sharing.Add

(

SharingEntry

item

)

Add an entry to the shares list fires the added event.

Parameters:

item

the entry to be added

Definition at line 397 of file Sharing.cs.

References DCPlusPlus.Sharing.EntriesChanged, DCPlusPlus.Sharing.EntryAdded, DCPlusPlus.Sharing.file_list_needs_update, DCPlusPlus.Sharing.items, and DCPlusPlus.Sharing.share_lock.

Referenced by DCPlusPlus.Sharing.RecurseShareDirectoryAsync(), and DCPlusPlus.Sharing.ShareFileFinished().

        {
            lock (share_lock)
            {
                items.Add(item);
            }
            try
            {
                if (EntryAdded != null)
                    EntryAdded(item);
                if (EntriesChanged != null)
                    EntriesChanged();
            }
            catch (Exception ex)
            {
                Console.WriteLine("Exception occured in added event callback: " + ex.Message);
            }
            file_list_needs_update = true;
        }

Here is the caller graph for this function:

bool DCPlusPlus.Sharing.CleanDirectories

(

DirectoryContents

dc

)

[private]

Cleans the directory tree from empty directories (broken somehow).

Parameters:

dc

the starting point from which to clean

Returns:

reserved for internal purposes

Definition at line 863 of file Sharing.cs.

References DCPlusPlus.Sharing.DirectoryContents.directories, and DCPlusPlus.Sharing.DirectoryContents.files.

Referenced by DCPlusPlus.Sharing.UpdateFileLists().

        {//cleans directorycontents class of empty shares
            //check if this dir is empty and shall be removed
            foreach (DirectoryContents dir in dc.directories)
            {
                if (!CleanDirectories(dir))
                    dc.directories.Remove(dir); //hope this will not throw an exception
            }
            if (dc.directories.Count == 0 && dc.files.Count == 0)
            {
                return (false);
            }
            else if (dc.directories.Count == 1 && dc.files.Count == 0)
            {//only one shared dir here .. exchange this , this may lead into problems of incorrect tree... investigation needed
                dc = dc.directories[0];
            }
            return (true);
        }

Here is the caller graph for this function:

void DCPlusPlus.Sharing.Clear

(

)

Clears the shares list.

Definition at line 419 of file Sharing.cs.

References DCPlusPlus.Sharing.EntriesChanged, DCPlusPlus.Sharing.EntriesCleared, DCPlusPlus.Sharing.file_list_needs_update, DCPlusPlus.Sharing.items, and DCPlusPlus.Sharing.share_lock.

Referenced by DCPlusPlus.Sharing.TestShareSaveLoad().

        {
            lock (share_lock)
            {
                items.Clear();
            }
            try
            {

                if (EntriesCleared != null)
                    EntriesCleared();
                if (EntriesChanged != null)
                    EntriesChanged();
            }
            catch (Exception ex)
            {
                Console.WriteLine("Exception occured in clear event callback: " + ex.Message);
            }
            file_list_needs_update = true;
        }

Here is the caller graph for this function:

bool DCPlusPlus.Sharing.Contains

(

SharingEntry

item

)

Definition at line 927 of file Sharing.cs.

References DCPlusPlus.Sharing.items, and DCPlusPlus.Sharing.share_lock.

        {
            bool ret = false;
            lock (share_lock)
            {
                ret = items.Contains(item);
            }
            return (ret);
        }

void DCPlusPlus.Sharing.CopyTo	(	SharingEntry[]	array,
		int	arrayIndex
	)

Definition at line 937 of file Sharing.cs.

References DCPlusPlus.Sharing.items, and DCPlusPlus.Sharing.share_lock.

        {
            lock (share_lock)
            {
                foreach (SharingEntry entry in items)
                {
                    array.SetValue(entry, arrayIndex);
                    arrayIndex = arrayIndex + 1;
                }
            }
        }

delegate void DCPlusPlus.Sharing.DirectoryFinishedEventHandler

(

string

directory

)

Prototype for the Directory Finished Event Handler.

Parameters:

directory

The directory finished sharing

delegate void DCPlusPlus.Sharing.EntriesChangedEventHandler

(

)

Prototype for the Entries Changed Event Handler.

delegate void DCPlusPlus.Sharing.EntriesClearedEventHandler

(

)

Prototype for the Entries Cleared Event Handler.

delegate void DCPlusPlus.Sharing.EntryAddedEventHandler

(

SharingEntry

entry

)

Prototype for the Entry Added Event Handler.

Parameters:

entry

The entry that was added to the shares

delegate void DCPlusPlus.Sharing.EntryRemovedEventHandler

(

SharingEntry

entry

)

Prototype for the Entry Removed Event Handler.

Parameters:

entry

The entry that was removed from the shares

void DCPlusPlus.Sharing.FillDirectories

(

DirectoryContents

root

)

[private]

Fill a directory contents tree from the shares list.

Parameters:

root

Definition at line 827 of file Sharing.cs.

References DCPlusPlus.Sharing.DirectoryContents.directories, DCPlusPlus.Sharing.DirectoryContents.directory_name, DCPlusPlus.Sharing.DirectoryContents.files, DCPlusPlus.Sharing.FindExistingDirectory(), DCPlusPlus.Sharing.items, and DCPlusPlus.Sharing.share_lock.

Referenced by DCPlusPlus.Sharing.UpdateFileLists().

        {
            lock (share_lock)
            {
                foreach (SharingEntry entry in items)
                {
                    string path = Path.GetDirectoryName(entry.Filename);
                    path = path.Substring(3);//strip away the drive letter --> WIN32 specific!!!! needs to be changed if other platform shall be supported
                    char[] seps = {'\\'};
                    string[] paths = path.Split(seps);
                    DirectoryContents actual = root;
                    foreach (string path_part in paths)
                    {
                        DirectoryContents existing = FindExistingDirectory(actual,path_part);
                        if (existing == null)
                        {
                            DirectoryContents add = new DirectoryContents();
                            add.directory_name = path_part;
                            actual.directories.Add(add);
                            existing = add;
                        }
                        actual = existing;
                    }
                    if(!actual.files.Contains(entry))
                        actual.files.Add(entry);


                }
            }
        }

Here is the call graph for this function:

Here is the caller graph for this function:

DirectoryContents DCPlusPlus.Sharing.FindExistingDirectory	(	DirectoryContents	dc,
		string	directory_name
	)			[private]

Find an existing directory in the directory contents tree.

Parameters:

	dc	the starting point of search
	directory_name	the path of the directory to search for

Returns:

the directory sub tree found or NULL

Definition at line 815 of file Sharing.cs.

References DCPlusPlus.Sharing.DirectoryContents.directories.

Referenced by DCPlusPlus.Sharing.FillDirectories().

        {
            foreach (DirectoryContents dir in dc.directories)
            {
                if (dir.directory_name == directory_name) return (dir);
            }
            return (null);
        }

Here is the caller graph for this function:

static string DCPlusPlus.Sharing.FromXmlString

(

string

org

)

[static, private]

Convert a xml string back to a normal string (unquoting of invalid characters).

Parameters:

org

xml string

Returns:

an unquoted string

Definition at line 782 of file Sharing.cs.

        {
            if (org == null) return ("");
            string tmp = new string(org.ToCharArray());
            //System.Console.WriteLine("Stripping Linefeeds on string content: '" + tmp+"'");
            while (tmp.IndexOf("&") != -1) tmp = tmp.Replace("&", "&");
            while (tmp.IndexOf("&lt;") != -1) tmp = tmp.Replace("&lt;", "<");
            while (tmp.IndexOf("&gt;") != -1) tmp = tmp.Replace("&gt;", ">");
            while (tmp.IndexOf("&quot;") != -1) tmp = tmp.Replace("&quot;", "\"");
            while (tmp.IndexOf("&apos;") != -1) tmp = tmp.Replace("&apos;", "'");
            for (int i = 0; i < 32; i++)
            {
                char c = Convert.ToChar(i);
                if (i != 0x09 && i != 0x0a && i != 0x0d)
                {
                    int pos = -1;
                    string s = "&#" + Convert.ToString(c, 16) + ";";
                    while ((pos = tmp.IndexOf(s)) != -1)
                    {
                        tmp = tmp.Remove(pos, s.Length);
                        tmp = tmp.Insert(pos, c.ToString());
                    }
                }
            }
            //System.Console.WriteLine("after multiple newline remove check: '" + tmp + "'");
            return (tmp);
        }

string DCPlusPlus.Sharing.GetDirectoryContentsString

(

DirectoryContents

dc

)

[private]

Recursively gets all directory contents tree.

Parameters:

dc

the starting point of content gathering

Returns:

the directory contents

Definition at line 886 of file Sharing.cs.

References DCPlusPlus.Sharing.DirectoryContents.directories, DCPlusPlus.Sharing.DirectoryContents.directory_name, DCPlusPlus.Sharing.DirectoryContents.files, and DCPlusPlus.Sharing.ToXmlString().

Referenced by DCPlusPlus.Sharing.UpdateFileLists().

        {//recursively get all contents in one string
            string dir_string = "";
            if (dc.directory_name != "")
                dir_string += "<Directory Name=\"" + ToXmlString(dc.directory_name) + "\">\n";
            foreach (DirectoryContents dir in dc.directories)
            {
                dir_string += GetDirectoryContentsString(dir);
            }
            if (dc.directory_name != "")
            {
                foreach (SharingEntry file in dc.files)
                {
                    dir_string += "<File Name=\"" + ToXmlString(Path.GetFileName(file.Filename)) + "\" Size=\"" + file.Filesize + "\" TTH=\"" + file.TTH + "\"/>\n";
                }
                dir_string += "</Directory>\n";
            }
            return (dir_string);
        }

Here is the call graph for this function:

Here is the caller graph for this function:

IEnumerator IEnumerable. DCPlusPlus.Sharing.GetEnumerator

(

)

[private]

Definition at line 1068 of file Sharing.cs.

References DCPlusPlus.Sharing.items.

        {
            return (new SharingEnumerator(items.ToArray()));
        }

IEnumerator<SharingEntry> DCPlusPlus.Sharing.GetEnumerator

(

)

Definition at line 1022 of file Sharing.cs.

References DCPlusPlus.Sharing.items.

        {
            return (new SharingEnumerator2(items.ToArray()));
        }

string DCPlusPlus.Sharing.GetFileListXml

(

)

Get the DC++ file list.

Returns:

the uncompressed file list

Definition at line 909 of file Sharing.cs.

References DCPlusPlus.Sharing.file_list, DCPlusPlus.Sharing.file_list_needs_update, and DCPlusPlus.Sharing.UpdateFileLists().

Referenced by DCPlusPlus.Sharing.TestEmptyGetFileListXml(), and DCPlusPlus.Sharing.TestGetFileListXml().

        {
            if (file_list_needs_update)
                UpdateFileLists();
            return (file_list);
        }

Here is the call graph for this function:

Here is the caller graph for this function:

byte [] DCPlusPlus.Sharing.GetFileListXmlBZ2

(

)

Get the compressed DC++ file list.

Returns:

the compressed file list

Definition at line 919 of file Sharing.cs.

References DCPlusPlus.Sharing.file_list_bz2, DCPlusPlus.Sharing.file_list_needs_update, and DCPlusPlus.Sharing.UpdateFileLists().

Referenced by DCPlusPlus.Client.SetupPeerEventHandler().

        {
            if (file_list_needs_update)
                UpdateFileLists();
            return(file_list_bz2);
        }

Here is the call graph for this function:

Here is the caller graph for this function:

SharingEntry DCPlusPlus.Sharing.GetShareByFilename

(

string

filename

)

Tries to find a Share identified by its filename.

Parameters:

filename

the filename of the share to be found

Returns:

an existing entry or NULL if none was found

Definition at line 354 of file Sharing.cs.

References DCPlusPlus.Sharing.items, and DCPlusPlus.Sharing.share_lock.

Referenced by DCPlusPlus.Sharing.GetShareByFileRequest(), and DCPlusPlus.Sharing.TestShareSearchRemove().

        {
            SharingEntry ret = null;
            lock (share_lock)
            {
                foreach (SharingEntry entry in items)
                {
                    if (entry.Filename.EndsWith(filename)) //maybe change this to a more sophisticated approach
                    {
                        //Console.WriteLine("Found entry by filename: "+filename);
                        ret =  entry;
                        break;
                    }
                }
            }
            return (ret);
        }

Here is the caller graph for this function:

SharingEntry DCPlusPlus.Sharing.GetShareByFileRequest

(

string

file_request

)

Tries to find a Share identified by its TTH or filename to search for a TTH put a TTH/ in front the Base32 encoded TTH.

Parameters:

file_request

TTH or filename of share to be found

Returns:

an existing entry for the file request or NULL if none was found

Definition at line 342 of file Sharing.cs.

References DCPlusPlus.Sharing.GetShareByFilename(), and DCPlusPlus.Sharing.GetShareByTTH().

Referenced by DCPlusPlus.Client.SetupPeerEventHandler().

        {
            if(file_request.StartsWith("TTH/"))
                return(GetShareByTTH(file_request.Substring(4)));
            return (GetShareByFilename(file_request));
        }

Here is the call graph for this function:

Here is the caller graph for this function:

SharingEntry DCPlusPlus.Sharing.GetShareByTTH

(

string

tth

)

Tries to find a share identified by its tth.

Parameters:

tth

the tth of the share to be found

Returns:

an existing entry or NULL if none was found

Definition at line 376 of file Sharing.cs.

References DCPlusPlus.Sharing.items, and DCPlusPlus.Sharing.share_lock.

Referenced by DCPlusPlus.Client.ConnectHub(), and DCPlusPlus.Sharing.GetShareByFileRequest().

        {
            SharingEntry ret = null;
            lock (share_lock)
            {
                foreach (SharingEntry entry in items)
                {
                    if (entry.HasTTH && entry.TTH == tth)
                    {
                        ret = entry;
                        break;
                    }
                }
            }
            return (ret);
        }

Here is the caller graph for this function:

void DCPlusPlus.Sharing.LoadSharesFromXml

(

string

xml

)

Load shares from a xml string.

Parameters:

xml

a xml representation of a shares list

Definition at line 514 of file Sharing.cs.

References DCPlusPlus.Sharing.EntriesChanged, DCPlusPlus.Sharing.EntriesCleared, DCPlusPlus.Sharing.EntryAdded, DCPlusPlus.Sharing.file_list_needs_update, DCPlusPlus.Sharing.Items, DCPlusPlus.Sharing.items, DCPlusPlus.Sharing.share_lock, and DCPlusPlus.Sharing.total_bytes_shared.

Referenced by DCPlusPlus.Sharing.LoadSharesFromXmlFile().

        {
            lock (share_lock)
            {
                items.Clear();
            }
            if (EntriesCleared != null)
                EntriesCleared();
            Sharing s = new Sharing();
            try
            {
                XmlSerializer serializer = new XmlSerializer(typeof(Sharing));
                MemoryStream ms = new MemoryStream(System.Text.Encoding.Default.GetBytes(xml));
                s = (Sharing)serializer.Deserialize(ms);
            }
            catch (Exception ex)
            {
                Console.WriteLine("Error deserializing queue: " + ex.Message);
            }
            if (s != null)
            {
                lock (share_lock)
                {
                    items = s.Items;
                }
            }
            if (EntryAdded != null)
            {
                lock (share_lock)
                {
                    foreach (SharingEntry entry in items)
                    {
                        total_bytes_shared += entry.Filesize;
                        EntryAdded(entry);
                    }
                }
            }
            if (EntriesChanged != null)
            {
                EntriesChanged();
            }
            file_list_needs_update = true;
        }

Here is the caller graph for this function:

void DCPlusPlus.Sharing.LoadSharesFromXmlFile

(

string

filename

)

Load shares from a xml file.

Parameters:

filename

the filename of the shares xml file

Definition at line 589 of file Sharing.cs.

References DCPlusPlus.Sharing.LoadSharesFromXml().

Referenced by DCPlusPlus.Sharing.TestShareSaveLoad().

        {
            try
            {
                if (!File.Exists(filename)) return;
                LoadSharesFromXml(System.IO.File.ReadAllText(filename));
            }
            catch (Exception ex)
            {
                Console.WriteLine("Error loading queue from: " + filename + " : " + ex.Message);
            }
        }

Here is the call graph for this function:

Here is the caller graph for this function:

void DCPlusPlus.Sharing.RecurseShareDirectoryAsync

(

string

directory

)

[private]

Recursively share a directory tree.

Parameters:

directory

the path of the root directory to be shared

Definition at line 262 of file Sharing.cs.

References DCPlusPlus.Sharing.Add(), DCPlusPlus.Sharing.ShareFileAsync(), and DCPlusPlus.Sharing.total_bytes_shared.

Referenced by DCPlusPlus.Sharing.ShareDirectoryAsync().

        {
            if (!Directory.Exists(directory)) return;
            string[] files = Directory.GetFiles(directory);
            string[] dirs = Directory.GetDirectories(directory);
            foreach (string dir in dirs)
            {
                if (System.IO.Directory.Exists(dir))
                {
                    RecurseShareDirectoryAsync(dir);
                }
            }
            foreach (string file in files)
            {
                if (System.IO.File.Exists(file))
                {
                    SharingEntry entry = ShareFileAsync(file);
                    if (entry != null)
                    {
                        total_bytes_shared += entry.Filesize;
                        Add(entry);
                    }
                }
            }
        }

Here is the call graph for this function:

Here is the caller graph for this function:

bool DCPlusPlus.Sharing.Remove

(

string

filename

)

Remove an entry from the shares list fires the removed event if an entry was removed.

Parameters:

filename

the filename of the entry to remove

Returns:

TRUE if an entry was removed

Definition at line 476 of file Sharing.cs.

References DCPlusPlus.Sharing.EntriesChanged, DCPlusPlus.Sharing.EntryRemoved, DCPlusPlus.Sharing.file_list_needs_update, DCPlusPlus.Sharing.SharingEntry.Filesize, DCPlusPlus.Sharing.items, DCPlusPlus.Sharing.share_lock, and DCPlusPlus.Sharing.total_bytes_shared.

        {
            SharingEntry ret = null;
            lock (share_lock)
            {
                foreach (SharingEntry entry in items)
                {
                    if (entry.Filename == filename)
                    {
                        items.Remove(entry);
                        ret = entry;
                        break;
                    }
                }
            }
            if (ret != null)
            {
                total_bytes_shared -= ret.Filesize;
                try
                {
                    if (EntryRemoved != null)
                        EntryRemoved(ret);
                    if (EntriesChanged != null)
                        EntriesChanged();
                }
                catch (Exception ex)
                {
                    Console.WriteLine("Exception occured in remove event callback: " + ex.Message);
                }
                file_list_needs_update = true;
                return (true);
            }
            return (false);
        }

bool DCPlusPlus.Sharing.Remove

(

SharingEntry

item

)

Remove an entry from the shares list fires the removed event if an entry was removed.

Parameters:

item

the entry to remove

Returns:

TRUE if an entry was removed

Definition at line 446 of file Sharing.cs.

References DCPlusPlus.Sharing.EntriesChanged, DCPlusPlus.Sharing.EntryRemoved, DCPlusPlus.Sharing.file_list_needs_update, DCPlusPlus.Sharing.SharingEntry.Filesize, DCPlusPlus.Sharing.items, DCPlusPlus.Sharing.share_lock, and DCPlusPlus.Sharing.total_bytes_shared.

Referenced by DCPlusPlus.Sharing.TestShareSearchRemove().

        {
            total_bytes_shared -= item.Filesize;
            bool ret = false;
            lock (share_lock)
            {
                ret = items.Remove(item);
            }
            if (ret == false) return (false); //only call event handler if an entry was actually removed
            try
            {
                if (EntryRemoved != null)
                    EntryRemoved(item);
                if (EntriesChanged != null)
                    EntriesChanged();
            }
            catch (Exception ex)
            {
                Console.WriteLine("Exception occured in remove event callback: " + ex.Message);
            }
            file_list_needs_update = true;
            return (ret);
        }

Here is the caller graph for this function:

string DCPlusPlus.Sharing.SaveSharesToXml

(

)

Get shares list represented as a xml string.

Returns:

the share list xml formatted

Definition at line 561 of file Sharing.cs.

References DCPlusPlus.Sharing.share_lock.

Referenced by DCPlusPlus.Sharing.SaveSharesToXmlFile().

        {
            //nice way but seems to not work with list<> members
            lock (share_lock)
            {
                string ret = "";
                try
                {
                    XmlSerializer serializer = new XmlSerializer(typeof(Sharing));
                    MemoryStream ms = new MemoryStream();
                    serializer.Serialize(ms, this);
                    ms.Flush();
                    ret = System.Text.Encoding.Default.GetString(ms.GetBuffer(), 0, (int)ms.Length);//TODO ... 4gb crash border
                    //ret = ret.TrimEnd((char)0);

                }
                catch (Exception ex)
                {
                    Console.WriteLine("Error serializing queue: " + ex.Message);
                    return (null);
                }
                return (ret);
            }
        }

Here is the caller graph for this function:

void DCPlusPlus.Sharing.SaveSharesToXmlFile

(

string

filename

)

Save shares to a xml file.

Parameters:

filename

the filename to write to

Definition at line 605 of file Sharing.cs.

References DCPlusPlus.Sharing.SaveSharesToXml().

Referenced by DCPlusPlus.Sharing.TestShareSaveLoad().

        {
            try
            {
                if (File.Exists(filename + ".backup") && File.Exists(filename))
                    File.Delete(filename + ".backup");
                if (File.Exists(filename))
                    File.Move(filename, filename + ".backup");

                System.IO.File.WriteAllText(filename, SaveSharesToXml());
            }
            catch (Exception ex)
            {
                Console.WriteLine("Error saving queue to: " + filename + " : " + ex.Message);
            }
        }

Here is the call graph for this function:

Here is the caller graph for this function:

void DCPlusPlus.Sharing.ShareDirectory

(

string

directory

)

Asynchronously share a directory tree [Non blocking].

Parameters:

directory

the path of the root directory to be shared

Definition at line 330 of file Sharing.cs.

References DCPlusPlus.Sharing.ShareDirectoryAsync(), DCPlusPlus.Sharing.ShareDirectoryFinished(), and DCPlusPlus.Sharing.ShareDirectoryHandler().

Referenced by DCPlusPlus.Sharing.TestEmptyGetFileListXml(), DCPlusPlus.Sharing.TestGetFileListXml(), DCPlusPlus.Sharing.TestShareDirectory(), DCPlusPlus.Sharing.TestShareSaveLoad(), DCPlusPlus.Sharing.TestShareSearchRemove(), DCPlusPlus.Sharing.TestSharingNotExistingDirectory(), and DCPlusPlus.Sharing.TestTTHs().

        {
            ShareDirectoryHandler sdh = new ShareDirectoryHandler(ShareDirectoryAsync);
            IAsyncResult result = sdh.BeginInvoke(directory, new AsyncCallback(ShareDirectoryFinished), sdh);
        }

Here is the call graph for this function:

Here is the caller graph for this function:

string DCPlusPlus.Sharing.ShareDirectoryAsync

(

string

directory

)

[private]

Handler to recursively share a directory tree.

Parameters:

directory

the path of the root directory to be shared

Returns:

the directories path that was given as parameter

Definition at line 253 of file Sharing.cs.

References DCPlusPlus.Sharing.RecurseShareDirectoryAsync().

Referenced by DCPlusPlus.Sharing.ShareDirectory().

        {//recurse into directories
            RecurseShareDirectoryAsync(directory);
            return (directory);
        }

Here is the call graph for this function:

Here is the caller graph for this function:

void DCPlusPlus.Sharing.ShareDirectoryFinished

(

IAsyncResult

result

)

[private]

Callback for the share directory Handler.

Parameters:

result

Async Result/State

Definition at line 306 of file Sharing.cs.

References DCPlusPlus.Sharing.DirectoryFinished, DCPlusPlus.Sharing.file_list_needs_update, and DCPlusPlus.Sharing.ShareDirectoryHandler().

Referenced by DCPlusPlus.Sharing.ShareDirectory().

        {
            ShareDirectoryHandler sdh = (ShareDirectoryHandler)result.AsyncState;
            string directory = sdh.EndInvoke(result);
            if (DirectoryFinished != null)
                DirectoryFinished(directory);
            file_list_needs_update = true;
        }

Here is the call graph for this function:

Here is the caller graph for this function:

delegate string DCPlusPlus.Sharing.ShareDirectoryHandler

(

string

directory

)

[private]

Private Prototype for the Share Directory Async Handler (we return the path to ensure the correct parameter will be given to the directory finished event handler [multiple sharing threads can run at the same time ,so we need a way to differentiate them]).

Parameters:

directory

the path of the directory to be shared

Returns:

the directories path that was given as parameter

Referenced by DCPlusPlus.Sharing.ShareDirectory(), and DCPlusPlus.Sharing.ShareDirectoryFinished().

Here is the caller graph for this function:

void DCPlusPlus.Sharing.ShareFile

(

string

filename

)

Asynchronously share a file [Non blocking].

Parameters:

filename

the filename of the file to be shared

Definition at line 320 of file Sharing.cs.

References DCPlusPlus.Sharing.ShareFileAsync(), DCPlusPlus.Sharing.ShareFileFinished(), and DCPlusPlus.Sharing.ShareFileHandler().

Referenced by DCPlusPlus.Sharing.TestShareFile().

        {
            ShareFileHandler sfh = new ShareFileHandler(ShareFileAsync);
            IAsyncResult result = sfh.BeginInvoke(filename, new AsyncCallback(ShareFileFinished), sfh);
        }

Here is the call graph for this function:

Here is the caller graph for this function:

SharingEntry DCPlusPlus.Sharing.ShareFileAsync

(

string

filename

)

[private]

Handler to share a file (will calculate its hash , so this may take a while or a lot longer ;-) ) TODO this will be renamed to ShareFile and vice versa for a more intuitive reading of the source code.

Parameters:

filename

the filename of the file to be shared

Returns:

an entry of the file that was shared

Definition at line 212 of file Sharing.cs.

References DCPlusPlus.Sharing.SharingEntry.Filename, DCPlusPlus.Sharing.SharingEntry.Filesize, and DCPlusPlus.Sharing.SharingEntry.TTH.

Referenced by DCPlusPlus.Sharing.RecurseShareDirectoryAsync(), and DCPlusPlus.Sharing.ShareFile().

        {//share file
            if (!System.IO.File.Exists(filename)) return (null);
            SharingEntry entry = new SharingEntry();
            entry.Filename = filename;
            try
            {
                System.IO.FileInfo fi = new FileInfo(filename);
            entry.Filesize = fi.Length;
            //now try to hash the file also
            /*
            Tiger192 tiger = new Tiger192();
            byte[] file_contents = System.IO.File.ReadAllBytes(filename);
            tiger.ComputeHash(file_contents, 0, file_contents.Length-1);
            Console.WriteLine("hash:" + Base32.GetString(tiger.Hash));
            entry.TTH = Base32.GetString(tiger.Hash);
            */
            ThexThreaded TTH = new ThexThreaded();
            entry.TTH = Base32.ToBase32String(TTH.GetTTH_Value(filename));

            }
            catch (Exception ex)
            {
                Console.WriteLine("exception during hashing:" + ex.Message);
            }
            return (entry);
        }

Here is the caller graph for this function:

void DCPlusPlus.Sharing.ShareFileFinished

(

IAsyncResult

result

)

[private]

Callback for the share file Handler.

Parameters:

result

Async Result/State

Definition at line 291 of file Sharing.cs.

References DCPlusPlus.Sharing.Add(), DCPlusPlus.Sharing.file_list_needs_update, DCPlusPlus.Sharing.ShareFileHandler(), and DCPlusPlus.Sharing.total_bytes_shared.

Referenced by DCPlusPlus.Sharing.ShareFile().

        {
            ShareFileHandler sfh = (ShareFileHandler)result.AsyncState;
            SharingEntry entry = sfh.EndInvoke(result);
            if (entry != null)
            {
                total_bytes_shared += entry.Filesize;
                Add(entry);
            }
            file_list_needs_update = true;
        }

Here is the call graph for this function:

Here is the caller graph for this function:

delegate SharingEntry DCPlusPlus.Sharing.ShareFileHandler

(

string

filename

)

[private]

Private Prototype for the Share File Async Handler.

Parameters:

filename

the filename of the file to be shared

Returns:

an entry of the file that was shared

Referenced by DCPlusPlus.Sharing.ShareFile(), and DCPlusPlus.Sharing.ShareFileFinished().

Here is the caller graph for this function:

[Test] void DCPlusPlus.Sharing.TestEmptyGetFileListXml

(

)

Test to see if a valid empty file list will be created.

Definition at line 1357 of file Sharing.cs.

References DCPlusPlus.Sharing.DirectoryFinished, DCPlusPlus.Sharing.EntryAdded, DCPlusPlus.Sharing.file_list, DCPlusPlus.Sharing.SharingEntry.Filename, DCPlusPlus.Sharing.SharingEntry.Filesize, DCPlusPlus.Sharing.GetFileListXml(), DCPlusPlus.Sharing.ShareDirectory(), and DCPlusPlus.Sharing.SharingEntry.TTH.

        {
            Console.WriteLine("Test to see if a correct empty filelist was created.");
            bool wait = true;
            Sharing s = new Sharing();
            s.EntryAdded = delegate(SharingEntry entry)
            {
                Console.WriteLine("File Added: " + entry.Filename + ", filesize: " + entry.Filesize + ",tth: " + entry.TTH);
            };
            s.DirectoryFinished = delegate(string directory)
            {
                wait = false;
            };
            s.ShareDirectory("..\\..\\..\\TestFileListEmpty"); 

            Console.WriteLine("Waiting for data");
            DateTime start = DateTime.Now;
            while (wait)
            {
                if (DateTime.Now - start > new TimeSpan(0, 0, 30))
                {
                    Console.WriteLine("");
                    Console.WriteLine("Operation took too long");
                    wait = false;
                    Assert.Fail("Operation took too long");
                }
                Console.Write(".");
                Thread.Sleep(250);
            }
            string file_list = s.GetFileListXml();
            Console.WriteLine("\nfilelist:\n" + file_list);

            //now check if items are correct
            Assert.IsTrue(file_list == "", "Empty FileList expected.");
            Console.WriteLine("Empty GetFilesList Creation Test successful.");
        }

Here is the call graph for this function:

[Test] void DCPlusPlus.Sharing.TestGetFileListXml

(

)

Test to see a valid file list will be created.

Definition at line 1397 of file Sharing.cs.

References DCPlusPlus.Sharing.DirectoryFinished, DCPlusPlus.Sharing.EntryAdded, DCPlusPlus.Sharing.file_list, DCPlusPlus.Sharing.SharingEntry.Filename, DCPlusPlus.Sharing.SharingEntry.Filesize, DCPlusPlus.Sharing.GetFileListXml(), DCPlusPlus.Sharing.ShareDirectory(), and DCPlusPlus.Sharing.SharingEntry.TTH.

        {
            Console.WriteLine("Test to see if a correct filelist was created.");
            bool wait = true;
            Sharing s = new Sharing();
            s.EntryAdded = delegate(SharingEntry entry)
            {
                Console.WriteLine("File Added: " + entry.Filename + ", filesize: " + entry.Filesize + ",tth: " + entry.TTH);
            };
            s.DirectoryFinished = delegate(string directory)
            {
                wait = false;
            };
            s.ShareDirectory("..\\..\\..\\TestFileList");

            Console.WriteLine("Waiting for data");
            DateTime start = DateTime.Now;
            while (wait)
            {
                if (DateTime.Now - start > new TimeSpan(0, 0, 30))
                {
                    Console.WriteLine("");
                    Console.WriteLine("Operation took too long");
                    wait = false;
                    Assert.Fail("Operation took too long");
                }
                Console.Write(".");
                Thread.Sleep(250);
            }
            string file_list = s.GetFileListXml();
            Console.WriteLine("\nfilelist:\n" + file_list);

            //now check if items are correct
            Assert.IsTrue(file_list == "", "Empty FileList expected.");
            Console.WriteLine("GetFilesList Creation Test successful.");
        }

Here is the call graph for this function:

[Test] void DCPlusPlus.Sharing.TestShareDirectory

(

)

Test to see if sharing of a directory works as expected.

Definition at line 1114 of file Sharing.cs.

References DCPlusPlus.Sharing.DirectoryFinished, DCPlusPlus.Sharing.EntryAdded, DCPlusPlus.Sharing.SharingEntry.Filename, DCPlusPlus.Sharing.SharingEntry.Filesize, DCPlusPlus.Sharing.items, DCPlusPlus.Sharing.ShareDirectory(), and DCPlusPlus.Sharing.SharingEntry.TTH.

        {
            Console.WriteLine("Test to share a directory.");
            bool wait = true;
            Sharing s = new Sharing();
            s.EntryAdded = delegate(SharingEntry entry)
            {
                Console.WriteLine("File Added: " + entry.Filename + ", filesize: " + entry.Filesize + ",tth: " + entry.TTH);
            };
            s.DirectoryFinished = delegate(string directory)
            {
                wait = false;
            };

            s.ShareDirectory("..\\..\\..\\TestDateien");

            Console.WriteLine("Waiting for data");
            DateTime start = DateTime.Now;
            while (wait)
            {
                if (DateTime.Now - start > new TimeSpan(0, 0, 30))
                {
                    Console.WriteLine("");
                    Console.WriteLine("Operation took too long");
                    wait = false;
                    Assert.Fail("Operation took too long");
                }
                Console.Write(".");
                Thread.Sleep(250);
            }

            //now check if items are correct
            Assert.IsTrue(s.items[0].Filename == "..\\..\\..\\TestDateien\\2sd.avi", "Filename not correct(2sd.avi).");
            Assert.IsTrue(s.items[0].Filesize == 28495872, "Filesize not correct(2sd.avi).");
            Assert.IsTrue(s.items[1].Filename == "..\\..\\..\\TestDateien\\test.mp3", "Filename not correct(test.mp3).");
            Assert.IsTrue(s.items[1].Filesize == 6053888, "Filesize not correct(test.mp3).");
            Assert.IsTrue(s.items[2].Filename == "..\\..\\..\\TestDateien\\test2.mp3", "Filename not correct(test2.mp3).");
            Assert.IsTrue(s.items[2].Filesize == 10539254, "Filesize not correct(test2.mp3).");
            Console.WriteLine("Share Directory Test successful.");
        }

Here is the call graph for this function:

[Test] void DCPlusPlus.Sharing.TestShareFile

(

)

Test to see if sharing of a file works as expected.

Definition at line 1080 of file Sharing.cs.

References DCPlusPlus.Sharing.EntryAdded, DCPlusPlus.Sharing.SharingEntry.Filename, DCPlusPlus.Sharing.SharingEntry.Filesize, DCPlusPlus.Sharing.ShareFile(), and DCPlusPlus.Sharing.SharingEntry.TTH.

        {
            Console.WriteLine("Test to share a file.");
            bool wait = true;
            Sharing s = new Sharing();
            s.EntryAdded = delegate(SharingEntry entry)
            {
                Console.WriteLine("File Added: " + entry.Filename + ", filesize: " + entry.Filesize + ",tth: " + entry.TTH);
                Assert.IsTrue(entry.Filename == "..\\..\\..\\TestDateien\\test.mp3", "Filename not correct(test.mp3).");
                Assert.IsTrue(entry.Filesize == 6053888, "Filesize not correct(test.mp3).");
                wait = false;
            };
            s.ShareFile("..\\..\\..\\TestDateien\\test.mp3");

            Console.WriteLine("Waiting for data");
            DateTime start = DateTime.Now;
            while (wait)
            {
                if (DateTime.Now - start > new TimeSpan(0, 0, 30))
                {
                    Console.WriteLine("");
                    Console.WriteLine("Operation took too long");
                    wait = false;
                    Assert.Fail("Operation took too long");
                }
                Console.Write(".");
                Thread.Sleep(250);
            }
            Console.WriteLine("Share File Test successful.");
        }

Here is the call graph for this function:

[Test] void DCPlusPlus.Sharing.TestShareSaveLoad

(

)

Test to see if loading and saving of shares works as expected.

Definition at line 1158 of file Sharing.cs.

References DCPlusPlus.Sharing.Clear(), DCPlusPlus.Sharing.DirectoryFinished, DCPlusPlus.Sharing.EntryAdded, DCPlusPlus.Sharing.SharingEntry.Filename, DCPlusPlus.Sharing.SharingEntry.Filesize, DCPlusPlus.Sharing.items, DCPlusPlus.Sharing.LoadSharesFromXmlFile(), DCPlusPlus.Sharing.SaveSharesToXmlFile(), DCPlusPlus.Sharing.ShareDirectory(), and DCPlusPlus.Sharing.SharingEntry.TTH.

        {
            Console.WriteLine("Test to save and load shares.");
            bool wait = true;
            Sharing s = new Sharing();
            s.EntryAdded = delegate(SharingEntry entry)
            {
                //Console.WriteLine("");
                Console.WriteLine("File Added: " + entry.Filename + ", filesize: " + entry.Filesize + ",tth: " + entry.TTH);
            };
            s.DirectoryFinished = delegate(string directory)
            {
                wait = false;
            };
            s.ShareDirectory("..\\..\\..\\TestDateien");

            Console.WriteLine("Waiting for data");
            DateTime start = DateTime.Now;
            while (wait)
            {
                if (DateTime.Now - start > new TimeSpan(0, 0, 30))
                {
                    Console.WriteLine("");
                    Console.WriteLine("Operation took too long");
                    wait = false;
                    Assert.Fail("Operation took too long");
                }
                Console.Write(".");
                Thread.Sleep(250);
            }
            Console.WriteLine("");
            Console.WriteLine("Sharing of files completed.");
            //now check if items are correct
            Assert.IsTrue(s.items[0].Filename == "..\\..\\..\\TestDateien\\2sd.avi", "Filename not correct(2sd.avi).");
            Assert.IsTrue(s.items[0].Filesize == 28495872, "Filesize not correct(2sd.avi).");
            Assert.IsTrue(s.items[1].Filename == "..\\..\\..\\TestDateien\\test.mp3", "Filename not correct(test.mp3).");
            Assert.IsTrue(s.items[1].Filesize == 6053888, "Filesize not correct(test.mp3).");
            Assert.IsTrue(s.items[2].Filename == "..\\..\\..\\TestDateien\\test2.mp3", "Filename not correct(test2.mp3).");
            Assert.IsTrue(s.items[2].Filesize == 10539254, "Filesize not correct(test2.mp3).");
            s.SaveSharesToXmlFile("..\\..\\..\\TestDateien\\test_shares.xml");
            Console.WriteLine("Saved Shares.");
            s.Clear();
            Console.WriteLine("Cleared Shares");
            Assert.IsTrue(s.items.Count == 0, "Clearing Shares failed.");
            s.LoadSharesFromXmlFile("..\\..\\..\\TestDateien\\test_shares.xml");
            Console.WriteLine("Shares loaded.");
            Assert.IsTrue(s.items[0].Filename == "..\\..\\..\\TestDateien\\2sd.avi", "Filename not correct(2sd.avi).");
            Assert.IsTrue(s.items[0].Filesize == 28495872, "Filesize not correct(2sd.avi).");
            Assert.IsTrue(s.items[1].Filename == "..\\..\\..\\TestDateien\\test.mp3", "Filename not correct(test.mp3).");
            Assert.IsTrue(s.items[1].Filesize == 6053888, "Filesize not correct(test.mp3).");
            Assert.IsTrue(s.items[2].Filename == "..\\..\\..\\TestDateien\\test2.mp3", "Filename not correct(test2.mp3).");
            Assert.IsTrue(s.items[2].Filesize == 10539254, "Filesize not correct(test2.mp3).");
            Console.WriteLine("Save and Load Shares Test successful.");
        }

Here is the call graph for this function:

[Test] void DCPlusPlus.Sharing.TestShareSearchRemove

(

)

Test to see if searching and removing of shares works as expected.

Definition at line 1216 of file Sharing.cs.

References DCPlusPlus.Sharing.DirectoryFinished, DCPlusPlus.Sharing.EntryAdded, DCPlusPlus.Sharing.SharingEntry.Filename, DCPlusPlus.Sharing.SharingEntry.Filesize, DCPlusPlus.Sharing.GetShareByFilename(), DCPlusPlus.Sharing.items, DCPlusPlus.Sharing.Remove(), DCPlusPlus.Sharing.ShareDirectory(), and DCPlusPlus.Sharing.SharingEntry.TTH.

        {
            Console.WriteLine("Test to search and remove a share.");
            bool wait = true;
            Sharing s = new Sharing();
            s.EntryAdded = delegate(SharingEntry entry)
            {
                Console.WriteLine("File Added: " + entry.Filename + ", filesize: " + entry.Filesize + ",tth: " + entry.TTH);
            };
            s.DirectoryFinished = delegate(string directory)
            {
                wait = false;
            };
            s.ShareDirectory("..\\..\\..\\TestDateien");

            Console.WriteLine("Waiting for data");
            DateTime start = DateTime.Now;
            while (wait)
            {
                if (DateTime.Now - start > new TimeSpan(0, 0, 30))
                {
                    Console.WriteLine("");
                    Console.WriteLine("Operation took too long");
                    wait = false;
                    Assert.Fail("Operation took too long");
                }
                Console.Write(".");
                Thread.Sleep(250);
            }
            Console.WriteLine("Sharing of files completed.");
            //now check if items are correct
            Assert.IsTrue(s.items[0].Filename == "..\\..\\..\\TestDateien\\2sd.avi", "Filename not correct(2sd.avi).");
            Assert.IsTrue(s.items[0].Filesize == 28495872, "Filesize not correct(2sd.avi).");
            Assert.IsTrue(s.items[1].Filename == "..\\..\\..\\TestDateien\\test.mp3", "Filename not correct(test2.mp3).");
            Assert.IsTrue(s.items[1].Filesize == 6053888, "Filesize not correct(test.mp3).");
            Assert.IsTrue(s.items[2].Filename == "..\\..\\..\\TestDateien\\test2.mp3", "Filename not correct(test2.mp3).");
            Assert.IsTrue(s.items[2].Filesize == 10539254, "Filesize not correct(test2.mp3).");
            int num = s.items.Count;
            SharingEntry found = s.GetShareByFilename("..\\..\\..\\TestDateien\\test.mp3");
            Assert.IsTrue(found != null, "Searching Share failed.");
            s.Remove(found);
            Console.WriteLine("Removed Share");
            Assert.IsTrue(s.items.Count == num - 1, "Removing Share failed(test.mp3).");
            found = s.GetShareByFilename("..\\..\\..\\TestDateien\\test.mp3");
            Assert.IsTrue(found == null, "Removing Share failed(test.mp3).");
            s.Remove("..\\..\\..\\TestDateien\\test2.mp3");
            Console.WriteLine("Removed another Share");
            Assert.IsTrue(s.items.Count == num - 2, "Removing Share failed(test2.mp3).");
            found = s.GetShareByFilename("..\\..\\..\\TestDateien\\test2.mp3");
            Assert.IsTrue(found == null, "Removing Share failed(test2.mp3).");
            Console.WriteLine("Search and Remove Test successful.");
        }

Here is the call graph for this function:

[Test] void DCPlusPlus.Sharing.TestSharingNotExistingDirectory

(

)

Test to see if sharing of a non existing directory fails as expected (to check for crashes of unexpected uncatched exceptions).

Definition at line 1319 of file Sharing.cs.

References DCPlusPlus.Sharing.DirectoryFinished, DCPlusPlus.Sharing.EntryAdded, DCPlusPlus.Sharing.SharingEntry.Filename, DCPlusPlus.Sharing.SharingEntry.Filesize, DCPlusPlus.Sharing.items, DCPlusPlus.Sharing.ShareDirectory(), and DCPlusPlus.Sharing.SharingEntry.TTH.

        {
            Console.WriteLine("Test to see if no files were shared.");
            bool wait = true;
            Sharing s = new Sharing();
            s.EntryAdded = delegate(SharingEntry entry)
            {
                Console.WriteLine("File Added: " + entry.Filename + ", filesize: " + entry.Filesize + ",tth: " + entry.TTH);
            };
            s.DirectoryFinished = delegate(string directory)
            {
                wait = false;
            };
            s.ShareDirectory("..\\..\\..\\NotExistingDirectory");

            Console.WriteLine("Waiting for data");
            DateTime start = DateTime.Now;
            while (wait)
            {
                if (DateTime.Now - start > new TimeSpan(0, 0, 30))
                {
                    Console.WriteLine("");
                    Console.WriteLine("Operation took too long");
                    wait = false;
                    Assert.Fail("Operation took too long");
                }
                Console.Write(".");
                Thread.Sleep(250);
            }

            //now check if items are correct
            Assert.IsTrue(s.items.Count == 0, "Test failed : More than none files were shared.");
            Console.WriteLine("Sharing Empty Dir Test successful.");
        }

Here is the call graph for this function:

[Test] void DCPlusPlus.Sharing.TestTTHs

(

)

Test to see if hashing of files works as expected.

Definition at line 1272 of file Sharing.cs.

References DCPlusPlus.Sharing.DirectoryFinished, DCPlusPlus.Sharing.EntryAdded, DCPlusPlus.Sharing.SharingEntry.Filename, DCPlusPlus.Sharing.SharingEntry.Filesize, DCPlusPlus.Sharing.items, DCPlusPlus.Sharing.ShareDirectory(), and DCPlusPlus.Sharing.SharingEntry.TTH.

        {
            Console.WriteLine("Test to see if correct TTHs were created.");
            bool wait = true;
            Sharing s = new Sharing();
            s.EntryAdded = delegate(SharingEntry entry)
            {
                Console.WriteLine("File Added: " + entry.Filename + ", filesize: " + entry.Filesize + ",tth: " + entry.TTH);
            };
            s.DirectoryFinished = delegate(string directory)
            {
                wait = false;
            };
            s.ShareDirectory("..\\..\\..\\TestDateien");

            Console.WriteLine("Waiting for data");
            DateTime start = DateTime.Now;
            while (wait)
            {
                if (DateTime.Now - start > new TimeSpan(0, 0, 30))
                {
                    Console.WriteLine("");
                    Console.WriteLine("Operation took too long");
                    wait = false;
                    Assert.Fail("Operation took too long");
                }
                Console.Write(".");
                Thread.Sleep(250);
            }

            //now check if items are correct
            Assert.IsTrue(s.items[0].Filename == "..\\..\\..\\TestDateien\\2sd.avi", "Filename not correct(2sd.avi).");
            Assert.IsTrue(s.items[0].TTH == "QNGNAPOTVVZRPGSQPOH5X4RWITB3OI27KWXGCEI", "TTH not correct(2sd.avi)(\"" + s.items[0].TTH + "\"!=\"QNGNAPOTVVZRPGSQPOH5X4RWITB3OI27KWXGCEI\").");
            Assert.IsTrue(s.items[0].Filesize == 28495872, "Filesize not correct(2sd.avi).");
            Assert.IsTrue(s.items[1].Filename == "..\\..\\..\\TestDateien\\test.mp3", "Filename not correct(test.mp3).");
            Assert.IsTrue(s.items[1].TTH == "LODVHCUGIS5G534HRWG4LIPXT5TPIO4SS6D2KKI", "TTH not correct(test.mp3)(\"" + s.items[1].TTH + "\"!=\"LODVHCUGIS5G534HRWG4LIPXT5TPIO4SS6D2KKI\").");
            Assert.IsTrue(s.items[1].Filesize == 6053888, "Filesize not correct(test.mp3).");
            Assert.IsTrue(s.items[2].Filename == "..\\..\\..\\TestDateien\\test2.mp3", "Filename not correct(test2.mp3).");
            Assert.IsTrue(s.items[2].TTH == "6CFXRPW5GWT5NQGAU3DYZOCQBAYM63WST5J3HAY", "TTH not correct(test2.mp3)(\"" + s.items[2].TTH + "\"!=\"6CFXRPW5GWT5NQGAU3DYZOCQBAYM63WST5J3HAY\").");
            Assert.IsTrue(s.items[2].Filesize == 10539254, "Filesize not correct(test2.mp3).");
            Console.WriteLine("TTHs Creation Test successful.");
        }

Here is the call graph for this function:

static string DCPlusPlus.Sharing.ToXmlString

(

string

org

)

[static, private]

Convert a string to a valid xml string (enquoting of invalid characters).

Parameters:

org

some string to be converted to a xml string

Returns:

a quoted xml string

Definition at line 728 of file Sharing.cs.

Referenced by DCPlusPlus.Sharing.GetDirectoryContentsString().

        {
            if (String.IsNullOrEmpty(org)) return ("");

            string tmp = new string(org.ToCharArray());
            //System.Console.WriteLine("ToXml on string content: '" + tmp+"'");
            int p = 0;
            //while ((p = tmp.IndexOf("&", p)) != -1) { tmp = tmp.Replace("&", "&amp;"); if(p<tmp.Length)p++; }
            List<int> amps = new List<int>();
            while ((p = tmp.IndexOf("&", p)) != -1)
            {
                //System.Console.WriteLine("ToXml add amp: '" + p + "'");
                amps.Add(p);
                if (p < tmp.Length - 1) p++;
                else break;


            }
            //System.Console.WriteLine("ToXml amp count: '" + amps.Count + "'");
            for (int i = 0; i < amps.Count; i++)
            {
                //System.Console.WriteLine("ToXml amps["+i+"]: '" + amps[i] + "' length of tmp:"+tmp.Length);
                tmp = tmp.Remove(amps[i] + (i * 4), 1);
                tmp = tmp.Insert(amps[i] + (i * 4), "&amp;");
                //System.Console.WriteLine("ToXml tmp after amp conversion: '" + tmp + "'");
            }


            while (tmp.IndexOf("<") != -1) tmp = tmp.Replace("<", "&lt;");
            while (tmp.IndexOf(">") != -1) tmp = tmp.Replace(">", "&gt;");
            while (tmp.IndexOf("\"") != -1) tmp = tmp.Replace("\"", "&quot;");
            while (tmp.IndexOf("'") != -1) tmp = tmp.Replace("'", "&apos;");
            for (int i = 0; i < 32; i++)
            {
                char c = Convert.ToChar(i);
                if (i != 0x09 && i != 0x0a && i != 0x0d)
                {
                    int pos = -1;
                    while ((pos = tmp.IndexOf(c)) != -1)
                    {
                        tmp = tmp.Remove(pos, 1);
                        tmp = tmp.Insert(pos, "&#" + Convert.ToString(c, 16) + ";");
                    }
                }
            }
            //System.Console.WriteLine("after multiple newline remove check: '" + tmp + "'");
            return (tmp);
        }

Here is the caller graph for this function:

void DCPlusPlus.Sharing.UpdateFileLists

(

)

Create the DC++ file list from our shares list.

Definition at line 638 of file Sharing.cs.

References DCPlusPlus.Sharing.cid, DCPlusPlus.Sharing.CleanDirectories(), DCPlusPlus.Sharing.file_list, DCPlusPlus.Sharing.file_list_bz2, DCPlusPlus.Sharing.FillDirectories(), DCPlusPlus.Sharing.generator, and DCPlusPlus.Sharing.GetDirectoryContentsString().

Referenced by DCPlusPlus.Sharing.GetFileListXml(), and DCPlusPlus.Sharing.GetFileListXmlBZ2().

        {
            string xml = "<?xml version=\"1.0\" encoding=\"utf-8\" standalone=\"yes\"?>\n";
            xml += "<FileListing Version=\"1\" CID=\"" + cid + "\" Base=\"/\" Generator=\"" + generator + "\">\n";
            //hierarchical tree that lists all directories that have
            // 1. a shared file in it
            // 2. at least two directories in it that have shared files in its tree
            //use DirectoryContents class to hold data structure
            //combine directoryContents to xml string
            //return xml string
            DirectoryContents root = new DirectoryContents();
            FillDirectories(root);
            bool empty_shares = CleanDirectories(root);
            xml += GetDirectoryContentsString(root);
            xml += "</FileListing>\n";
            /*if (empty_shares)
                file_list = "";
            else */
            file_list = xml;
            try
            {
                MemoryStream input = new MemoryStream(System.Text.Encoding.Default.GetBytes(file_list));
                MemoryStream output = new MemoryStream();
                ICSharpCode.SharpZipLib.BZip2.BZip2.Compress(input, output, 1024);
                input.Flush();
                byte[] out_data = output.GetBuffer();
                file_list_bz2 = out_data;
            }
            catch (Exception ex)
            {
                Console.WriteLine("Error compressing file list: " + ex.Message);
                file_list_bz2 = null;
            }
        }

Here is the call graph for this function:

Here is the caller graph for this function:

---

Member Data Documentation

string DCPlusPlus.Sharing.cid = "D2QLOGUYDX3QA" [protected]

Definition at line 672 of file Sharing.cs.

Referenced by DCPlusPlus.Sharing.UpdateFileLists().

event DirectoryFinishedEventHandler DCPlusPlus.Sharing.DirectoryFinished

Event handler that gets called when sharing/hashing a directory has finished.

Definition at line 159 of file Sharing.cs.

Referenced by DCPlusPlus.Sharing.ShareDirectoryFinished(), DCPlusPlus.Sharing.TestEmptyGetFileListXml(), DCPlusPlus.Sharing.TestGetFileListXml(), DCPlusPlus.Sharing.TestShareDirectory(), DCPlusPlus.Sharing.TestShareSaveLoad(), DCPlusPlus.Sharing.TestShareSearchRemove(), DCPlusPlus.Sharing.TestSharingNotExistingDirectory(), and DCPlusPlus.Sharing.TestTTHs().

event EntriesChangedEventHandler DCPlusPlus.Sharing.EntriesChanged

Event handler that gets called when one or more entries were changed (deprecated , or possibly reused for its original purpose).

Definition at line 189 of file Sharing.cs.

Referenced by DCPlusPlus.Sharing.Add(), DCPlusPlus.Sharing.Clear(), DCPlusPlus.Sharing.LoadSharesFromXml(), and DCPlusPlus.Sharing.Remove().

event EntriesClearedEventHandler DCPlusPlus.Sharing.EntriesCleared

Event handler that gets called when all shares were removed.

Definition at line 198 of file Sharing.cs.

Referenced by DCPlusPlus.Sharing.Clear(), and DCPlusPlus.Sharing.LoadSharesFromXml().

event EntryAddedEventHandler DCPlusPlus.Sharing.EntryAdded

Event handler that gets called when an entry was added to the shares.

Definition at line 169 of file Sharing.cs.

Referenced by DCPlusPlus.Sharing.Add(), DCPlusPlus.Sharing.LoadSharesFromXml(), DCPlusPlus.Sharing.TestEmptyGetFileListXml(), DCPlusPlus.Sharing.TestGetFileListXml(), DCPlusPlus.Sharing.TestShareDirectory(), DCPlusPlus.Sharing.TestShareFile(), DCPlusPlus.Sharing.TestShareSaveLoad(), DCPlusPlus.Sharing.TestShareSearchRemove(), DCPlusPlus.Sharing.TestSharingNotExistingDirectory(), and DCPlusPlus.Sharing.TestTTHs().

event EntryRemovedEventHandler DCPlusPlus.Sharing.EntryRemoved

Event handler that gets called when an entry was removed from the shares.

Definition at line 179 of file Sharing.cs.

Referenced by DCPlusPlus.Sharing.Remove().

string DCPlusPlus.Sharing.file_list = "" [private]

DC++ formatted file list of our shares list.

Definition at line 630 of file Sharing.cs.

Referenced by DCPlusPlus.Sharing.GetFileListXml(), DCPlusPlus.Sharing.TestEmptyGetFileListXml(), DCPlusPlus.Sharing.TestGetFileListXml(), and DCPlusPlus.Sharing.UpdateFileLists().

byte [] DCPlusPlus.Sharing.file_list_bz2 [private]

bz2 compressed file list

Definition at line 634 of file Sharing.cs.

Referenced by DCPlusPlus.Sharing.GetFileListXmlBZ2(), and DCPlusPlus.Sharing.UpdateFileLists().

bool DCPlusPlus.Sharing.file_list_needs_update = true [private]

set to TRUE if at least one file was added/removed to indicate that the file list needs to be reconstructed

Definition at line 626 of file Sharing.cs.

Referenced by DCPlusPlus.Sharing.Add(), DCPlusPlus.Sharing.Clear(), DCPlusPlus.Sharing.GetFileListXml(), DCPlusPlus.Sharing.GetFileListXmlBZ2(), DCPlusPlus.Sharing.LoadSharesFromXml(), DCPlusPlus.Sharing.Remove(), DCPlusPlus.Sharing.ShareDirectoryFinished(), and DCPlusPlus.Sharing.ShareFileFinished().

string DCPlusPlus.Sharing.generator = "vpDcPlusPlus 0.2" [protected]

Definition at line 689 of file Sharing.cs.

Referenced by DCPlusPlus.Sharing.UpdateFileLists().

List<SharingEntry> DCPlusPlus.Sharing.items = new List<SharingEntry>() [protected]

Definition at line 90 of file Sharing.cs.

Referenced by DCPlusPlus.Sharing.Add(), DCPlusPlus.Sharing.Clear(), DCPlusPlus.Sharing.Contains(), DCPlusPlus.Sharing.CopyTo(), DCPlusPlus.Sharing.FillDirectories(), DCPlusPlus.Sharing.GetEnumerator(), DCPlusPlus.Sharing.GetShareByFilename(), DCPlusPlus.Sharing.GetShareByTTH(), DCPlusPlus.Sharing.LoadSharesFromXml(), DCPlusPlus.Sharing.Remove(), DCPlusPlus.Sharing.TestShareDirectory(), DCPlusPlus.Sharing.TestShareSaveLoad(), DCPlusPlus.Sharing.TestShareSearchRemove(), DCPlusPlus.Sharing.TestSharingNotExistingDirectory(), and DCPlusPlus.Sharing.TestTTHs().

[XmlIgnoreAttribute] Object DCPlusPlus.Sharing.share_lock = new Object() [protected]

The lock object to make the sharing class thread safe.

Definition at line 136 of file Sharing.cs.

Referenced by DCPlusPlus.Sharing.Add(), DCPlusPlus.Sharing.Clear(), DCPlusPlus.Sharing.Contains(), DCPlusPlus.Sharing.CopyTo(), DCPlusPlus.Sharing.FillDirectories(), DCPlusPlus.Sharing.GetShareByFilename(), DCPlusPlus.Sharing.GetShareByTTH(), DCPlusPlus.Sharing.LoadSharesFromXml(), DCPlusPlus.Sharing.Remove(), and DCPlusPlus.Sharing.SaveSharesToXml().

long DCPlusPlus.Sharing.total_bytes_shared = 0 [protected]

Definition at line 107 of file Sharing.cs.

Referenced by DCPlusPlus.Sharing.LoadSharesFromXml(), DCPlusPlus.Sharing.RecurseShareDirectoryAsync(), DCPlusPlus.Sharing.Remove(), and DCPlusPlus.Sharing.ShareFileFinished().

---

Property Documentation

string DCPlusPlus.Sharing.CID [get, set]

??CID?? i really need to look up what cid means and does ;-)

Definition at line 679 of file Sharing.cs.

int DCPlusPlus.Sharing.Count [get]

Get the number of shared files.

Definition at line 125 of file Sharing.cs.

string DCPlusPlus.Sharing.Generator [get, set]

Get/Set the file list generator name in the DC++ file list.

Definition at line 694 of file Sharing.cs.

bool DCPlusPlus.Sharing.IsReadOnly [get]

Definition at line 951 of file Sharing.cs.

List<SharingEntry> DCPlusPlus.Sharing.Items [get, set]

List of shares (will be an unpublic property soon,because of public locks that would be needed to use Items in a loop).

Definition at line 97 of file Sharing.cs.

Referenced by DCPlusPlus.Sharing.LoadSharesFromXml().

[XmlIgnoreAttribute] long DCPlusPlus.Sharing.TotalBytesShared [get]

Get the total number of bytes of all files shared.

Definition at line 114 of file Sharing.cs.

---

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

• Eigene Dateien/Visual Studio 2005/Projects/DCPlusPlus/DCPlusPlus/Sharing.cs

---