SpringBoot中使用Cache提升接口性能詳解
環(huán)境：springboot2.3.12.RELEASE + JSR107 + Ehcache + JPASpring 框架從 3.1 開(kāi)始，對(duì) Spring 應(yīng)用程序提供了透明式添加緩存的支持。和事務(wù)支持一樣，抽象緩存允許一致地使用各
文檔很重要，而易讀的文檔更重要。在開(kāi)源軟件世界中，文檔可以告訴我們?nèi)绾问褂没蜇暙I(xiàn)一個(gè)應(yīng)用程序，就像 游戲 的規(guī)則書一樣。
有很多不同類型的文檔：
我們向一些貢獻(xiàn)者詢問(wèn)了他們的技術(shù)文檔工作流程，他們更喜歡使用哪種標(biāo)記語(yǔ)言，以及為什么會(huì)選擇其中一種。以下是他們的回答。
過(guò)去幾年中，Markdown 一直是我的標(biāo)準(zhǔn)語(yǔ)言。但最近我決定嘗試一下 AsciiDoc 。這種語(yǔ)法并不難，我在 Linux 桌面上的 Gedit 就支持它。我計(jì)劃暫時(shí)堅(jiān)持使用它一段時(shí)間。
—- Alan Formy-Duval
就低語(yǔ)法標(biāo)記語(yǔ)言而言，我更喜歡 AsciiDoc。我喜歡它，是因?yàn)槠滢D(zhuǎn)換過(guò)程一致且可預(yù)測(cè)，沒(méi)有令人困惑的“口味”變化 。我還喜歡將它輸出為 Docbook，這是一種我信任其持久性和靈活性的標(biāo)記語(yǔ)言，它有大量的語(yǔ)法標(biāo)記。
但“正確”的選擇往往取決于項(xiàng)目已經(jīng)在使用什么。如果項(xiàng)目使用某種口味的 Markdown，我就不會(huì)使用 AsciiDoc。嗯，公平地說(shuō)，我可能會(huì)使用 AsciiDoc，然后使用 Pandoc 將其轉(zhuǎn)換為草莓味的 Markdown。
當(dāng)然，我認(rèn)為 Markdown 有其應(yīng)用的時(shí)間和場(chǎng)合。我發(fā)現(xiàn)它比 AsciiDoc 更易讀。AsciiDoc 中的鏈接是這樣：
http://example.com [Example website]而 Markdown 中的鏈接是這樣：
[Example.com](http://example.com)Markdown 的語(yǔ)法直觀，以讀取 HTML 的方式呈現(xiàn)信息，大多數(shù)人都以相同的方式解析此類數(shù)據(jù)（“Example website……哦，那是藍(lán)色的文本，我將懸停一下以查看它指向哪里……它指向 example.com”）。
換句話說(shuō)，當(dāng)我的受眾是人類讀者時(shí)，我通常會(huì)選擇 Markdown，因?yàn)樗恼Z(yǔ)法簡(jiǎn)單，但仍具有足夠的語(yǔ)法可以進(jìn)行轉(zhuǎn)換，因此仍然是一種可接受的存儲(chǔ)格式。
雖然像 AsciiDoc 這樣簡(jiǎn)潔的語(yǔ)法看起來(lái)更令人吃驚，但如果我的受眾是要解析文件的計(jì)算機(jī)，我會(huì)選擇 AsciiDoc。
—- Seth Kenlon
我是 代碼即文檔 的忠實(shí)支持者，它將開(kāi)發(fā)者工具融入到內(nèi)容流程中。這樣可以更輕松地進(jìn)行高效的審查和協(xié)作，尤其是如果工程師是貢獻(xiàn)者。
作為一個(gè)標(biāo)記語(yǔ)言的行家，我在 O'Reilly 寫了整整一本關(guān)于 AsciiDoc 的書，還使用 Markdown 在各個(gè)平臺(tái)上發(fā)布了上千篇博文。但目前，我轉(zhuǎn)向使用 reStructuredText，并維護(hù)一些相關(guān)工具。
—— Lorna Mitchell
不得不提到 reStructuredText。在我大量使用 Python 編程時(shí)，它已成為我的首選。它也是 Python 長(zhǎng)期以來(lái)用于文檔源碼和代碼注釋的標(biāo)準(zhǔn)。
與 Markdown 相比，我喜歡它不會(huì)受到非標(biāo)準(zhǔn)規(guī)范的困擾。話雖如此，當(dāng)我處理更復(fù)雜的文檔時(shí)，確實(shí)還得使用許多 Sphinx 的功能和擴(kuò)展。
—— Jeremy Stanley
能不用標(biāo)記語(yǔ)言我就不用。
不過(guò)，我發(fā)現(xiàn) HTML 比其他標(biāo)記語(yǔ)言更易于使用。
—— Rikard Grossman-Nielsen
對(duì)我來(lái)說(shuō)，撰寫文檔有各種方式。這取決于文檔將要放在何處，是作為網(wǎng)站的一部分、軟件包的一部分，還是可下載的內(nèi)容。
對(duì)于 Scribus 來(lái)說(shuō)，其內(nèi)部文檔采用 HTML 格式，因?yàn)樾枰褂脙?nèi)部瀏覽器來(lái)訪問(wèn)。對(duì)于網(wǎng)站，可能需要使用維基語(yǔ)言。而對(duì)于可下載的內(nèi)容，可以創(chuàng)建 PDF 或 EPUB 格式。
我傾向于在純文本編輯器中編寫文檔。我可能會(huì)使用 XHTML，以便將這些文件導(dǎo)入到像 Sigil 這樣的 EPUB 制作工具中。當(dāng)然，對(duì)于創(chuàng)建 PDF，我會(huì)使用 Scribus，雖然我可能會(huì)導(dǎo)入用文本編輯器創(chuàng)建的文本文件。Scribus 具有包含圖形并精確控制其布局的優(yōu)勢(shì)。
Markdown 從未吸引我，我也從未嘗試過(guò) AsciiDoc。
—— Greg Pittman
我目前正在使用 HTML 撰寫大量文檔，所以我要為 HTML 代言一下。你可以使用 HTML 創(chuàng)建網(wǎng)站或創(chuàng)建文檔。請(qǐng)注意，這兩者實(shí)際上并不相同 —— 當(dāng)你創(chuàng)建網(wǎng)站時(shí)，大多數(shù)設(shè)計(jì)師關(guān)注的是呈現(xiàn)。但是當(dāng)你編寫文檔時(shí)，技術(shù)作者應(yīng)該專注于內(nèi)容。
當(dāng)我用 HTML 撰寫文檔時(shí)，我遵循 HTML 定義的標(biāo)簽和元素，并不關(guān)心它的外觀。換句話說(shuō)，我用“未經(jīng)樣式化”的 HTML 編寫文檔。稍后我總是可以添加樣式表。因此，如果我需要強(qiáng)調(diào)文本的某一部分（比如警告），或者給單詞或短語(yǔ)加重語(yǔ)氣，我可能會(huì)使用 <strong> 和 <em> 標(biāo)簽，像這樣：
<p><strong>警告：激光！</strong>不要用你剩下的那只眼睛看向激光。</p>或者在段落中提供一個(gè)簡(jiǎn)短的代碼示例，我可能會(huì)這樣寫：
<p><code>puts</code> 函數(shù)將一些文本輸出給用戶。</p>要在文檔中格式化一段代碼塊，我使用 <pre><code>..</code></pre>，如下所示：
voidprint_array(int *array, int size){ for (int i = 0; i < size; i++) { printf("array[%d] = %d/n", i, array[i]); }}HTML 的好處在于你可以立即在任何 Web 瀏覽器中查看結(jié)果。而你使用未經(jīng)樣式化的 HTML 編寫的任何文檔都可以通過(guò)添加樣式表來(lái)美化。
—— Jim Hall
在上世紀(jì) 80/90 年代，當(dāng)我在 System V Unix、SunOS，最后是 Solaris 上工作時(shí)，我使用了 nroff、troff 和最終的 groff 與 mm 宏。你可以了解一下使用 groff_mm 的 MM（前提是你已經(jīng)安裝了它們）。
MM 并不是真正的標(biāo)記語(yǔ)言，但它感覺(jué)像是。它是一套非常語(yǔ)義化的 troff 和 groff 宏。它具備標(biāo)記語(yǔ)言用戶所期望的大多數(shù)功能，如標(biāo)題、有序列表等等。
我的第一臺(tái) Unix 機(jī)器上也安裝了 “Writers' Workbench”，這對(duì)我們組織中需要撰寫技術(shù)報(bào)告但沒(méi)有特別進(jìn)行“引人入勝”寫作的許多人來(lái)說(shuō)是一個(gè)福音。它的一些工具已經(jīng)進(jìn)入了 BSD 或 Linux 環(huán)境，比如樣式（style）、用詞檢查（diction）和外觀（look）。
我還記得早在上世紀(jì) 90 年代初期，Solaris 附帶了一個(gè)標(biāo)準(zhǔn)通用標(biāo)記語(yǔ)言（SGML）工具，也可能是我們購(gòu)買了這個(gè)工具。我曾經(jīng)使用它一段時(shí)間，這可能解釋了為什么我不介意手動(dòng)輸入 HTML。
我使用過(guò)很多 Markdown，我應(yīng)該說(shuō)是“哪種 Markdown”，因?yàn)樗袩o(wú)數(shù)種風(fēng)格和功能級(jí)別。正因?yàn)槿绱耍也⒉皇?Markdown 的鐵桿粉絲。我想，如果我有很多 Markdown 要處理，我可能會(huì)嘗試使用一些 CommonMark 的實(shí)現(xiàn)，因?yàn)樗鼘?shí)際上有一個(gè)正式的定義。例如，Pandoc 支持 CommonMark（以及其他幾種）。
我開(kāi)始使用 AsciiDoc，相比于 Markdown，我更喜歡 AsciiDoc，因?yàn)樗苊饬恕澳闶褂玫氖悄膫€(gè)版本”的討論，并提供了許多有用的功能。過(guò)去，讓我對(duì) AsciiDoc 感到困擾的是，有一段時(shí)間似乎需要安裝 Asciidoctor，這是一個(gè)我不太想安裝的 Ruby 工具鏈。但是現(xiàn)在，在我所用的 Linux 發(fā)行版中，有了更多的實(shí)現(xiàn)方式。奇怪的是，Pandoc 可以輸出 AsciiDoc，但不支持讀取 AsciiDoc。
那些嘲笑我不愿意為 AsciiDoc 安裝 Ruby 工具鏈，卻樂(lè)意安裝 Pandoc 的 Haskell 工具鏈的人……我聽(tīng)到你們的笑聲了。
我羞愧地承認(rèn)，我現(xiàn)在主要使用 LibreOffice。
——Chris Hermansen
文檔編寫可以通過(guò)多種不同的途徑來(lái)完成，正如這里的作者們展示的那樣。對(duì)于代碼的使用方法，特別是在開(kāi)源領(lǐng)域，進(jìn)行文檔編寫非常重要。這確保其他人能夠正確地使用和貢獻(xiàn)你的代碼。同時(shí)，告訴未來(lái)的用戶你的代碼提供了什么也是明智之舉。
本文鏈接：http://m.rrqrq.com/showinfo-26-5150-0.html你喜歡哪種文檔標(biāo)記語(yǔ)言？
聲明：本網(wǎng)頁(yè)內(nèi)容旨在傳播知識(shí)，若有侵權(quán)等問(wèn)題請(qǐng)及時(shí)與本網(wǎng)聯(lián)系，我們將在第一時(shí)間刪除處理。郵件：2376512515@qq.com
上一篇： 實(shí)現(xiàn)分布式事務(wù)：Java與MySQL的XA事務(wù)協(xié)調(diào)
Copyright ? 2016-2023 天津谷騏科技有限公司 版權(quán)所有 sitemap.xml
違法及侵權(quán)請(qǐng)聯(lián)系：2376512515@qq.com 津ICP備18001702號(hào)
津公網(wǎng)安備 12010102000574號(hào)