第章評(píng)價(jià)ai好壞的標(biāo)準(zhǔn)

3.1方法和字段簽名3.2文件及其內(nèi)容

3.3環(huán)境變量和命令行選項(xiàng)

3.4文本信息也是api3.5協(xié)議3.6行為3.7國(guó)際化支持和信息國(guó)際化第3章評(píng)價(jià)api好壞的標(biāo)準(zhǔn)3.8api的廣泛定義

3.9如何檢查api的質(zhì)量3.9.1可理解性3.9.2一致性

3.9.3可見(jiàn)性

3.9.4簡(jiǎn)單的任務(wù)應(yīng)該有簡(jiǎn)單的方案3.9.5保護(hù)投資評(píng)價(jià)api好壞的標(biāo)準(zhǔn)

API設(shè)計(jì)誤解：API只是加對(duì)類和方法提供說(shuō)明的JAVADOCAPI存在的原因：

可以將大塊的構(gòu)件“無(wú)序”地集合應(yīng)用程序構(gòu)件模塊：包括共享類庫(kù)、框架、預(yù)先定義的應(yīng)用程序框架、及上述的組合。每個(gè)API完全正確，程序集成工作就簡(jiǎn)單。不存在調(diào)試、、閱讀代碼、打補(bǔ)丁和如何設(shè)計(jì)。是“無(wú)緒”的編程

API構(gòu)件?？?/p>

構(gòu)件模塊：(1)共享類庫(kù)(2)框架(3)預(yù)先定義的應(yīng)用程序框架

(4)上述的組合。每個(gè)API完全正確，程序集成工作就簡(jiǎn)單。程序集成工作就簡(jiǎn)單表現(xiàn)：(1)不用閱讀代碼要求(2)不要編寫代碼(3)不用調(diào)試模塊功能

(4)不用打補(bǔ)丁3.1

方法和字段的簽名一個(gè)API是一堆類以及類方法和字段（屬性）的集合。涉及成員方法問(wèn)題：

涉及公共的成員，包括數(shù)據(jù)成員、受保護(hù)成員、私有成員。

如何訪問(wèn)成員涉及模塊內(nèi)部相關(guān)問(wèn)題。

對(duì)公共成員訪問(wèn)公開成員：對(duì)所有公共（公開）成員訪問(wèn)，只需要訪問(wèn)相應(yīng)的名稱對(duì)非公開的成員訪問(wèn)涉及比較復(fù)雜，非公開的成員（內(nèi)容），未公開的內(nèi)容簡(jiǎn)介不是API，表示它不外承諾兼容性。

未公開的內(nèi)容訪問(wèn)對(duì)非公開成員訪問(wèn)，一般使用反射技術(shù)來(lái)創(chuàng)建對(duì)象時(shí)，不需要知道具體類型，只需要的話字符串的方式傳入類的全名即可創(chuàng)建一個(gè)實(shí)例對(duì)象。反射是直接讀入dll或者對(duì)應(yīng)的庫(kù)，反射機(jī)制是取出模塊中所有的中間語(yǔ)言代碼

反射機(jī)制有兩個(gè)用處程序集設(shè)計(jì)者本身在程序集發(fā)布后由于某些需求想調(diào)用原先的私有方法，進(jìn)行某些操作程序集的使用者惡意的使用私有成員作一些本身outofscopebydesign的事情。反射可以訪問(wèn)對(duì)象所有成員當(dāng)然包括私有的，所以這種做法是很危險(xiǎn)的

3.2文件及其內(nèi)容應(yīng)用程序執(zhí)行時(shí)要讀寫的文件夾以及這些事文件的格式非常重要。配置信息也是一類重要的API。。對(duì)外通過(guò)虛擬方式提供配置文件可以保持一致性，這是配置文件很重要的優(yōu)點(diǎn)。

3.3環(huán)境變量和命令行選項(xiàng)環(huán)境變量和命令行界面作為上下文環(huán)境，對(duì)于功能的庫(kù)來(lái)說(shuō)，往往不是很重要。接口在特定環(huán)境下也是非常重要。不是所有的操作系統(tǒng)的都提供了環(huán)境變量方面的功能

Java處理方式缺少一種讀取環(huán)境變量的方法需要的讀取當(dāng)前的環(huán)境變量值，然后編寫腳本調(diào)用前面的所說(shuō)的那些命令取代方案：系統(tǒng)屬性。Java中的任何方法都是可以用調(diào)用System.getProperty方法，通過(guò)傳入一個(gè)字符串名稱來(lái)讀取與屬性相關(guān)的值。

3.4文本信息也是API很多程序不僅可以通過(guò)環(huán)境變量和命令行參數(shù)進(jìn)行控制，還可以向一段程序輸入一段文本作為參數(shù)并取得一個(gè)返回值。

Unixe

有一個(gè)很大的特點(diǎn)，就是它合用了管道技術(shù)。管道是從一個(gè)程序進(jìn)程向另一個(gè)程序進(jìn)單向傳送信息的技術(shù)。

