狠狠色丁香婷婷综合尤物/久久精品综合一区二区三区/中国有色金属学报/国产日韩欧美在线观看 - 国产一区二区三区四区五区tv

LOGO OA教程 ERP教程 模切知識(shí)交流 PMS教程 CRM教程 開發(fā)文檔 其他文檔  
 
網(wǎng)站管理員

如何去閱讀源碼,我總結(jié)了18條心法

admin
2023年9月25日 22:54 本文熱度 506

這篇文章聊一聊如何去閱讀開源項(xiàng)目的源碼。

在聊如何去閱讀源碼之前,先來(lái)簡(jiǎn)單說(shuō)一下為什么要去閱讀源碼,大致可分為以下幾點(diǎn)原因:

  • 最直接的原因,就是面試需要,面試喜歡問(wèn)源碼,讀完源碼才可以跟面試官battle
  • 提升自己的編程水平,學(xué)習(xí)編程思想和和代碼技巧
  • 熟悉技術(shù)實(shí)現(xiàn)細(xì)節(jié),提高設(shè)計(jì)能力
  • ...

那么到底該如何去閱讀源碼呢?這里我總結(jié)了18條心法,助你修煉神功

學(xué)好JDK

身為一個(gè)Javaer,不論要不要閱讀開源項(xiàng)目源碼,都要學(xué)好JDK相關(guān)的技術(shù)。

所有的Java類開源項(xiàng)目,本質(zhì)上其實(shí)就是利用JDK已有的類庫(kù)和關(guān)鍵字實(shí)現(xiàn)一種業(yè)務(wù)功能,所以學(xué)會(huì)了JDK相關(guān)的類庫(kù)是看其它的源碼基礎(chǔ)。

如果你不懂JDK,你去閱讀源碼會(huì)發(fā)現(xiàn)有太多看不懂的地方,會(huì)影響讀源碼的心情和信心。

學(xué)習(xí)JDK主要包括使用和原理兩部分。內(nèi)容大致包括以下幾部分:

  • 集合相關(guān),比如常見的Map,List,Queue的實(shí)現(xiàn),包括線程安全與不安全
  • 并發(fā)相關(guān),比如synchronized、volatile、CAS、AQS、鎖、線程池、原子類等等
  • io相關(guān),包括bio和nio等等
  • 反射相關(guān)
  • 網(wǎng)絡(luò)編程相關(guān)
  • ...

了解設(shè)計(jì)模式

在一個(gè)優(yōu)秀的開源項(xiàng)目中,設(shè)計(jì)模式處處存在,所以在你開始閱讀源碼之前最好先了解一下常見的一些設(shè)計(jì)模式。當(dāng)你了解了一些設(shè)計(jì)模式以后,在源碼中遇到了相關(guān)的設(shè)計(jì)模式,你就可以快速明白代碼結(jié)構(gòu)的設(shè)計(jì),從而以整體的視角去閱讀相關(guān)代碼。

同時(shí),學(xué)習(xí)設(shè)計(jì)模式不僅可以幫助我們閱讀源碼,在日常開發(fā)中也可以幫助我們?cè)O(shè)計(jì)出更易于擴(kuò)展的程序。

學(xué)習(xí)設(shè)計(jì)模式的話可以看看《大話設(shè)計(jì)模式》這本書,如果不想看書也可以找一些視頻或者專欄。

之前我也寫過(guò)一篇關(guān)于開源項(xiàng)目中常用的設(shè)計(jì)模式文章 兩萬(wàn)字盤點(diǎn)那些被玩爛了的設(shè)計(jì)模式 ,有興趣的小伙伴可以看看。

先從官網(wǎng)入手

官網(wǎng)是介紹開源項(xiàng)目的地方,同時(shí)也是學(xué)習(xí)一個(gè)開源項(xiàng)目最開始的地方,通過(guò)官網(wǎng)我們可以快速的了解項(xiàng)目,比如:

  • 項(xiàng)目的定位
  • 一些核心概念
  • 功能
  • 使用教程
  • 整體的架構(gòu)和設(shè)計(jì)
  • 常見的問(wèn)題及解答
  • ...
RokcetMQ官網(wǎng)

當(dāng)你了解了項(xiàng)目的一些概念、功能等信息之后,如果你在讀源碼一旦發(fā)現(xiàn)了代碼是實(shí)現(xiàn)這些概念或者功能的足跡,那么能夠幫助你更好的理解代碼。

熟悉源碼模塊結(jié)構(gòu)

