成人免费xxxxx在线视频软件_久久精品久久久_亚洲国产精品久久久_天天色天天色_亚洲人成一区_欧美一级欧美三级在线观看

你知道如何寫一個框架嗎?詳細步驟放送

開發 后端 架構
作者也沒寫過什么框架,只是分享一些自己的理解,拋磚引玉罷了。如果你寫過一些框架可能會產生一些共鳴歡迎討論,如果你正在寫或正打算寫一個框架可能會給你一些啟發。本文以為較長可能會分多個篇博客來寫,現在能想到的是主要分為步驟、模式兩部分。如果你覺得好,按一個推薦舉手之勞讓更多的人可以看到。寫本文的時候作者完全是把腦子里的東西寫了出來,沒有參考任何的資料,所以對于每一項內容可能都是不完整的,不能作為一個完整的參考。有一些方法學的東西每個人都有自己的喜好,沒有覺得的對和錯。
定位

所謂定位就是回答幾個問題,我出于什么目的要寫一個框架,我的這個框架是干什么的,有什么特性適用于什么場景,我的這個框架的用戶對象是誰,他們會怎么使用,框架由誰維護將來怎么發展等等。

  1. 如果你打算寫框架,那么肯定心里已經有一個初步的定位,比如它是一個緩存框架、Web MVC框架、IOC框架、ORM/數據訪問框架、RPC框架或是一個用于Web開發的全棧式框架。
  2. 是 否要重復造輪子?除非是練手項目,一般我們是有了解決不了問題的時候才會考慮不使用既有的成熟的框架而重復造輪子的,這個時候需要列出新框架主要希望解決 什么問題。有關是否應該重復造輪子的話題討論了很多,我的建議是在把問題列清后進行簡單的研究看看是否可以通過擴展現有的框架來解決這個問題。一般而言大 部分成熟的框架都有一定的擴展和內部組件的替換能力,可以解決大部分技術問題,但在如下情況下我們可能不得不自己去寫一個框架,比如即使通過擴展也無法滿 足技術需求、安全原因、需要更高的生產力、需要讓框架和公司內部的流程更好地進行適配、開源的普適框架無法滿足性能需求、二次開發的成本高于重新開發的成 本等等。
  3. 主打輕量級?輕量級是很多人打算自己寫一個新框架的原因,但我們要明白,大部分項目在一開始的時候其實都是輕量級的,隨著框架 的用戶越來越多,它必定需要滿足各種奇怪的需求,在經過了無數次迭代之后,框架的主線流程就會多很多擴展點、檢測點,這樣框架勢必變得越來越重(從框架的 入口到框架的工作結束的方法調用層次越來越多,勢必框架也就越來越慢),如果你打算把框架定位于一個輕量級的框架的話,那么在今后的迭代過程中需要進行一 些權衡,在心中有堅定的輕量級的理念的同時不斷做性能測試來確保框架的輕量,否則隨著時間的發展框架可能會越來越重進而偏離了開始的定位。
  4. 特性?如果你打算寫一個框架,并且只有輕量級這一個理由的話,你或許應該再為自己的框架想一些新特性,就像做一個產品一樣,如果找不出兩個以上的亮點,那么這個產品不太可能成功,比如你的新框架可以是一個零配置的框架,可以是一個前端開發也能用的后端框架。
  5. 其它?一般來說框架是給程序員使用的,我們要考慮框架使用的頻度是怎么樣的,這可能決定的框架的性能需求和穩定性需求。還有,需要考慮框架將來怎么發展,是希望走開源路線還是商業路線。當然,這些問題也可以留到框架有一個大致的結構后再去考慮。

我們來為本文模擬一個場景,假設我們覺得現有的Spring MVC等框架開發起來效率有點低,打算重復造輪子,對于新框架的定位是一個給Java程序員使用的輕量級的、零配置的、易用的、易擴展的Web MVC框架。


調研

雖然到這里你已經決定去寫一個框架了,但是在著手寫之前還是至少建議評估一下市面上的類似(成熟)框架。需要做的是通讀這些框架的文檔以及閱讀一些源碼,這么做有幾個目的:

  1. 通過分析現有框架的功能,可以制定出一個新框架要實現的功能列表。
  2. 通過分析現有框架的問題,總結出新框架需要避免的東西和改善的地方。
  3. 通過閱讀現有框架的源碼,幫助自己理清框架的主線流程為總體設計做鋪墊(后面總體設計部分會更多談到)。
  4. 如果能充分理解現有的框架,那么你就是站在巨人的肩膀上寫框架,否則很可能就是在井底造輪子。

新 開發一個框架的好處是沒有兼容歷史版本的包袱,但是責任也同樣重大,因為如果對于一開始的定位或設計工作沒有做好的話,將來如果要對格局進行改變就會有巨 大的向前兼容的包袱(除非你的框架沒有在任何正式項目中使用),兼容意味著框架可能會越來越重,可能會越來越難看,閱讀至少一到兩個開源實現,做好充分的 調研工作可以使你避免犯大錯。

假設我們評估了一些主流框架后已經很明確,我們的MVC框架是一個Java平臺的、基于Servlet的輕量級的Web MVC框架,主要的理念是約定優于配置,高內聚大于低耦合,提供主流Web MVC框架的大部分功能,并且易用方面有所創新,新特性體包括:

  1. 起手零配置,總體上約定由于配置,即使需要擴展配置也支持通過代碼和配置文件兩種方式進行配置。
  2. 除了Servlet之外不依賴其它類庫,支持通過插件方式和諸如Spring等框架進行整合。
  3. 更優化的項目結構,不需要按照傳統的Java Web項目結構那樣來分離代碼和WEB-INF,視圖可以和代碼在一起,閱讀代碼更便利。
  4. 攔截器和框架本身更緊密,提供Action、Controller和Global三個級別的"攔截器"(或者說過濾器)。
  5. 豐富的Action的返回值,返回的可以是視圖、可以是重定向、可以是文件、可以是字符串、可以是Json數據,可以是Javascript代碼等等。
  6. 支持針對測試環境自動生成測試的視圖模型數據,以便前端和后端可以同時開發項目。
  7. 支持在開發的時候自動生成路由信息、模型綁定、異常處理等配置的信息頁面和調試頁面,方便開發和調試。

提供一套通用的控件模版,使得,并且支持多種模版引擎,比如Jsp、Velocity、Freemarker、Mustache等等。

嗯,看上去挺誘人的,這是一個不錯的開端,如果你要寫的框架自己都不覺得想用的話,那么別人就更不會有興趣來嘗試使用你的框架了。

#p#
解決難點

之 所以把解決難點放在開搞之前是因為,如果實現這個框架的某些特性,甚至說實現這個框架的主流程有一些核心問題難以解決,那么就要考慮對框架的特性進行調 整,甚至取消框架的開發計劃了。有的時候我們在用A平臺的時候發現一個很好用的框架,希望把這個框架移植到B平臺,這個想法是好的,但之所以在這以前這么 多年沒有人這么干過是因為這個平臺的限制壓根不可能實現這樣的東西。比如我們要實現一個MVC框架,勢必需要依賴平臺提供的反射特性,如果你的語言平臺壓 根就沒有運行時反射這個功能,那么這就是一個非常難以解決的難點。又比如我們在某個平臺實現一個類似于.NET平臺Linq2Sql的數據訪問框架,但如 果這個目標平臺的開發語言并不像C#那樣提供了類型推斷、匿名類型、Lambda表達式、擴展方法的話那么由于語法的限制你寫出來的框架在使用的時候是無 法像.NET平臺Linq2Sql那樣優雅的,這就違背了實現框架的主要目的,實現新的框架也就變得意義不大了。

