Synnefo » Pithos MS Client

using System;

using System.Collections.Generic;

using System.ComponentModel.Composition;

using System.Diagnostics;

using System.Diagnostics.Contracts;

using System.IO;

using System.Linq;

using System.Net;

using System.Text;

using System.Threading;

using System.Threading.Tasks;

using Pithos.Interfaces;

using Pithos.Network;

using log4net;

namespace Pithos.Core.Agents

{

    [Export]

    public class NetworkAgent

    {

        private Agent<CloudAction> _agent;

        [Import]

        public IStatusKeeper StatusKeeper { get; set; }

        public IStatusNotification StatusNotification { get; set; }

        [Import]

        public FileAgent FileAgent {get;set;}

       /* public int BlockSize { get; set; }

        public string BlockHash { get; set; }*/

        private static readonly ILog Log = LogManager.GetLogger("NetworkAgent");

        private List<AccountInfo> _accounts=new List<AccountInfo>();

        public void Start(/*int blockSize, string blockHash*/)

        {

/*

            if (blockSize<0)

                throw new ArgumentOutOfRangeException("blockSize");

            if (String.IsNullOrWhiteSpace(blockHash))

                throw new ArgumentOutOfRangeException("blockHash");

            Contract.EndContractBlock();

*/

/*

            BlockSize = blockSize;

            BlockHash = blockHash;

*/

            _agent = Agent<CloudAction>.Start(inbox =>

            {

                Action loop = null;

                loop = () =>

                {

                    var message = inbox.Receive();

                    var process=message.Then(Process,inbox.CancellationToken);

                    inbox.LoopAsync(process, loop);

                };

                loop();

            });

        }

        private Task<object> Process(CloudAction action)

        {

            if (action == null)

                throw new ArgumentNullException("action");

            if (action.AccountInfo==null)

                throw new ArgumentException("The action.AccountInfo is empty","action");

            Contract.EndContractBlock();

            var accountInfo = action.AccountInfo;

            using (log4net.ThreadContext.Stacks["NETWORK"].Push("PROCESS"))

            {                

                Log.InfoFormat("[ACTION] Start Processing {0}:{1}->{2}", action.Action, action.LocalFile,

                               action.CloudFile.Name);

                var localFile = action.LocalFile;

                var cloudFile = action.CloudFile;                

                var downloadPath = (cloudFile == null)

                                       ? String.Empty

                                       : Path.Combine(accountInfo.AccountPath, cloudFile.RelativeUrlToFilePath(accountInfo.UserName));

                try

                {

                    var account = action.CloudFile.Account ?? accountInfo.UserName;

                    var container = action.CloudFile.Container ?? FolderConstants.PithosContainer;

                    switch (action.Action)

                    {

                        case CloudActionType.UploadUnconditional:

                            UploadCloudFile(accountInfo,account, container, localFile, action.LocalHash.Value, action.TopHash.Value);

                            break;

                        case CloudActionType.DownloadUnconditional:

                            DownloadCloudFile(accountInfo, account, container, new Uri(cloudFile.Name, UriKind.Relative),

                                              downloadPath);

                            break;

                        case CloudActionType.DeleteCloud:

                            DeleteCloudFile(accountInfo, account, container, cloudFile.Name);

                            break;

                        case CloudActionType.RenameCloud:

                            var moveAction = (CloudMoveAction)action;

                            RenameCloudFile(accountInfo, account, container, moveAction.OldFileName, moveAction.NewPath,

                                            moveAction.NewFileName);

                            break;

                        case CloudActionType.MustSynch:

                            if (!File.Exists(downloadPath))

                            {

                                var cloudUri = new Uri(action.CloudFile.Name, UriKind.Relative);

                                DownloadCloudFile(accountInfo, account, container, cloudUri, downloadPath);

                            }

                            else

                            {

                                SyncFiles(accountInfo, action);

                            }

                            break;

                    }

                    Log.InfoFormat("[ACTION] End Processing {0}:{1}->{2}", action.Action, action.LocalFile,

                                           action.CloudFile.Name);

                }

                catch (OperationCanceledException)

                {

                    throw;

                }

                catch (FileNotFoundException exc)

                {

                    Log.ErrorFormat("{0} : {1} -> {2}  failed because the file was not found.\n Rescheduling a delete",

                        action.Action, action.LocalFile, action.CloudFile, exc);

                    Post(new CloudDeleteAction(accountInfo,action.CloudFile,action.FileState));

                }

                catch (Exception exc)

                {

                    Log.ErrorFormat("[REQUEUE] {0} : {1} -> {2} due to exception\r\n{3}",

                                     action.Action, action.LocalFile, action.CloudFile, exc);

                    _agent.Post(action);

                }

                return CompletedTask<object>.Default;

            }

        }

