在實際開發中,我們通常都是按照模塊進行開發,同一模塊的不同接口url往往是最后的一級url不同,具有相同的前綴url。因此,我們期望在后台開發中,可以按照模塊來進行處理我們的請求,對於這種需求,iris框架也是支持的。
usersRouter := app.Party("/admin", userMiddleware)
如上述代碼所示,iris框架中使用app.Party方法來對請求進行分組處理,第二個參數是處理路由組的中間件方法,通常情況下我們會在中間件中寫context.Next()方法。
應用程序內代碼配置
在iris框架開發中,初始化應用程序時已經使用了默認的配置值。作為開發者,我們可以不需要其他額外的配置就啟動我們的應用程序。
如果開發者想要自己根據自己的需求進行配置,iris框架也是支持的,本節課我們來學習一下iris框架所支持的配置方式。
現在主流的配置文件格式有:xml、yaml、 cnf、toml、json等等格式。xml現在使用的已經不多,cnf格式的配置文件適合數據庫的配置文件,在本節內容中,我們將帶大家學習多種配置文件的使用方法。
在iris程序的全局app實例中,支持通過多種方式進行代碼配置,途徑是多樣的:
-
1、使用app.Configure(iris.WithConfiguration(iris.Configuration{DisableStartuplog:false}))來對整體應用進行配置項配置
-
2、通過app.Run方法的第二個參數來進行相關的自定義配置項的配置,第二個參數的類型同1一致。
以上兩種方式,無論哪種方式,都是對app服務應用進行Configuration配置,提供應用配置的Configuration結構體定義所支持的配置項分別為:
-
DisableInterruptHandler:如果設置為true,當人為中斷程序執行時,則不會自動正常將服務器關閉。如果設置為true,需要自己自定義處理。默認為false。
-
DisablePathCorrection: 該配置項表示更正並將請求的路徑重定向到已注冊的路徑。比如:如果請求/home/ 但找不到此Route的處理程序,然后路由器檢查/home處理程序是否存在,如果是,(permant)將客戶端重定向到正確的路徑/home。默認為false。
-
EnablePathEscape:該配置選項用於配置是否支持路徑轉義。適用於請求url中包含轉義字符時進行配置。默認為false。
-
FireMethodNotAllowed: 默認為false。
-
DisableBodyConsumptionOnUnmarshal:該設置選項用於配置讀取請求數據的方法是否使用,如果設置為true,則表示禁用context.UnmarshalBody,context. ReadJSON以及context.ReadXML。默認為false。
-
DisableAutoFireStatusCode:該配置變量為控制是否處理錯誤自動執行,如果為true,則不會進行錯誤自動執行。該配置項默認為false。
-
TimeFormat:時間格式。默認格式為:"Mon, 02 Jan 2006 15:04:05 GMT"
-
Charset:字體格式選項。默認字體為:"UTF-8"
通過TOML配置文件進行配置
什么是toml? toml是Tom’s Obvious, Minimal Language的縮寫, toml是一種配置文件。TOML是前GitHub CEO, Tom Preston-Werner,於2013年創建的語言,其目標是成為一個小規模的易於使用的語義化配置文件格式。TOML被設計為可以無二義性的轉換為一個哈希表(Hash table)。
具體的項目配置使用中,我們需要創建config.tml類型的配置文件,並在程序中明確使用toml文件進行讀取配置內容。如下圖所所示:
app.Configure(iris.WithConfiguration(iris.TOML("./configs/iris.tml")))
通過YAML配置文件
YAML 是專門用來寫配置文件的語言,寫法簡潔、功能強大,比JSON格式還要方便。Yaml實質上是一種通用的數據串行化格式。Yaml的主要語法格式有以下幾項:
-
大小寫敏感。
-
使用縮進表示層級關系。
-
縮進時不允許使用Tab鍵,只允許使用空格。
-
縮進的空格數目不受限制,相同層級的配置元素 左側對齊即可。
在本節內容中,我們可以通過yaml配置文件來對應用進行簡單選項的的配置:
app.Configure(iris.WithConfiguration(iris.))
通過讀取自定義配置文件
這里我們給大家演示如何使用json格式的配置文件來進行應用的配置,然后從應用程序中進行讀取。
首先創建json格式的配置文件,並編寫配置項,如下圖:
{
"appname": "IrisDemo",
"port": 8000
}
在應用程序內,編程實現對配置文件的讀取和解析,如下圖:
file, _ := os.Open("/Users/hongweiyu/go/src/irisDemo/5-路由組及Iris配置/config.json")
defer file.Close()
decoder := json.NewDecoder(file)
conf := Coniguration{}
err := decoder.Decode(&conf)
if err != nil {
fmt.Println("Error:", err)
}
fmt.Println(conf.Port)
本節課我們帶大家學習了在iris框架中如何使用路由組和對應用進行相關的配置的內容,本節課學習的內容我們在實戰項目中都能能夠用到。