RM新时代官方网站

代碼分析與自動(dòng)化重構(gòu)工具集:Modernizing(代碼結(jié)構(gòu)分析工具)

遺留系統(tǒng)的現(xiàn)代化演進(jìn)是一門藝術(shù)。

Why 開源 遺留系統(tǒng)現(xiàn)代化工具

在日常的軟件開發(fā)里,我們經(jīng)常會(huì)遇到一系列的問題,諸如于:

  • 如何解決人類智商不夠的問題?模式、原則和工具

  • 誰應(yīng)該去解決代碼的問題?代碼

  • ……

應(yīng)對于這些問題,其中的一個(gè)解決方案就是:自動(dòng)化的工具,有些人喜歡稱之為。支撐這些工具的便是一系列的原則模式,將它們?nèi)谌氲焦ぞ咧小A硗庖粋€(gè)解決人成長的方案就是:元元(meta-meta),這是另外一個(gè)故事。

遺留系統(tǒng)是常態(tài)。多數(shù)時(shí)候,我們所遇到的系統(tǒng)里多數(shù)是遺留系統(tǒng),來到一個(gè)新項(xiàng)目時(shí),可能就需要對他們快速的分析,以提供洞見 —— 寫 PPT 匯報(bào)。所以,在過去的幾年里,咨詢團(tuán)隊(duì)也沉淀了一系列的遺留系統(tǒng)分析和重構(gòu)的工具,比如新哥的 Tequila、正在開源的架構(gòu)分析和守護(hù)工具 ArchGuard 等等。除此,在有些重構(gòu)項(xiàng)目里,還要編寫定制的工具來進(jìn)行分析。

技術(shù)熱情發(fā)電。主要的挑戰(zhàn)是,我們需要拿自己的業(yè)余時(shí)間來完善工具。

既然要用自己的時(shí)間來開發(fā),還和項(xiàng)目沒有關(guān)系,這種用愛發(fā)電的事情,用開源的方式最合適了。

我們需要怎樣的工具?

從對于使用工具的結(jié)果來看,我們需要這個(gè)現(xiàn)代化工具是:

  • 可視化驅(qū)動(dòng)。快速生成項(xiàng)目的分析結(jié)果,并展示出來給開發(fā)人員了解現(xiàn)狀,還有編寫 PPT。

  • 必要的交互性。用于在重構(gòu)的過程中,尋找合適的切入點(diǎn)。

  • 定制化開發(fā)。

    • 特定壞味道。不同的開發(fā)團(tuán)隊(duì)會(huì)有不同的壞味道,有些壞味道是無法由 Sonarqube 這樣的工具識(shí)別的。

    • 自動(dòng)化重構(gòu)?;谝阎膲奈兜?,對應(yīng)的代碼位置信息,對代碼進(jìn)行自動(dòng)化重構(gòu)。

  • 適當(dāng)?shù)恼Z法精準(zhǔn)度。更高的語法精準(zhǔn)度,意味著更高的開發(fā)成本,需要有針對地平衡它們。

  • 多平臺(tái)。我們用的是 macOS,而多數(shù)時(shí)候,客戶使用的是 Windows。

如何開發(fā)這樣的工具?

這里定義的遺留系統(tǒng)現(xiàn)代化工具包含了這么幾部分:語法分析、結(jié)果及可視化、自動(dòng)化重構(gòu)、架構(gòu)守護(hù)。

代碼分析與自動(dòng)化重構(gòu)工具集:Modernizing(代碼結(jié)構(gòu)分析工具)

語法分析

對代碼進(jìn)行語法分析,生成特定的語言的數(shù)據(jù)結(jié)構(gòu)。常用的工具有:Antlr、Ctags、TreeSitter、Doxygen、CodeQuery 等。一個(gè)大致的對比(拍腦袋訂的)如下表所示:

代碼分析與自動(dòng)化重構(gòu)工具集:Modernizing(代碼結(jié)構(gòu)分析工具)

結(jié)果及可視化