        private void SyncFiles(AccountInfo accountInfo,CloudAction action)

        {

            if (accountInfo == null)

                throw new ArgumentNullException("accountInfo");

            if (action==null)

                throw new ArgumentNullException("action");

            if (action.LocalFile==null)

                throw new ArgumentException("The action's local file is not specified","action");

            if (!Path.IsPathRooted(action.LocalFile.FullName))

                throw new ArgumentException("The action's local file path must be absolute","action");

            if (action.CloudFile== null)

                throw new ArgumentException("The action's cloud file is not specified", "action");

            Contract.EndContractBlock();

            var localFile = action.LocalFile;

            var cloudFile = action.CloudFile;

            var downloadPath=action.LocalFile.FullName.ToLower();

            var account = cloudFile.Account;

            //Use "pithos" by default if no container is specified

            var container = cloudFile.Container ?? FolderConstants.PithosContainer;

            var cloudUri = new Uri(cloudFile.Name, UriKind.Relative);

            var cloudHash = cloudFile.Hash.ToLower();

            var localHash = action.LocalHash.Value.ToLower();

            var topHash = action.TopHash.Value.ToLower();

            //Not enough to compare only the local hashes, also have to compare the tophashes

            //If any of the hashes match, we are done

            if ((cloudHash == localHash || cloudHash == topHash))

            {

                Log.InfoFormat("Skipping {0}, hashes match",downloadPath);

                return;

            }

            //The hashes DON'T match. We need to sync

            var lastLocalTime = localFile.LastWriteTime;

            var lastUpTime = cloudFile.Last_Modified;

            //If the local file is newer upload it

            if (lastUpTime <= lastLocalTime)

            {

                //It probably means it was changed while the app was down                        

                UploadCloudFile(accountInfo,account, container, localFile, action.LocalHash.Value,

                                action.TopHash.Value);

            }

            else

            {

                //It the cloud file has a later date, it was modified by another user or computer.

                //We need to check the local file's status                

                var status = StatusKeeper.GetFileStatus(downloadPath);

                switch (status)

                {

                    case FileStatus.Unchanged:                        

                        //If the local file's status is Unchanged, we can go on and download the newer cloud file

                        DownloadCloudFile(accountInfo,account, container,cloudUri,downloadPath);

                        break;

                    case FileStatus.Modified:

                        //If the local file is Modified, we may have a conflict. In this case we should mark the file as Conflict

                        //We can't ensure that a file modified online since the last time will appear as Modified, unless we 

                        //index all files before we start listening.                       

                    case FileStatus.Created:

                        //If the local file is Created, it means that the local and cloud files aren't related,

                        // yet they have the same name.

                        //In both cases we must mark the file as in conflict

                        ReportConflict(downloadPath);

                        break;

                    default:

                        //Other cases should never occur. Mark them as Conflict as well but log a warning

                        ReportConflict(downloadPath);

                        Log.WarnFormat("Unexcepted status {0} for file {1}->{2}", status,

                                       downloadPath, action.CloudFile.Name);

                        break;

                }

            }

        }

        private void ReportConflict(string downloadPath)

        {

            if (String.IsNullOrWhiteSpace(downloadPath))

                throw new ArgumentNullException("downloadPath");

            Contract.EndContractBlock();

            StatusKeeper.SetFileOverlayStatus(downloadPath, FileOverlayStatus.Conflict);

            var message = String.Format("Conflict detected for file {0}", downloadPath);

            Log.Warn(message);

            StatusNotification.NotifyChange(message, TraceLevel.Warning);

        }

/*

        private Task<object> Process(CloudMoveAction action)

        {

            if (action == null)

                throw new ArgumentNullException("action");

            Contract.EndContractBlock();

            Log.InfoFormat("[ACTION] Start Processing {0}:{1}->{2}", action.Action, action.LocalFile, action.CloudFile.Name);

            try

            {

                RenameCloudFile(action.OldFileName, action.NewPath, action.NewFileName);

                Log.InfoFormat("[ACTION] End Processing {0}:{1}->{2}", action.Action, action.LocalFile, action.CloudFile.Name);

            }

            catch (OperationCanceledException)

            {

                throw;

            }

            catch (Exception exc)

            {

                Log.ErrorFormat("[REQUEUE] {0} : {1} -> {2} due to exception\r\n{3}",

                                action.Action, action.OldFileName, action.NewFileName, exc);

                _agent.Post(action);

            }

            return CompletedTask<object>.Default;

        }

*/