對于我們要實現的MVC框 架貌似不存在什么根本性的無法解決的問題,畢竟在Java平臺已經有很多可以參考的例子了。如果框架的實現總體上沒什么問題的話,就需要逐一評估框架的這 些新特性是否可以解決。建議對于每一個難點特性做一個原型項目來證明可行,以免在框架實現到一半的時候發現有無法解決的問題就比較尷尬了。

分析一下,貌似我們要實現的這8大特性只有第1點要研究一下,看看如何免配置通過讓代碼方式讓我們的Web MVC框架可以和Servlet進行整合,如果無法實現的話,我們可能就需要把第1點特性從零配置改為一分鐘快速配置了。


開搞

首先需要給自己框架取一個名字,取名要考慮到易讀、易寫、易記,也需要盡量避免和市面上其它產品的名字重復,還有就是最好不要起一個侮辱其它同類框架的名字以免引起公憤。
如果將來打算把項目搞大的話,可以提前注冊一下項目的相關域名,畢竟現在域名也便宜,避免到時候項目名和域名差距很大,或項目的.com或.org域名對應了一個什么不太和諧的網站這就尷尬了。
然后就是找一個地方來托管自己的代碼,如果一開始不希望公開代碼的話,最好除了本地源代碼倉庫還有一個異地的倉庫以免磁盤損壞導致抱憾終身,當然如果不怕出丑的話也可以在起步的時候就使用Github等網站來托管自己的代碼。

#p#
總體設計

對 于總體設計我的建議是一開始不一定需要寫什么設計文檔畫什么類圖,因為可能一開始的時候無法形成這么具體的概念,我們可以直接從代碼開始做第一步。框架的 使用者一般而言還是開發人員,拋開框架的內在的實現不說,框架的API設計的好壞取決于兩個方面。對于普通開發人員而言就是使用層面的API是否易于使 用,拿我們的MVC框架舉例來說:

最基本的,搭建一個HelloWorld項目,聲明一個Controller和Action,配置一個路由規則讓Get方法的請求可以解析到這個Action,可以輸出HelloWorld文字,怎么實現?
如果要實現從Cookie以及表單中獲取相關數據綁定到Action的參數里面,怎么實現?
如果要配置一個Action在調用前需要判斷權限,在調用后需要記錄日志,怎么實現?

我們這里說的API,它不一定全都是方法調用的API,廣義上來說我們認為框架提供的接入層的使用都可以認為是API,所以上面的一些功能都可以認為是MVC框架的API。

框架除了提供基本的功能,還要提供一定程度的擴展功能,使得一些復雜的項目能夠在某些方面對框架進行增強以適應各種需求,比如:

  1. 我的Action是否可以返回圖片驗證碼?
  2. 我的Action的參數綁定是否可以從Memcached中獲取數據?
  3. 如果出現異常,能否在開發的時候顯示具體的錯誤信息,在正式環境顯示友好的錯誤頁面并且記錄錯誤信息到數據庫?

一 般而言如果要實現這樣的功能就需要自己實現框架公開的一些類或接口,然后把自己的實現"注冊"到框架中,讓框架可以在某個時候去使用這些新的實現。這就需 要框架的設計者來考慮應該以怎么樣的友好形式公開出去哪些內容,使得以后的擴展實現在自由度以及最少實現上的平衡,同時要兼顧外來的實現不破壞框架已有的 結構。

要想清楚這些不是一件容易的事情,所以在框架的設計階段完全可以使用從上到下的方式進行設計。也就是不去考慮框架怎么實現,而是以一 個使用者的身份來寫一個框架的示例網站,API怎么簡單怎么舒服就怎么設計,只從使用者的角度來考慮問題。對于相關用到的類,直接寫一個空的類(能用接口 的盡量用接口,你的目的只是通過編譯而不是能運行起來),讓程序可以通過編譯就可以了。你可以從框架的普通使用開始寫這樣一個示例網站,然后再寫各種擴展 應用,在此期間你可能會用到框架內部的20個類,這些類就是框架的接入類,在你的示例網站通過編譯的那剎那,其實你已經實現了框架的接入層的設計。

這里值得一說的是API的設計蘊含了非常多的學問以及經驗,要在目標平臺設計一套合理易用的API首先需要對目標平臺足夠了解,每一個平臺都有一些約定俗成的規范,如果設計的API能符合這些規范那么開發人員會更容易接受這個框架,此外還有一些建議:

  1. 之 所以我們把API的設計先行,而不是讓框架的設計先行是因為這樣我們更容易設計出好用的API,作為框架的實現者,我們往往會進行一些妥協,我們可能會為 了在框架內部DRY而設計出一套丑陋的API讓框架的使用者去做一些重復的工作;我們也可能會因為想讓框架變得更松耦合強迫框架的使用者去使用到框架的一 些內部API去初始化框架的組件。如果框架不是易用的,那么框架的內部設計的再合理又有什么意義?
  2. 盡量少暴露一些框架內部的類名吧,對 于框架的使用者來說,你的框架對他一點都不熟悉,如果要上手你的框架需要學習一到兩個類尚可接受,如果要使用到十幾個類會頭暈腦脹的,即使你的框架有非常 多的功能以及配置,可以考慮提供一個入口類,比如創建一個ConfigCenter類作為入口,讓使用者可以僅僅探索這個類便可對框架進行所有的配置。
  3. 一 個好的框架是可以讓使用者少犯錯誤的,框架的設計者務必要考慮到,框架的使用者沒有這個業務來按照框架的最佳實踐來做,所以在設計API的時候,如果你希 望API的使用者一定要按照某個方式來做的話,可以考慮設置一個簡便的重載來加載默認的最合理的使用方式而不是要求使用者來為你的方法初始一些什么依賴, 同時也可以在API內部做一些檢測,如果發現開發人員可能會犯錯進行一些提示或拋出異常。好的框架無需過多的文檔,它可以在開發人員用的時候告知它哪里錯 了,最佳實踐是什么,即便他們真的錯了也能以默認的更合理的方式來彌補這個錯誤。
  4. 建議所有的API都有一套統一的規范,比如入口都叫XXXCenter或XXXManager,而不是叫XXXCenter、YYYManager和 ZZZService。API往往需要進行迭代和改良的,在首個版本中把好名字用掉也不一定是一個好辦法,最好還是給自己的框架各種API的名字留一點余 地,這樣以后萬一需要升級換代不至于太牽強。

