记一次基于云服务开发文档在线编辑系统的开发记录，支持版本记录、可增加批注。_C#

　　从工作实习的时候我就参与了一个项目叫做“云文档管理系统”，说白了就是文件的上传、下载、预览、分享、回收站等等一些操作。上传下载以及分享都很Easy，复杂的就在文档预览上，图片、视频、音频都有现成的插件可以使用，Office文档的在线预览相对来说还是比较复杂的，当时也是看好多把Office文档转换成html进行预览的，也有转换成Pdf预览的，即使都实现预览效果又怎样。客户提出一个需求叫做“文档版本修改历史留存、可增加批注”，当时这个需求简直让人头大，我不知道如何下手。我记得我当时的主管对这个需求也是很无助啊，过了几天他就告诉我他找到一个插件，不过只能在IE浏览器上使用Active X控件才能实现，而且调试起来超级麻烦。我记得当时这个功能还是废弃了。

　　时隔五年，我偶然间发现了一个文档在线预览的服务，大家可以参考我的另一篇博客《如何实现文档在线预览》，这里我就不再过多赘述了。即使到目前我也只是把文档在线预览功能找到了解决方案，可是文档在线编辑一直是我的一个心结。2021年开年到现在，每天工作都很繁忙，午休的时间累积在一起我写了一个基于云服务的文档在线编辑系统（基础功能基本已经实现），如果有需要的小伙伴可以参照我下面介绍的步骤来体验一下：

开通开发者权限

我们进入云服务官网，申请加入开发者，跟着导航一步一步走就OK了，等待审核通过，你会得到appId和appKey，这俩参数在调用接口时候会用到。记一次基于云服务开发文档在线编辑系统的开发记录，支持版本记录、可增加批注。

验签方法封装

　　验签方法，就是对你调用接口的参数进行签名，被调用方拿到你的参数要进行校验，校验通过才算是有效调用。

/// <summary>
/// 生成验签数据 sign
/// </summary>
public class Signclient
{
    public static string generateSign(string secret, Dictionary<string, string[]> paramMap)
    {
        string fullParamStr = uniqSortParams(paramMap);
        return HmacSHA256(fullParamStr, secret);
    }
    public static string uniqSortParams(Dictionary<string, string[]> paramMap)
    {
        paramMap.Remove("sign");
        paramMap = paramMap.OrderBy(o => o.Key).ToDictionary(o => o.Key.ToString(), p => p.Value);
        StringBuilder strB = new StringBuilder();
        foreach (KeyValuePair<string, string[]> kvp in paramMap)
        {
            string key = kvp.Key;
            string[] value = kvp.Value;
            if (value.Length > 0)
            {
                Array.Sort(value);
                foreach (string temp in value)
                {
                    strB.Append(key).Append("=").Append(temp);
                }
            }
            else
            {
                strB.Append(key).Append("=");
            }
        }
        return strB.ToString();
    }
    public static string HmacSHA256(string data, string key)
    {
        string signRet = string.Empty;
        using (HMACSHA256 mac = new HMACSHA256(Encoding.UTF8.GetBytes(key)))
        {
            byte[] hash = mac.ComputeHash(Encoding.UTF8.GetBytes(data));
            signRet = ToHexString(hash); ;
        }
        return signRet;
    }
    public static string ToHexString(byte[] bytes)
    {
        string hexString = string.Empty;
        if (bytes != null)
        {
            StringBuilder strB = new StringBuilder();
            foreach (byte b in bytes)
            {
                strB.AppendFormat("{0:X2}", b);
            }
            hexString = strB.ToString();
        }
        return hexString;
    }
}

记住，这个sign很重要，因为我刚开始把appKey当做sign传入参数进行调用，总是报错，后来才知道是我签名传了个寂寞。