云服务开发文档在线编辑系统

Z时代
2024-01-10
分类：技术分享

从工作实习的时候我就参与了一个项目叫做“云文档管理系统”，说白了就是文件的上传、下载、预览、分享、回收站等等一些操作。上传下载以及分享都很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传入参数进行调用，总是报错，后来才知道是我签名传了个寂寞。