Golang開發(fā)的全功能單文件Web服務(wù)器

2024-01-16    分類: 網(wǎng)站建設(shè)

最新HTTP/2標(biāo)準(zhǔn)已經(jīng)發(fā)布,是基于谷歌QUIC的技術(shù)升級而成。雖然標(biāo)準(zhǔn)已經(jīng)發(fā)布,但是目前還鮮有應(yīng)用支持,那么有沒有方法進(jìn)行技術(shù)嘗鮮呢?答案是肯定的。本文蟲蟲給大家介紹一個Golang Web服務(wù)器應(yīng)用Algernon,作為一個單文件的Golang應(yīng)用內(nèi)置了HTTP/2,Lua,Markdown,Pongo2,HyperApp,Amber,Sass(SCSS),GCSS,JSX,BoltDB的功能,支持 Redis,PostgreSQL,MariaDB / MySQL數(shù)據(jù)庫。支持限速,插件,用戶和權(quán)限等各種功能。所有這些都包含在一個自包含可執(zhí)行文件中,麻雀雖小五臟俱全。

技術(shù)架構(gòu)

使用Golang開發(fā),后端數(shù)據(jù)庫可以使用Bolt(內(nèi)置),MySQL,PostgreSQL或Redis(推薦)。對各種功能支持總共使用了下面的類庫:

permissions2用于處理用戶和權(quán)限;gopher-lua用于解釋和運行Lua;http2用于服務(wù)HTTP/2,QUIC用于服務(wù)QUIC;blackfriday用于Markdown渲染;amber用于Amber模板;Pongo2用于Pongo2模板;Sass(SCSS)和GCSS用于CSS預(yù)處理;logrus用于日志記錄;goja-babel用于從JSX轉(zhuǎn)換為JavaScript;tollbooth用于速率限制;pie用于插件支持;graceful用于優(yōu)雅關(guān)閉。

設(shè)計思想

該項目源于用Markdown,Pongo2,Amber,HTML或JSX(+ React)等編寫應(yīng)用,并用CSS樣式支持和設(shè)計。數(shù)據(jù)使用Lua腳本與Redis,BoltDB,PostgreSQL或MariaDB/MySQL鏈接操作。

Pongo2,Sass和Lua也是很好的一個選擇,而且Pongo2比Amber更靈活。

Bolt是一個純粹的key/value存儲,使用Golang編寫。Bolt無需預(yù)先安裝設(shè)置數(shù)據(jù)庫,內(nèi)置在Algernon中使用。也支持廣泛使用的數(shù)據(jù)庫,比如MariaDB/MySQL和PostgreSQL。

Algernon以下文件進(jìn)行特殊渲染和解析以下文件(后綴),按優(yōu)先順序排列:

index.lua是Lua代碼,動態(tài)lua腳本處理。

index.html HTML默認(rèn)頁面。

index.md 渲染為HTML下的Markdown代碼。

index.txt 純文本文件。

index.pongo2,index.po2或index.tmpl渲染為HTML的Pongo2代碼。

index.amber渲染為HTML的Amber代碼。

index.hyper.js或index.hyper.jsx渲染為HTML的JSX + HyperApp代碼

data.lua是Lua代碼,其中函數(shù)和變量可用于同一目錄中的Pongo2、Amber和Markdown頁面。

如果將單個Lua腳本作為命令行參數(shù)提供,用于獨立服務(wù)器。它可用于設(shè)置處理程序或為特定URL前綴提供文件和目錄。

style.gcss是GCSS代碼,支持對同目錄下的Pongo2,Amber和Markdown頁面的樣式。

總之,Algernon支持對以下文件擴(kuò)展名的處理??:

Markdown:.md(渲染為HTML)

Pongo2:.po2,.pongo2或.tpl(渲染為任何文本,通常為HTML)

琥珀色:.amber(渲染為HTML)

Sass:.scss(渲染為CSS)

GCSS:.gcss(渲染為CSS)

JSX:.jsx(渲染為JavaScript / ECMAScript)

Lua:.lua(提供自己的輸出和內(nèi)容類型的腳本)

HyperApp:.hyper.js或.hyper.jsx(渲染為HTML)

