599錯(cuò)誤處理
如果在與七牛的交互中出現(xiàn)http狀態(tài)碼為599的錯(cuò)誤，一句話，不要猶豫，直接聯(lián)系七牛技術(shù)支持。七牛的文檔也在很多地方提到這個(gè)錯(cuò)誤，都是指導(dǎo)大家去聯(lián)系技術(shù)支持的。筆者是在分塊上傳后的mkfile調(diào)用時(shí)出現(xiàn)的，聯(lián)系技術(shù)支持后，說是調(diào)整了一下，讓我重試。后來就好了…
分塊上傳無法從回調(diào)中獲得文件的原始名
簡(jiǎn)單上傳采用的是multipart/form-data方式上傳，七牛服務(wù)端能夠從請(qǐng)求中獲得文件的原始名，并支持使用魔法變量$(fname)回調(diào)業(yè)務(wù)服務(wù)器。不過當(dāng)使用分片上傳的時(shí)候情況有所不同。分片上傳需要在最后調(diào)用mkfile，來將分片拼接起來。但是，mkfile接口支持普通的請(qǐng)求，并沒有附帶文件名，所以七牛也就無法獲得文件名，此時(shí)從$(fname)中是取不到文件名的。這個(gè)問題我也向七牛技術(shù)支持提交了問題，得到的結(jié)果是使用自定義變量mkfile支持將自定義變量放在url中，回調(diào)的時(shí)候自定義變量可以傳遞給業(yè)務(wù)服務(wù)器。
慎用圖片預(yù)處理
七牛云支持很多對(duì)文件的預(yù)處理，其中最常用的應(yīng)該就是圖片預(yù)處理了，可以對(duì)圖片的大小做變換等。七牛推薦使用GET的方式直接指定圖片處理結(jié)果的url，像這樣：
http://qiniuphotos.qiniudn.com/gogopher.jpg?imageView2/1/w/200/h/200
處理后的圖片會(huì)自動(dòng)緩存，用戶不用關(guān)心，只要每次訪問都用這個(gè)url就行了。然而，筆者在開始的時(shí)候，為了保持與其他文件形式統(tǒng)一的處理方法，對(duì)圖片使用了預(yù)處理（因?yàn)橐曨l什么的只能預(yù)處理），即在token中指定了預(yù)處理。此時(shí)問題出現(xiàn)了，從后臺(tái)的日志看到，圖片的預(yù)處理通知回調(diào)竟然比正常的上傳成功回調(diào)還要快！這就導(dǎo)致預(yù)處理結(jié)果到來之前，我的業(yè)務(wù)服務(wù)器的數(shù)據(jù)庫中還沒有這個(gè)圖片，無法保存預(yù)處理結(jié)果了。所以推薦還是使用url直接處理，對(duì)圖片要慎用預(yù)處理
視頻文件無法快進(jìn)播放
通常用戶在觀看視頻的時(shí)候都會(huì)根據(jù)自己的喜好，快速將視頻定位到指定的時(shí)間播放。實(shí)現(xiàn)這個(gè)功能，需要視頻本身有關(guān)鍵幀信息、服務(wù)端需要支持關(guān)鍵幀播放請(qǐng)求。
但是筆者發(fā)現(xiàn)，在使用七牛云轉(zhuǎn)化后的視頻，這樣做是無效的。于是咨詢技術(shù)支持，得到的答案是：轉(zhuǎn)化的文件是具有關(guān)鍵幀的，但七牛使用CDN加速，所以關(guān)鍵幀請(qǐng)求需要CDN的支持，如果想要用這個(gè)功能的話，需要單獨(dú)聯(lián)系銷售或技術(shù)支持在CDN上配置，而且時(shí)間比較長。筆者聯(lián)系了銷售和技術(shù)支持，說是幫我配置，但到現(xiàn)在還沒有搞定，因?yàn)樽罱@個(gè)也不是特別重要，所以也沒有跟下去。
Callback校驗(yàn)
這是可選的一個(gè)步驟。由于七牛云會(huì)在上傳完成之后回調(diào)業(yè)務(wù)服務(wù)器，所以理論上說業(yè)務(wù)服務(wù)器需要校驗(yàn)這個(gè)回調(diào)的合理性。原理在七牛的文檔中有，需要用到HMAC-SHA1簽名函數(shù)。但是七牛的sdk中沒有提供直接的方式來做校驗(yàn)，在研讀文檔、多次失敗和查看sdk源碼后，筆者終于校驗(yàn)成功了。關(guān)鍵的分歧在于，文檔中的這句話：
獲取明文：data = Request.URL.Path +”\n” +Request.Body
這里的Request.URL.Path是否包含Querystring?答案是包含的!下面是筆者C#服務(wù)端的校驗(yàn)代碼，使用的是ASP.NET Web Api：
C# Code復(fù)制內(nèi)容到剪貼板
- byte[] key = System.Text.Encoding.UTF8.GetBytes(Qiniu.Conf.Config.SECRET_KEY);
- using (HMACSHA1 hmac = new HMACSHA1(key))
- {
- var t = filterContext.Request.Content.ReadAsStringAsync();
- t.Wait();
- string rawbody = t.Result;
- log.DebugFormat("request's rawbody : {0}", rawbody);
- string text = filterContext.Request.RequestUri.PathAndQuery + "\n" + rawbody;
- log.DebugFormat("PathAndQuery + \\n + rawbody : {0}", text);
- byte[] digest = hmac.ComputeHash(System.Text.Encoding.UTF8.GetBytes(text));
- string computed = Qiniu.Util.Base64URLSafe.Encode(digest);
- log.DebugFormat("Computed hash after base64 : {0}", computed);
-
- IEnumerablestring> auths;
- if (filterContext.Request.Headers.TryGetValues("Authorization", out auths) auths.Count() == 1)
- {
- string auth = auths.First();
- log.DebugFormat("Authorization in header : {0}", auth);
- if (auth.StartsWith("QBox "))
- {
- var arr = auth.Substring(5).Split(':');
- if (arr.Length == 2)
- {
- if (arr[1] != computed)
- {
- log.ErrorFormat("Authorization failed. Since auth from header {0} not equals computed {1}", arr[1], computed);
- }
- else
- {
- log.Debug("Authorization success.");
- //only pass can be return
- return;
- }
- }
- else
- {
- log.Error("Callback Authorization's format is invalid, can not find two part after split by ':'.");
- }
- }
- else
- {
- log.Error("Callback Authorization's format is invalid, missing leading 'QBox '.");
- }
- }
- else
- {
- log.Error("The request from qiniu callback is missing 'Authorization'");
- }
-
- filterContext.Response = filterContext.Request.CreateResponse(System.Net.HttpStatusCode.Forbidden);
-
- }
如下幾個(gè)注意點(diǎn)：
明文應(yīng)當(dāng)是請(qǐng)求的path+querystring部分和rawbody
對(duì)于.NET而言，明文和key都需要用UTF-8編碼變換成字節(jié)才能進(jìn)行簽名。而php中的hash_hmac函數(shù)完全不用這么復(fù)雜…
簽名的結(jié)果再用base64的url安全的方式編碼，再與請(qǐng)求的http頭部的Authorization比較
建議官方在文檔中加入一些相對(duì)底層一些的編程語言的實(shí)現(xiàn)，php太高端了…
js-sdk實(shí)現(xiàn)略顯粗糙
在使用過程中，我發(fā)現(xiàn)官方的js-sdk有幾個(gè)我覺得不好的地方：
不能為每個(gè)文件獲取UpToken
試想，在文件上傳過程中有獲取UpToken是必須的，而且UpToken又需要包含預(yù)處理指令，不同的文件顯然需要不同的UpToken，而在js-sdk的實(shí)現(xiàn)中，只在初始化這個(gè)上傳組件對(duì)象的時(shí)候請(qǐng)求一次上傳憑證，后面所有的上傳都需要使用這個(gè)預(yù)先得到的UpToken：
JavaScript Code復(fù)制內(nèi)容到剪貼板
- uploader.bind('Init', function(up, params) {
- getUpToken();
- });
于是我修改了這部分，在BeforeUpload事件中請(qǐng)求UpToken。建議官方考慮更改這個(gè)地方
只能實(shí)現(xiàn)分片上傳，無法斷點(diǎn)續(xù)傳
js-sdk的實(shí)現(xiàn)在分片上傳的實(shí)現(xiàn)上，是很簡(jiǎn)單的，不僅沒有使用分片，而是分塊（一塊4m，調(diào)用mkblk），而且沒有實(shí)現(xiàn)持久化ctx，或者類似的回調(diào)或接口。4m分塊這個(gè)問題還可以不追究，沒有實(shí)現(xiàn)持久化ctx就說不過去了，不持久化怎么實(shí)現(xiàn)斷點(diǎn)續(xù)傳撒?!就算不實(shí)現(xiàn)，也應(yīng)該給出回調(diào)的入口，讓調(diào)用者來實(shí)現(xiàn)持久化，而我實(shí)在無法找到這個(gè)’空子’可鉆，只能直接在源碼上改動(dòng)了。
沒有復(fù)用流行類庫的東西
這個(gè)其實(shí)算不上問題，因?yàn)樽鳛橐粋€(gè)不依賴jquery的sdk，當(dāng)然不能使用jquery現(xiàn)成的東西，比如ajax。不依賴jquery就算了，依賴plupload是幾個(gè)意思嘛，還依賴全局對(duì)象…于是最后，我干脆自己將sdk改成了Backbone的類，將不要的東西統(tǒng)統(tǒng)去掉，使用jquery和underscore簡(jiǎn)化代碼了…