        public void Post(CloudAction cloudAction)

        {

            if (cloudAction == null)

                throw new ArgumentNullException("cloudAction");

            if (cloudAction.AccountInfo==null)

                throw new ArgumentException("The CloudAction.AccountInfo is empty","cloudAction");

            Contract.EndContractBlock();

            //If the action targets a local file, add a treehash calculation

            if (cloudAction.LocalFile != null)

            {

                var accountInfo = cloudAction.AccountInfo;

                if (cloudAction.LocalFile.Length>accountInfo.BlockSize)

                    cloudAction.TopHash = new Lazy<string>(() => Signature.CalculateTreeHashAsync(cloudAction.LocalFile,

                                    accountInfo.BlockSize, accountInfo.BlockHash).Result

                                     .TopHash.ToHashString());

                else

                {

                    cloudAction.TopHash=new Lazy<string>(()=> cloudAction.LocalHash.Value);

                }

            }

            _agent.Post(cloudAction);

        }

        class ObjectInfoByNameComparer:IEqualityComparer<ObjectInfo>

        {

            public bool Equals(ObjectInfo x, ObjectInfo y)

            {

                return x.Name.Equals(y.Name,StringComparison.InvariantCultureIgnoreCase);

            }

            public int GetHashCode(ObjectInfo obj)

            {

                return obj.Name.ToLower().GetHashCode();

            }

        }

        //Remote files are polled periodically. Any changes are processed

        public Task ProcessRemoteFiles(DateTime? since=null)

        {

            return Task<Task>.Factory.StartNewDelayed(10000, () =>

            {

                using (log4net.ThreadContext.Stacks["Retrieve Remote"].Push("All accounts"))

                {

                    //Next time we will check for all changes since the current check minus 1 second

                    //This is done to ensure there are no discrepancies due to clock differences

                    DateTime nextSince = DateTime.Now.AddSeconds(-1);

                    var tasks=from accountInfo in _accounts

                              select ProcessAccountFiles(accountInfo, since);

                    var process=Task.Factory.Iterate(tasks);

                    return process.ContinueWith(t=>

                        ProcessRemoteFiles(nextSince));

                }

            });            

        }

        public Task ProcessAccountFiles(AccountInfo accountInfo,DateTime? since=null)