下一步工作就是把項目中那些空的類按照功能進行劃分。目的很簡單,就是讓你的框架 的100個類或接口能夠按照功能進行拆分和歸類,這樣別人一打開你的框架就可以馬上知道你的框架分為哪幾個主要部分,而不是在100個類中暈眩;還有因為 一旦在你的框架有使用者后你再要為API相關的那些類調整包就比困難了,即使你在創建框架的時候覺得我的框架就那么十幾個類無需進行過多的分類,但是在將 來框架變大又發現當初設計的不合理,無法進行結構調整就會變得很痛苦。因此這個工作還是相當重要的,對于大多數框架來說,可以有幾種切蛋糕的方式:

  1. 分 層。我覺得框架和應用程序一樣,也需要進行分層。傳統的應用程序我們分為表現層、邏輯層和數據訪問層,類似的對于很多框架也可以進行橫向的層次劃分。要分 層的原因是我們的框架要處理的問題是基于多層抽象的,就像如果沒有OSI七層模型,要讓一個HTTP應用去直接處理網絡信號是不合理的也是不利于重用的。 舉一個例子,如果我們要寫一個基于Socket的RPC的框架,我們需要處理方法的代理以及序列化,以及序列化數據的傳輸,這完全是兩個層面的問題,前者 偏向于應用層,后者偏向于網絡層,我們完全有理由把我們的框架分為兩個層面的項目(至少是兩個包),rpc.core和rpc.socket,前者不關心 網絡實現來處理所有RPC的功能,后者不關心RPC來處理所有的Socket功能,在將來即使我們要淘汰我們的RPC的協議了,我們也可以重用 rpc.socket項目,因為它和RPC的實現沒有任何關系,它關注的只是socket層面的東西。
  2. 橫切。剛才說的分層是橫向的分 割,橫切是縱向的分割(橫切是跨多個模塊的意思,不是橫向來切的意思)。其實橫切關注點就是諸如日志、配置、緩存、AOP、IOC等通用的功能,對于這部 分功能,我們不應該把他們和真正的業務邏輯混淆在一起。對于應用類項目是這樣,對于框架類項目也是這樣,如果某一部分的代碼量非常大,完全有理由為它分出 一個單獨的包。對于RPC項目,我們可能就會把客戶端和服務端通訊的消息放在common包內,把配置的處理單獨放在config包內。
  3. 功能。也就是要實現一個框架主要解決的問題點,比如對于上面提到的RPC框架的core部分,可以想到的是我們主要解決是客戶端如何找到服務端,如何把進 行方法調用以及把方法的調用信息傳給目標服務端,服務端如何接受到這樣的信息根據配置在本地實例化對象調用方法后把結果返回客戶端三大問題,那么我們可能 會把項目分為routing、client、server等幾個包。

如果是一個RPC框架,大概是這樣的結構:

你知道如何寫一個框架嗎?詳細步驟大放送

對于我們的Web MVC框架,舉例如下:

  1. 我們可以有一個mvc.core項目,細分如下的包:
  2. common:公共的一組件,下面的各模塊都會用到
  3. config:配置模塊,解決框架的配置問題
  4. startup:啟動模塊,解決框架和Servlet如何進行整合的問題
  5. plugin:插件模塊,插件機制的實現,提供IPlugin的抽象實現
  6. routing:路由模塊,解決請求路徑的解析問題,提供了IRoute的抽象實現和基本實現
  7. controller:控制器模塊,解決的是如何產生控制器
  8. model:視圖模型模塊,解決的是如何綁定方法的參數
  9. action:action模塊,解決的是如何調用方法以及方法返回的結果,提供了IActionResult的抽象實現和基本實現
  10. view:視圖模塊,解決的是各種視圖引擎和框架的適配
  11. filter:過濾器模塊,解決是執行Action,返回IActionResult前后的AOP功能,提供了IFilter的抽象實現以及基本實現
  12. 我們可以再創建一個mvc.extension項目,細分如下的包:
  13. filters:一些IFilter的實現
  14. results:一些IActionResult的實現
  15. routes:一些IRoute的實現
  16. plugins:一些IPlugin的實現

這里我們以IXXX來描述一個抽象,可以是接口也可以是抽象類,在具體實現的時候根據需求再來確定。

你知道如何寫一個框架嗎?詳細步驟大放送

這 種結構的劃分方式完全吻合上面說的切蛋糕方式,可以看到除了橫切部分和分層部分,作為一個Web MVC框架,它核心的組件就是routing、model、view、controller、action(當然,對于有些MVC框架它沒有route部 分,route部分是交由Web框架實現的)。

如果我們在這個時候還無法確定框架的模塊劃分的話,問題也不大,我們可以在后續的搭建龍骨的步驟中隨著更多的類的建立,繼續理清和確定模塊的劃分。

經過了設計的步驟,我們應該心里對下面的問題有一個初步的規劃了:

  • 我們的框架以什么形式來提供如何優雅的API?
  • 我們的框架包含哪些模塊,模塊大概的作用是什么?

#p#
搭建龍骨 

在 經過了初步的設計之后,我們可以考慮為框架搭建一套龍骨,一套抽象的層次關系。也就是用抽象類、接口或空的類實現框架,可以通過編譯,讓框架撐起來,就像 造房子搭建房子的鋼筋混凝土結構(添磚加瓦是后面的事情,我們先要有一個結構)。對于開發應用程序來說,其實沒有什么撐起來一說,因為應用程序中很多模塊 都是并行的,它可能并沒有一個主結構,主流程,而對于框架來說,它往往是一個高度面向對象的,高度抽象的一套程序,搭建龍骨也就是搭建一套抽象層。這么說 可能有點抽象,我們還是來想一下如果要做一個Web MVC框架,需要怎么為上面說的幾個核心模塊進行抽象(我們也來體會一下框架中一些類的命名,這里我們為了更清晰,為所有接口都命名為IXXX,這點不太 符合Java的命名規范):

  1. routing MVC的入口是路由
  2. 每一個路由都是IRoute代表了不同的路由實現,它也提供一個getRouteResult()方法來返回RouteResult對象
  3. 我們實現一個框架自帶的DefaultRoute,使得路由支持配置,支持默認值,支持正則表達式,支持約束等等
  4. 我們需要有一個Routes類來管理所有的路由IRoute,提供一個findRoute()方法來返回RouteResult對象,自然我們這邊調用的就是IRoute的getRouteResult()方法,返回能匹配到的結果
  5. RouteResult對象就是匹配的路由信息,包含了路由解析后的所有數據
  6. controller 路由下來是控制器
  7. 我們有IControllerFactory來創建Controller,提供createController()方法來返回IController
  8. IController代表控制器,提供一個execute()方法來執行控制器
  9. 我們實現一個框架自帶的DefaultControllerFactory來以約定由于配置的方式根據約定規則以及路由數據RouteResult來找到IController并創建它
  10. 我 們為IController提供一個抽象實現,AbstractController,要求所有MVC框架的使用者創建的控制器需要繼承 AbstractController,在這個抽象實現中我們可以編寫一些便捷的API以便開發人員使用,比如view()方法、file()方法、 redirect()方法、json()方法、js()方法等等
  11. action 找到了控制器后就是來找要執行的方法了
  12. 我們有IActionResult來代表Action返回的結果,提供一個execute()方法來執行這個結果
  13. 我們的框架需要實現一些自帶的IActionResult,比如ContentResult、ViewResult、FileResult、JsonResult、RedirectResult來對應AbstractController的一些便捷方法
  14. 再來定義一個IActionInvoker來執行Action,提供一個invokeAction()方法
  15. 我們需要實現一個DefaultActionInvoker以默認的方式進行方法的調用,也就是找到方法的一些IFilter按照一定的順序執行他們,最后使用反射進行方法的調用得到上面說的IActionResult并執行它的execute()方法
  16. filter 我們的框架很重要的一點就是便捷的過濾器
  17. 剛才提到了IFilter,代表的是一個過濾器,我們提供IActionFilter對方法的執行前后進行過濾,提供IResultFilter對IActionResult執行前后進行過濾
  18. 我們的IActionInvoker怎么找到需要執行的IFilter呢,我們需要定義一個IFilterProvider來提供過濾器,它提供一個getFilters()方法來提供所有的IFilter的實例
  19. 我 們的框架可以實現一些自帶的IFilterProvider,比如AnnotationFilterProvider通過掃描Action或 Controller上的注解來獲取需要執行的過濾器信息;比如我們還可以實現GlobalFilterProvider,開發人員可以直接通過配置或代 碼方式告知框架應用于全局的IFilter
  20. 既然我們實現了多個IFilterProvider,我們自然需要有一個類來管理這些IFilterProvider,我們實現一個FilterProviders類并提供getFilters()方法(這和我們的Routes類來管理IRoute是類似的,命名統一)
  21. view 各種IActionResult中最特殊最復雜的就是ViewResult,我們需要有一個單獨的包來處理ViewResult的邏輯
  22. 我們需要有IViewEngine來代表一個模版引擎,提供一個getViewEngineResult()方法返回ViewEngineResult
  23. ViewEngineResult包含視圖引擎尋找視圖的結果信息,里面包含IView和尋找的一些路徑等
  24. IView自然代表的是一個視圖,提供render()方法(或者為了統一也可以叫做execute)來渲染視圖
  25. 我 們的框架可以實現常見的一些模版引擎,比如FreemarkerViewEngine、VelocityViewEngine 等,VelocityViewEngine返回的ViewEngineResult自然包含的是一個實現IView的VelocityView,不會返回 其它引擎的IView
  26. 同樣的,我們是不是需要一個ViewEngines來管理所有的IViewEngine呢,同樣也是實現findViewEngine()方法
  27. common 這里可以放一些項目中各個模塊都要用到的一些東西
  28. 比 如各種context,context代表的是執行某個任務需要的環境信息,這里我們可以定義HttpContext、 ControllerContext、ActionContext和ViewContext,后者繼承前者,隨著MVC處理流程的進行,View執行時的 上下文相比Action執行時的上下文信息肯定是多了視圖的信息,其它同理,之所以把這個信息放在common里面而不是放在各個模塊自己的包內是因為這 樣更清晰,可以一目了然各種對象的執行上下文有一個立體的概念
  29. 比如各種helper或utility

