SDK自動化設(shè)計-GoogleCode

1、淘寶開放平臺自動化SDK介紹簡要介紹淘寶開放平臺自動化SDK是開放平臺業(yè)界一項首創(chuàng)的技術(shù)。它的出現(xiàn)解決了長期以來：SDK維護困難、人工編寫筆誤、SDK更新速度慢、SDK無法多語言化的難題。API數(shù)據(jù)類型介紹淘寶API的數(shù)據(jù)類型是一種簡化版的JAVA類型，它適用于互聯(lián)網(wǎng)傳輸，兼容各種流行的開發(fā)語言，簡單、方便、容易理解。類型名稱類型描述取值范圍Number整型數(shù)據(jù)-264 264String字符串類型Boolean布爾型true, falseDate日期類型（使用北京時區(qū)）格式：yyyy-MM-dd HH:mm:ssField List以半角逗號分隔的字符串列表Price人民幣金額精確到分byt

2、e字節(jié)數(shù)組類型API元數(shù)據(jù)介紹API元數(shù)據(jù)是淘寶開放API最基本最抽象的數(shù)據(jù)，利用它可以自動生成各種語言的SDK，API在線測試工具，API離線文檔等。API元數(shù)據(jù)是以XML的形式展現(xiàn)的，它主要包含數(shù)據(jù)結(jié)構(gòu)和API兩個部分：數(shù)據(jù)結(jié)構(gòu)主要包含：名稱、描述和屬性列表。特殊字段解釋字段名稱字段描述level數(shù)據(jù)結(jié)構(gòu)屬性的類型級別，可選值為：l Basic: 基本類型l Basic Array: 基本類型數(shù)組l Object: 對象類型l Object Array: 對象類型數(shù)組private字段是否隱私，隱私字段需要用戶登錄才能返回，可選值為：true/falseAPI主要包含：名稱、授權(quán)、請求參數(shù)

3、、響應(yīng)參數(shù)，響應(yīng)示例、錯誤碼、FAQ。字段名稱字段描述authorize調(diào)用接口的授權(quán)類型，直接表現(xiàn)為是否需要傳入Session Key，可選值為：l 必須用戶授權(quán)l(xiāng) 可選用戶授權(quán)l(xiāng) 不需用戶授權(quán)SDK自動化設(shè)計總體設(shè)計整個系統(tǒng)基于狀態(tài)和策略模式來設(shè)計以達到快速擴展的目的，它主要分為以下五個部分：Domain：API元數(shù)據(jù)的層次結(jié)構(gòu)展現(xiàn)TypeMapper: 淘寶API數(shù)據(jù)類型與特定語言數(shù)據(jù)類型之間的映射SdkParser: 淘寶API元數(shù)據(jù)的解釋器，通過它可以把元數(shù)據(jù)解釋為Domain結(jié)構(gòu)SdkCompiler：SDK的編譯器，通過它可以把源代碼編譯成特定語言的字節(jié)碼或二進制碼SdkGene

4、rator：SDK的生成器，它主要負(fù)責(zé)生成源代碼和對字節(jié)碼進行打包發(fā)布模型類圖系統(tǒng)類圖擴展方式第一步：編寫基礎(chǔ)框架主要包含API請求的HTTP通訊、API響應(yīng)的通用解釋（XML和JSON）、API的簽名及驗證工具。當(dāng)然還要包括把這三者結(jié)合起來的框架。存放位置：把基礎(chǔ)框架打包壓縮（ZIP包），并存放在src/main/resources目錄下（如taobao-sdk-java-source.zip）第二步：編寫模板主要包含數(shù)據(jù)結(jié)構(gòu)模板、API請求模板，API響應(yīng)模板。如果需要依賴第三方IDE來編譯的話，還需要提供工程文件模板。模板以文本文件的方式提供，動態(tài)內(nèi)容通過占位符的方式來替換。存放位置：放

5、在src/main/resources/template目錄下第三步：擴展類庫主要有3個擴展點：實現(xiàn)類型映射器（TypeMapper）、實現(xiàn)源碼編譯器（SdkCompiler）、實現(xiàn)源碼生成器（SdkGenerator）注：1. 如果是弱類型語言（如PHP），是不需要實現(xiàn)類型映射器的；2. 如果是動態(tài)語言（如PHP），是不需要實現(xiàn)源碼編譯器的。存放位置：分別放在放在com/taobao/top/autosdk/mapper,com/taobao/top/autosdk/compiler,com/taobao/top/autosdk/generator,三個目錄下使用方式生成JAVA SDK：File target = new File(C:/Sdk/Java);SdkParser parser = new MetaSdkParser(new JavaTypeMapper();SdkGenerator sg = new JavaSdkGene