13518219792
近期正在探索前端、后端、系統(tǒng)端各類常用組件與工具，對(duì)其一些常見(jiàn)的組件進(jìn)行再次整理一下，形成標(biāo)準(zhǔn)化組件專題，后續(xù)該專題將包含各類語(yǔ)言中的一些常用組件。歡迎大家進(jìn)行持續(xù)關(guān)注。
創(chuàng)新互聯(lián)專注于網(wǎng)站建設(shè)|網(wǎng)站建設(shè)維護(hù)|優(yōu)化|托管以及網(wǎng)絡(luò)推廣，積累了大量的網(wǎng)站設(shè)計(jì)與制作經(jīng)驗(yàn)，為許多企業(yè)提供了網(wǎng)站定制設(shè)計(jì)服務(wù)，案例作品覆蓋高空作業(yè)車租賃等行業(yè)。能根據(jù)企業(yè)所處的行業(yè)與銷售的產(chǎn)品，結(jié)合品牌形象的塑造，量身定制品質(zhì)網(wǎng)站。
本節(jié)分享一個(gè)基于Go語(yǔ)言的HTML和CSS網(wǎng)站生成器 hugo ，它針對(duì)速度、易用性和可配置性進(jìn)行了優(yōu)化。Hugo 獲取一個(gè)包含內(nèi)容和模板的目錄，并將它們呈現(xiàn)為一個(gè)完整的 HTML 網(wǎng)站。Hugo 依賴于 Markdown 文件和元數(shù)據(jù)的前端，你可以從任何目錄運(yùn)行 Hugo。這適用于您沒(méi)有特權(quán)帳戶的共享主機(jī)和其他系統(tǒng)。例如我們?nèi)粘＞帉懸恍┎┛臀恼拢M(jìn)行快速生成一套靜態(tài)頁(yè)面進(jìn)行分享時(shí)可以使用它來(lái)進(jìn)行生成一套靜態(tài)頁(yè)面作為我們的博客部署基礎(chǔ)。
它支持大量的主題模板，我們可以通過(guò) 進(jìn)行選擇相關(guān)的主題使用，有興趣的小伙伴可以進(jìn)行深入研究一下
cobra是一個(gè)提供簡(jiǎn)單接口來(lái)創(chuàng)建強(qiáng)大的現(xiàn)代CLI界面的庫(kù)類似git git tools，cobra也是一個(gè)應(yīng)用程序，它會(huì)生成你的應(yīng)用程序的腳手架來(lái)快速開(kāi)發(fā)基于cobra的應(yīng)用程序
cobra提供：
cobra建立在命令、參數(shù)、標(biāo)志的結(jié)構(gòu)之上
commands代表動(dòng)作，args是事物，flags是動(dòng)作的修飾符
最好的應(yīng)用程序在使用時(shí)讀起來(lái)就像句子，因此，用戶直觀地知道如何與它們交互
模式如下：APPNAME VERB NOUN --ADJECTIVE. or APPNAME COMMAND ARG --FLAG（APPNAME 動(dòng)詞 名詞 形容詞 或者 APPNAME 命令 參數(shù) 標(biāo)志）
一些真實(shí)世界的好例子可以更好地說(shuō)明這一點(diǎn)
kubectl 命令更能體現(xiàn)APPNAME 動(dòng)詞 名詞 形容詞
如下的例子，server 是command，port是flag
這個(gè)命令中，我們告訴git 克隆url
命令是應(yīng)用程序的中心點(diǎn)，應(yīng)用程序支持的每一個(gè)交互都包含在一個(gè)命令中，命令可以有子命令，也可以運(yùn)行操作
在上面的例子中，server是命令
更多關(guān)于cobra.Command
flag是一種修改命令行為的方式，cobra支持完全兼容POSIX標(biāo)志，也支持go flag package，cobra可以定義到子命令上的標(biāo)志，也可以僅對(duì)該命令可用的標(biāo)志
在上面的命令中，port是標(biāo)志
標(biāo)志的功能由 pflag library 提供，pflag library是flag標(biāo)準(zhǔn)庫(kù)的一個(gè)分支，在添加POSIX兼容性的同時(shí)維護(hù)相同的接口。
使用cobra很簡(jiǎn)單，首先，使用go get按照最新版本的庫(kù)，這個(gè)命令會(huì)安裝cobra可執(zhí)行程序以及庫(kù)和依賴項(xiàng)
下一步，引入cobra到應(yīng)用程序中
雖然歡迎您提供自己的組織，但通常基于Cobra的應(yīng)用程序?qū)⒆裱韵陆M織結(jié)構(gòu)：
在Cobra應(yīng)用程序中，main.go文件通常非常簡(jiǎn)單。它有一個(gè)目的：初始化Cobra。
使用cobra生成器
cobra提供了程序用來(lái)創(chuàng)建你的應(yīng)用程序然后添加你想添加的命令，這是將cobra引入應(yīng)用程序最簡(jiǎn)單的方式
這兒 你可以發(fā)現(xiàn)關(guān)于cobra的更多信息
要手動(dòng)實(shí)現(xiàn)cobra，需要?jiǎng)?chuàng)建一個(gè)main.go 和rootCmd文件，可以根據(jù)需要提供其他命令
Cobra不需要任何特殊的構(gòu)造器。只需創(chuàng)建命令。
理想情況下，您可以將其放在app/cmd/root.go中：
在init（）函數(shù)中定義標(biāo)志和處理配置
例子如下，cmd/root.go:
創(chuàng)建main.go
使用root命令，您需要讓主函數(shù)執(zhí)行它。為清楚起見(jiàn)，Execute應(yīng)該在根目錄下運(yùn)行，盡管它可以在任何命令上調(diào)用。
在Cobra應(yīng)用程序中，main.go文件通常非常簡(jiǎn)單。它有一個(gè)目的：初始化Cobra。
可以定義其他命令，通常每個(gè)命令在cmd/目錄中都有自己的文件。
如果要?jiǎng)?chuàng)建版本命令，可以創(chuàng)建cmd/version.go并用以下內(nèi)容填充它：
如果希望將錯(cuò)誤返回給命令的調(diào)用者，可以使用RunE。
然后可以在execute函數(shù)調(diào)用中捕獲錯(cuò)誤。
標(biāo)志提供修飾符來(lái)控制操作命令的操作方式。
由于標(biāo)志是在不同的位置定義和使用的，因此我們需要在外部定義一個(gè)具有正確作用域的變量來(lái)分配要使用的標(biāo)志。
有兩種不同的方法來(lái)分配標(biāo)志。
標(biāo)志可以是“持久”的，這意味著該標(biāo)志將可用于分配給它的命令以及該命令下的每個(gè)命令。對(duì)于全局標(biāo)志，在根上指定一個(gè)標(biāo)志作為持久標(biāo)志。
也可以在本地分配一個(gè)標(biāo)志，該標(biāo)志只應(yīng)用于該特定命令。
默認(rèn)情況下，Cobra只解析目標(biāo)命令上的本地標(biāo)志，而忽略父命令上的任何本地標(biāo)志。通過(guò)啟用Command.TraverseChildren，Cobra將在執(zhí)行目標(biāo)命令之前解析每個(gè)命令上的本地標(biāo)志。
使用viper綁定標(biāo)志
在本例中，持久標(biāo)志author與viper綁定。注意：當(dāng)用戶未提供--author標(biāo)志時(shí)，變量author將不會(huì)設(shè)置為config中的值。
更多關(guān)于 viper的文檔
Flags默認(rèn)是可選的，如果希望命令在未設(shè)置標(biāo)志時(shí)報(bào)告錯(cuò)誤，請(qǐng)根據(jù)需要進(jìn)行標(biāo)記：
持久性Flags
可以使用命令的Args字段指定位置參數(shù)的驗(yàn)證。
內(nèi)置了以下驗(yàn)證器：
在下面的示例中，我們定義了三個(gè)命令。兩個(gè)是頂級(jí)命令，一個(gè)（cmdTimes）是頂級(jí)命令之一的子命令。在這種情況下，根是不可執(zhí)行的，這意味著需要一個(gè)子命令。這是通過(guò)不為“rootCmd”提供“Run”來(lái)實(shí)現(xiàn)的。
我們只為一個(gè)命令定義了一個(gè)標(biāo)志。
有關(guān)標(biāo)志的更多文檔，請(qǐng)?jiān)L問(wèn)
對(duì)于一個(gè)更完整的例子更大的應(yīng)用程序，請(qǐng)檢查 Hugo 。
當(dāng)您有子命令時(shí)，Cobra會(huì)自動(dòng)將help命令添加到應(yīng)用程序中。當(dāng)用戶運(yùn)行“應(yīng)用程序幫助”時(shí)，將調(diào)用此函數(shù)。此外，help還支持所有其他命令作為輸入。例如，您有一個(gè)名為“create”的命令，沒(méi)有任何附加配置；調(diào)用“app help create”時(shí)，Cobra將起作用。每個(gè)命令都會(huì)自動(dòng)添加“-help”標(biāo)志。
以下輸出由Cobra自動(dòng)生成。除了命令和標(biāo)志定義之外，不需要任何東西。
幫助就像其他命令一樣。它周圍沒(méi)有特殊的邏輯或行為。事實(shí)上，你可以提供你想提供的。
您可以為默認(rèn)命令提供自己的幫助命令或模板，以用于以下功能：
當(dāng)用戶提供無(wú)效的標(biāo)志或無(wú)效的命令時(shí)，Cobra通過(guò)向用戶顯示“用法”來(lái)響應(yīng)。
你可以從上面的幫助中認(rèn)識(shí)到這一點(diǎn)。這是因?yàn)槟J(rèn)幫助將用法作為其輸出的一部分嵌入。
您可以提供自己的使用函數(shù)或模板供Cobra使用。與幫助一樣，函數(shù)和模板也可以通過(guò)公共方法重寫：
如果在root命令上設(shè)置了version字段，Cobra會(huì)添加一個(gè)頂級(jí)的'--version'標(biāo)志。運(yùn)行帶有“-version”標(biāo)志的應(yīng)用程序?qū)⑹褂冒姹灸０鍖姹敬蛴〉綐?biāo)準(zhǔn)輸出。可以使用cmd.SetVersionTemplate（s string）函數(shù)自定義模板。
可以在命令的主運(yùn)行函數(shù)之前或之后運(yùn)行函數(shù)。PersistentPreRun和PreRun函數(shù)將在運(yùn)行之前執(zhí)行。PersistentPostRun和PostRun將在運(yùn)行后執(zhí)行。如果子函數(shù)不聲明自己的函數(shù)，則它們將繼承Persistent*Run函數(shù)。這些函數(shù)按以下順序運(yùn)行：
輸出：
當(dāng)發(fā)生“未知命令”錯(cuò)誤時(shí)，Cobra將打印自動(dòng)建議。這使得Cobra在發(fā)生拼寫錯(cuò)誤時(shí)的行為類似于git命令。例如：
基于注冊(cè)的每個(gè)子命令和Levenshtein距離的實(shí)現(xiàn)，建議是自動(dòng)的。匹配最小距離2（忽略大小寫）的每個(gè)已注冊(cè)命令都將顯示為建議。
如果需要在命令中禁用建議或調(diào)整字符串距離，請(qǐng)使用：
or
您還可以使用SuggestFor屬性顯式設(shè)置將為其建議給定命令的名稱。這允許對(duì)在字符串距離方面不接近的字符串提供建議，但在您的一組命令中是有意義的，并且對(duì)于某些您不需要?jiǎng)e名的字符串。例子：
Cobra可以基于子命令、標(biāo)志等生成文檔。請(qǐng)?jiān)?docs generation文檔 中閱讀更多關(guān)于它的信息。
Cobra可以為以下shell生成shell完成文件：bash、zsh、fish、PowerShell。如果您在命令中添加更多信息，這些補(bǔ)全功能將非常強(qiáng)大和靈活。在 Shell Completions 中閱讀更多關(guān)于它的信息。
Cobra is released under the Apache 2.0 license. See LICENSE.txt
主要通過(guò)以下幾個(gè)過(guò)程生成：
（一）編寫模板文件
（二）配置FreeMarker
（三）統(tǒng)一文件生成工具
（四）數(shù)據(jù)庫(kù)操作
（五）封裝填充數(shù)據(jù)
FreeMarker是一款模板引擎：即一種基于模板和動(dòng)態(tài)數(shù)據(jù)，用于輸出文本的通用工具。
FreeMarker模板使用FreeMarker Template Language（FTL）編寫，它是一種簡(jiǎn)單的、專用的語(yǔ)言。
代碼生成器的實(shí)現(xiàn)原理十分簡(jiǎn)單，就是根據(jù)數(shù)據(jù)庫(kù)的某一個(gè)或多個(gè)業(yè)務(wù)表的結(jié)構(gòu)，生成對(duì)應(yīng)的Entity.java、Dao.java、Service.java、Controller.java、Mapper.xml文件