通常來說,我們會(huì)出于以下的一些情況,來對遺留系統(tǒng)進(jìn)行可視化:

  • 數(shù)值化。如針對于特定的 smell 進(jìn)行自動(dòng)化重構(gòu),類似于 Sonarqube,常見的模式和原則源自于《重構(gòu)》一書。在 Coca 里,還引入了在一些論文里看到了測試的 bad smell,諸如于沒有斷言的測試等。

  • 可視化依賴。如針對于代碼中的類、包等的依賴情況進(jìn)行可視化,主要用于分析分層架構(gòu)等。常用的工具有:PlantUML、Graphviz、D3.js、Echarts 等。

  • 代碼屬性可視化。如針對于文件的修改頻率、大小等屬性進(jìn)行可視化,可以獲取諸如于單位時(shí)間內(nèi)的文件變化頻率。一個(gè)文件經(jīng)常修改,還大量被引用,那說明它是一個(gè)不穩(wěn)定的類、文件,除了業(yè)務(wù)變化,最有可能就是設(shè)計(jì)不合理。

  • 其它。

自動(dòng)化重構(gòu)

這一步是可選的,它取決于我們的場景。通常來說,編寫這樣的功能主要彌補(bǔ)是現(xiàn)代化的 IDE 無法完成的工作,諸如于:

  • 多代碼庫間的未使用類刪除。

  • 多代碼庫間的聚類。

  • 針對于 CSS 顏色的重構(gòu)。

架構(gòu)守護(hù)

編寫架構(gòu)的守護(hù)規(guī)則,以對于系統(tǒng)的架構(gòu)進(jìn)行守護(hù),用的工具有:ArchUnit、ArchGuard 等。在參考了 ArchUnit 的語法之后,我們也設(shè)計(jì)了一個(gè)多語言的架構(gòu)守護(hù)工具:Guarding。

在開發(fā)這些工具的過程中,它們也不斷地 push 著我進(jìn)一步學(xué)習(xí)語言背后的東西,如編譯原理(語言的前端部分),理解構(gòu)建系統(tǒng)(build system)等。

遺留系統(tǒng)現(xiàn)代化工具集

為了更有針對性地對遺留系統(tǒng)進(jìn)行現(xiàn)代化,最近我們創(chuàng)建了一個(gè)新的組織:Modernizing,集合了先前開發(fā)的一系列工具。并創(chuàng)建了:awesome-modernization 用于對其它的一系列相關(guān)的工具進(jìn)行收集。

在 Modernizing 里,針對于單個(gè)編程語言的工具有:

  • 針對于 Java 語言的系統(tǒng)重構(gòu)、系統(tǒng)遷移和系統(tǒng)分析的工具:Coca,Go 語言,GitHub stars:691。Coca 是一個(gè)“全功能”的重構(gòu)工具,基于 Antlr 進(jìn)行語法分析的,除了常規(guī)的可視化、調(diào)用分析,還可以進(jìn)行自動(dòng)化重構(gòu)。Coca 一名的由來是:對標(biāo)新哥寫的 Tequila —— 龍舌蘭酒 vs 快樂水。

  • 針對于 CSS/LESS/CSS 的分析和自動(dòng)化重構(gòu)工具:Lemonj,TypeScript 語言,GitHub stars:128。當(dāng)時(shí)設(shè)計(jì)的主要目的是:用來對 CSS 中的顏色進(jìn)行提取,基于 Antlr 的語法樹分析,可以用于進(jìn)行自動(dòng)化的重構(gòu)。

  • 針對于 MySQL 代碼進(jìn)行自動(dòng)化分析,并從中構(gòu)建中 UML,并生成其關(guān)系的:SQLing,Go 語言,使用 PingCapSQL 解析器解析。當(dāng)然了,還有一個(gè)初始化的針對于 PL/SQL 的版本:pling。

  • 適用于 Ant 轉(zhuǎn) Maven 的半自動(dòng)化工具:Merry,Go 語言 Antlr。

  • 前端規(guī)范化改造工具:Clij,用于一鍵添加 eslint、husky、lint-staged 等,TypeScript 語言。