根據(jù)擴(kuò)展名為其他文件指定mimetype。

沒有索引文件的目錄顯示為目錄列表。

盡可能使用UTF-8。

可以通過命令行或lua腳本配置服務(wù)器,但是配置是非必須的,默認(rèn)無需配置既可以使用。

技術(shù)特點

支持HTTP,HTTP/2,默認(rèn)啟動HTTPS(HTTP/2需要瀏覽器支持)。

支持Lua動態(tài)程序,可以使用Lua腳本處理程序。

Algernon可執(zhí)行文件為本機(jī)靜態(tài)編譯編,速度相當(dāng)快。

適用于Linux,OS X和64位Windows。

Lua解釋器被編譯為可執(zhí)行文件。

支持熱部署自動刷新功能,實時編輯/實時預(yù)覽。

自包含的Algernon應(yīng)用程序可以壓縮到存檔(以.zip或.alg結(jié)尾),支持子啟動時加載。

內(nèi)置支持Markdown,Pongo2,Amber,Sass(SCSS),GCSS和JSX。

默認(rèn)情況下,使用Redis作為數(shù)據(jù)庫后端,如果沒有可用的Redis服務(wù)器,Algernon將使用內(nèi)置的Bolt數(shù)據(jù)庫。

可以對Markdown渲染的HTML頁面指定以MultiMarkdown語法的標(biāo)題:

title: Title內(nèi)容。

后臺無需要文件轉(zhuǎn)換器(如SASS)即可進(jìn)行文件轉(zhuǎn)化。

如果設(shè)置了autorefresh,源文件時自動刷新頁面。

交互式REPL。

如果Markdown文件名作為第一個參數(shù),則它將在端口3000上提供預(yù)覽,無需任何數(shù)據(jù)庫。方便在本地查看README.md文件。

完全多線程。將使用所有可用的CPU。

支持通過tollbooth進(jìn)行速率限制。

Lua REPL提供了幫助命令,可快速瀏覽可用的Lua功能。

可以加載用任何語言編寫的插件。插件必須提供Lua.Code和Lua.Help函數(shù),并通過stderr + stdin來交互JSON-RPC。

內(nèi)置線程安全文件緩存,具有多種可用緩存模式(例如,僅用于緩存圖像)。

可以讀取并保存到JSON文檔。支持簡單的JSON路徑表達(dá)式(如簡單版本的XPath,但對于JSON)。

支持緩存壓縮,可以將緩存中存儲的文件直接從緩存發(fā)送到客戶端,無需解壓縮。

對大于4096B的文件發(fā)送到客戶端的文件默認(rèn)使用gzip壓縮。

使用PostgreSQL作為后端數(shù)據(jù)庫時候,默認(rèn)使用HSTORE鍵/值類型(PostgreSQL 9.1或更高版本)。

沒有外部依賴,純Golang程序。

需要Go 1.12或更高版本。另外用于QUIC支持的包不支持使用gccgo(GCC)構(gòu)建。

安裝OS X

蘋果OS X系統(tǒng)可以使用包管理器直接安裝:

brew install algernon

如果沒有安裝Homebrew包管理器,請先安裝。

Arch Linux

可以使用AUR源安裝:

pacman -S algernon

二進(jìn)制包

其他系統(tǒng)請下載對應(yīng)二進(jìn)制包即可使用。

源碼安裝

從源碼編譯安裝,適用于任何系統(tǒng)。用get命令從官方主分支下載最新源碼

get -u github/xyproto/algernon

使用該方法安裝,需要先設(shè)置GOPATH, 并將$GOPATH/bin添加到執(zhí)行PATH中

export GOPATH =~/go

export PATH = $PATH:$GOPATH/bin

也可以先git clone到本地然后編譯安裝

Golang 1.12版本

早期Golang版本

docker容器Algernon基本使用運行Algernon:以開發(fā)者模式運行

algernon -e

該命令啟用調(diào)試模式,以內(nèi)置的Bolt數(shù)據(jù)庫,以HTTP形式啟動,并對除了以下類型的其他文件啟用緩存,這些類型包括Pongo2,Amber,Lua,Sass,GCSS,Markdown和JSX。