當(dāng)你對(duì)項(xiàng)目有大致的了解之后,就可以從Github上把代碼clone下來(lái),官網(wǎng)有項(xiàng)目源碼的Github地址。

當(dāng)成功拉下來(lái)代碼之后,就可以對(duì)項(xiàng)目源碼模塊進(jìn)行簡(jiǎn)單的分析,熟悉模塊結(jié)構(gòu),分析模塊功能,混個(gè)眼熟。

如上是RocketMQ源碼,如果前面閱讀過(guò)官網(wǎng)相關(guān)的一些概念介紹,就大致可以知道這些模塊有什么功能。

RocketMQ概念介紹

比如說(shuō),源碼中的broker模塊,官網(wǎng)說(shuō)broker主要是負(fù)責(zé)消息存儲(chǔ),那么broker模塊代碼塊肯定就主要實(shí)現(xiàn)了消息存儲(chǔ)的功能。

還有些模塊可以根據(jù)單詞的意思進(jìn)行判斷,比如common模塊,一看就是存儲(chǔ)一些公共類的模塊,example模塊,就是RocketMQ使用代碼示例的模塊等等。

順著demo開始讀

有的小伙伴在讀源碼的時(shí)候不知道從哪里開始讀比較合適,最后隨便從源碼中的某個(gè)模塊就開始讀,讀讀越來(lái)越發(fā)現(xiàn)讀不下去。

讀源碼正確的姿勢(shì)應(yīng)該是從demo開始讀。

比如說(shuō),現(xiàn)在我想要閱讀一下RocketMQ生產(chǎn)者是如何發(fā)送消息的,整個(gè)過(guò)程是什么樣的,那么我首先至少得寫個(gè)發(fā)送消息的demo,看看代碼是如何寫的。

demo一般可以從官網(wǎng)中查看

RocketMQ官網(wǎng)發(fā)送消息代碼示例

除了官網(wǎng),一般開源項(xiàng)目在源碼中也會(huì)有相應(yīng)的demo,代碼放在示例模塊,就比如上面提到的RocketMQ的example模塊。

最后還可以通過(guò)谷歌搜索一下demo。

DefaultMQProducer producer = new DefaultMQProducer("sanyouProducer");
//指定NameServer的地址
producer.setNamesrvAddr("localhost:9876");
//啟動(dòng)生產(chǎn)者
producer.start();
//省略代碼。。
Message msg = new Message("sanyouTopic""TagA""三友的java日記".getBytes(RemotingHelper.DEFAULT_CHARSET));
// 發(fā)送消息并得到消息的發(fā)送結(jié)果,然后打印
SendResult sendResult = producer.send(msg);

如上是RocketMQ生產(chǎn)者發(fā)送消息的一個(gè)demo,消息發(fā)送源碼閱讀就從這塊代碼開始入手,一步一步進(jìn)入源碼中,這就算開始閱讀源碼了。

帶著目的去讀

帶著目的去讀其實(shí)很好理解,就拿上面生產(chǎn)者發(fā)送消息流程源碼來(lái)說(shuō),讀源碼的第一個(gè)目的其實(shí)就是弄懂生產(chǎn)者發(fā)送消息的流程。

除了弄懂生產(chǎn)者發(fā)送消息,你還可以帶著其它目的去讀。

比如說(shuō),消息發(fā)送的核心邏輯是send方法實(shí)現(xiàn)的,那么除了消息發(fā)送,是不是可以去弄懂生產(chǎn)者在啟動(dòng)的過(guò)程做了哪些事,也就是start方法的作用。

再比如生產(chǎn)者發(fā)送消息肯定涉及到網(wǎng)絡(luò)通信相關(guān)的內(nèi)容,那么了解RocketMQ底層網(wǎng)絡(luò)通信模型是不是也可以算一個(gè)目的。

當(dāng)你帶著這些目的,你讀源碼就有很強(qiáng)的目的性,讀完印象會(huì)很深刻。當(dāng)然如果你最開始想不到這些目的,也沒(méi)有什么關(guān)系,你可以先往下讀,在讀的過(guò)程中再去嘗試發(fā)現(xiàn)一些其它的目的。

先抓主線,再抓分支

有的小伙伴在讀源碼的時(shí)候,每個(gè)方法都使勁一直往下點(diǎn),最后都不知道代碼進(jìn)入到哪了,這其實(shí)是非常不可取的。

