chinese直男口爆体育生外卖, 99久久er热在这里只有精品99, 又色又爽又黄18禁美女裸身无遮挡, gogogo高清免费观看日本电视,私密按摩师高清版在线,人妻视频毛茸茸,91论坛 兴趣闲谈,欧美 亚洲 精品 8区,国产精品久久久久精品免费

0
  • 聊天消息
  • 系統(tǒng)消息
  • 評(píng)論與回復(fù)
登錄后你可以
  • 下載海量資料
  • 學(xué)習(xí)在線(xiàn)課程
  • 觀(guān)看技術(shù)視頻
  • 寫(xiě)文章/發(fā)帖/加入社區(qū)
會(huì)員中心
創(chuàng)作中心

完善資料讓更多小伙伴認(rèn)識(shí)你,還能領(lǐng)取20積分哦,立即完善>

3天內(nèi)不再提示

真刀真槍模塊化(2)—圖解Service模型

電子設(shè)計(jì) ? 作者:電子設(shè)計(jì) ? 2020-12-14 22:38 ? 次閱讀
加入交流群
微信小助手二維碼

掃碼添加小助手

加入工程師交流群

作者: GorgonMeducer 傻孩子
首發(fā):裸機(jī)思維

【說(shuō)在前面的話(huà)】

在前面一篇文章《真刀真槍模塊化(1)——一本糊涂賬》中,我們討論了:

在工程開(kāi)發(fā)中進(jìn)行模塊化的本來(lái)目的——為了復(fù)用已有的代碼,節(jié)省當(dāng)前項(xiàng)目的開(kāi)發(fā)時(shí)間;

實(shí)際操作過(guò)程中遇到的尷尬問(wèn)題——模塊的具體實(shí)現(xiàn)原本應(yīng)該被視作黑盒子,程序員因?yàn)楦鞣N心理上的原因要閱讀代碼;

以及

“原則上”的解決方案——嚴(yán)禁程序員在項(xiàng)目開(kāi)發(fā)過(guò)程中閱讀模塊的具體實(shí)現(xiàn)代碼。

道理說(shuō)起來(lái)簡(jiǎn)單,真要實(shí)際操作起來(lái),一線(xiàn)開(kāi)發(fā)人員往往會(huì)直搖頭:手中已有的所謂“模塊”質(zhì)量參差不齊、模塊的開(kāi)發(fā)者魚(yú)龍混雜、很多模塊別說(shuō)出了問(wèn)題要找開(kāi)發(fā)方負(fù)責(zé)維護(hù)了,就是原作者是誰(shuí)恐怕都找不到了——在這種情況下,大談“禁止開(kāi)發(fā)人員閱讀模塊的實(shí)現(xiàn)代碼”,簡(jiǎn)直就是天方夜譚,頗有幾分“何不食肉糜”的傲慢。
——難道模塊化本身錯(cuò)了么?實(shí)際情況并非如此,這里傻孩子忍不住想“感慨”兩句:在追求和實(shí)踐新的方法(論)的時(shí)候,總難免會(huì)遇到這樣那樣的困難,有的困難甚至讓整個(gè)方案看起來(lái)“完全行不通”——在這種時(shí)候,如果立即退出來(lái)將整個(gè)方法全盤(pán)否定,就會(huì)失去寶貴的前進(jìn)機(jī)會(huì)。
在模塊化的過(guò)程中,要想發(fā)揮模塊化“復(fù)用已有代碼”、“降低開(kāi)發(fā)時(shí)間”的作用,就必須將模塊視作黑盒子;一旦模塊被視作黑盒子,實(shí)現(xiàn)的質(zhì)量和后續(xù)的可靠維護(hù)就成為當(dāng)前模塊是否可用的基石——進(jìn)一步來(lái)說(shuō),不靠譜的代碼實(shí)現(xiàn)和差強(qiáng)人意的接口設(shè)計(jì)與封裝是導(dǎo)致模塊化失敗的根本原因。
本文將為您介紹一種模塊化封裝的簡(jiǎn)單操作方式——由傻孩子根據(jù)十多年工程實(shí)踐經(jīng)驗(yàn)總結(jié)、歷經(jīng)無(wú)數(shù)商業(yè)項(xiàng)目的千錘百煉。通過(guò)這一方式構(gòu)建的模塊,我稱(chēng)之為服務(wù)(Service),因此,這里所要介紹的模型又被稱(chēng)之為“Service模型”。

