599錯(cuò)誤處理
如果在與七牛的交互中出現(xiàn)http狀態(tài)碼為599的錯(cuò)誤,一句話(huà),不要猶豫,直接聯(lián)系七牛技術(shù)支持。七牛的文檔也在很多地方提到這個(gè)錯(cuò)誤,都是指導(dǎo)大家去聯(lián)系技術(shù)支持的。筆者是在分塊上傳后的mkfile調(diào)用時(shí)出現(xiàn)的,聯(lián)系技術(shù)支持后,說(shuō)是調(diào)整了一下,讓我重試。后來(lái)就好了…
分塊上傳無(wú)法從回調(diào)中獲得文件的原始名
簡(jiǎn)單上傳采用的是multipart/form-data方式上傳,七牛服務(wù)端能夠從請(qǐng)求中獲得文件的原始名,并支持使用魔法變量$(fname)回調(diào)業(yè)務(wù)服務(wù)器。不過(guò)當(dāng)使用分片上傳的時(shí)候情況有所不同。分片上傳需要在最后調(diào)用mkfile,來(lái)將分片拼接起來(lái)。但是,mkfile接口支持普通的請(qǐng)求,并沒(méi)有附帶文件名,所以七牛也就無(wú)法獲得文件名,此時(shí)從$(fname)中是取不到文件名的。這個(gè)問(wèn)題我也向七牛技術(shù)支持提交了問(wèn)題,得到的結(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)緩存,用戶(hù)不用關(guān)心,只要每次訪問(wèn)都用這個(gè)url就行了。然而,筆者在開(kāi)始的時(shí)候,為了保持與其他文件形式統(tǒng)一的處理方法,對(duì)圖片使用了預(yù)處理(因?yàn)橐曨l什么的只能預(yù)處理),即在token中指定了預(yù)處理。此時(shí)問(wèn)題出現(xiàn)了,從后臺(tái)的日志看到,圖片的預(yù)處理通知回調(diào)竟然比正常的上傳成功回調(diào)還要快!這就導(dǎo)致預(yù)處理結(jié)果到來(lái)之前,我的業(yè)務(wù)服務(wù)器的數(shù)據(jù)庫(kù)中還沒(méi)有這個(gè)圖片,無(wú)法保存預(yù)處理結(jié)果了。所以推薦還是使用url直接處理,對(duì)圖片要慎用預(yù)處理
視頻文件無(wú)法快進(jìn)播放
通常用戶(hù)在觀看視頻的時(shí)候都會(huì)根據(jù)自己的喜好,快速將視頻定位到指定的時(shí)間播放。實(shí)現(xiàn)這個(gè)功能,需要視頻本身有關(guān)鍵幀信息、服務(wù)端需要支持關(guān)鍵幀播放請(qǐng)求。
但是筆者發(fā)現(xiàn),在使用七牛云轉(zhuǎn)化后的視頻,這樣做是無(wú)效的。于是咨詢(xún)技術(shù)支持,得到的答案是:轉(zhuǎn)化的文件是具有關(guān)鍵幀的,但七牛使用CDN加速,所以關(guān)鍵幀請(qǐng)求需要CDN的支持,如果想要用這個(gè)功能的話(huà),需要單獨(dú)聯(lián)系銷(xiāo)售或技術(shù)支持在CDN上配置,而且時(shí)間比較長(zhǎng)。筆者聯(lián)系了銷(xiāo)售和技術(shù)支持,說(shuō)是幫我配置,但到現(xiàn)在還沒(méi)有搞定,因?yàn)樽罱@個(gè)也不是特別重要,所以也沒(méi)有跟下去。
Callback校驗(yàn)
這是可選的一個(gè)步驟。由于七牛云會(huì)在上傳完成之后回調(diào)業(yè)務(wù)服務(wù)器,所以理論上說(shuō)業(yè)務(wù)服務(wù)器需要校驗(yàn)這個(gè)回調(diào)的合理性。原理在七牛的文檔中有,需要用到HMAC-SHA1簽名函數(shù)。但是七牛的sdk中沒(méi)有提供直接的方式來(lái)做校驗(yàn),在研讀文檔、多次失敗和查看sdk源碼后,筆者終于校驗(yàn)成功了。關(guān)鍵的分歧在于,文檔中的這句話(huà):
獲取明文: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ì)底層一些的編程語(yǔ)言的實(shí)現(xiàn),php太高端了…
js-sdk實(shí)現(xiàn)略顯粗糙
在使用過(guò)程中,我發(fā)現(xiàn)官方的js-sdk有幾個(gè)我覺(jué)得不好的地方:
不能為每個(gè)文件獲取UpToken
試想,在文件上傳過(guò)程中有獲取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)分片上傳,無(wú)法斷點(diǎn)續(xù)傳
js-sdk的實(shí)現(xiàn)在分片上傳的實(shí)現(xiàn)上,是很簡(jiǎn)單的,不僅沒(méi)有使用分片,而是分塊(一塊4m,調(diào)用mkblk),而且沒(méi)有實(shí)現(xiàn)持久化ctx,或者類(lèi)似的回調(diào)或接口。4m分塊這個(gè)問(wèn)題還可以不追究,沒(méi)有實(shí)現(xiàn)持久化ctx就說(shuō)不過(guò)去了,不持久化怎么實(shí)現(xiàn)斷點(diǎn)續(xù)傳撒?!就算不實(shí)現(xiàn),也應(yīng)該給出回調(diào)的入口,讓調(diào)用者來(lái)實(shí)現(xiàn)持久化,而我實(shí)在無(wú)法找到這個(gè)’空子’可鉆,只能直接在源碼上改動(dòng)了。
沒(méi)有復(fù)用流行類(lèi)庫(kù)的東西
這個(gè)其實(shí)算不上問(wèn)題,因?yàn)樽鳛橐粋€(gè)不依賴(lài)jquery的sdk,當(dāng)然不能使用jquery現(xiàn)成的東西,比如ajax。不依賴(lài)jquery就算了,依賴(lài)plupload是幾個(gè)意思嘛,還依賴(lài)全局對(duì)象…于是最后,我干脆自己將sdk改成了Backbone的類(lèi),將不要的東西統(tǒng)統(tǒng)去掉,使用jquery和underscore簡(jiǎn)化代碼了…