正確的方法應(yīng)該是先抓住主線流程,分支流程先大致看看,知道大概是什么作用,等讀完主線之后,再回過(guò)頭仔細(xì)讀一下分支代碼。

舉個(gè)例子來(lái)說(shuō),在Spring中,ApplicationContext在使用之前需要調(diào)用一下refresh方法,而refresh方法就定義了整個(gè)容器刷新的執(zhí)行流程代碼。

refresh方法部分截圖

當(dāng)在讀這段代碼,你可以先讀一讀refresh中各個(gè)方法大致都做了什么,等讀完之后,你可以具體的去讀每個(gè)代碼的具體實(shí)現(xiàn),比如說(shuō)prepareRefresh干了什么,obtainFreshBeanFactory是如何獲取到BeanFactory的,prepareBeanFactory又在對(duì)BeanFactory做了什么事等等。

不要過(guò)度摳實(shí)現(xiàn)細(xì)節(jié)

有的小伙伴在閱讀的時(shí)候特別喜歡深究,想要弄清每行代碼是如何實(shí)現(xiàn)的,這不僅非常難而且也是不可取的。

就比如說(shuō),我們都知道,在Spring Bean的生命周期中,當(dāng)存在基于xml的方式來(lái)聲明Bean的方式,Spring會(huì)去解析xml,生成BeanDefinition。當(dāng)你想要了解Bean的生命周期過(guò)程的時(shí)候,其實(shí)是沒(méi)有太大的必要去過(guò)度扣Spring是如何解析xml生成BeanDefinition的細(xì)節(jié),這對(duì)你整體了解Bean的生命周期沒(méi)有太大的意義,只需要知道最終會(huì)轉(zhuǎn)換成BeanDefinition就可以了。

那什么時(shí)候去扣實(shí)現(xiàn)細(xì)節(jié)呢?

  • 當(dāng)你需要使用到的時(shí)候,比如說(shuō)你遇到了一個(gè)bug或者是需要擴(kuò)展
  • 阻礙你理解功能實(shí)現(xiàn)的時(shí)候

大膽猜

讀源碼的時(shí)候也需要我們發(fā)揮一點(diǎn)想象力,去猜一猜功能是如何實(shí)現(xiàn)的。猜不是瞎猜,而是基于目前了解的一些知識(shí)、技術(shù)或者是思想合理地去猜。

就比如說(shuō),當(dāng)你已經(jīng)知道了OpenFeign最終會(huì)對(duì)每一個(gè)FeignClient接口生成動(dòng)態(tài)代理對(duì)象,之后注入的對(duì)象都是代理對(duì)象,代理對(duì)象中實(shí)現(xiàn)了RPC的請(qǐng)求之后,那么當(dāng)你在學(xué)習(xí)dubbo的時(shí)候,是不是就可以去猜測(cè)注入的dubbo接口最終也是一個(gè)動(dòng)態(tài)代理對(duì)象,并且這個(gè)代理對(duì)象也實(shí)現(xiàn)了RPC的請(qǐng)求?

之后你在讀代碼的時(shí)候就需要著重注意發(fā)現(xiàn)是否有動(dòng)態(tài)代理生成的代碼,這就算是一個(gè)目的,一旦發(fā)現(xiàn)了動(dòng)態(tài)代理相關(guān)的代碼,那么這塊代碼很可能就是dubbo RPC實(shí)現(xiàn)的核心。

學(xué)會(huì)看類名

不要小看類名,優(yōu)秀的代碼命名都是見名知意的,所以從類名也可能窺探出這個(gè)類的一些蛛絲馬跡。

如下列舉了幾個(gè)比較常用的命名習(xí)慣

  • 以Registry結(jié)尾的一般都是存儲(chǔ)功能,比如Spring中的SingletonBeanRegistry就是用來(lái)保存單例Bean的;Mybatis中的MapperRegistry就是用來(lái)保存Mapper接口的
  • 以Support、Helper、s、Util(s)結(jié)尾的一般都是工具類
  • 以Filter,Interceptor結(jié)尾的一般都是攔截作用,一般會(huì)配合責(zé)任鏈模式(Chain)使用
  • 以Event、Listener結(jié)尾的一般都是基于觀察者模式實(shí)現(xiàn)的事件發(fā)布訂閱模型
  • ...

除了一些比較通用的命名習(xí)慣,也有一些項(xiàng)目獨(dú)有的一些命名習(xí)慣。