接下去就不再詳細闡述model、plugin等模塊的內容了。

看到這里,我們來總結一下,我們的MVC框架在組織結構上有著高度的統一:

  • 如果xxx本身并無選擇策略,但xxx的創建過程也不是一個new這么簡單的,可以由xxxFactory類來提供一個xxx
  • 如果我們需要用到很多個yyy,那么我們會有各種yyyProvider(通過getyyy()方法)來提供這些yyy,并且我們需要有一個yyyProviders來管理這些yyyProvider
  • 如果zzz的選擇是有策略性的,會按照需要選擇zzz1或zzzN,那么我們可能會有一個zzzs來管理這些zzz并且(通過findzzz()方法)來提供合適的zzz

同 時我們框架的相關類的命名也是非常統一的,可以一眼看出這是實現、還是抽象類還是接口;是提供程序,是執行結果還是上下文。當然,在將來的代碼實現過程中 很可能會把很多接口變為抽象類提供一些默認的實現,這并不會影響項目的主結構。我們會在模式篇對框架常用的一些高層設計模式做更多的介紹。

到了這里,我們的項目里已經有幾十個空的(抽象)類、接口了,其中也定義了各種方法可以把各個模塊串起來(各種find()方法和execute()方法),可以說整個項目的龍骨已經建立起來了,這種感覺很好,因為我們心里很有底,我們只需要在接下去的工作中做兩個事情:

  • 實現各種DefaultXXX來走通主流程
  • 實現各種IyyyProvider和Izzz接口來完善支線流程

#p#
走通主線流程

所謂走通主線流程,就是讓這個框架可以以一個HelloWorld形式跑起來,這就需要把幾個核心類的核心方法使用最簡單的方式進行實現,還是拿我們的MVC框架來舉例子:

  • 從startup開始,可能需要實現ServletContextListener來動態注冊我們框架的入口Servlet,暫且起名為DispatcherServlet吧,在這個類中我們需要走一下主線流程
  • 調用Routes.findRoute()獲得IRoute
  • 調用IRoute.getRouteResult()來獲得RouteResult
  • 使用拿到的RouteResult作為參數調用DefaultControllerFactory.createController()獲得IController(其實也是AbstractController)
  • 調用IController.execute()
  • 在 config中創建一個IConfig作為一種配置方式,我們實現一個DefaultConfig,把各種默認實現注冊到框架中去,也就是 DefaultRoute、DefaultControllerFactory、DefaultActionInvoker,然后把各種 IViewEngine加入ViewEngines
  • 然后需要完成相關默認類的實現:
  • 實現Routes.findRoute()
  • 實現DefaultRoute.getRouteResult()
  • 實現DefaultControllerFactory.createController()
  • 實現AbstractController.execute()
  • 實現DefaultActionInvoker.invokeAction()
  • 實現ViewResult.execute()
  • 實現ViewEngines.findViewEngine()
  • 實現VelocityViewEngine.getViewEngineResult()
  • 實現VelocityView.render()

在這一步,我們并不一定要去觸碰filter和model這部分的內容,我們的主線流程只是解析路由,獲得控制器,執行方法,找到視圖然后渲染視圖。過濾器和視圖模型的綁定屬于增強型的功能,屬于支線流程,不屬于主線流程。

雖 然在這里我們說了一些MVC的實現,但本文的目的不在于教你實現一個MVC框架,所以不用深究每一個類的實現細節,這里想說的是,在前面的龍骨搭建完后, 你會發現按照這個龍骨為它加一點肉上去實現主要的流程是順理成章的事情,毫無痛苦。在整個實現的過程中,你可以不斷完善common下的一些 context,把方法的調用參數封裝到上下文對象中去,不但看起來清楚且符合開閉原則。到這里,我們應該可以跑起來在設計階段做的那個示例網站的 HelloWorld功能了。

在這里還想說一點,有些人在實現框架的時候并沒有搭建龍骨的一步驟,直接以非OOP的方式實現了主線流程,這種方式有以下幾個缺點:

不容易做到SRP單一指責原則,你很容易把各種邏輯都集中寫在一起,比如大量的邏輯直接寫到了DispatcherServlet中,輔助一些Service或Helper,整個框架就肥瘦不勻,有些類特別龐大有些類特別小。
不容易做到OCP開閉原則,擴展起來不方便需要修改老的代碼,我們期望的擴展是實現新的類然后讓框架感知,而不是直接修改框架的某些代碼來增強功能。
很難實現DIP依賴倒置原則,即使你依賴的確實是IService但其實就沒意義,因為它只有一個實現,只是把他當作幫助類來用罷了。

#p#
實現各種支線流程

我們想一下,對于這個MVC框架有哪些沒有實現的支線流程?其實無需多思考,因為我們在搭建龍骨階段的設計已經給了我們明確的方向了,我們只需要把除了主線之外的那些龍骨上也填充一些實體即可,比如:

  1. 實現更多的IRoute,并注冊到Routes
  2. 實現更多的IViewEngine,并注冊到ViewEngines
  3. 實現必要的IFilterProvider以及FilterProviders,把IFilterProvider注冊到FilterProviders
  4. 增強DefaultActionInvoker.invokeAction()方法,在合適的時候調用這些IFilter
  5. 實現更多的IActionResult,并且為AbstractController實現更多的便捷方法來返回這些IActionResult
  6. ……實現更多model模塊的內容和plugin模塊的內容

實現了這一步后,你會發現整個框架飽滿起來了,每一個包中不再是僅有的那些接口和默認實現,而且會有一種OOP的爽快感,爽快感來源于幾個方面:

  1. 面對接口編程抽象和多態的放心安心的爽快感
  2. 為抽象類實現具體類享受到父類大量實現的滿足的爽快感
  3. 實現了大量的接口和抽象類后充實的爽快感