針對于多語言的工具,我們有:

  • 基于 Antlr 的多語言的語言模型分析工具:Chapi,Kotlin 語言。其設(shè)計(jì)的初衷是用于生成 Coca 相同的數(shù)據(jù)結(jié)構(gòu),以接入更多的可視化工具。在語法分析上,采用的是 Antlr 進(jìn)行分析。

  • 基于 Doxygen 的多語言分析和可視化工具:Go mod 版本的新哥的 Tequila。其中,還有一系列的迷之代碼,需要重構(gòu)掉。

  • 基于 Ctags 的多語言模型分析和可視化工具:Modeling,Rust 語言。分析源碼,并生成基于模型的可視化依賴。

  • 基于 TreeSitter 的多語言架構(gòu)守護(hù)工具:Guarding,Rust 語言。通過自制的 DSL,來對系統(tǒng)架構(gòu)進(jìn)行守護(hù)。

除此,還有一個(gè)在 Inherd 開源小組下開源的:Coco,它主要是通過代碼的物理屬性:修改頻率 目錄 行數(shù)來分析系統(tǒng)的工具。以及現(xiàn)在緊鑼密鼓開源中的 ArchGuard。

我們使用一系列不同的語言和工具來開發(fā)這些軟件,因?yàn)椴煌膱鼍爸?,都?huì)有不同的選擇。

下一步?

現(xiàn)有的工具都是分散的,不同工具之前的數(shù)據(jù)格式不盡相同,缺乏統(tǒng)一的數(shù)據(jù)格式。在輸出格式不統(tǒng)一時(shí),我們就難以進(jìn)行標(biāo)準(zhǔn)的可視化,諸如于我們正在構(gòu)建 codecity 用于在元宇宙里,對遺留系統(tǒng)進(jìn)行可視化,又或者是正在從 ArchGuard 中拆分的前端可視化部分,以用于復(fù)用。理想的情況下,它應(yīng)該像是一個(gè) pipeline 架構(gòu)的系統(tǒng),由一系列的 pipe 和 filter 所構(gòu)成。

歡迎訪問我們的 GitHub:https://github.com/modernizing

也歡迎成為這一系列工具的核心開發(fā)者 ~ 。

版權(quán)聲明:本文內(nèi)容由互聯(lián)網(wǎng)用戶自發(fā)貢獻(xiàn),該文觀點(diǎn)僅代表作者本人。本站僅提供信息存儲(chǔ)空間服務(wù),不擁有所有權(quán),不承擔(dān)相關(guān)法律責(zé)任。如發(fā)現(xiàn)本站有涉嫌抄襲侵權(quán)/違法違規(guī)的內(nèi)容, 請發(fā)送郵件至 舉報(bào),一經(jīng)查實(shí),本站將立刻刪除。

(0)
上一篇 2022年5月29日 上午9:39
下一篇 2022年5月29日 上午9:48

