lyfz_repos/铂金版源码/WFtpClient/netftp-2015/System.Net.FtpClient/Extensions/XSHA1.cs

using System;
using System.Collections.Generic;
using System.Net.FtpClient;

namespace System.Net.FtpClient.Extensions {
    /// <summary>
    /// Implementation of the non-standard XSHA1 command
    /// </summary>
    public static class XSHA1 {
        delegate string AsyncGetXSHA1(string path);
        static Dictionary<IAsyncResult, AsyncGetXSHA1> m_asyncmethods = new Dictionary<IAsyncResult, AsyncGetXSHA1>();

        /// <summary>
        /// Gets the SHA-1 hash of the specified file using XSHA1. This is a non-standard extension
        /// to the protocol and may or may not work. A FtpCommandException will be
        /// thrown if the command fails.
        /// </summary>
        /// <param name="client">FtpClient Object</param>
        /// <param name="path">Full or relative path to remote file</param>
        /// <returns>Server response, presumably the SHA-1 hash.</returns>
        public static string GetXSHA1(this FtpClient client, string path) {
            FtpReply reply;

            if (!(reply = client.Execute("XSHA1 {0}", path)).Success)
                throw new FtpCommandException(reply);

            return reply.Message;
        }

        /// <summary>
        /// Asynchronusly retrieve a SHA1 hash. The XSHA1 command is non-standard
        /// and not guaranteed to work.
        /// </summary>
        /// <param name="client">FtpClient Object</param>
        /// <param name="path">Full or relative path to remote file</param>
        /// <param name="callback">AsyncCallback</param>
        /// <param name="state">State Object</param>
        /// <returns>IAsyncResult</returns>
        public static IAsyncResult BeginGetXSHA1(this FtpClient client, string path, AsyncCallback callback, object state) {
            AsyncGetXSHA1 func = new AsyncGetXSHA1(client.GetXSHA1);
            IAsyncResult ar = func.BeginInvoke(path, callback, state); ;

            lock (m_asyncmethods) {
                m_asyncmethods.Add(ar, func);
            }

            return ar;
        }

        /// <summary>
        /// Ends an asynchronous call to BeginGetXSHA1()
        /// </summary>
        /// <param name="ar">IAsyncResult returned from BeginGetXSHA1()</param>
        /// <returns>The SHA-1 hash of the specified file.</returns>
        public static string EndGetXSHA1(IAsyncResult ar) {
            AsyncGetXSHA1 func = null;

            lock (m_asyncmethods) {
                if (!m_asyncmethods.ContainsKey(ar))
                    throw new InvalidOperationException("The specified IAsyncResult was not found in the collection.");

                func = m_asyncmethods[ar];
                m_asyncmethods.Remove(ar);
            }

            return func.EndInvoke(ar);
        }
    }
}