        {   

            if (accountInfo==null)

                throw new ArgumentNullException("accountInfo");

            if (String.IsNullOrWhiteSpace(accountInfo.AccountPath))

                throw new ArgumentException("The AccountInfo.AccountPath is empty","accountInfo");

            Contract.EndContractBlock();

            using (log4net.ThreadContext.Stacks["Retrieve Remote"].Push(accountInfo.UserName))

            {

                Log.Info("Scheduled");

                var client=new CloudFilesClient(accountInfo);

                //Get the list of server objects changed since the last check

                var listObjects = Task<IList<ObjectInfo>>.Factory.StartNew(() =>

                                client.ListObjects(accountInfo.UserName, FolderConstants.PithosContainer, since));

                //Get the list of deleted objects since the last check

                var listTrash = Task<IList<ObjectInfo>>.Factory.StartNew(() =>

                                client.ListObjects(accountInfo.UserName, FolderConstants.TrashContainer, since));

                var listShared = Task<IList<ObjectInfo>>.Factory.StartNew(() =>

                                client.ListSharedObjects(since));

                var listAll = Task.Factory.TrackedSequence(

                    () => listObjects,

                    () => listTrash,

                    () => listShared);

                var enqueueFiles = listAll.ContinueWith(task =>

                {

                    if (task.IsFaulted)

                    {

                        //ListObjects failed at this point, need to reschedule

                        Log.ErrorFormat("[FAIL] ListObjects for{0} in ProcessRemoteFiles with {0}", accountInfo.UserName,task.Exception);

                        return;

                    }

                    using (log4net.ThreadContext.Stacks["SCHEDULE"].Push("Process Results"))

                    {

                        var remoteObjects = ((Task<IList<ObjectInfo>>) task.Result[0]).Result;

                        var trashObjects = ((Task<IList<ObjectInfo>>) task.Result[1]).Result;

                        var sharedObjects = ((Task<IList<ObjectInfo>>) task.Result[2]).Result;

                        //Items with the same name, hash may be both in the container and the trash

                        //Don't delete items that exist in the container

                        var realTrash = from trash in trashObjects

                                        where !remoteObjects.Any(info => info.Hash == trash.Hash)

                                        select trash;

                        ProcessDeletedFiles(accountInfo,realTrash);                        

                        var remote = from info in remoteObjects.Union(sharedObjects)

                                     let name = info.Name

                                     where !name.EndsWith(".ignore", StringComparison.InvariantCultureIgnoreCase) &&

                                           !name.StartsWith("fragments/", StringComparison.InvariantCultureIgnoreCase)

                                     select info;

                        //Create a list of actions from the remote files

                        var allActions = ObjectsToActions(accountInfo,remote);

                        //And remove those that are already being processed by the agent

                        var distinctActions = allActions

                            .Except(_agent.GetEnumerable(), new PithosMonitor.LocalFileComparer())

                            .ToList();

                        //Queue all the actions

                        foreach (var message in distinctActions)

                        {

                            Post(message);

                        }

                        //Report the number of new files

                        var remoteCount = distinctActions.Count(action=>

                            action.Action==CloudActionType.DownloadUnconditional);

                        if ( remoteCount > 0)

                            StatusNotification.NotifyChange(String.Format("Processing {0} new files", remoteCount));

                        Log.Info("[LISTENER] End Processing");                        

                    }

                });

                var log = enqueueFiles.ContinueWith(t =>

                {                    

                    if (t.IsFaulted)

                    {

                        Log.Error("[LISTENER] Exception", t.Exception);

                    }

                    else

                    {

                        Log.Info("[LISTENER] Finished");

                    }

                });

                return log;

            }

        }

        //Creates an appropriate action for each server file

        private IEnumerable<CloudAction> ObjectsToActions(AccountInfo accountInfo,IEnumerable<ObjectInfo> remote)

        {

            if (remote==null)

                throw new ArgumentNullException();

            Contract.EndContractBlock();

            //In order to avoid multiple iterations over the files, we iterate only once

            //over the remote files

            foreach (var objectInfo in remote)

            {

                var relativePath = objectInfo.RelativeUrlToFilePath(accountInfo.UserName);

                //and remove any matching objects from the list, adding them to the commonObjects list

                if (FileAgent.Exists(relativePath))

                {

                    var localFile = FileAgent.GetFileInfo(relativePath);

                    var state = FileState.FindByFilePath(localFile.FullName);

                    //Common files should be checked on a per-case basis to detect differences, which is newer

                    yield return new CloudAction(accountInfo,CloudActionType.MustSynch,

                                                   localFile, objectInfo, state, accountInfo.BlockSize,

                                                   accountInfo.BlockHash);

                }

                else

                {

                    //If there is no match we add them to the localFiles list

                    //but only if the file is not marked for deletion

                    var targetFile = Path.Combine(accountInfo.AccountPath, relativePath);

                    var fileStatus = StatusKeeper.GetFileStatus(targetFile);

                    if (fileStatus != FileStatus.Deleted)

                    {

                        //Remote files should be downloaded

                        yield return new CloudDownloadAction(accountInfo,objectInfo);

                    }

                }

            }            

        }

        private void ProcessDeletedFiles(AccountInfo accountInfo,IEnumerable<ObjectInfo> trashObjects)

        {

            foreach (var trashObject in trashObjects)

            {

                var relativePath = trashObject.RelativeUrlToFilePath(accountInfo.UserName);

                //and remove any matching objects from the list, adding them to the commonObjects list

                FileAgent.Delete(relativePath);                                

            }

        }

