日韩无码专区无码一级三级片|91人人爱网站中日韩无码电影|厨房大战丰满熟妇|AV高清无码在线免费观看|另类AV日韩少妇熟女|中文日本大黄一级黄色片|色情在线视频免费|亚洲成人特黄a片|黄片wwwav色图欧美|欧亚乱色一区二区三区

RELATEED CONSULTING
相關(guān)咨詢
選擇下列產(chǎn)品馬上在線溝通
服務(wù)時間：8:30-17:00
你可能遇到了下面的問題
關(guān)閉右側(cè)工具欄

新聞中心

這里有您想知道的互聯(lián)網(wǎng)營銷解決方案
API設(shè)計新思維：用流暢接口構(gòu)造內(nèi)部DSL

程序設(shè)計語言的抽象機制包含了兩個最基本的方面：一是語言關(guān)注的基本元素/語義;另一個是從基本元素/語義到復(fù)合元素/語義的構(gòu)造規(guī)則。在C、C++、Java、C#、Python等通用語言中，語言的基本元素/語義往往離問題域較遠，通過API庫的形式進行層層抽象是降低問題難度最常用的方法。比如，在C語言中最常見的方式是提供函數(shù)庫來封裝復(fù)雜邏輯，方便外部調(diào)用。

創(chuàng)新互聯(lián)建站于2013年成立，是專業(yè)互聯(lián)網(wǎng)技術(shù)服務(wù)公司，擁有項目成都做網(wǎng)站、網(wǎng)站建設(shè)、外貿(mào)營銷網(wǎng)站建設(shè)網(wǎng)站策劃，項目實施與項目整合能力。我們以讓每一個夢想脫穎而出為使命，1280元泰寧做網(wǎng)站,已為上家服務(wù),為泰寧各地企業(yè)和個人服務(wù),聯(lián)系電話:028-86922220

不過普通的API設(shè)計方法存在一種天然的陷阱，那就是不管怎樣封裝，大過程雖然比小過程抽象層次更高，但本質(zhì)上還是過程，受到過程語義的制約。也就是說，通過基本元素/語義構(gòu)造更高級抽象元素/語義的時候，語言的構(gòu)造規(guī)則很大程度上限制了抽象的維度，我們很難跳出這個維度去，甚至可能根本意識不到這個限制。而SQL、HTML、CSS、make等DSL(領(lǐng)域特定語言)的抽象維度是為特定領(lǐng)域量身定做的，從這些抽象角度看問題往往最為簡單，所以DSL在解決其特定領(lǐng)域的問題時比通用程序設(shè)計語言更加方便。通常，SQL等非通用語言被稱為外部DSL(External DSL);在通用語言中，我們其實也可以在一定程度上突破語言構(gòu)造規(guī)則的抽象維度限制，定義內(nèi)部DSL(Internal DSL)。

本文將介紹一種被稱為流暢接口(Fluent Interface)的內(nèi)部DSL設(shè)計方法。Wikipedia上Fluent Interface的定義是：

A fluent interface (as first coined by Eric Evans and Martin Fowler) is an implementation of an object oriented API that aims to provide for more readable code. A fluent interface is normally implemented by using method chaining to relay the instruction context of a subsequent call (but a fluent interface entails more than just method chaining)。

下面將分4個部分來逐步說明流暢接口在構(gòu)造內(nèi)部DSL中的典型應(yīng)用。

1.基本語義抽象

如果要輸出0..4這5個數(shù)，我們一般會首先想到類似這樣的代碼：

 
 
 
    
  
  
  
  1. //Java    
    2. 
  
  
  
  2. for (int i = 0; i < 5; ++i) {    
    3. 
  
  
  
  3. system.out.println(i);    
    4. 
  
  
  
  4. }    
    5.

而Ruby雖然也支持類似的for循環(huán)，但最簡單的是下面這樣的實現(xiàn)：

 
 
 
    
  
  
  
  1. //Ruby    
    2. 
  
  
  
  2. .times {|i| puts i}    
    3.

Ruby中一切皆對象，5是Fixnum類的實例，times是Fixnum的一個方法，它接受一個block參數(shù)。相比for循環(huán)實現(xiàn)，Ruby 的times方式更簡潔，可讀性更強，但熟悉OOP的朋友可能會有疑問，times是否應(yīng)該作為整型類的方法呢?在OOP中，方法調(diào)用通常代表了向?qū)ο蟀l(fā)送消息，改變或查詢對象的狀態(tài)，times方法顯然不是對整型對象狀態(tài)的查詢和修改。如果你是Ruby的設(shè)計者，你會把times方法放入Fixnum類嗎?如果答案是否定的，那么Ruby的這種設(shè)計本質(zhì)上代表了什么呢?實際上，這里的times雖然只是一個普通的類方法，但它的目的卻與普通意義上的類方法不同，它的語義實際上類似于for循環(huán)這樣的語言基本語義，可以被視為一種自定義的基本語義。times的語義從一定程度上跳出了類方法的框框，向問題域邁進了一步!