toString方法的誤用toString返回的字符串URL格式，試圖讓用戶知道，如果不要取得路徑應(yīng)該調(diào)用getPath方法。程序員員想知道錯(cuò)誤發(fā)生的地方，只能得到到輸出的錯(cuò)誤信息，然后再去解析輸出設(shè)備的錯(cuò)誤文本信息。

3.5協(xié)議協(xié)議是針對(duì)文本內(nèi)容的API。它們用來(lái)定義網(wǎng)絡(luò)傳送中的信息格式，所以非常重要。協(xié)議訪問(wèn)控制問(wèn)題：對(duì)于一個(gè)對(duì)外開放的套接字來(lái)說(shuō)，其實(shí)訪問(wèn)是沒(méi)有辦法進(jìn)行控制的。另一個(gè)問(wèn)題是因使用網(wǎng)絡(luò)協(xié)議而被放大，每個(gè)網(wǎng)絡(luò)協(xié)議會(huì)有多種客房端，協(xié)議有多個(gè)版本和程序進(jìn)行交互，且這種多樣性還會(huì)不斷擴(kuò)散。3.牲5協(xié)議凝不一據(jù)致性漲問(wèn)題服務(wù)們器上鉆的Su召bv財(cái)er泄si咳on軟件蕉版本怒與客乞戶端刑計(jì)算米機(jī)上醋所使?jié)O用的蔑版本肢不一鋼致。版本漲不一旗致問(wèn)央題協(xié)議紐奉不一母致問(wèn)巖題。協(xié)議呼演進(jìn)嘩問(wèn)題辮。版骨本要補(bǔ)向后鋸兼容擴(kuò)張堪性和刮通用薦性問(wèn)耳題。3.奔6行為AP岸I可避免雨去了紀(jì)解一端個(gè)組襖件內(nèi)況部具原體實(shí)現(xiàn)稱，可以愚使用其他寒的黑阿盒程垃序模災(zāi)塊來(lái)組裝放自己的程負(fù)序。不論AP琴I的抽些象度候有多且好，AP爽I對(duì)應(yīng)柏的內(nèi)鐘部實(shí)現(xiàn)沿經(jīng)常會(huì)泄拖露具宵體的腿內(nèi)容遣。從敢而使綁得這蛇些內(nèi)著部實(shí)魚現(xiàn)也冬變成弟了AP鄉(xiāng)豐I的一部煤分對(duì)散外公主開盡管AP共I具體行為效很難睬控制袋，但宵它仍是AP悼I契約注中非別常重此要、骨甚至具最重若要的摔一部需分。育只有騎組件涉的行酬為能腦夠保圓證穩(wěn)蹤蝶定，年其用交戶在頓組裝無(wú)程序吊時(shí)，罩才能爺做到矮用“無(wú)勿緒”廟方式來(lái)替餐換一木個(gè)模舅塊。直。3.扛7國(guó)際知化支仙持和潮信息國(guó)際腎化很多AP鼓I設(shè)計(jì)菜，并湯不會(huì)浩考慮爐到所準(zhǔn)有人卷的需薦求不同陰的AP羞I會(huì)有辟不同柱的目帝標(biāo)受眾有人枯非常帖關(guān)注這些斗對(duì)于緩這些就是肝合適竭的、鎮(zhèn)感興侮趣的AP柔I。很多栗開發(fā)愛(ài)人員詳都是證針對(duì)萬(wàn)一個(gè)稍功能哨的類蘋庫(kù)進(jìn)踢行編廢碼的，從這樣慢的一躲個(gè)AP漁I普通精用戶純的角尸度來(lái)驅(qū)看，這是糕國(guó)際礙化信息宮中的壯鍵值強(qiáng)是一屢個(gè)底丙層的誤實(shí)現(xiàn)侄。。3.志8A相PI的廣威泛定元義AP供I遠(yuǎn)遠(yuǎn)絡(luò)不止節(jié)是類授、方刊法、祥函數(shù)剛和簽宋名這貌些東抬西。為了有利善于在哀“無(wú)角緒”偵的狀擊態(tài)下孕把一紙個(gè)大據(jù)的系孟統(tǒng)組鳴件集查成的逃方式扯拼裝享出來(lái)誓，從付這個(gè)敲角度未來(lái)看魚，AP快I的定愈義就郊非常鼠廣泛以，從磚簡(jiǎn)單錯(cuò)的文保本信節(jié)息到企那些稿復(fù)雜蠢或者揀很難劈燕控制散的組蕉件行榴為，互都可飯以算邁是AP折I。3.竊9如何役檢查AP誼I的質(zhì)舊量漂亮農(nóng)并不襲是衡欺量AP室I的唯咐一標(biāo)包準(zhǔn)。況工程舍的首均要目殃標(biāo)是者制作另可正歐常運(yùn)竹作的唱系統(tǒng)玻。我傘們應(yīng)典該設(shè)犬計(jì)易已于使張用、馳廣泛到接受鍛且富模有成焰效的AP慈I?？衫韮斀庑砸恢仑曅钥梢?jiàn)婆性3.對(duì)9.優(yōu)1可理惰解性AP璃I是設(shè)計(jì)焰者與璃開發(fā)欄人員熄之間巷交流希的途對(duì)徑后嘆者要槍根據(jù)鴿相應(yīng)示的的AP毒I提供洲具體椒實(shí)現(xiàn)泛。程桑序員朽的溝喝通方腹式就秘是AP誰(shuí)I。涉及建的概池念必苦須處最于用因戶的星視野掀范圍么內(nèi)，午否則誰(shuí)他們蹲就無(wú)違法理央解這膀些概閣念。AP私I設(shè)計(jì)瞎者需押要理兵解其嘗目標(biāo)母用戶植普遍辰上具易有的弊知識(shí)懇，并粉且在睛此類務(wù)知識(shí)康的基分礎(chǔ)上葡設(shè)計(jì)AP剪I?？衫硖幗庑蚤_始辭人員薄都使賤用過(guò)海大部巾分Ja擺va的類凝庫(kù)因憂此也殖了解呼其涉商及的叛概念碎。很多AP爸I用戶陣都會(huì)想去找益一個(gè)鑰現(xiàn)有稿的程融序，衛(wèi)這個(gè)醫(yī)程序嫂的功嘗能要妹與現(xiàn)斃在要添開發(fā)晃的功沫能比顧較相石似，廚然后個(gè)把這錦個(gè)程唇序的伶代碼魔復(fù)制勿過(guò)來(lái)朽，再股加以隔調(diào)整毛來(lái)完本成自雞己現(xiàn)遵在開濕發(fā)的氧功能。那換么提花向大量加的例鐮子能參夠有以效地請(qǐng)幫助鴉大家范使用AP良I3.惡9.梳2一致視性AP叼I有不肉念舊口惡很總重要岔的評(píng)冰價(jià)標(biāo)嫂準(zhǔn)，催而且負(fù)也很啟容易集進(jìn)行炭檢查絕，那粉就是深一致谷性。在整恭個(gè)AP壩I的開欣發(fā)過(guò)堆程中價(jià)最好抓保持尸一致搞性的緞風(fēng)格沃，至盒少對(duì)AP金I進(jìn)行盟演進(jìn)憶時(shí)一周定要蠻保持便一致茅。3.汁9.漸3可見(jiàn)向性有人京想使甚用某指?jìng)€(gè)AP飯I，但轟根本膝找不欠到這挖個(gè)AP旺I，或驅(qū)者很熄難清螺楚地拒了解劉這個(gè)AP火I如何病使用棗，那來(lái)么這刃個(gè)AP注I再漂彼亮也耽沒(méi)什收么用莫。為什件么時(shí)途候開素源軟妨件如好此成權(quán)功，幻玉因?yàn)槊C在使平用開言源軟雄件時(shí)卡，通陪常只驗(yàn)需要傻把現(xiàn)嘴有的虧一些被源代以碼復(fù)嚇制過(guò)悔來(lái)就日可以嫂開始臨工作鋪了。有一撒個(gè)入候口來(lái)邀作為押用戶悲開始礦使用AP圾I的起愈點(diǎn)為薯，可畫以幫零助用闊戶找費(fèi)到正避確的略方式思來(lái)解淋決他李們的善問(wèn)題伍。3.伯9.樣4簡(jiǎn)單丈任務(wù)應(yīng)該舊有簡(jiǎn)單孫方案不同讓用戶群共資用一傳個(gè)AP虎I。設(shè)侮計(jì)AP啄I時(shí)最米容易嗓也是斧最常脅犯的梅錯(cuò)誤莫就是燃把針晨對(duì)不磁同受貨眾的弄功能基都放蛛在不一娃個(gè)AP罩I中。降體低程序隸員的慮可見(jiàn)淚性，談某些勒開發(fā)警人員疊只關(guān)涼心AP飲I某一釋方面洪的功裂能。常用語(yǔ)團(tuán)方案飼是把一誰(shuí)個(gè)AP禮I分解敗成兩預(yù)個(gè)或損者多歐個(gè)組光成部助分：縮慧一部荷分是針取對(duì)調(diào)用文功能愉的開浸發(fā)人母員，候而另叔一部井分則鏟應(yīng)該多放在組貿(mào)易右逆差慎的包極中，付或者獄有其沖特有姓的命神名空朋間，鏡用來(lái)方便慕擴(kuò)展當(dāng)前僑模塊遮的功家能3.迫9.柔5保護(hù)漫投資要使成用一嚴(yán)個(gè)類峽庫(kù)，潛那么至就要管去了綁解它常，砍鉛它能奔?jí)驕p聞少自伏己的濾工作悼量，卷而不態(tài)是帶古來(lái)更兄多的唐問(wèn)題冶。對(duì)獄于AP燙I設(shè)計(jì)太者來(lái)億說(shuō)，植首要釀的任的務(wù)就供是要熱保護(hù)廁其用偽