我們再來總結一下之前說的那些內容,實現一個框架的第一大步就是:

  1. 設計一套合理的接口
  2. 為框架進行模塊劃分
  3. 為框架搭建由抽象結構構成的骨架
  4. 在這個骨架的基礎上實現一個HelloWorld程序
  5. 為這個骨架的其它部分填充更多實現

經 過這樣的一些步驟后可以發現這個框架是很穩固的,很平衡的,很易于擴展的。其實到這里很多人覺得框架已經完成了,有血有肉,其實個人覺得只能說開發工作實 現了差不多30%,后文會繼續說,畢竟直接把這樣一個血肉之軀拿出去對外有點嚇人,我們需要為它進行很多包裝和完善。

#p#

單元測試 

在這之前我們寫的框架只能說是一個在最基本的情況下可以使用的框架,作為一個框架我們無法預測開發人員將來會怎么使用它,所以我們需要做大量的工作來確保框架不但各種功能都是正確的,而且還是健壯的。寫應用系統的代碼,大多數項目是不會去寫單元測試的,原因很多:

  • 項目趕時間,連做一些輸入驗證都沒時間搞,哪里有時間寫測試代碼。
  • 項目對各項功能的質量要求不高,只要能在標準的操作流程下功能可用即可。
  • 項目基本不會去改或是臨時項目,一旦測試通過之后就始終是這樣子了,沒有迭代。
  • ……

對于框架,恰恰相反,沒有配套的單元測試的框架(也就是僅僅使用人工的方式進行測試,比如在main中調用一些方法觀察日志或輸出,或者運行一下示例項目查看各種功能是否正常,是非常可怕的)原因如下:

  1. 自動化程度高,回歸需要的時間短,甚至可以整合到構建過程中進行,這是人工測試無法實現的。
  2. 框架一定是有非常多的迭代和重構的, 每一次修改雖然只改了A功能,但是可能會影響到B和C功能,人工測試的話你可能只會驗證A是否正常,容易忽略B和C,使用單元測試的話只要所有功能都有覆蓋,那么幾乎不可能遺漏因為修改導致的潛在問題,而且還能反饋出來因為修改導致的兼容性問題。
  3. 之前說過,一旦框架開放出去,框架的使用者可能會以各種方式在各種環境來使用你的框架,環境不同會造成很多怪異的邊界輸入或非法輸入,需要使用單元測試對代碼進行嚴格的邊界測試,以確保框架可以在嚴酷的環境下生存。
  4. 單元測試還能幫助我們改善設計,在寫單元測試的時候如果發現目標代碼非常難以進行模擬難以構建有效的單元測試,那么說明目標代碼可能有強依賴或職責過于復雜,一個被單元測試高度覆蓋的框架往往是設計精良的,符合高內聚低耦合的框架。

如果框架的時間需求不是特別緊的話,單元測試的引入可以是走通主線流程的階段就引入,越早引入框架的成熟度可能就會越高,以后重構返工的機會會越小,框架的可靠性也肯定會大幅提高。之前我有寫過一個類庫項目,并沒有寫單元測試,在項目中使用了這個類庫一段時間也沒有出現任何問題,后來花了一點時間為類庫寫了單元測試,出乎我意料之外的是,我的類庫提供的所有API中有超過一半是無法通過單元測試的(原以為這是一個成熟的類庫,其實包含了數十個BUG),甚至其中有一個API是在我的項目中使用的。你可能會問,為什么在使用這個API的時候沒有發生問題而在單元測試的時候發生問題了呢?原因之前提到過,我是框架的設計者,我在使用類庫提供的API的時候是知道使用的最佳實踐的,因此我在使用的時候為類庫進行了一個特別的設置,這個問題如果不是通過單元測試暴露的話,那么其它人在使用這個類庫的時候基本都會遇到一個潛在的BUG。

#p#

示范項目

寫一個示例項目不僅僅是為了給別人參考,而且還能夠幫助自己去完善框架,對于示例項目,最好兼顧下面幾點:

  1. 是一個具有一定意義的網站或系統,而不是純粹為了演示特性而演示。這是因為,很多時候只有那些真正的業務邏輯才會暴露出問題,演示特性的時候我們總是有一些定勢思維會規避很多問題。或者可以提供兩個項目,一個純粹演示特性,一個是示例項目。
  2. 覆蓋盡可能多的特性或使用難點,在項目的代碼中提供一些注釋,很多開發人員不喜歡閱讀文檔,反而喜歡看一下示例項目直接上手(模仿示例項目,或直接拿示例項目中的代碼來修改)。
  3. 項目中的代碼,特別是涉及到框架使用的代碼一定要規范,原因上面也說了,作為框架的設計者你不會希望大家復制的代碼粘帖的代碼一團糟吧。
  4. 如果你的項目針對的不僅僅是Web項目,那么示例項目最好提供Web和桌面兩個版本,一來你自己容易發現因為環境不同帶來的使用差異,二來可以給予不同類型項目不同的最佳實踐。


完善日志和異常

一個好的框架不但需要設計精良,日志和異常的處理是否到位也是非常重要的標準,這里有一些反例:

  1. 日志的各種級別的使用沒有統一的標準,甚至是永遠只使用某個級別的日志。
  2. 幾乎沒有任何的日志,框架的運行完全是一個黑盒。
  3. 記錄的日志多且沒有實際含義,只是調試的時候用來觀察變量的內容。
  4. 異常類型只使用Exception,不使用更具體化的類型,沒有自定義類型。
  5. 異常的消息文本只寫"錯誤"字樣,不寫清楚具體的問題所在。
  6. 永遠只是拋出異常,讓異常上升到最外層,交給框架的使用者去處理。
  7. 用異常來控制代碼流程,或本應該在方法未達到預期效果的時候使用異常卻使用返回值。

其實個人覺得,一個框架的主邏輯代碼并不一定是最難的,最難的是對一些細節的處理,讓框架保持一套規范的統一的日志和異常的使用反而對框架開發者來說是一個難點,下面是針對記錄日志的一些建議:

1、首先要對框架使用的日志級別有一個規范,比如定義:

  1. DEBUG:用于觀察程序的運行流程,僅在調試的時候開啟
  2. INFO:用于告知程序運行狀態或階段的變化,可以在測試環境開啟
  3. WARNING:用于告知程序可以自己恢復的錯誤或異常,或不影響主線流程執行的錯誤或問題,可以在正式環境開啟
  4. ERROR:用于告知程序無法恢復,主線流程中斷,需要開發或運維人員知曉干預的錯誤或異常,需要在正式環境開啟

2、按照上面的級別規范,在需要記錄日志的地方記錄日志,除了DEBUG級別的日志其它日志不能記錄過多,如果框架總是在運行的時候輸出幾十個WARNNING也容易讓使用者忽略真正的問題。
3、日志記錄的消息需要是明確的,最好包含一些上下文信息,比如"無法在xxx下找到配置文件xxx.config,框架將采用默認的配置",而不是"加載配置失敗!"