【正文】

從具體操作層面來(lái)說(shuō),所謂Service模型并不復(fù)雜。
首先,每一個(gè)模塊都有一個(gè)屬于自己的專(zhuān)門(mén)的文件夾,文件夾的名稱(chēng)與模塊名相同:

其次,每一個(gè)模塊中都有一個(gè)專(zhuān)門(mén)的頭文件,用于提供給模塊的使用者來(lái)包含(#include);該頭文件的名稱(chēng)必須與模塊的名稱(chēng)相同。

需要特別強(qiáng)調(diào)和說(shuō)明的是:

該頭文件用于“從模塊內(nèi)部向模塊外部”提供使用模塊所必須的“最小信息”;

任何人要使用模塊,必須且只能包含該頭文件;

我們把這類(lèi)向模塊的使用者提供必要信息的頭文件稱(chēng)之為接口頭文件;

接口頭文件遵循“最小信息公開(kāi)原則”,即,該頭文件中只存放用戶(hù)使用模塊最少最少所必須知道的信息。實(shí)際操作中,類(lèi)型定義、宏定義、函數(shù)和全局變量聲明都應(yīng)該首先放置在對(duì)應(yīng)的源代碼中(或是后面會(huì)提到的模塊內(nèi)私有的接口頭文件中);當(dāng)且僅當(dāng)我們發(fā)現(xiàn)用戶(hù)要使用模塊的某一功能必須要用到某一信息時(shí),才“極不情愿”地、“摳門(mén)”的、且盡可能將其它能剝離和隱藏的信息剝離開(kāi)后,放置到接口頭文件中。

與接口頭文件相對(duì),每一個(gè)模塊內(nèi)部都會(huì)有一個(gè)專(zhuān)門(mén)的頭文件用于實(shí)現(xiàn)對(duì)模塊的配置:

該頭文件用于“從模塊外部向模塊內(nèi)部”輸入配置信息;

如無(wú)特殊說(shuō)明或安排,該頭文件應(yīng)該固定命名為 app/_cfg.h(沒(méi)有額外的前綴和后綴);

如無(wú)特殊說(shuō)明或安排,該頭文件應(yīng)該僅包含配置信息,例如:宏定義、類(lèi)型定義(在極其特殊的情況下,偶爾出現(xiàn)的全局變量或者函數(shù)聲明);

我們把這類(lèi)頭文件稱(chēng)之為“配置頭文件”;

在構(gòu)建和使用模塊的時(shí)候,無(wú)論是模塊的設(shè)計(jì)者還是模塊的使用者,都應(yīng)該遵循黑盒子原則,在操作上表現(xiàn)為——模塊的使用者不應(yīng)該修改任何位于模塊文件夾內(nèi)部的內(nèi)容——模塊文件夾既是黑盒子的容器,也是黑盒子的邊界。
為了遵守這一原則,模塊內(nèi)部的配置頭文件實(shí)際上是不允許用戶(hù)去修改的——那么這又如何讓用戶(hù)更改對(duì)模塊的各個(gè)配置選項(xiàng)呢?答案很簡(jiǎn)單,如下圖所示:模塊內(nèi)部的app/_cfg.h 在文件的一開(kāi)始會(huì)首先包含上一級(jí)目錄的app/_cfg.h。

為了實(shí)現(xiàn)這一點(diǎn),一個(gè)模塊內(nèi)部 app/_cfg.h 的固定內(nèi)容格式為:

//!作為模塊的用戶(hù),不要修改這里的任何內(nèi)容

一個(gè)模塊的接口頭文件,其內(nèi)部格式可能為:

//!作為模塊的用戶(hù),不要修改這里的任何內(nèi)容

可以很容易注意到,當(dāng)使用某一模塊時(shí),用戶(hù)可以很方便的在模塊外部定義一個(gè)屬于自己的 app/_cfg.h 來(lái)向模塊提供配置信息——而無(wú)論如何修改這一文件,都不會(huì)破壞黑盒子本身的內(nèi)容。
再次,一個(gè)模塊往往擁有一個(gè)或多個(gè)C源文件,它只需要包含模塊的接口頭文件,就可以共享一些“對(duì)外公開(kāi)的信息”。

這里有個(gè)朋友會(huì)問(wèn)了:根據(jù)最小信息公開(kāi)原則,接口頭文件中只包含了一些最小信息,如果模塊內(nèi)的多個(gè)C源文件之間需要共享一些非公開(kāi)的私有信息,該怎么處理呢?
為了解決這一問(wèn)題,我們一般會(huì)引入一個(gè)以雙下劃線(xiàn)為前綴的接口頭文件(比如,叫做/_/_common.h),并視其為模塊的私有財(cái)產(chǎn)。如下圖所示,這一頭文件是僅供模塊內(nèi)的源代碼包含的——無(wú)論是模塊的接口頭文件還是模塊的配置頭文件都不應(yīng)該對(duì)其進(jìn)行包含——以防信息泄露:

一個(gè)典型的 /_/_common.h 內(nèi)容如下:

/*!作為模塊的用戶(hù),不要修改這里的任何內(nèi)容,理論上也不應(yīng)該關(guān)心這

基于這一規(guī)則,模塊內(nèi)一個(gè)可能的C源文件內(nèi)容如下:

//! 作為模塊的用戶(hù),不要修改這里的任何內(nèi)容

最后,一個(gè)模塊內(nèi)是允許包含其它子模塊的,對(duì)于這種嵌套情況,僅需要兩步驟就可以完成部署:

將子模塊拷貝到父模塊中,或者按照前述的模塊構(gòu)建規(guī)則,在父模塊中建立一個(gè)子模塊;

父模塊的接口頭文件包含子模塊的接口頭文件

少數(shù)情況下,如果子模塊與父模塊高度耦合(一般來(lái)說(shuō)就是在父模塊中從頭開(kāi)始建立一個(gè)新的子模塊時(shí)會(huì)發(fā)生這種情況)——比如子模塊依賴(lài)父模塊的 /_/_common.h 中提供的信息,則應(yīng)該在子模塊中也建立一個(gè) /_/_common.h,并仿照 app/_cfg.h 的做法,在頭文件的一開(kāi)始首先向上包含父模塊的 /_/_common.h;

如果父模塊包含/_/_common.h,而子模塊并不需要這一信息,則子模塊無(wú)需在做任何特殊修改。

對(duì)app/_cfg.h來(lái)說(shuō),由于子模塊原本就會(huì)自動(dòng)包含上一級(jí)的app/_cfg.h,因此,我們無(wú)須做任何特殊操作,子模塊就可以透過(guò)父模塊的app/_cfg.h自動(dòng)從外界獲取配置信息——這就像是一種標(biāo)準(zhǔn)化的水管安裝。

以上就是使用Service模型進(jìn)行模塊化的基本規(guī)則。是不是很簡(jiǎn)單?

【后記】

Service模型本身是完全本著簡(jiǎn)化用戶(hù)操作的宗旨,以實(shí)用性為重中之重,同時(shí)也避免一切“反直覺(jué)”的設(shè)定。
對(duì)用戶(hù)來(lái)說(shuō),這一模型是非常友好的:

只需要拷貝模塊目錄就可以完成部署;

只需要在模塊的外部額外添加一個(gè)app/_cfg.h就可以實(shí)現(xiàn)對(duì)模塊的配置;

所有關(guān)于模塊的使用信息(使用說(shuō)明書(shū))都放置在一個(gè)唯一的、與模塊同名的接口頭文件中;且這里包含的信息對(duì)用戶(hù)來(lái)說(shuō)都是可用的(沒(méi)有無(wú)用信息,也沒(méi)有多余信息);

對(duì)模塊的開(kāi)發(fā)者來(lái)說(shuō):

這一模型是高度遵守黑盒子原則的;

用戶(hù)使用模塊,是不需要“用臟手染指”自己寶貴的代碼的(無(wú)需修改);

對(duì)制作 Library 非常友好,只需要保留接口頭文件,而將其它所有文件(包括源代碼和私有接口頭文件)刪除并保留一個(gè)固化好的app/_cfg.h即可。

模塊是非常容易遷移和嵌套的。

當(dāng)然,這一Service模型也有一個(gè)小缺點(diǎn)(可能有些人也對(duì)此無(wú)法容忍),即,用某些工程管理工具將頭文件的包含關(guān)系展開(kāi)時(shí),通常會(huì)看到海量的app/_cfg.h(盡管他們內(nèi)部都使用了模塊特有的保護(hù)宏進(jìn)行區(qū)別)——對(duì)于這一問(wèn)題,在真刀真槍模塊化的后續(xù)內(nèi)容中,將提供一個(gè)較為完美的解決方案,這里就先賣(mài)個(gè)關(guān)子——對(duì)普通用戶(hù)來(lái)說(shuō),現(xiàn)有的Service模型足夠了。

審核編輯 黃昊宇

聲明:本文內(nèi)容及配圖由入駐作者撰寫(xiě)或者入駐合作網(wǎng)站授權(quán)轉(zhuǎn)載。文章觀(guān)點(diǎn)僅代表作者本人,不代表電子發(fā)燒友網(wǎng)立場(chǎng)。文章及其配圖僅供工程師學(xué)習(xí)之用,如有內(nèi)容侵權(quán)或者其他違規(guī)問(wèn)題,請(qǐng)聯(lián)系本站處理。 舉報(bào)投訴
  • 模型
    +關(guān)注

    關(guān)注

    1

    文章

    3521

    瀏覽量

    50444
  • Service
    +關(guān)注

    關(guān)注

    0

    文章

    31

    瀏覽量

    14097
收藏 人收藏
加入交流群
微信小助手二維碼

掃碼添加小助手

加入工程師交流群

    評(píng)論

    相關(guān)推薦
    熱點(diǎn)推薦

    新品推薦|模塊化集成式高速連接器

    LRM連接器隨著電子技術(shù)的快速發(fā)展,在電力傳輸、工業(yè)自動(dòng)、航空航天等領(lǐng)域,對(duì)高效、穩(wěn)定、可靠的電氣連接解決方案的需求日益增長(zhǎng)。因此日晟萬(wàn)晟開(kāi)發(fā)了新一代模塊化集成式高速連接器-LRM系列,該款連接器
    的頭像 發(fā)表于 07-07 18:15 ?149次閱讀
    新品推薦|<b class='flag-5'>模塊化</b>集成式高速連接器

    鴻蒙5開(kāi)發(fā)寶藏案例分享---模塊化設(shè)計(jì)案例分享

    鴻蒙模塊化開(kāi)發(fā)大揭秘!官方隱藏案例實(shí)戰(zhàn)指南 大家好呀! 最近在HarmonyOS文檔里挖到一個(gè)寶藏——官方其實(shí)藏了大量模塊化設(shè)計(jì)案例!很多小伙伴可能沒(méi)注意到,今天我就帶大家手把手拆解這些黃金實(shí)踐,附
    發(fā)表于 06-12 16:17

    原理圖模塊化,BOM 物料位號(hào)處理

    原理圖模塊化,把常用的模塊保存成一個(gè)PART(在TOOL 菜單下 選擇 Generate Part)。保存成OLB格式。使用的時(shí)候,就像使用元器件一樣,從庫(kù)里面拖出來(lái)直接放到原理圖上即可。 問(wèn)題是
    發(fā)表于 06-09 19:27

    MCU-40型自動(dòng)測(cè)量是如何實(shí)現(xiàn)分布式模塊化?

    在巖土工程、大型基建和能源設(shè)施的安全監(jiān)測(cè)中,傳統(tǒng)的集中式數(shù)據(jù)采集系統(tǒng)往往面臨布線(xiàn)復(fù)雜、擴(kuò)展性差、容錯(cuò)率低等挑戰(zhàn)。南京峟思工程儀器有限公司推出的MCU-40型自動(dòng)測(cè)量系統(tǒng),憑借其創(chuàng)新的分布式模塊化
    的頭像 發(fā)表于 04-10 14:03 ?270次閱讀
    MCU-40型自動(dòng)測(cè)量是如何實(shí)現(xiàn)分布式<b class='flag-5'>模塊化</b>?

    MCU分布式模塊化自動(dòng)測(cè)量單元:數(shù)據(jù)傳輸與處理能力如何?

    在現(xiàn)代工程監(jiān)測(cè)中,MCU分布式模塊化自動(dòng)測(cè)量單元(MCU)以其靈活的配置和強(qiáng)大的數(shù)據(jù)處理能力,成為了各類(lèi)安全監(jiān)測(cè)項(xiàng)目的理想選擇。本文將深入探討MCU的工作原理、數(shù)據(jù)傳輸方式以及其在實(shí)際應(yīng)用中的優(yōu)勢(shì)
    的頭像 發(fā)表于 03-12 14:09 ?409次閱讀
    MCU分布式<b class='flag-5'>模塊化</b>自動(dòng)測(cè)量單元:數(shù)據(jù)傳輸與處理能力如何?

    重磅新品|CMW系列模塊化連接器

    模塊化連接器產(chǎn)生背景隨著人們不斷追求產(chǎn)品功能的多樣性和極致性能,產(chǎn)品不斷的更新迭代,連接器作為測(cè)試物與被測(cè)設(shè)備之間的橋梁,測(cè)試需求也隨著功能的增加不斷變化。在過(guò)去,傳統(tǒng)的連接器雖然在一定程度上滿(mǎn)足了
    的頭像 發(fā)表于 02-06 09:14 ?1037次閱讀
    重磅新品|CMW系列<b class='flag-5'>模塊化</b>連接器

    原理圖模塊化,BOM 物料位號(hào)處理

    原理圖模塊化,BOM 物料位號(hào)的處理問(wèn)題 原理圖模塊化,把常用的模塊保存成一個(gè)PART(在TOOL 菜單下 選擇 Generate Part)。保存成OLB格式。使用的時(shí)候,就像使用元器件一樣,從
    發(fā)表于 01-03 08:22

    華為預(yù)制模塊化數(shù)據(jù)中心連續(xù)十年蟬聯(lián)全球第一

    近日,第三方國(guó)際權(quán)威機(jī)構(gòu)Omdia發(fā)布《2023全球預(yù)制模塊化數(shù)據(jù)中心報(bào)告》,對(duì)全球預(yù)制模塊化數(shù)據(jù)中心市場(chǎng)動(dòng)態(tài)、市場(chǎng)份額、發(fā)展趨勢(shì)進(jìn)行洞察和分析。報(bào)告顯示,2023年華為預(yù)制模塊化數(shù)據(jù)中心位居全球市場(chǎng)份額第一,至今已連續(xù)十年蟬聯(lián)
    的頭像 發(fā)表于 12-31 11:41 ?878次閱讀

    全球第四 科華數(shù)據(jù)蟬聯(lián)全球模塊化UPS榜單

    近日,第三方權(quán)威機(jī)構(gòu)Omdia發(fā)布《2024全球模塊化UPS市場(chǎng)報(bào)告》,對(duì)全球模塊化UPS市場(chǎng)動(dòng)向、市場(chǎng)份額及發(fā)展趨勢(shì)等進(jìn)行了分析與洞察。報(bào)告顯示,作為模塊化UPS的創(chuàng)新引領(lǐng)者,科華數(shù)據(jù)在2023年
    的頭像 發(fā)表于 12-13 14:51 ?1023次閱讀
    全球第四 科華數(shù)據(jù)蟬聯(lián)全球<b class='flag-5'>模塊化</b>UPS榜單

    模塊化示波器的技術(shù)原理和應(yīng)用

    模塊化示波器是一種用于信息科學(xué)與系統(tǒng)科學(xué)領(lǐng)域的電子測(cè)量?jī)x器,以下是對(duì)其技術(shù)原理及應(yīng)用的詳細(xì)闡述:一、技術(shù)原理 信號(hào)轉(zhuǎn)換與顯示: 模塊化示波器利用電子示波管的特性,將肉眼無(wú)法直接觀(guān)測(cè)的交變電
    發(fā)表于 12-11 14:20

    模塊化儀器的技術(shù)原理和應(yīng)用場(chǎng)景

    模塊化儀器是插拔式的計(jì)算機(jī)板卡,功能類(lèi)似于傳統(tǒng)的臺(tái)式儀器,其技術(shù)原理和應(yīng)用場(chǎng)景可以歸納如下:一、技術(shù)原理 模塊化設(shè)計(jì):模塊化儀器使用一個(gè)框架,可以將不同類(lèi)型或不同數(shù)量的功能卡插入其中,從而適應(yīng)一系列
    發(fā)表于 11-28 15:09

    銘普推出創(chuàng)新模塊化儲(chǔ)能系統(tǒng)

    銘普公司在通信網(wǎng)絡(luò)能源領(lǐng)域深耕多年,近日成功推出了一款創(chuàng)新的模塊化儲(chǔ)能系統(tǒng),為5G基站節(jié)費(fèi)提供了有力支持。
    的頭像 發(fā)表于 10-30 17:27 ?705次閱讀

    模塊化插座接線(xiàn)方法有哪些

    模塊化插座,也稱(chēng)為模塊化電源插座或模塊化PDU(Power Distribution Unit),是一種可以根據(jù)需要靈活配置電源插座和接口的設(shè)備。這種設(shè)計(jì)允許用戶(hù)根據(jù)具體的用電需求,選擇不同的
    的頭像 發(fā)表于 10-18 09:50 ?1900次閱讀

    通信設(shè)備安全引發(fā)全球關(guān)注!國(guó)產(chǎn)替代迫在眉睫

    在當(dāng)今這個(gè)復(fù)雜多變的國(guó)際局勢(shì)中,沖突的形式不在局限于軍事對(duì)抗。隨著科技的飛速發(fā)展,遠(yuǎn)程網(wǎng)絡(luò)攻擊正悄然成為最令人畏懼的“武器”之一。與真刀真槍的物理攻擊相比,這種無(wú)形的威脅更加難以預(yù)測(cè)和防范,其潛在
    的頭像 發(fā)表于 10-12 10:25 ?824次閱讀
    通信設(shè)備安全引發(fā)全球關(guān)注!國(guó)產(chǎn)<b class='flag-5'>化</b>替代迫在眉睫

    研華工控機(jī)的模塊化設(shè)計(jì),復(fù)雜應(yīng)用場(chǎng)景的靈活解決方案!

    工控機(jī)模塊化設(shè)計(jì)是工業(yè)自動(dòng)和嵌入式系統(tǒng)領(lǐng)域的重要趨勢(shì)。靈活、可擴(kuò)展的設(shè)計(jì),使得用戶(hù)可以根據(jù)實(shí)際需求,選擇合適的模塊進(jìn)行組合,形成高度定制的工控機(jī)產(chǎn)品,從而滿(mǎn)足不斷變化的市場(chǎng)需求和復(fù)
    的頭像 發(fā)表于 09-07 09:58 ?743次閱讀
    研華工控機(jī)的<b class='flag-5'>模塊化</b>設(shè)計(jì),復(fù)雜應(yīng)用場(chǎng)景的靈活解決方案!