另一個例子來自Eric Evans的“用兩個時間點構(gòu)造一個時間段對象”，普通設(shè)計：

 
 
 
    
  
  
  
  1. //Java  
    2. 
  
  
  
  2. TimePoint fiveOClock, sixOClock;  
    3. 
  
  
  
  3. TimeInterval meetingTime = new TimeInterval(fiveOClock, sixOClock); 
    4.

另一種Evans的設(shè)計是這樣：

 
 
 
    
  
  
  
  1. //Java  
    2. 
  
  
  
  2. TimeInterval meetingTime = fiveOClock.until(sixOClock); 
    3.

按傳統(tǒng)OO設(shè)計，until方法本不應(yīng)出現(xiàn)在TimePoint類中，這里TimePoint類的until方法同樣代表了一種自定義的基本語義，使得表達時間域的問題更加自然。

雖然上面的兩個簡單例子和普通設(shè)計相比看不出太大的優(yōu)勢，但它卻為我們理解流暢接口打下了基礎(chǔ)。重要的是應(yīng)該體會到它們從一定程度上跳出了語言基本抽象機制的束縛，我們不應(yīng)該再用類職責(zé)劃分、迪米特法則(Law of Demeter)等OO設(shè)計原則來看待它們。

2.管道抽象

在Shell中，我們可以通過管道將一系列的小命令組合在一起實現(xiàn)復(fù)雜的功能。管道中流動的是單一類型的文本流，計算過程就是從輸入流到輸出流的變換過程，每個命令是對文本流的一次變換作用，通過管道將作用疊加起來。在Shell中，很多時候我們只需要一句話就能完成log統(tǒng)計這樣的中小規(guī)模問題。和其他抽象機制相比，管道的優(yōu)美在于無嵌套。比如下面這段C程序，由于嵌套層次較深，不容易一下子理解清楚：

 
 
 
    
  
  
  
  1. //C  
    2. 
  
  
  
  2. min(max(min(max(a,b),c),d),e) 
    3.

而用管道來表達同樣的功能則清晰得多：

 
 
 
    
  
  
  
  1. #!/bin/bash  
    2. 
  
  
  
  2. max a b | min c | max d | min e 
    3.

我們很容易理解這段程序表達的意思是：先求a，b的最大值;再把結(jié)果和c取最小值;再把結(jié)果和d求最大值;再把結(jié)果和e求最小值。

