国产xxxx99真实实拍_久久不雅视频_高清韩国a级特黄毛片_嗯老师别我我受不了了小说

資訊專欄INFORMATION COLUMN

什么是好的API設(shè)計(jì)？

mudiyouyou / 2903人閱讀

摘要：什么是我們只要是在進(jìn)行編程我們就需要不停的設(shè)計(jì)。不易誤用這一點(diǎn)很重要，要減少使用者的心智負(fù)擔(dān)。盡量少的外部依賴減少使用者的成本。良好的命名盡量做到自描述。

什么是API？

我們只要是在進(jìn)行編程我們就需要不停的設(shè)計(jì)API。

API簡(jiǎn)單來(lái)講可以是一個(gè)調(diào)用的函數(shù)，一個(gè)接口。

抽象來(lái)說(shuō)，接口是一個(gè)內(nèi)聚系統(tǒng)暴漏給外部的一切信息，包含但不限于：

調(diào)用方式：比如通過(guò)lib庫(kù)或者h(yuǎn)ttp接口等。

調(diào)用約定：比如lib的函數(shù)簽名或者HTTP的參數(shù)，http method或者頭信息，長(zhǎng)短鏈接等等。

依賴關(guān)系：比如接口的調(diào)用需要涉及到第三方或者其他的準(zhǔn)備工作等等。

API就像一個(gè)人一樣，我們和一個(gè)API打交道的時(shí)候需要了解這個(gè)人的特性偏好等，有的人很好相處，而有的人讓人很頭疼，尤其是你不得不和他打交道的時(shí)候，和人一樣，如果你不得不和他打交道，要改變他的秉性是很痛苦的，人的“本性難移”, API也一樣，一旦發(fā)布了，要改變的成本就很大很大。

好的API應(yīng)該具有：

易于學(xué)習(xí)：即使沒有文檔也易于使用。

不易誤用：這一點(diǎn)很重要，要減少使用者的心智負(fù)擔(dān)。

易于滿足需求：API的完備性和正交性。能夠容易的滿足需求，完備性保證功能完整，正交性保證接口的簡(jiǎn)潔性，不需要為所有的需求提供接口，而是由用戶去組合。

易于擴(kuò)展性

怎么樣設(shè)計(jì)良好的API？

專一：一個(gè)API的功能應(yīng)該是單一的，需要能夠很容易的解釋和理解，也就會(huì)更好用。

盡可能的小：小有很多的優(yōu)勢(shì)，易于理解和維護(hù)。

盡量少的外部依賴：減少使用者的成本。

設(shè)計(jì)不被實(shí)現(xiàn)影響：不要暴漏實(shí)現(xiàn)細(xì)節(jié)給用戶，竟可能少的暴露，不止是內(nèi)部細(xì)節(jié)，對(duì)于不必要的接口盡量不要發(fā)布，比如使用不多的功能，可以暫時(shí)不暴露接口。

良好的命名：盡量做到自描述。

完善的文檔

考慮性能

Thanks ~

AD:

文章版權(quán)歸作者所有，未經(jīng)允許請(qǐng)勿轉(zhuǎn)載,若此文章存在違規(guī)行為，您可以聯(lián)系管理員刪除。

轉(zhuǎn)載請(qǐng)注明本文地址：http://m.specialneedsforspecialkids.com/yun/21877.html

相關(guān)文章

  • 一篇文章了解Js Bridge

    摘要：安全安全是很重要的，現(xiàn)在有些實(shí)現(xiàn)中使用了，而在之前，存在任意代碼執(zhí)行漏洞，這就會(huì)導(dǎo)致嚴(yán)重的安全問題。 showImg(https://segmentfault.com/img/bV4k9Q?w=719&h=372); 什么是JS Bridge 在大多數(shù)APP開發(fā)過(guò)程中，都會(huì)通過(guò)H5來(lái)實(shí)現(xiàn)部分功能，而Hybird APP基本90%以上都是H5。現(xiàn)在很少有純?cè)腁PP。但是，由于H5頁(yè)面...

    Karuru 評(píng)論0 收藏0

  • JavaScript文章

    摘要：我對(duì)知乎前端相關(guān)問題的十問十答張?chǎng)涡駨場(chǎng)涡翊笊駥?duì)知乎上經(jīng)典的個(gè)前端問題的回答。作者對(duì)如何避免常見的錯(cuò)誤，難以發(fā)現(xiàn)的問題，以及性能問題和不好的實(shí)踐給出了相應(yīng)的建議。但并不是本身有問題，被標(biāo)準(zhǔn)定義的是極好的。 這一次，徹底弄懂 JavaScript 執(zhí)行機(jī)制 本文的目的就是要保證你徹底弄懂javascript的執(zhí)行機(jī)制，如果讀完本文還不懂，可以揍我。 不論你是javascript新手還是老...

    mumumu 評(píng)論0 收藏0

  • why nodejs

    摘要：一個(gè)快速計(jì)算假設(shè)每個(gè)線程可能有一個(gè)伴隨的內(nèi)存，運(yùn)行在具有的系統(tǒng)上，我們理論上最多有個(gè)并發(fā)連接，以及線程之間的上下文切換的成本。通過(guò)避免這一切，實(shí)現(xiàn)了超過(guò)個(gè)并發(fā)連接的可伸縮性級(jí)別作為概念驗(yàn)證。 通過(guò)近期的面試，我認(rèn)識(shí)到自己的學(xué)習(xí)方法還是有問題，面百度的時(shí)候面試官問我，為什么要用node，為什么不用php，對(duì)于只學(xué)過(guò)node幾天的我當(dāng)時(shí)就楞了，大概想到單線程事件輪詢和多線程，后來(lái)面試官告訴...

    wujl596 評(píng)論0 收藏0

  • 《從零構(gòu)建前后分離web項(xiàng)目》探究 - 深入聊聊前后分離架構(gòu)

    摘要：什么是前后分離前后端分離并不是什么新鮮事，到處都是前后端分離的實(shí)踐。然而一些歷史項(xiàng)目在從一體化設(shè)計(jì)轉(zhuǎn)向前后端分離的架構(gòu)時(shí)，不可避免的會(huì)遇到各種各樣的問題。搞了一個(gè)前后分離，需要分離部署。 探究 ：深入聊聊前后分離架構(gòu) 前后分離，一直是一個(gè)相當(dāng)泛泛的問題，前后分離到底好不好？沒有絕對(duì)的對(duì)，沒有絕對(duì)的錯(cuò)，業(yè)界就這個(gè)問題已經(jīng)激烈的探討幾年了.出現(xiàn)討論的點(diǎn)在于：分離當(dāng)然是好的,但是以什么樣的服...

    whinc 評(píng)論0 收藏0

發(fā)表評(píng)論

0條評(píng)論

最新活動(dòng)
閱讀需要支付1元查看
<