        private void RenameCloudFile(AccountInfo accountInfo,string account, string container,string oldFileName, string newPath, string newFileName)

        {

            if (accountInfo==null)

                throw new ArgumentNullException("accountInfo");

            if (String.IsNullOrWhiteSpace(account))

                throw new ArgumentNullException("account");

            if (String.IsNullOrWhiteSpace(container))

                throw new ArgumentNullException("container");

            if (String.IsNullOrWhiteSpace(oldFileName))

                throw new ArgumentNullException("oldFileName");

            if (String.IsNullOrWhiteSpace(oldFileName))

                throw new ArgumentNullException("newPath");

            if (String.IsNullOrWhiteSpace(oldFileName))

                throw new ArgumentNullException("newFileName");

            Contract.EndContractBlock();

            //The local file is already renamed

            this.StatusKeeper.SetFileOverlayStatus(newPath, FileOverlayStatus.Modified);

            var client = new CloudFilesClient(accountInfo);

            client.MoveObject(account, container, oldFileName, container, newFileName);

            this.StatusKeeper.SetFileStatus(newPath, FileStatus.Unchanged);

            this.StatusKeeper.SetFileOverlayStatus(newPath, FileOverlayStatus.Normal);

            NativeMethods.RaiseChangeNotification(newPath);

        }

        private void DeleteCloudFile(AccountInfo accountInfo, string account, string container, string fileName)

        {

            if (accountInfo == null)

                throw new ArgumentNullException("accountInfo");

            if (String.IsNullOrWhiteSpace(account))

                throw new ArgumentNullException("account");

            if (String.IsNullOrWhiteSpace(container))

                throw new ArgumentNullException("container");

            if (String.IsNullOrWhiteSpace(container))

                throw new ArgumentNullException("container");

            if (String.IsNullOrWhiteSpace(fileName))

                throw new ArgumentNullException("fileName");

            if (Path.IsPathRooted(fileName))

                throw new ArgumentException("The fileName should not be rooted","fileName");

            Contract.EndContractBlock();

            using ( log4net.ThreadContext.Stacks["DeleteCloudFile"].Push("Delete"))

            {

                var info = FileAgent.GetFileInfo(fileName);

                var fullPath = info.FullName.ToLower();

                this.StatusKeeper.SetFileOverlayStatus(fullPath, FileOverlayStatus.Modified);

                var client = new CloudFilesClient(accountInfo);

                client.DeleteObject(account, container, fileName);

                this.StatusKeeper.ClearFileStatus(fullPath);

            }

        }

        //Download a file.

        private void DownloadCloudFile(AccountInfo accountInfo, string account, string container, Uri relativeUrl, string localPath)

        {

            if (accountInfo == null)

                throw new ArgumentNullException("accountInfo");

            if (String.IsNullOrWhiteSpace(account))

                throw new ArgumentNullException("account");

            if (String.IsNullOrWhiteSpace(container))

                throw new ArgumentNullException("container");

            if (relativeUrl == null)

                throw new ArgumentNullException("relativeUrl");

            if (String.IsNullOrWhiteSpace(localPath))

                throw new ArgumentNullException("localPath");

            if (!Path.IsPathRooted(localPath))

                throw new ArgumentException("The localPath must be rooted", "localPath");

            Contract.EndContractBlock();

            var download=Task.Factory.Iterate(DownloadIterator(accountInfo,account,container, relativeUrl, localPath));

            download.Wait();

        }

        private IEnumerable<Task> DownloadIterator(AccountInfo accountInfo, string account, string container, Uri relativeUrl, string localPath)