jQuery的鏈?zhǔn)秸{(diào)用設(shè)計也具有管道的風(fēng)格，方法鏈上流動的是同一類型的jQuery對象，每一步方法調(diào)用是對對象的一次作用，整個方法鏈將各個方法的作用疊加起來。

 
 
 
    
  
  
  
  1. //Javascript  
    2. 
  
  
  
  2. $('li').filter(':event').css('background-color', 'red'); 
    3.

3.層次結(jié)構(gòu)抽象

除了管道這種“線性”結(jié)構(gòu)外，流暢接口還可用于構(gòu)造層次結(jié)構(gòu)抽象。比如，用Javascript動態(tài)創(chuàng)建創(chuàng)建下面的HTML片段：

 
 
 
    
  
  
  
  1.  id="’product_123’" class="’product’"> 
    2. 
  
  
  
  2.  src="’preview_123.jpg’" alt="" /> 
    3. 
  
  
  
    3.  
  
  
  
    •     
    • Name: iPad2 32G
      •  
  
  
  
    •     
    • Price: 3600
      •  
  
  
  
     
    4.
 

若采用Javascript的DOM API：

 
 
 
    
  
  
  
  1. //Javascript  
    2. 
  
  
  
  2. var div = document.createElement('div');  
    3. 
  
  
  
  3. div.setAttribute(‘id’, ‘product_123’);  
    4. 
  
  
  
  4. div.setAttribute(‘class’, ‘product’);  
    5. 
  
  
  
  5.    
    6. 
  
  
  
  6. var img = document.createElement('img');  
    7. 
  
  
  
  7. img.setAttribute(‘src’, ‘preview_123.jpg’);  
    8. 
  
  
  
  8. div.appendChild(img);  
    9. 
  
  
  
  9.    
    10. 
  
  
  
  10. var ul = document.createElement('ul');  
    11. 
  
  
  
  11. var li1 = document.createElement('li');  
    12. 
  
  
  
  12. var txt1 = document.createTextNode("Name: iPad2 32G");  
    13. 
  
  
  
  13. li1.appendChild(txt1);  
    14. 
  
  
  
  14. …  
    15. 
  
  
  
  15. div.appendChild(ul); 
    16.

而下面流暢接口API則要有表現(xiàn)力得多：

 
 
 
    
  
  
  
  1. //Javascript  
    2. 
  
  
  
  2. var obj =  
    3. 
  
  
  
  3. $.div({id:’product_123’, class:’product’})  
    4. 
  
  
  
  4.     .img({src:’preview_123.jpg’})  
    5. 
  
  
  
  5.     .ul()  
    6. 
  
  
  
  6.         .li().text(‘Name: iPad2 32G’)._li()  
    7. 
  
  
  
  7.         .li().text(‘Price: 3600’)._li()  
    8. 
  
  
  
  8.     ._ul()  
    9. 
  
  
  
  9.  ._div(); 
    10.

和Javascript的標(biāo)準(zhǔn)DOM API相比，上面的API設(shè)計不再局限于孤立地看待某一個方法，而是考慮了它們在解決問題時的組合使用，所以代碼的表現(xiàn)形式特別貼近問題的本質(zhì)。這樣的代碼是自解釋的(self-explanatory)在可讀性方面要明顯勝于DOM API，這相當(dāng)于定義了一種類似于HTML的內(nèi)部DSL，它擁有自己的語義和語法。需要特別注意的是，上面的層次結(jié)構(gòu)抽象和管道抽象有著本質(zhì)的不同，管道抽象的方法鏈上通常是同一對象的連續(xù)傳遞，而層次抽象中方法鏈上的對象卻在隨著層次的變化而變化。此為，我們可以把業(yè)務(wù)規(guī)則也表達在流暢接口中，比如上面的例子中，body()不能包含在div()返回的對象中，div().body()將拋出”body方法不存在”異常。

4.異步抽象

流暢接口不僅可以構(gòu)造復(fù)雜的層次抽象，還可以用于構(gòu)造異步抽象。在基于回調(diào)機制的異步模式中，多個異步調(diào)用的同步和嵌套問題是使用異步的難點所在。有時一個稍復(fù)雜的調(diào)用和同步關(guān)系會導(dǎo)致代碼充滿了復(fù)雜的同步檢查和層層回調(diào)，難以理解和維護。這個問題從本質(zhì)上講和上面HTML的例子一樣，是由于多數(shù)通用語言并未把異步作為基本元素/語義，許多異步實現(xiàn)模式是向語言的妥協(xié)。針對這個問題，我用Javascript編寫了一個基于流暢接口的異步DSL，示例代碼如下：

 
 
 
    
  
  
  
  1. //Javascript  
    2. 
  
  
  
  2. $.begin()  
    3. 
  
  
  
  3.     .async(newTask('task1'), 'task1')  
    4. 
  
  
  
  4.     .async(newTask('task2'), 'task2')  
    5. 
  
  
  
  5.     .async(newTask('task3'), 'task3')  
    6. 
  
  
  
  6. .when()  
    7. 
  
  
  
  7.     .each_done(function(name, result) {  
    8. 
  
  
  
  8.         console.log(name + ': ' + result);})  
    9. 
  
  
  
  9.     .all_done(function(){ console.log('good, all completed'); })  
    10. 
  
  
  
  10.     .timeout(function(){  
    11. 
  
  
  
  11.         console.log('timeout!!');  
    12. 
  
  
  
  12.         $.begin()  
    13. 
  
  
  
  13.             .async(newTask('task4'), 'task4')  
    14. 
  
  
  
  14.         .when()  
    15. 
  
  
  
  15.             .each_done(function(name, result) {  
    16. 
  
  
  
  16.                 console.log(name + ': ' + result); })  
    17. 
  
  
  
  17.         .end();}  
    18. 
  
  
  
  18.         , 3000)  
    19. 
  
  
  
  19. .end(); 
    20.

上面的代碼只是一句Javascript調(diào)用，但從另一個角度看它卻像一段描述異步調(diào)用的DSL程序。它通過流暢接口定義了begin when end的語法結(jié)構(gòu)，begin后面跟的是啟動異步調(diào)用的代碼;when后面是異步結(jié)果處理，可以選擇each_done, all_done, timeout中的一種或多種。而begin when end結(jié)構(gòu)本身是可以嵌套的，比如上面的代碼在timeout處理分支中就包含了另一個begin when end結(jié)構(gòu)。通過這個DSL，我們可以比基于回調(diào)的方式更好地表達異步調(diào)用的同步和嵌套關(guān)系。

上面介紹了用流暢接口構(gòu)造的4種典型抽象，出此之外還有很多其他的抽象和應(yīng)用場合，比如：不少單元測試框架就通過流暢接口定義了單元測試的DSL。雖然上面的例子以Javascript等動態(tài)語言居多，但其實流暢接口所依賴的語法基礎(chǔ)并不苛刻，即使在Java這樣的靜態(tài)語言中，同樣可以輕松地使用。流暢接口不同于傳統(tǒng)的API設(shè)計，理解和使用流暢接口關(guān)鍵是要突破語言抽象機制帶來的定勢思維，根據(jù)問題域選取適當(dāng)?shù)某橄缶S度，利用語言的基本語法構(gòu)造領(lǐng)域特定的語義和語法。

原文：http://www.cnblogs.com/weidagang2046/

【編輯推薦】

  1. 開發(fā)者免費調(diào)用谷歌地圖API時代正式結(jié)束
  2. WCF Web API輕松實現(xiàn)REST
  3. 新浪微博API開發(fā)簡介之用戶授權(quán)（PHP基礎(chǔ)篇）
  4. 谷歌拼音輸入法擴展API開發(fā)指南
  5. 教你如何構(gòu)建簡單Web API

當(dāng)前標(biāo)題：API設(shè)計新思維：用流暢接口構(gòu)造內(nèi)部DSL
文章網(wǎng)址：http://www.5511xx.com/article/djchish.html