相關(guān)推薦

  • 科研項(xiàng)目中的任務(wù)分工

    科研項(xiàng)目中的任務(wù)分工科研項(xiàng)目中的任務(wù)分工。研究對象為工程項(xiàng)目和工程項(xiàng)目,它是科學(xué)研究的對象,它是科學(xué)研究的出發(fā)點(diǎn)和歸宿。與文獻(xiàn)研究相比,它更注重的是研究過程,是研究結(jié)果的應(yīng)用對象和…

    科研百科 2024年11月26日
    2
  • 貨幣資金控制 – 財(cái)務(wù)內(nèi)部控制設(shè)計(jì)(貨幣資金內(nèi)部控制方案設(shè)計(jì))

    對貨幣資金的內(nèi)部控制,保證貨幣資金的安全,提高貨幣資金的使用效益。 所稱貨幣資金,是指企業(yè)所擁有或控制的現(xiàn)金、銀行存款和其他貨幣資金。 現(xiàn)金內(nèi)控 (一) 現(xiàn)金的收付必須由企業(yè)專職出…

    科研百科 2022年9月24日
    385
  • 施工的項(xiàng)目管理系統(tǒng)

    施工的項(xiàng)目管理系統(tǒng)是一種用于管理施工項(xiàng)目的工具,能夠幫助項(xiàng)目經(jīng)理和技術(shù)人員更好地協(xié)調(diào)工作,提高項(xiàng)目的效率和質(zhì)量。本文將介紹一種基于Web的施工項(xiàng)目管理系統(tǒng),包括系統(tǒng)的功能、優(yōu)點(diǎn)和應(yīng)…

    科研百科 2024年12月24日
    3
  • 無紙化會(huì)議管理系統(tǒng):告別會(huì)議痛點(diǎn),用戶體驗(yàn)再升級(jí)!(無紙化會(huì)議系統(tǒng)功能)

    在數(shù)字化時(shí)代的浪潮下,無紙化會(huì)議管理系統(tǒng)正逐漸成為企業(yè)會(huì)議的主流選擇。該系統(tǒng)通過集成多媒體、網(wǎng)絡(luò)通信和人機(jī)交互等技術(shù),實(shí)現(xiàn)了會(huì)議內(nèi)容的電子化、信息化和高效化,極大地提升了會(huì)議效率和…

    科研百科 2024年4月23日
    74
  • 科研項(xiàng)目工作獎(jiǎng)勵(lì)方案

    科研項(xiàng)目工作獎(jiǎng)勵(lì)方案 隨著科技的不斷進(jìn)步,科研項(xiàng)目成為了推動(dòng)社會(huì)進(jìn)步的重要力量。為了激勵(lì)科學(xué)家們更好的開展科研項(xiàng)目,提高科研水平,我們制定了一份科研項(xiàng)目工作獎(jiǎng)勵(lì)方案。 一、獎(jiǎng)勵(lì)金額…

    科研百科 2025年3月1日
    3
  • 科研管理系統(tǒng)軟件(科研管理系統(tǒng)軟件有哪些)

    隨著社會(huì)的發(fā)展,在信息社會(huì)中,信息的獲取、處理、交流和決策都需要高質(zhì)量的計(jì)算機(jī)軟件來完成。課題科研是企業(yè)、政務(wù)部門面臨的一項(xiàng)重要任務(wù),科研管理內(nèi)容也比較復(fù)雜,科研涉及的內(nèi)容極為廣泛…

    科研百科 2023年12月23日
    146
  • 科研項(xiàng)目申報(bào)正規(guī)辦理

    科研項(xiàng)目申報(bào)正規(guī)辦理是推進(jìn)科技創(chuàng)新的重要保障,也是提高科研經(jīng)費(fèi)使用效率、優(yōu)化科研環(huán)境的重要手段。在申報(bào)科研項(xiàng)目時(shí),正規(guī)辦理至關(guān)重要,以下是一些關(guān)鍵點(diǎn): 1. 正規(guī)渠道申報(bào):選擇正規(guī)…

    科研百科 2025年3月15日
    2
  • 抓黨建促鄉(xiāng)村振興缺思路、無舉措整改措施

    抓黨建促鄉(xiāng)村振興缺思路、無舉措整改措施 近年來,我國鄉(xiāng)村發(fā)展取得了長足進(jìn)步,但也存在一些問題。其中,抓黨建促鄉(xiāng)村振興缺思路、無舉措整改措施是最為突出的問題之一。 抓黨建促鄉(xiāng)村振興是…

    科研百科 2024年10月10日
    67
  • 項(xiàng)目施工管理系統(tǒng)

    項(xiàng)目施工管理系統(tǒng)是一種用于管理項(xiàng)目施工過程的軟件系統(tǒng),可以幫助項(xiàng)目經(jīng)理和施工團(tuán)隊(duì)更好地協(xié)調(diào)和管理項(xiàng)目施工過程。本文將介紹項(xiàng)目施工管理系統(tǒng)的主要特點(diǎn)、應(yīng)用場景和優(yōu)缺點(diǎn)。 一、項(xiàng)目施工…

    科研百科 2024年12月13日
    5
  • 科研項(xiàng)目的等級(jí)

    科研項(xiàng)目等級(jí) 科研項(xiàng)目等級(jí)是衡量科研項(xiàng)目質(zhì)量的重要指標(biāo),通常由科學(xué)界評估機(jī)構(gòu)進(jìn)行評定。這些機(jī)構(gòu)通常會(huì)根據(jù)科研項(xiàng)目的研究內(nèi)容和所取得的成果來評估其等級(jí)。 目前,科學(xué)界常用的科研項(xiàng)目等…

    科研百科 2025年3月3日
    5
RM新时代官方网站