下面是一些針對使用異常的建議:

  1. 框架由于配置錯誤或使用錯誤或運行錯誤,不能完成API名字所表示的功能,考慮拋出轉化后的異常,讓調用者知道發什么了什么情況,同時框架可以建立自己的錯誤處理機制
  2. 對于可以預料的錯誤,并且錯誤類型可以枚舉,考慮以返回值的形式告知調用者可以根據不同的結果來處理后續的邏輯
  3. 對于框架內部功能實現上遇到的調用者無能力解決的錯誤,如果錯誤可以重試或不影響返回,可以記錄警告或錯誤日志
  4. 可以為每一個模塊都陪伴自定義的異常類型,包含相關的上下文信息(比如ViewException可以包含ViewContext),這樣出現異常可以很方便知曉是哪個模塊出現問題并且可以得到出現異常時的環境信息
  5. 如果異常跨了實現層次(比如從框架到應用),那么最好進行一下包裝轉換(比如把文件讀取失敗的提示改為加載配置文件失敗的提示),否則上層人員是不知道怎么處理這些內部問題的,內部問題需要由框架自己來處理
  6. 異常的日志中可以記錄和當前操作密切相關的參數信息,比如搜索的路徑,視圖名等等,有關方法的信息不用過多記錄,異常一般都帶有調用棧信息
  7. 如果可能的話,出現異常的時候可以分析一下為什么會出現這樣的問題,在異常信息中給一些解決問題的建議或幫助鏈接方便使用者排查問題
  8. 異常處理從壞到好的層次是,出現了嚴重問題的時候:
  9. 使用者什么都不知道,程序的完整性和邏輯得到破壞
  10. 使用者既不知道出現了什么問題也不知道怎么去解決
  11. 使用者能明確知道出現了什么問題,但無法去解決
  12. 使用者不但知道發生了什么,還能通過異常消息的引導快速解決問題

#p#
完善配置

配置的部分可以留到框架寫的差不多了再去寫,因為這個時候已經可以想清楚哪些配置是:

  1. 需要公開出去給使用者配置的,并且配置會根據環境不同而不同
  2. 需要公開出去給使用者來配置的,配置和部署環境無關
  3. 僅僅需要在框架內供框架開發人員來配置的
  4. 無需是一個配置,只要在代碼中集中存儲這個設定即可

一般來說配置有幾種方式:

  1. 通過配置文件來配置,比如XML文件、JSON文件或property文件
  2. 通過注解或特性(Annotation/Attribute)方式(對類、方法、參數)進行配置
  3. 通過代碼方式進行配置(比如單獨的配置類,或實現配置類或調用框架的配置API)

很多框架提供了多種配置方式,比如Spring MVC同時支持上面三種方式的配置,個人覺得對配置,我們還是應該區別對待,而不是無腦把所有的配置項都同時以上面三種方式提供配置,我們要考慮高內聚和低耦合原則,對于Web框架來說,高內聚需要考慮的比低耦合更多,我的建議是對不同的配置項提供不同的配置方式:

  1. 如果配置項目是需要讓使用者來配置的,特別是和環境相關的,那么最好使用配置方式來配置,比如開放的端口、內存、線程數配置,不過要注意:
  2. 所有配置項目需要有默認值,如果找不到配置使用默認值,如果配置不合理使用默認值(你不會希望使用你框架的人把框架內部的線程池的min設置為999999,或定時器的間隔設置為0毫秒吧?)
  3. 框架啟動的時候檢測所有配置,如果不合理給予提示,大多人只會在啟動的時候看一下日志,使用的時候根本就不管
  4. 不知道大家對于配置文件的格式傾向于XML呢還是JSON呢還是鍵值對呢?
  5. 對于所有僅在開發時進行的配置,都盡量不要去使用配置文件,并且讓配置盡量和它所配置的對象靠在一起:
  6. 如果是對框架整體性進行的設置擴展類型的配置,那就可以提供代碼方式進行配置,比如我們要實現的MVC框架的各種IRoute、IViewEngine等,最好可以提供IConfig接口讓開發人員可以去實現接口,這樣他們可以知道有哪些東西可以配置,代碼就是文檔
  7. 如果是那種對模型、Action進行的配置,比如模型的驗證規則、Filter等一律采用注解的方式進行配置
  8. 有的人說使用配置文件進行配置非常靈活,使用代碼方式和注解方式來配置不靈活而且可能有侵入性。我覺得還是要權衡對待,我的建議是不要把太多框架內在的東西放在配置文件中,增加使用者的難度(而且很多時候,大多數人只是復制配置為了完成配置而配置,并不是為了真正的靈活性而去使用配置文件來配置你的框架,看看網上這么所SSH配置文件的抄來抄去就知道了)。
  9. 最后,我建議很多太內部的東西對于輕量級的應用型框架可以不去提供任何配置選項,只需要在某個常量文件中定義即可,讓真正有需求進行二次開發的開發人員去修改,對于一個框架如果一下子暴露上百個"高級"配置項給使用者,他們會暈眩的。


提供狀態服務

所謂狀態服務就是反映框架內部運作狀態的服務,很多開源服務或系統(Nginx、Mongodb等)都提供了類似的模塊和功能,作為框架的話我覺得也有必要提供一些內部信息(主要是配置、數據統計以及內部資源狀態)出來,這樣使用你框架的人可以在開發的時候或線上運作的時候了解框架的運作狀態,我們舉兩個例子,對于一個我們之前提到的Web MVC框架來說,可以提供這些信息:

  1. 路由配置
  2. 視圖引擎配置
  3. 過濾器配置

對于一個Socket框架來說,有一些不同,Socket框架是有狀態的,其狀態服務提供的信息除了當前生效的配置信息之外,更多的是反映當前框架內部一些資源的狀態以及統計數據:

  1. 各種配置(池配置、隊列配置、集群配置)
  2. Socket相關的統計數據(總打開、總關閉、每秒收發數據、總收發數據、當前打開等等)
  3. 各種池的當前狀態
  4. 各種隊列的當前狀態

狀態服務可以以下面幾種形式來提供:

  1. 代碼方式,比如如果開發人員實現了IXXXStateAware接口的話,就可以為它的實現類來推送一些信息,也可以直接在框架中設立一個StateCenter來公開框架所有的狀態信息
  2. 自動日志方式,比如如果在配置中開啟了stateLoggingInterval=60s的選項,我們的框架就會自動一分鐘一次輸出日志,顯示框架內部的狀態
  3. 接口方式,比如開放一個Restful的接口或額外監聽一個端口來提供狀態服務,方便使用者可以拿原始的數據和其它監控平臺進行整合
  4. 內部外部工具方式
  5. 比如我們可以直接為框架提供一個專門的頁面(/_route)來呈現路由的配置(甚至我們可以在這個頁面上讓開發人員可以直接輸入地址來測試路由的匹配情況,狀態服務不一定只能看),這樣在開發和測試的時候可以更方便調試
  6. 我們也可以為框架提供一個專有工具來查看框架的狀態信息(當然,這個工具其實可能就是連接框架的某個網絡服務來獲取數據),這樣即使框架在多個機器中使用,我們可能也只有一個監控工具即可
  7. 如果沒有狀態服務,那么在運行的時候框架就是一個黑盒,反之如果狀態服務足夠詳細的話,可以方便我們排查一些功能或性能問題。不過要注意的一點是,狀體服務可能會降低框架的性能,我們可能需要對狀態服務也進行一次壓測,排除狀態服務中損耗性能的地方(有些數據的收集會意想不到得損耗性能)。

#p#
檢查線程安全

框架對多線程環境支持的是否好,是框架質量的一個重要的評估標準,往往可以看到甚至有一些成熟的框架也會有多線程問題。這里涉及幾個方面:

1,你無法預料框架的使用者會怎么樣去實例化和保存你的API的入口類,如果你的入口類被用成為了一個單例,在并發調用的情況下會不會有單線程問題?

這是一個老話題,之前已經說過很多次,你在設計框架的時候心里如果把一個類定位成了單例的類但卻沒有提供單例模式,你是無法要求使用者來幫你實現單例的。這其中涉及的不僅僅是多線程問題,可能還有性能問題。比如見過某分布式緩存的客戶端的CacheClient在文檔中要求使用者針對一個緩存集群保持一個CacheClient的單例(因為其中有了連接池),但是用的人還是每一次都實例化了一個CacheClient出來,幾小時后就會產生幾萬個半死的Socket導致網絡奔潰。又見過某類庫的入口工廠的代碼注釋中寫了要求使用的人把XXXFactory作為單例來使用(因為其中緩存了大量數據),但是用的人就沒有注意到這個注釋,每一次都實例化了一個XXXFactory,造成GC的崩潰。所以我覺得作為框架的設計者開發人員,最好還是把框架的最佳實踐直接做到API中,使得使用者不可能出錯(之前說過一句話,再重復一次,好的框架不會讓使用的人犯錯)。你可能會說對于CacheClient的例子,不可能做成單例的,因為我的程序可能需要用到多個緩存的集群,換個思路,我們完全可以在封裝一層,通過一個CacheClientCreator之類的類來管理多個單例的CacheClient。即使在某些極端的情況下,你不能只提供一條路給使用者去走,也需要在框架內做一些檢測機制,及時提醒使用者 "我們發現您這樣使用了框架,這可能會產生問題,你本意是否打算那樣做呢?"

2,如果你的入口類本來就是單例的,那么你是類中是否持有共享資源,你的API在并發的情況下被調用是否可以確保這些資源的線程安全?在解決多線程問題的時候往往有幾個難點:

百密難有一疏,你很難想到這段代碼會有人這樣去并發調用。比如某init()方法,某config()方法,你總是假設使用者會調用并且僅調用一次,但事實不一定這樣,有的時候調用者自己也不清楚我的容器會調用我這段代碼多少次。
好吧,解決多線程問題各種煩躁,那就對各種涉及到共享資源的方法全部加鎖。對方法進行粗獷(粒度)的鎖可能會導致性能急劇下降甚至是死鎖問題。
自以為使用了優雅的無鎖代碼或并發容器但卻達不到目的。我們往往在大量使用了并發集合心中暗自竊喜解決了多線程問題的同時又達到了極佳的性能,但你以為這樣是解決了線程安全問題但其實根本就沒有,我們不能假設A和B都方法是線程安全的,但對A和B方法調用的整個代碼段是線程安全的。

對于多線程問題,我沒有好的解決辦法,不過下面的幾條我覺得可以嘗試:

需要非常仔細的過一遍代碼,把涉及到共享資源的地方,以及相關的方法和類列出來,不要去假設什么,只要API暴露出去了則假設它可能被并發調用。共享資源不一定是靜態資源,哪怕資源是非靜態的,在并發環境下對相同對象的資源進行操作也可能產生問題。
一般而言對于公開的API,作為框架的設計者我們需要確保所有的靜態方法(或但單例類的實例方法)是線程安全的,對于實例方法我們可以不這么做(因為性能原因),但是需要在注釋中明確提示使用者方法的非線程安全,如果需要并發調用請自行處理線程安全問題。
可以看看是否有可能讓這些資源(字段)變為方法內的局部變量,有的時候我們并不是真正的需要類持有一個字段,只是因為多個方法要使用相同的東西,隨手一寫罷了。
對于使用頻率低的一些方法相關的一些資源沒有必要使用并發容器,直接采用粗狂的方式進行資源加鎖甚至是方法級別加鎖,先確保沒有線程安全,如果以后做壓測出現性能問題再來解決。
對于使用頻率高的一些方法相關的一些資源可以使用并發容器,但需要仔細思考一下代碼是否會存在線程安全問題,必要的話為代碼設計一些多線程環境的單元測試去驗證。


性能測試和優化

之前也提到過,你不會預測到你的項目會在怎么樣的訪問量下使用,我們不希望框架和同類的框架相比有明顯的性能差距(如果你做的是一個ORM框架或RPC框架,這個工作就是必不可少的),所以在框架基本完成后我們需要做Benchmark:

  1. 確定幾個測試用例,盡量覆蓋主流程和一些重要擴展
  2. 找幾個主流的同類型框架,實現相同的測試用例,實現到時候要單純一點,盡量不要再依賴其它外部框架
  3. 為這些框架和自己的框架,使用壓力測試工具在相同的環境和平臺來跑這些測試用例,使用圖表繪制在不同的壓力下的執行時間(以及內存和CPU等主要資源的消耗情況)
  4. 如果出現明顯的差距則用性能分析工具進行排查和優化,比如:
  5. 優化框架內的線程安全的實現方式
  6. 為框架內的代碼做一些緩存(緩存反射得到的元數據等等)
  7. 減少調用層次
  8. 這些調整可能會打破原來的主線流程或讓代碼變得難以理解,需要留下相關注釋
  9. 不斷重壓力測試和優化的過程,每次嘗試優化5%~20%的性能,雖然越到后來可能會越難,如果發現實在無法優化的話(性能分析工具顯示性能的分布已經很均勻了),可以看一下其它框架對于這部分工作實現的代碼邏輯

封裝和擴展

個人覺得一個框架如果只是能用那是第一個層次,能很方便的進行擴展或二次開發那是另外一個層次,如果我們龍骨階段的工作做的足夠好,框架是一個立體飽滿的框架,那么這部分的工作量就會小很多,否則我們需要對框架進行不少的重構以便可以達到這個層次。

  1. 我們需要縱覽一下框架的所有類型,看看有哪些類型我們是打算提供開發人員進行增強、擴展或替換的,對這些類型進行響應的結構調整。
  2. 比如希望被增強,則需要從繼承的角度來考慮
  3. 比如希望被擴展,則需要從Provider的角度來考慮
  4. 比如希望被替換,則需要在配置中提供組件的替換
  5. 我們需要再為這些類型進行精細化的調整:
  6. 檢查是否該封閉的封閉了,該開放的開放了
  7. 增強擴展或替換是否會帶來副作用
  8. 對于新來的外來類型,接收和使用的時候做足夠的檢查
  9. 相關日志的完善

#p#
重構還是重構

光是重構這個事情其實就可以說一本書了,其實我有一點代碼的潔癖,這里列一些我自己寫代碼的時候注重的地方:

  1. 格式:每次提交代碼的時候使用IDE來格式化你的代碼和引用(當然,實現可能需要配置IDE為你喜歡的代碼風格)
  2. 命名:保持整個類和接口命名統一,各種er,Provider、Creator、Initializer、Invoker、Selector代表的是一件事情,不要使用漢語拼音命名,如果英文不夠好的話多查一下字典,有的時候我甚至會因為一個命名去閱讀一些源代碼看看老外是怎么命名這個對象或這個方法的
  3. 訪問控制修飾符:這是一個非常難做好的細節,因為有太多的地方有訪問控制修飾符,究竟是給予什么級別的修飾符往往又取決于框架的擴展。可以在一開始的時候給盡量小的權限,在必要的時候慢慢提升,比如對于方法除了一定要給public的地方(比如公共API或實現接口),盡量都給private,在有繼承層次關系的時候去給到protected,對于類可以都給默認包/程序集權限,產生編譯錯誤的時候再去給到public
  4. 屬性/getter、setter:對于非POJO類字段的公開也要仔細想一下, 是否有必要有setter,因為一旦外部可以來設置類的某個內部字段,那么不僅僅可能改變了類的內部狀態,你還要考慮的是怎么處理這種改變,是不是有線程安全問題等等,甚至要考慮是否有必要開放getter,是否應該把類內部的信息公開給外部
  5. 方法:思考每一個方法在當前的類中存在是否合理,這是否屬于當前類應該做的事情,方法是否做了太多事情太少事情
  6. 參數:需要思考,對于調用每一個方法的參數,應該是傳給方法,還是讓方法自己去獲取;應該傳多個參數,還是封裝一個上下文給到方法
  7. 常量:盡量用枚舉或靜態字符串來代替框架使用到的一些常量或幻數,需要為常量進行一個分類不能一股腦堆在一個常量類Consts中