        {

            if (accountInfo == null)

                throw new ArgumentNullException("accountInfo");

            if (String.IsNullOrWhiteSpace(account))

                throw new ArgumentNullException("account");

            if (String.IsNullOrWhiteSpace(container))

                throw new ArgumentNullException("container");

            if (relativeUrl==null)

                throw new ArgumentNullException("relativeUrl");

            if (String.IsNullOrWhiteSpace(localPath))

                throw new ArgumentNullException("localPath");

            if (!Path.IsPathRooted(localPath))

                throw new ArgumentException("The localPath must be rooted", "localPath");

            Contract.EndContractBlock();

            var url = relativeUrl.ToString();

            if (url.EndsWith(".ignore",StringComparison.InvariantCultureIgnoreCase))

                yield break;

            //Are we already downloading or uploading the file? 

            using (var gate=NetworkGate.Acquire(localPath, NetworkOperation.Downloading))

            {

                if (gate.Failed)

                    yield break;

                //The file's hashmap will be stored in the same location with the extension .hashmap

                //var hashPath = Path.Combine(FileAgent.FragmentsPath, relativePath + ".hashmap");

                var client = new CloudFilesClient(accountInfo);

                //Retrieve the hashmap from the server

                var getHashMap = client.GetHashMap(account, container, url);

                yield return getHashMap;

                var serverHash=getHashMap.Result;

                //If it's a small file

                var downloadTask=(serverHash.Hashes.Count == 1 )

                    //Download it in one go

                    ? DownloadEntireFile(client, account, container, relativeUrl, localPath) 

                    //Otherwise download it block by block

                    : DownloadWithBlocks(client, account, container, relativeUrl, localPath, serverHash);

                yield return downloadTask;

                //Retrieve the object's metadata

                var info=client.GetObjectInfo(account, container, url);

                //And store it

                StatusKeeper.StoreInfo(localPath, info);

                //Notify listeners that a local file has changed

                StatusNotification.NotifyChangedFile(localPath);

            }

        }

        //Download a small file with a single GET operation

        private Task DownloadEntireFile(CloudFilesClient client, string account, string container, Uri relativeUrl, string localPath)

        {

            if (client == null)

                throw new ArgumentNullException("client");

            if (String.IsNullOrWhiteSpace(account))

                throw new ArgumentNullException("account");

            if (String.IsNullOrWhiteSpace(container))

                throw new ArgumentNullException("container");

            if (relativeUrl == null)

                throw new ArgumentNullException("relativeUrl");

            if (String.IsNullOrWhiteSpace(localPath))

                throw new ArgumentNullException("localPath");

            if (!Path.IsPathRooted(localPath))

                throw new ArgumentException("The localPath must be rooted", "localPath");

            Contract.EndContractBlock();

            //Calculate the relative file path for the new file

            var relativePath = relativeUrl.RelativeUriToFilePath();

            //The file will be stored in a temporary location while downloading with an extension .download

            var tempPath = Path.Combine(FileAgent.FragmentsPath, relativePath + ".download");

            //Make sure the target folder exists. DownloadFileTask will not create the folder

            var directoryPath = Path.GetDirectoryName(tempPath);

            if (!Directory.Exists(directoryPath))

                Directory.CreateDirectory(directoryPath);

            //Download the object to the temporary location

            var getObject = client.GetObject(account, container, relativeUrl.ToString(), tempPath).ContinueWith(t =>

            {

                t.PropagateExceptions();

                //And move it to its actual location once downloading is finished

                if (File.Exists(localPath))

                    File.Replace(tempPath,localPath,null,true);

                else

                    File.Move(tempPath,localPath);

            });

            return getObject;

        }

        //Download a file asynchronously using blocks

        public Task DownloadWithBlocks(CloudFilesClient client, string account, string container, Uri relativeUrl, string localPath, TreeHash serverHash)

        {

            if (client == null)

                throw new ArgumentNullException("client");

            if (String.IsNullOrWhiteSpace(account))

                throw new ArgumentNullException("account");

            if (String.IsNullOrWhiteSpace(container))

                throw new ArgumentNullException("container");

            if (relativeUrl == null)

                throw new ArgumentNullException("relativeUrl");

            if (String.IsNullOrWhiteSpace(localPath))

                throw new ArgumentNullException("localPath");

            if (!Path.IsPathRooted(localPath))

                throw new ArgumentException("The localPath must be rooted", "localPath");

            if (serverHash == null)

                throw new ArgumentNullException("serverHash");

            Contract.EndContractBlock();

            return Task.Factory.Iterate(BlockDownloadIterator(client,account,container, relativeUrl, localPath, serverHash));

        }

        private IEnumerable<Task> BlockDownloadIterator(CloudFilesClient client, string account, string container, Uri relativeUrl, string localPath, TreeHash serverHash)