新建一個簡單的hello lua文件index.lua:

瀏覽器訪問,結(jié)果如下:

自定義Algernon應(yīng)用程序

創(chuàng)建應(yīng)用目錄:

mkdir mypage && cd mypage

創(chuàng)建名為index.lua的文件,其中包含以下內(nèi)容和上面一樣。

啟動:

algernon --httponly --autorefresh .

啟動增加參數(shù)autorefresh,使得文件編輯后可以熱加載實時生效。可以試著編輯下index.lua并刷新瀏覽器以查看新結(jié)果。

注意—autorefresh對Markdown,Pongo2和Amber頁面也生效,比如我新建一個chongchong.md頁面:

然后瀏覽器訪問:

HTTP/2 和HTTPS支持應(yīng)用

利用openssl創(chuàng)建創(chuàng)建自簽名證書,僅用于測試:

openssl req -x509 -newkey rsa:4096 -keyout key.pem -out cert.pem -days 3000 -nodes

結(jié)果中,按照提示中按Return鍵,在Common Name時候輸入任意名稱,我們輸入的是CC,就會在本目錄生成cert.pem和key.pem兩個證書文件

啟動

algernon .

然后通過瀏覽器以https訪問:

https://localhost:3000

由于使用子簽名證書,沒有添加根域證書,需要在瀏覽器添加信息才能訪問。

注意https頭信息,確實是HTTP/2。

Lua支持基本的Lua功能

//返回服務(wù)器的版本字符串。

version() -> string

//睡眠給定的秒數(shù)(可以是浮點數(shù))。

sleep(number)

//將給定的字符串記錄為信息。采用可變數(shù)量的字符串。

log(...)

//將給定的字符串記錄為警告。采用可變數(shù)量的字符串。

warn(...)

//將給定的字符串記錄為錯誤。采用可變數(shù)量的字符串。

err(...)

//返回1970年的納秒數(shù)(Unix時間)

unixnano() -> number

//將Markdown轉(zhuǎn)換為HTML

markdown(string) -> string

//返回運行REPL或腳本的目錄。如果給出了文件名(可選),則返回腳本運行的路徑,使用路徑分隔符和給定的文件名連接。

scriptdir([string]) -> string

//返回運行服務(wù)器的目錄。如果給出了文件名(可選),則返回服務(wù)器運行的路徑,使用路徑分隔符和給定的文件名連接。

serverdir([string]) -> string

Lua插件

//在給定可執(zhí)行文件路徑的情況下加載插件。成功時返回true。如果在Lua提示符上調(diào)用,將返回插件幫助文本。

Plugin(string)

//給定一個插件路徑,返回插件中Lua.Code函數(shù)返回的Lua代碼??赡軙祷匾粋€空字符串。

PluginCode(string) -> string

//獲取插件路徑,函數(shù)名稱和參數(shù)。如果函數(shù)調(diào)用失敗,則返回空字符串;如果成功,則返回結(jié)果為JSON字符串。

CallPlugin(string, string, ...) -> string

Lua代碼庫函數(shù)

這些函數(shù)可以與插件函數(shù)結(jié)合使用,用于存儲加載serverconf.lua時插件返回的Lua代碼,然后在處理請求時檢索Lua代碼。

//創(chuàng)建或使用代碼庫對象。 (可選)將數(shù)據(jù)結(jié)構(gòu)名稱作為第一個參數(shù)。

CodeLib([string]) -> userdata

//給定命名空間和Lua代碼,將給定代碼添加到命名空間。成功時返回true。

codelib:add(string, string) -> bool

//給定命名空間和Lua代碼,將給定代碼設(shè)置為命名空間中的唯一代碼。成功時返回true。

codelib:set(string, string) -> bool

//給定命名空間,返回Lua代碼或空字符串。

codelib:get(string) -> string

//將給定命名空間中的(eval)代碼導(dǎo)入當(dāng)前的Lua狀態(tài)。成功時返回true。

codelib:import(string) -> bool

//完全清除代碼庫。成功時返回true。

codelib:clear() -> bool

Lua文件上傳函數(shù)