除了上面說的一些問題,我覺得對于重構,最重要的一句話就是:不要讓同一段代碼出現兩遍,主要圍繞這個原則進行重構往往就會解決很多設計問題,要實現這個目標可能需要:

  1. 干差不多活的類使用繼承來避免代碼重復(提煉超類),使用模版方法來把差異留給子類實現
  2. 構造方法可以層次化調用,主構造方法只要一個就可以了,不要在構造方法中實現太多邏輯
  3. 如果方法的代碼有重復可以考慮對方法提取出更小的公共方法來調用(提煉方法),也可以考慮使用Lambda表達式進行更小粒度重復代碼的提取(提煉邏輯)
  4. 可以使用IDE或一些代碼分析工具來分析重復代碼,如果你能想盡一切辦法來避免這些重復的話,代碼質量可以提高一個層次

其實也不一定是在重構的時候再去處理上面所有的問題,如果在寫代碼的時候都帶著這些意識來寫的話那么重構的負擔就會小一點(不過寫代碼思想的負擔比較大,需要同時考慮封裝問題、優雅問題、日志異常問題、多線程問題等等,所以寫一套能用的代碼和寫一套好的代碼其實不是一回事情)。


項目文檔

如果要別人來使用你的框架,除了示例項目來說提供和維護一份項目文檔是很有必要的,我建議文檔分為這幾個部分:

  1. 特性 Features:
  2. 相當于項目的一個宣傳手冊,讓別人能被你項目的亮點所吸引
  3. 每一個特性可以是一句話來介紹
  4. 新手入門 Get started:
  5. 介紹框架的基本定位和作用
  6. 從下載開始,通過一步一步的方式讓用戶了解怎么把框架用起來
  7. 整個文檔的閱讀時間在10分鐘以內
  8. 新手教程 Tutorials:
  9. 提供5~10篇文章站在使用者的角度來介紹項目的主要功能點
  10. 還是通過一步一步的方式,教大家使用框架完成一個小項目(比如CRUD)
  11. 介紹框架使用的最佳實踐
  12. 整個文檔的閱讀時間在8小時內
  13. 手冊 Manual:
  14. 介紹項目的定位和理念
  15. 詳細介紹項目的每一個功能點,可以站在框架設計者的角度多介紹一些理念
  16. 詳細介紹項目的每一個配置,以及默認配置和典型配置
  17. 詳細介紹項目的每一個擴展點和替換點
  18. 文檔最好不是帶格式的,方便以后適配各種文檔生成器和開源網站


開源

開源的好處是有很多人可以看到你的代碼幫助你改進,你的框架也可能會在更多的復雜環境下使用,框架的發展會較快框架的代碼質量也會有很大的提升。

要把框架進行開源,除了上面的各種工作之外可能還有一些額外的工作需要做:

  1. 選擇一個合適的License,并且檢測自己選擇的License與使用到的類庫的License是否兼容,在代碼頭的地方標記上License。
  2. 要確保每一個人都可以在自己的環境中可以構建你的代碼,盡量使用Maven等大家熟悉的構建工具來管理依賴和構建。
  3. 選擇諸如Github等平臺來管理源代碼,并以良好的格式上傳你的文檔,有條件的話對示例子網站進行部署。
  4. 如果你希望你的代碼讓更多的人一起來參與開發,那么需要制定和公開一些規范,比如風格、命名、提交流程、測試規范、質量要求等等。
  5. 開源后時刻對項目進行關注,對各種反饋和整合請求進行及時的反饋,畢竟開源是讓別人來幫你一起改進代碼,不是單純讓別人來學習你的代碼也不是讓別人來幫你寫代碼。 

看到這里你可能相信我一開始的話了吧,框架可以使用到完善可以商用差距還是很大的,而且還要確保在迭代的過程中框架不能偏離開始的初衷不能有很大的性能問題出現,任重道遠。

原文鏈接:http://www.cnblogs.com/lovecindywang/p/4444915.html

原文鏈接:http://www.cnblogs.com/lovecindywang/p/4447739.html

責任編輯:王雪燕 來源: 博客園
相關推薦

2019-08-01 12:59:21

Bug代碼程序

2022-10-08 00:06:00

JS運行V8

2020-10-16 15:06:59

開發技術方案

2022-05-09 10:47:08

登錄SpringSecurity

2015-10-12 16:45:26

NodeWeb應用框架

2022-03-24 14:49:57

HTTP前端

2024-01-26 11:08:57

C++函數返回不同類型

2020-04-08 08:35:20

JavaScript模塊函數

2010-11-19 09:16:38

2013-01-14 09:44:58

JavaScriptJSJS框架

2017-09-01 14:18:50

前端React組件

2017-08-21 16:36:12

語法樹AST解析器HTML5

2022-04-11 08:20:36

編程輔助工具GitHubCopilot

2021-05-07 06:08:03

分布式框架NIO

2020-08-29 19:15:09

python數據庫SQLite

2025-02-14 10:13:55

2021-02-19 07:59:21

數據埋點數據分析大數據

2021-11-02 22:50:10

鼠標計算機傳感器

2017-11-02 16:23:11

混合云云計算數據中心

2010-05-17 09:51:51

Windows Emb
點贊
收藏

51CTO技術棧公眾號

主站蜘蛛池模板: 日韩精品在线免费观看视频 | 国产成人精品一区二区三区四区 | 日韩激情在线 | 国产精品爱久久久久久久 | 国产精品久久久久久久久久 | 人人人人干 | 成人综合视频在线 | 欧美一级视频免费看 | 激情av网站| 欧美区日韩区 | aaa天堂| 精品啪啪| 男女午夜免费视频 | 成人免费在线播放 | 黄色网址在线免费观看 | 蜜臀久久| 精品国产黄a∨片高清在线 www.一级片 国产欧美日韩综合精品一区二区 | 国产精品一区二区三区四区 | 一区二区三区视频播放 | 久久久久久久久国产 | 国内精品久久久久 | 国产精品久久久久国产a级 欧美日韩国产免费 | 91精品国产91久久综合桃花 | 91视频在线看 | 人人做人人澡人人爽欧美 | 免费观看一级特黄欧美大片 | 亚洲人成人一区二区在线观看 | 亚洲成人自拍 | 精品亚洲一区二区三区四区五区高 | 日韩在线观看网站 | 国产高清视频一区二区 | 操到爽 | 久久久成人免费一区二区 | 91亚洲国产亚洲国产 | 日本在线看 | 国产精品久久国产精品 | 亚洲a视频| 欧美一区二区三区视频 | 亚洲国产欧美一区二区三区久久 | 精品视频久久久 | 天天视频一区二区三区 |