        {

            if (client == null)

                throw new ArgumentNullException("client");

            if (String.IsNullOrWhiteSpace(account))

                throw new ArgumentNullException("account");

            if (String.IsNullOrWhiteSpace(container))

                throw new ArgumentNullException("container");

            if (relativeUrl == null)

                throw new ArgumentNullException("relativeUrl");

            if (String.IsNullOrWhiteSpace(localPath))

                throw new ArgumentNullException("localPath");

            if (!Path.IsPathRooted(localPath))

                throw new ArgumentException("The localPath must be rooted", "localPath");

            if(serverHash==null)

                throw new ArgumentNullException("serverHash");

            Contract.EndContractBlock();

            //Calculate the relative file path for the new file

            var relativePath = relativeUrl.RelativeUriToFilePath();

            var blockUpdater = new BlockUpdater(FileAgent.FragmentsPath, localPath, relativePath, serverHash);

            //Calculate the file's treehash

            var calcHash = Signature.CalculateTreeHashAsync(localPath, serverHash.BlockSize,serverHash.BlockHash);

            yield return calcHash;                        

            var treeHash = calcHash.Result;

            //And compare it with the server's hash

            var upHashes = serverHash.GetHashesAsStrings();

            var localHashes = treeHash.HashDictionary;

            for (int i = 0; i < upHashes.Length; i++)

            {

                //For every non-matching hash

                var upHash = upHashes[i];

                if (!localHashes.ContainsKey(upHash))

                {

                    if (blockUpdater.UseOrphan(i, upHash))

                    {

                        Log.InfoFormat("[BLOCK GET] ORPHAN FOUND for {0} of {1} for {2}", i, upHashes.Length, localPath);

                        continue;

                    }

                    Log.InfoFormat("[BLOCK GET] START {0} of {1} for {2}", i, upHashes.Length, localPath);

                    var start = i*serverHash.BlockSize;

                    //To download the last block just pass a null for the end of the range

                    long? end = null;

                    if (i < upHashes.Length - 1 )

                        end= ((i + 1)*serverHash.BlockSize) ;

                    //Download the missing block

                    var getBlock = client.GetBlock(account, container, relativeUrl, start, end);

                    yield return getBlock;

                    var block = getBlock.Result;

                    //and store it

                    yield return blockUpdater.StoreBlock(i, block);

                    Log.InfoFormat("[BLOCK GET] FINISH {0} of {1} for {2}", i, upHashes.Length, localPath);

                }

            }

            blockUpdater.Commit();

            Log.InfoFormat("[BLOCK GET] COMPLETE {0}", localPath);            

        }

        private void UploadCloudFile(AccountInfo accountInfo, string account, string container, FileInfo fileInfo, string hash, string topHash)

        {

            if (accountInfo == null)

                throw new ArgumentNullException("accountInfo");

            if (String.IsNullOrWhiteSpace(account))

                throw new ArgumentNullException("account");

            if (String.IsNullOrWhiteSpace(container))

                throw new ArgumentNullException("container");

            if (fileInfo == null)

                throw new ArgumentNullException("fileInfo");

            if (String.IsNullOrWhiteSpace(hash))

                throw new ArgumentNullException("hash");

            if (topHash == null)

                throw new ArgumentNullException("topHash");

            Contract.EndContractBlock();

            var upload = Task.Factory.Iterate(UploadIterator(accountInfo,account,container,fileInfo, hash.ToLower(), topHash.ToLower()));

            upload.Wait();

        }

        private IEnumerable<Task> UploadIterator(AccountInfo accountInfo, string account, string container, FileInfo fileInfo, string hash, string topHash)

