- 簡(jiǎn)體
- 簡(jiǎn)體中文 English
[北京網(wǎng)站制作]API設(shè)計(jì)新思維:用流暢接口構(gòu)造內(nèi)部DSL
API設(shè)計(jì)新思維:用流暢接口構(gòu)造內(nèi)部DSL
程序設(shè)計(jì)語(yǔ)言的抽象機(jī)制包含了兩個(gè)最基本的方面:一是語(yǔ)言關(guān)注的基本元素/語(yǔ)義;另一個(gè)是從基本元素/語(yǔ)義到復(fù)合元素/語(yǔ)義的構(gòu)造規(guī)則。在C、C++、Java、C#、Python等通用語(yǔ)言中,語(yǔ)言的基本元素/語(yǔ)義往往離問(wèn)題域較遠(yuǎn),通過(guò)API庫(kù)的形式進(jìn)行層層抽象是降低問(wèn)題難度最常用的方法。比如,在C語(yǔ)言中最常見(jiàn)的方式是提供函數(shù)庫(kù)來(lái)封裝復(fù)雜邏輯,方便外部調(diào)用。(北京網(wǎng)站制作)
不過(guò)普通的API設(shè)計(jì)方法存在一種天然的陷阱,那就是不管怎樣封裝,大過(guò)程雖然比小過(guò)程抽象層次更高,但本質(zhì)上還是過(guò)程,受到過(guò)程語(yǔ)義的制約。也就是說(shuō),通過(guò)基本元素/語(yǔ)義構(gòu)造更高級(jí)抽象元素/語(yǔ)義的時(shí)候,語(yǔ)言的構(gòu)造規(guī)則很大程度上限制了抽象的維度,我們很難跳出這個(gè)維度去,甚至可能根本意識(shí)不到這個(gè)限制。而SQL、HTML、CSS、make等DSL(領(lǐng)域特定語(yǔ)言)的抽象維度是為特定領(lǐng)域量身定做的,從這些抽象角度看問(wèn)題往往最為簡(jiǎn)單,所以DSL在解決其特定領(lǐng)域的問(wèn)題時(shí)比通用程序設(shè)計(jì)語(yǔ)言更加方便。通常,SQL等非通用語(yǔ)言被稱(chēng)為外部DSL(External DSL);在通用語(yǔ)言中,我們其實(shí)也可以在一定程度上突破語(yǔ)言構(gòu)造規(guī)則的抽象維度限制,定義內(nèi)部DSL(Internal DSL)。
本文將介紹一種被稱(chēng)為流暢接口(Fluent Interface)的內(nèi)部DSL設(shè)計(jì)方法。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è)部分來(lái)逐步說(shuō)明流暢接口在構(gòu)造內(nèi)部DSL中的典型應(yīng)用。
1.基本語(yǔ)義抽象
如果要輸出0..4這5個(gè)數(shù),我們一般會(huì)首先想到類(lèi)似這樣的代碼:
- //Java
- for (int i = 0; i < 5; ++i) {
- system.out.println(i);
- }
而Ruby雖然也支持類(lèi)似的for循環(huán),但最簡(jiǎn)單的是下面這樣的實(shí)現(xiàn):
- //Ruby
- .times {|i| puts i}
Ruby中一切皆對(duì)象,5是Fixnum類(lèi)的實(shí)例,times是Fixnum的一個(gè)方法,它接受一個(gè)block參數(shù)。相比f(wàn)or循環(huán)實(shí)現(xiàn),Ruby 的times方式更簡(jiǎn)潔,可讀性更強(qiáng),但熟悉OOP的朋友可能會(huì)有疑問(wèn),times是否應(yīng)該作為整型類(lèi)的方法呢?在OOP中,方法調(diào)用通常代表了向?qū)ο蟀l(fā)送消息,改變或查詢對(duì)象的狀態(tài),times方法顯然不是對(duì)整型對(duì)象狀態(tài)的查詢和修改。如果你是Ruby的設(shè)計(jì)者,你會(huì)把times方法放入Fixnum類(lèi)嗎?如果答案是否定的,那么Ruby的這種設(shè)計(jì)本質(zhì)上代表了什么呢?實(shí)際上,這里的times雖然只是一個(gè)普通的類(lèi)方法,但它的目的卻與普通意義上的類(lèi)方法不同,它的語(yǔ)義實(shí)際上類(lèi)似于for循環(huán)這樣的語(yǔ)言基本語(yǔ)義,可以被視為一種自定義的基本語(yǔ)義。times的語(yǔ)義從一定程度上跳出了類(lèi)方法的框框,向問(wèn)題域邁進(jìn)了一步!
另一個(gè)例子來(lái)自Eric Evans的“用兩個(gè)時(shí)間點(diǎn)構(gòu)造一個(gè)時(shí)間段對(duì)象”,普通設(shè)計(jì):
- 3 //Java
- TimePoint fiveOClock, sixOClock;
- TimeInterval meetingTime = new TimeInterval(fiveOClock, sixOClock);
另一種Evans的設(shè)計(jì)是這樣:
- 2 //Java
- TimeInterval meetingTime = fiveOClock.until(sixOClock);
按傳統(tǒng)OO設(shè)計(jì),until方法本不應(yīng)出現(xiàn)在TimePoint類(lèi)中,這里TimePoint類(lèi)的until方法同樣代表了一種自定義的基本語(yǔ)義,使得表達(dá)時(shí)間域的問(wèn)題更加自然。
雖然上面的兩個(gè)簡(jiǎn)單例子和普通設(shè)計(jì)相比看不出太大的優(yōu)勢(shì),但它卻為我們理解流暢接口打下了基礎(chǔ)。重要的是應(yīng)該體會(huì)到它們從一定程度上跳出了語(yǔ)言基本抽象機(jī)制的束縛,我們不應(yīng)該再用類(lèi)職責(zé)劃分、迪米特法則(Law of Demeter)等OO設(shè)計(jì)原則來(lái)看待它們。
2.管道抽象
在Shell中,我們可以通過(guò)管道將一系列的小命令組合在一起實(shí)現(xiàn)復(fù)雜的功能。管道中流動(dòng)的是單一類(lèi)型的文本流,計(jì)算過(guò)程就是從輸入流到輸出流的變換過(guò)程,每個(gè)命令是對(duì)文本流的一次變換作用,通過(guò)管道將作用疊加起來(lái)。在Shell中,很多時(shí)候我們只需要一句話就能完成log統(tǒng)計(jì)這樣的中小規(guī)模問(wèn)題。和其他抽象機(jī)制相比,管道的優(yōu)美在于無(wú)嵌套。比如下面這段C程序,由于嵌套層次較深,不容易一下子理解清楚:
- 2 //C
- min(max(min(max(a,b),c),d),e)
而用管道來(lái)表達(dá)同樣的功能則清晰得多:
- 2 #!/bin/bash
- max a b | min c | max d | min e
我們很容易理解這段程序表達(dá)的意思是:先求a,b的最大值;再把結(jié)果和c取最小值;再把結(jié)果和d求最大值;再把結(jié)果和e求最小值。
jQuery的鏈?zhǔn)秸{(diào)用設(shè)計(jì)也具有管道的風(fēng)格,方法鏈上流動(dòng)的是同一類(lèi)型的jQuery對(duì)象,每一步方法調(diào)用是對(duì)對(duì)象的一次作用,整個(gè)方法鏈將各個(gè)方法的作用疊加起來(lái)。
- 2 //Javascript
- $('li').filter(':event').css('background-color', 'red');
3.層次結(jié)構(gòu)抽象
除了管道這種“線性”結(jié)構(gòu)外,流暢接口還可用于構(gòu)造層次結(jié)構(gòu)抽象。比如,用Javascript動(dòng)態(tài)創(chuàng)建創(chuàng)建下面的HTML片段:
- <div id="’product_123’" class="’product’">
- <img src="’preview_123.jpg’" alt="" />
- <ul>
- <li>Name: iPad2 32G</li>
- <li>Price: 3600</li>
- </ul>
- </div>
若采用Javascript的DOM API:
- //Javascript
- var div = document.createElement('div');
- div.setAttribute(‘id’, ‘product_123’);
- div.setAttribute(‘class’, ‘product’);
- var img = document.createElement('img');
- img.setAttribute(‘src’, ‘preview_123.jpg’);
- div.appendChild(img);
- var ul = document.createElement('ul');
- var li1 = document.createElement('li');
- var txt1 = document.createTextNode("Name: iPad2 32G");
- li1.appendChild(txt1);
- …
- div.appendChild(ul);
而下面流暢接口API則要有表現(xiàn)力得多:
- //Javascript
- var obj =
- $.div({id:’product_123’, class:’product’})
- .img({src:’preview_123.jpg’})
- .ul()
- .li().text(‘Name: iPad2 32G’)._li()
- .li().text(‘Price: 3600’)._li()
- ._ul()
- ._div();
和Javascript的標(biāo)準(zhǔn)DOM API相比,上面的API設(shè)計(jì)不再局限于孤立地看待某一個(gè)方法,而是考慮了它們?cè)诮鉀Q問(wèn)題時(shí)的組合使用,所以代碼的表現(xiàn)形式特別貼近問(wèn)題的本質(zhì)。這樣的代碼是自解釋的(self-explanatory)在可讀性方面要明顯勝于DOM API,這相當(dāng)于定義了一種類(lèi)似于HTML的內(nèi)部DSL,它擁有自己的語(yǔ)義和語(yǔ)法。需要特別注意的是,上面的層次結(jié)構(gòu)抽象和管道抽象有著本質(zhì)的不同,管道抽象的方法鏈上通常是同一對(duì)象的連續(xù)傳遞,而層次抽象中方法鏈上的對(duì)象卻在隨著層次的變化而變化。此為,我們可以把業(yè)務(wù)規(guī)則也表達(dá)在流暢接口中,比如上面的例子中,body()不能包含在div()返回的對(duì)象中,div().body()將拋出”body方法不存在”異常。(高端網(wǎng)站建設(shè))
4.異步抽象
流暢接口不僅可以構(gòu)造復(fù)雜的層次抽象,還可以用于構(gòu)造異步抽象。在基于回調(diào)機(jī)制的異步模式中,多個(gè)異步調(diào)用的同步和嵌套問(wèn)題是使用異步的難點(diǎn)所在。有時(shí)一個(gè)稍復(fù)雜的調(diào)用和同步關(guān)系會(huì)導(dǎo)致代碼充滿了復(fù)雜的同步檢查和層層回調(diào),難以理解和維護(hù)。這個(gè)問(wèn)題從本質(zhì)上講和上面HTML的例子一樣,是由于多數(shù)通用語(yǔ)言并未把異步作為基本元素/語(yǔ)義,許多異步實(shí)現(xiàn)模式是向語(yǔ)言的妥協(xié)。針對(duì)這個(gè)問(wèn)題,我用Javascript編寫(xiě)了一個(gè)基于流暢接口的異步DSL,示例代碼如下:
- //Javascript
- $.begin()
- .async(newTask('task1'), 'task1')
- .async(newTask('task2'), 'task2')
- .async(newTask('task3'), 'task3')
- .when()
- .each_done(function(name, result) {
- console.log(name + ': ' + result);})
- .all_done(function(){ console.log('good, all completed'); })
- .timeout(function(){
- console.log('timeout!!');
- $.begin()
- .async(newTask('task4'), 'task4')
- .when()
- .each_done(function(name, result) {
- console.log(name + ': ' + result); })
- .end();}
- , 3000)
- .end();
上面的代碼只是一句Javascript調(diào)用,但從另一個(gè)角度看它卻像一段描述異步調(diào)用的DSL程序。它通過(guò)流暢接口定義了begin when end的語(yǔ)法結(jié)構(gòu),begin后面跟的是啟動(dòng)異步調(diào)用的代碼;when后面是異步結(jié)果處理,可以選擇each_done, all_done, timeout中的一種或多種。而begin when end結(jié)構(gòu)本身是可以嵌套的,比如上面的代碼在timeout處理分支中就包含了另一個(gè)begin when end結(jié)構(gòu)。通過(guò)這個(gè)DSL,我們可以比基于回調(diào)的方式更好地表達(dá)異步調(diào)用的同步和嵌套關(guān)系。
上面介紹了用流暢接口構(gòu)造的4種典型抽象,出此之外還有很多其他的抽象和應(yīng)用場(chǎng)合,比如:不少單元測(cè)試框架就通過(guò)流暢接口定義了單元測(cè)試的DSL。雖然上面的例子以Javascript等動(dòng)態(tài)語(yǔ)言居多,但其實(shí)流暢接口所依賴(lài)的語(yǔ)法基礎(chǔ)并不苛刻,即使在Java這樣的靜態(tài)語(yǔ)言中,同樣可以輕松地使用。流暢接口不同于傳統(tǒng)的API設(shè)計(jì),理解和使用流暢接口關(guān)鍵是要突破語(yǔ)言抽象機(jī)制帶來(lái)的定勢(shì)思維,根據(jù)問(wèn)題域選取適當(dāng)?shù)某橄缶S度,利用語(yǔ)言的基本語(yǔ)法構(gòu)造領(lǐng)域特定的語(yǔ)義和語(yǔ)法。
建站流程
-
網(wǎng)站需求
-
網(wǎng)站策劃方案
-
頁(yè)面設(shè)計(jì)風(fēng)格
-
確認(rèn)交付使用
-
資料錄入優(yōu)化
-
程序設(shè)計(jì)開(kāi)發(fā)
-
后續(xù)跟蹤服務(wù)
-
聯(lián)系電話
010-60259772
熱門(mén)標(biāo)簽
- 網(wǎng)站建設(shè)
- 食品網(wǎng)站建設(shè)
- 微信小程序開(kāi)發(fā)
- 小程序開(kāi)發(fā)
- 無(wú)錫網(wǎng)站建設(shè)
- 研究所網(wǎng)站建設(shè)
- 沈陽(yáng)網(wǎng)站建設(shè)
- 廊坊網(wǎng)站建設(shè)
- 鄭州網(wǎng)站建設(shè)
- 婚紗攝影網(wǎng)站建設(shè)
- 手機(jī)端網(wǎng)站建設(shè)
- 高校網(wǎng)站制作
- 天津網(wǎng)站建設(shè)
- 教育網(wǎng)站建設(shè)
- 品牌網(wǎng)站建設(shè)
- 政府網(wǎng)站建設(shè)
- 北京網(wǎng)站建設(shè)
- 網(wǎng)站設(shè)計(jì)
- 網(wǎng)站制作
最新文章
推薦新聞
更多行業(yè)-
網(wǎng)站建設(shè)重在創(chuàng)新的設(shè)計(jì)理念
現(xiàn)在比較流行新概念的營(yíng)銷(xiāo)型網(wǎng)站建設(shè),所謂營(yíng)銷(xiāo)就是指讓自己的網(wǎng)站在互聯(lián)網(wǎng)...
2012-07-24 -
揭露三天能做到首頁(yè)的百度優(yōu)化
網(wǎng)站制作公司尚品中國(guó)(m.proteomeinstitute.com):SEO網(wǎng)站優(yōu)...
2012-05-13 -
科研院所網(wǎng)站建設(shè)如何選擇風(fēng)格?
不同公司適應(yīng)不同網(wǎng)站建設(shè)風(fēng)格,那么如果是科研院所網(wǎng)站建設(shè)的話,該選擇哪...
2023-03-15 -
天津網(wǎng)站制作如何從百度快照動(dòng)態(tài)分析網(wǎng)站呢?
網(wǎng)站百度快照是網(wǎng)站首頁(yè)在百度搜索引擎上的網(wǎng)頁(yè)緩存,是我們網(wǎng)站建設(shè)和網(wǎng)站...
2022-01-27 -
新站前期SEO優(yōu)化工作該如何進(jìn)行?
在搜索引擎算法不斷更新的時(shí)代,對(duì)于新站來(lái)說(shuō),做SEO網(wǎng)站優(yōu)化的難度越來(lái)...
2014-02-23 -
讓我們正確認(rèn)識(shí)百度權(quán)重、排名和google的PR值之間的關(guān)系
北京網(wǎng)站建設(shè)公司尚品中國(guó):網(wǎng)站權(quán)重雖然很多SEO網(wǎng)站優(yōu)化人員都在議論,...
2012-02-11
預(yù)約專(zhuān)業(yè)咨詢顧問(wèn)溝通!
免責(zé)聲明
非常感謝您訪問(wèn)我們的網(wǎng)站。在您使用本網(wǎng)站之前,請(qǐng)您仔細(xì)閱讀本聲明的所有條款。
1、本站部分內(nèi)容來(lái)源自網(wǎng)絡(luò),涉及到的部分文章和圖片版權(quán)屬于原作者,本站轉(zhuǎn)載僅供大家學(xué)習(xí)和交流,切勿用于任何商業(yè)活動(dòng)。
2、本站不承擔(dān)用戶因使用這些資源對(duì)自己和他人造成任何形式的損失或傷害。
3、本聲明未涉及的問(wèn)題參見(jiàn)國(guó)家有關(guān)法律法規(guī),當(dāng)本聲明與國(guó)家法律法規(guī)沖突時(shí),以國(guó)家法律法規(guī)為準(zhǔn)。
4、如果侵害了您的合法權(quán)益,請(qǐng)您及時(shí)與我們,我們會(huì)在第一時(shí)間刪除相關(guān)內(nèi)容!
聯(lián)系方式:010-60259772
電子郵件:394588593@qq.com