比如說(shuō)Spring中常見的以PostProcessor結(jié)尾的都是擴(kuò)展接口,實(shí)現(xiàn)這些接口可以拿到某個(gè)比較核心的組件,從而實(shí)現(xiàn)對(duì)Spring的擴(kuò)展。

其實(shí)很多開源項(xiàng)目的命名都比較偏向Spring的命名風(fēng)格,當(dāng)你遇到了跟Spring的命名比較像的時(shí)候,那么可以大膽猜測(cè)類的作用。

學(xué)會(huì)看類結(jié)構(gòu)

類結(jié)構(gòu)也非常重要,他也能夠幫助我們窺探類的大致功能。

ApplicationContext

如上圖,是Spring中ApplicationContext的繼承體系,當(dāng)你需要了解ApplicationContext的時(shí)候,可以先去熟悉一下它的父接口的作用,當(dāng)你大致弄明白了每個(gè)接口的作用,那么ApplicationContext有啥作用就大致就清楚了。

除了可以看類繼承體系,還可以瀏覽一下類大致提供了哪些方法,了解對(duì)外提供的功能。

類方法通過(guò)快捷鍵 ctrl+F12(mac:fn+command+F12)查看,并且還支持模糊搜索方法名,我本人就非常喜歡這個(gè)快捷鍵

ApplicationContext

總結(jié)類的職責(zé)

當(dāng)我們?cè)谧x完一個(gè)類的代碼的時(shí)候,一定要總結(jié)這個(gè)類的職責(zé),明白這個(gè)類存在的意義。一般情況下一個(gè)類核心職責(zé)只有一個(gè),遵循單一職責(zé)的設(shè)計(jì)原則。

舉個(gè)例子,在RocketMQ中有一個(gè)類MQClientAPIImpl

MQClientAPIImpl

其實(shí)從名字大概看不出這個(gè)類主要是有什么功能,但是當(dāng)我讀代碼的時(shí)候發(fā)現(xiàn)每個(gè)方法最終都調(diào)用RemotingClient方法,而RemotingClient只有一個(gè)實(shí)現(xiàn)NettyRemotingClient,所以從這個(gè)實(shí)現(xiàn)和類名可以猜出來(lái)RemotingClient是發(fā)送網(wǎng)絡(luò)請(qǐng)求的客戶端,所以當(dāng)讀完MQClientAPIImpl源碼之后,我就知道了MQClientAPIImpl這個(gè)類的職責(zé)大致是封裝參數(shù),然后通過(guò)RemotingClient向MQ發(fā)送消息的。

當(dāng)知道這個(gè)類的職責(zé)的時(shí)候,那么其它地方在調(diào)用這個(gè)類的方法的時(shí)候,就知道大概在做什么事了。

習(xí)慣閱讀注釋

當(dāng)你在讀源碼的時(shí)候,如果有注釋,最好能先讀一下注釋,這樣能幫助你厘清類或者方法的功能,先知道功能,再去讀源碼就容易多了。

注釋一般都是英文,如果看不懂,可以裝個(gè)插件

寫好注釋

俗話說(shuō)的好記性不如爛筆頭,寫好注釋也是閱讀源碼中很重要的一個(gè)環(huán)節(jié),好的注釋可以幫助快速回憶起實(shí)現(xiàn)細(xì)節(jié)和功能。

注釋并不需要對(duì)每行代碼都注釋,當(dāng)然如果你愿意也沒(méi)多大問(wèn)題,但是注釋應(yīng)包括以下幾點(diǎn)內(nèi)容:

  • 核心類和方法實(shí)現(xiàn)的核心功能
  • 核心功能大致的實(shí)現(xiàn)邏輯
  • 核心的成員變量的作用
  • 方法中不易讀懂的代碼實(shí)現(xiàn)細(xì)節(jié)
DefaultMessageStore

如圖,是我讀RocketMQ中對(duì)于DefaultMessageStore類閱讀的注釋,這個(gè)類是RocketMQ中一個(gè)非常核心的類,從名字可以看出來(lái)跟消息的存儲(chǔ)有關(guān)。這個(gè)類的功能非常多,所以我寫了很多注釋,列舉了這個(gè)類主要有哪些功能和這些功能實(shí)現(xiàn)的一些細(xì)節(jié)。

總結(jié)思想,及時(shí)輸出

當(dāng)你讀完某個(gè)功能模塊的時(shí)候,就可以嘗試對(duì)這塊功能實(shí)現(xiàn)邏輯或者思想進(jìn)行總結(jié)。