        {

            if (accountInfo == null)

                throw new ArgumentNullException("accountInfo");

            if (String.IsNullOrWhiteSpace(account))

                throw new ArgumentNullException("account");

            if (String.IsNullOrWhiteSpace(container))

                throw new ArgumentNullException("container");

            if (fileInfo == null)

                throw new ArgumentNullException("fileInfo");

            if (String.IsNullOrWhiteSpace(hash))

                throw new ArgumentNullException("hash");

            if (topHash == null)

                throw new ArgumentNullException("topHash");

            Contract.EndContractBlock();

            if (fileInfo.Extension.Equals("ignore", StringComparison.InvariantCultureIgnoreCase))

                yield break;

            var url = fileInfo.AsRelativeUrlTo(accountInfo.AccountPath);

            var fullFileName = fileInfo.FullName;

            using(var gate=NetworkGate.Acquire(fullFileName,NetworkOperation.Uploading))

            {

                //Abort if the file is already being uploaded or downloaded

                if (gate.Failed)

                    yield break;

                var client = new CloudFilesClient(accountInfo);

                //Even if GetObjectInfo times out, we can proceed with the upload            

                var info = client.GetObjectInfo(account, container, url);

                var cloudHash = info.Hash.ToLower();

                //If the file hashes match, abort the upload

                if (hash == cloudHash  || topHash ==cloudHash)

                {

                    //but store any metadata changes 

                    this.StatusKeeper.StoreInfo(fullFileName, info);

                    Log.InfoFormat("Skip upload of {0}, hashes match", fullFileName);

                    yield break;

                }

                //Mark the file as modified while we upload it

                StatusKeeper.SetFileOverlayStatus(fullFileName, FileOverlayStatus.Modified);

                //And then upload it

                //If the file is larger than the block size, try a hashmap PUT

                if (fileInfo.Length > accountInfo.BlockSize )

                {

                    //To upload using a hashmap

                    //First, calculate the tree hash

                    var treeHash = Signature.CalculateTreeHashAsync(fileInfo.FullName, accountInfo.BlockSize,

                        accountInfo.BlockHash);

                    yield return treeHash;

                    yield return Task.Factory.Iterate(UploadWithHashMap(accountInfo,account,container,fileInfo,url,treeHash));

                }

                else

                {

                    //Otherwise do a regular PUT

                    yield return client.PutObject(account, container, url, fullFileName, hash);                    

                }

                //If everything succeeds, change the file and overlay status to normal

                this.StatusKeeper.SetFileState(fullFileName, FileStatus.Unchanged, FileOverlayStatus.Normal);

            }

            //Notify the Shell to update the overlays

            NativeMethods.RaiseChangeNotification(fullFileName);

            StatusNotification.NotifyChangedFile(fullFileName);

        }

        public IEnumerable<Task> UploadWithHashMap(AccountInfo accountInfo,string account,string container,FileInfo fileInfo,string url,Task<TreeHash> treeHash)

        {

            if (accountInfo == null)

                throw new ArgumentNullException("accountInfo");

            if (String.IsNullOrWhiteSpace(account))

                throw new ArgumentNullException("account");

            if (String.IsNullOrWhiteSpace(container))

                throw new ArgumentNullException("container");

            if (fileInfo == null)

                throw new ArgumentNullException("fileInfo");

            if (String.IsNullOrWhiteSpace(url))

                throw new ArgumentNullException(url);

            if (treeHash==null)

                throw new ArgumentNullException("treeHash");

            Contract.EndContractBlock();

            var fullFileName = fileInfo.FullName;

            var client = new CloudFilesClient(accountInfo);

            //Send the hashmap to the server            

            var hashPut = client.PutHashMap(account, container, url, treeHash.Result);

            yield return hashPut;

            var missingHashes = hashPut.Result;

            //If the server returns no missing hashes, we are done

            while (missingHashes.Count > 0)

            {

                var buffer = new byte[accountInfo.BlockSize];

                foreach (var missingHash in missingHashes)

                {

                    //Find the proper block

                    var blockIndex = treeHash.Result.HashDictionary[missingHash];

                    var offset = blockIndex*accountInfo.BlockSize;

                    var read = fileInfo.Read(buffer, offset, accountInfo.BlockSize);

                    //And upload the block                

                    var postBlock = client.PostBlock(account, container, buffer, 0, read);

                    //We have to handle possible exceptions in a continuation because

                    //*yield return* can't appear inside a try block

                    yield return postBlock.ContinueWith(t => 

                        t.ReportExceptions(

                            exc => Log.ErrorFormat("[ERROR] uploading block {0} of {1}\n{2}", blockIndex, fullFileName, exc),

                            ()=>Log.InfoFormat("[BLOCK] Block {0} of {1} uploaded", blockIndex,fullFileName)));

                }

                //Repeat until there are no more missing hashes

                hashPut = client.PutHashMap(account, container, url, treeHash.Result);

                yield return hashPut;

                missingHashes = hashPut.Result;

            }

        }

        public void AddAccount(AccountInfo accountInfo)

        {            

            if (!_accounts.Contains(accountInfo))

                _accounts.Add(accountInfo);

        }

    }

}