//創(chuàng)建文件上傳對象。采用表單ID(來自POST請求)作為第一個參數(shù)。將可選的大上載大?。ㄒ訫iB為單位)作為第二個參數(shù)。

//失敗時返回nil和錯誤字符串,成功時返回userdata和空字符串。

UploadedFile(string[, number]) -> userdata, string

//返回客戶端指定的上傳文件名

uploadedfile:filename() -> string

//返回已接收數(shù)據(jù)的大小

uploadedfile:size() -> number

Lua處理請求函數(shù)

//設(shè)置頁面的Content-Type。

content(string)

//返回請求的HTTP方法(GET,POST等)。

method() -> string

//將文本輸出到瀏覽器/客戶端。采用可變數(shù)量的字符串。

print(...)

//返回請求的URL路徑。

urlpath() -> string

//返回請求中的HTTP標(biāo)頭,給定鍵或空字符串。

header(string) -> string

//在給定鍵和值的情況下設(shè)置HTTP標(biāo)頭。

setheader(string, string)

更多函數(shù)支持請參考官方文檔,此處略。

Markdown支持

Algernon實現(xiàn)對Markdown的快速瀏覽,實現(xiàn)在線webMarkdown查看器。-m標(biāo)志用來啟動:

algernon -m README.md在瀏覽器中查看README.md。

除了常規(guī)的Markdown語法之外,Algernon還支持在Markdown文件的頂部設(shè)置頁眉標(biāo)題和語法高亮樣式,如下所示:

該代碼將使用highlight.js突出顯示代碼,并提供多種樣式。

replace_with_theme后面的字符串將用于替換當(dāng)前主題字符串與給定字符串。這使得可以為一個主題使用一個圖像(如logo_default_theme.png)。主題可以是light,dark,redbox,bw,github,wing,material,neon,default,werc或CSS文件的路徑?;蛘咄荒夸浵碌膕tyle.gcss文件自定義的樣式。

范例和截圖

官方提供了大量的范例可以供使用,可以在官方倉下載samplepack.zip安裝包,解壓到web目錄更目錄然后通過瀏覽器就可以訪問。

bootstrap小應(yīng)用hyperapp計數(shù)

這是在啟用調(diào)試模式時處理Lua腳本中的錯誤的方法。

three.js

Algernon Charles Swinburne的一首詩,背景中有三個旋轉(zhuǎn)的圓環(huán)。使用CSS3高斯模糊,使用three.js作為3D圖形。

prettify代碼美化

美化樣本的屏幕截圖,由單個Lua腳本提供。

todo小程序

使用Alact和Algernon交互使用

tiles圖片拼圖小游戲

非常感謝您讀完創(chuàng)新互聯(lián)的這篇文章:"Golang開發(fā)的全功能單文件Web服務(wù)器",僅為提供更多信息供用戶參考使用或為學(xué)習(xí)交流的方便。我們公司提供:網(wǎng)站建設(shè)、網(wǎng)站制作、官網(wǎng)建設(shè)、SEO優(yōu)化、小程序制作等服務(wù),歡迎聯(lián)系我們提供您的需求。

標(biāo)題名稱:Golang開發(fā)的全功能單文件Web服務(wù)器
當(dāng)前路徑:http://www.muchs.cn/news43/313893.html

成都網(wǎng)站建設(shè)公司_創(chuàng)新互聯(lián),為您提供網(wǎng)站改版ChatGPT、建站公司、網(wǎng)站維護(hù)網(wǎng)站內(nèi)鏈面包屑導(dǎo)航

廣告

聲明:本網(wǎng)站發(fā)布的內(nèi)容(圖片、視頻和文字)以用戶投稿、用戶轉(zhuǎn)載內(nèi)容為主,如果涉及侵權(quán)請盡快告知,我們將會在第一時間刪除。文章觀點不代表本網(wǎng)站立場,如需處理請聯(lián)系客服。電話:028-86922220;郵箱:631063699@qq.com。內(nèi)容未經(jīng)允許不得轉(zhuǎn)載,或轉(zhuǎn)載時需注明來源: 創(chuàng)新互聯(lián)

商城網(wǎng)站建設(shè)