比如說(shuō),當(dāng)你了解了CAS思想的時(shí)候,你會(huì)發(fā)現(xiàn),原來(lái)保證線程安全不僅僅可以通過(guò)加鎖的方式,還可以基于樂(lè)觀鎖的方式來(lái)實(shí)現(xiàn)。

在總結(jié)之后可以輸出成一個(gè)文檔,又或者是流程圖。我個(gè)人比較喜歡畫圖,這里推薦兩個(gè)在線畫圖工具:

  • processon
  • draw.io

processon我平時(shí)就在用,功能多,但是需要收費(fèi);draw.io的話免費(fèi),圖標(biāo)和顏色感覺(jué)比processon好看,平時(shí)文章中的貼圖就是用draw.io畫的。

這里多說(shuō)一句,總結(jié)思想還是非常重要的,在我閱讀了很多源碼之后,我發(fā)現(xiàn)很多技術(shù)或者功能的實(shí)現(xiàn)原理最終都是殊途同歸。

提前了解依賴的技術(shù)

一般一個(gè)開源項(xiàng)目不是所有的技術(shù)都是自己實(shí)現(xiàn)的,它也會(huì)依賴一些其它的框架或者是思想,提前了解這些框架或者是思想,可以幫助你更好地閱讀和理清代碼。

比如說(shuō),RocketMQ底層是基于Netty框架實(shí)現(xiàn)網(wǎng)絡(luò)通信的,當(dāng)你對(duì)Netty有所了解,知道Netty在啟動(dòng)的時(shí)候需要注冊(cè)一堆ChannelHandler用來(lái)處理網(wǎng)絡(luò)請(qǐng)求,那么在讀RocketMQ底層網(wǎng)絡(luò)通信功能的時(shí)候你就可以去找一下Netty啟動(dòng)的代碼,看看都注冊(cè)了哪些ChannelHandler,然后就知道RocketMQ是如何處理和發(fā)送請(qǐng)求的。

查閱相關(guān)資料

當(dāng)在閱讀源碼的時(shí)候,對(duì)某一塊代碼功能實(shí)現(xiàn)不太清楚的時(shí)候,可以通過(guò)查閱相關(guān)資料來(lái)輔助閱讀,包括但不限于以下幾種通道:

  • 官網(wǎng)
  • 書籍
  • Github
  • 文章
  • 視頻

堅(jiān)持

最后一點(diǎn)也是最核心的一點(diǎn)就是堅(jiān)持。只有你長(zhǎng)期堅(jiān)持讀源碼,不停地思考,總結(jié),不斷提升自身技術(shù)的廣度和深度,找到適合自己的閱讀方式,閱讀源碼才會(huì)是越來(lái)越容易的一件事。

··············  END  ··············


該文章在 2023/9/25 22:54:02 編輯過(guò)
關(guān)鍵字查詢
相關(guān)文章
正在查詢...
點(diǎn)晴ERP是一款針對(duì)中小制造業(yè)的專業(yè)生產(chǎn)管理軟件系統(tǒng),系統(tǒng)成熟度和易用性得到了國(guó)內(nèi)大量中小企業(yè)的青睞。
點(diǎn)晴PMS碼頭管理系統(tǒng)主要針對(duì)港口碼頭集裝箱與散貨日常運(yùn)作、調(diào)度、堆場(chǎng)、車隊(duì)、財(cái)務(wù)費(fèi)用、相關(guān)報(bào)表等業(yè)務(wù)管理,結(jié)合碼頭的業(yè)務(wù)特點(diǎn),圍繞調(diào)度、堆場(chǎng)作業(yè)而開發(fā)的。集技術(shù)的先進(jìn)性、管理的有效性于一體,是物流碼頭及其他港口類企業(yè)的高效ERP管理信息系統(tǒng)。
點(diǎn)晴WMS倉(cāng)儲(chǔ)管理系統(tǒng)提供了貨物產(chǎn)品管理,銷售管理,采購(gòu)管理,倉(cāng)儲(chǔ)管理,倉(cāng)庫(kù)管理,保質(zhì)期管理,貨位管理,庫(kù)位管理,生產(chǎn)管理,WMS管理系統(tǒng),標(biāo)簽打印,條形碼,二維碼管理,批號(hào)管理軟件。
點(diǎn)晴免費(fèi)OA是一款軟件和通用服務(wù)都免費(fèi),不限功能、不限時(shí)間、不限用戶的免費(fèi)OA協(xié)同辦公管理系統(tǒng)。
Copyright 2010-2025 ClickSun All Rights Reserved