Go + Amis 快速搭建建议动态网站
近日有个想法，之前写的命令行工具在使用中逐渐发现交互方式过于原始，自己用的很爽，但是给项目组其他同事使用时就捉襟见肘，于是想给工具加个UI界面。
结合自己的技术栈，我更希望工具直接用之前的golang代码，同时有以下几个诉求：
- 使用golang开发
- 足够轻量
- 学习实现成本低
- 跨平台，至少支持 arm&x86平台，至少支持windows、linux、macOS
调研了现在的golang客户端UI库，主要有两类选择，一种是类似qt、gotk3类型的客户端UI库，另一种是使用webview，支持css+html+js实现UI方案，经过挑选之后，主要就几个方案：
- golang + go-astilectron
- golang + qt
- golang + amis
由于不需要考虑 安卓 & ios等移动平台，也不需要复杂的UI页面特效，最终这里选择了 golang + amis, 其中amis是百度的低代码解决方案，可以使用json轻松编辑页面，对于本人常年浸淫在纯后端开发的工程师而言，会更简单。
先看最终效果：
示例
使用方式：在命令行执行命令后自动打开浏览器，自动跳转到工具web页面首页。
工程示例
其中redis-data-helper目录下就是工具的所有代码，amis.tmpl文件为首页模板，通过渲染index.json的配置初始化页面。其余每个json文件对应一个组件。整个项目为单页应用。
最终工具会将所有json文件&tmpl模板文件 go embed到编译产物中，使用工具的同学完全不用关心环境搭建等麻烦问题。
详细教程：
首先创建一个模板文件amis.tmpl
goAmis
<script src="https://cdn.jsdelivr.net/npm/amis@1.2.3/sdk/sdk.js"></script>
<script type="text/javascript">
(function () {
const amis = amisRequire('amis/embed');
const amisJSON = {
"type": "page",
"toolbar": [
{
"type": "button",
"label": "获取当前页面配置",
// "confirmText": "是否跳转获取页面的配置 ？",
"url": "{{ .getConfigAddr }}",
"actionType": "url"
}
],
"body": [
{
type: "service",
schemaApi: "{{ .pageSchemaApi }}"
}
]
};
amis.embed('#root', amisJSON, {}, {});
})();
</script>
说明：
{{ .getConfigAddr }} & {{ .pageSchemaApi }} 会在页面返回之前将数据渲染进去返回给浏览器，这两个变量最终指向的是页面的布局json文件，index.json
下面看index.json文件实现：
{
"type": "page",
"body": [
{
"type": "alert",
"body": [
{
"type": "tpl",
"tpl": " Lwp-Postman 是由 小飞 基于 Amis + Golang 搭建的多功能服务工具",
"inline": false,
"wrapperComponent": "div"
}
],
"level": "success"
},
{
"type": "divider"
},
{
"type": "tabs",
"mode": "vertical",
"tabs": [
{
"title": "文件服务",
"type": "service",
"schemaApi": "GET: /config/get/media_id"
},
{
"title": "文件上传",
"type": "service",
"schemaApi": "GET: /config/get/file_upload"
},
{
"title": "Location",
"type": "service",
"schemaApi": "GET: /config/get/location"
},
{
"title": "Lwp请求模拟",
"type": "service",
"schemaApi": "GET: /config/get/media_id"
},
{
"title": "更多",
"type": "service",
"schemaApi": "GET: /config/get/media_id"
}
]
}
],
"regions": [
"body"
],
"messages": {},
"className": "r b-a b-2x"
}说明：go服务端要实现 http接口，处理 `/config/get/media_id` 请求。
go服务端代码示例：
golang + gin框架
func main() {
initBoltDB()
tmplFs, err := fs.Sub(systemStatic, "static")
if err != nil {
log.Fatalln(err)
return
}
tmpl, err := template.ParseFS(tmplFs, "*.tmpl")
if err != nil {
log.Fatalln(err)
return
}
port := os.Getenv("PORT")
if port == "" {
port = defaultPort
}
engine := gin.Default()
engine.SetHTMLTemplate(tmpl)
// 首页直接跳转到默认页面
engine.GET("/", func(c *gin.Context) { c.Redirect(http.StatusPermanentRedirect, "/page/"+defaultIndex) })
engine.GET("/page/:name", renderPage)
// 页面配置
engine.GET("/config/list", listConfig)
engine.GET("/config/get/:name", getConfig)
engine.GET("/config/delete/:name", deleteConfig)
engine.POST("/config/save", saveConfig)
engine.POST("/file/media_id/decode", func(context *gin.Context) {
log.Printf("form:%v", context.Request.Form)
//{"status":0,"msg":"保存成功","data":{"id":1}}
context.JSON(http.StatusOK, map[string]interface{}{
"status": 0,
"msg": "提交",
"data": map[string]interface{}{
"id": "hello fayren",
},
})
})
go func() {
if err := engine.Run(":" + port); err != nil {
log.Fatalln(err)
return
}
}()
Open("http://localhost/page/index")
select {}
}
func renderPage(c *gin.Context) {
name := c.Param("name")
if name == "" {
name = "404"
}
c.HTML(http.StatusOK, "amis.tmpl", gin.H{
"pageTitle": name,
"asideSchemaApi": "GET:/config/get/aside",
"pageSchemaApi": "GET:/config/get/" + name,
"getConfigAddr": "/config/get/" + name,
})
}
func listConfig(c *gin.Context) {
var pages []*pageItem
if err := boltDB.View(func(tx *bolt.Tx) error {
bucket := tx.Bucket(defaultBucket)
return bucket.ForEach(func(k, v []byte) error {
pages = append(pages, &pageItem{Name: string(k), Config: string(v)})
return nil
})
}); err != nil {
c.AbortWithStatusJSON(http.StatusOK, &basicResp{Status: -1, Msg: err.Error()})
return
}
c.JSON(http.StatusOK, &basicResp{Status: 0, Data: map[string]interface{}{
"items": pages,
"total": len(pages),
}})
}
func getConfig(c *gin.Context) {
var name = c.Param("name")
if name == "" {
c.AbortWithStatusJSON(http.StatusOK, &basicResp{Status: -1, Msg: "name is empty"})
return
}
var pageData []byte
_ = boltDB.View(func(tx *bolt.Tx) error {
bucket := tx.Bucket(defaultBucket)
pageData = bucket.Get([]byte(name))
return nil
})
// 404
if len(pageData) == 0 {
pageData = page404Data
}
c.Data(http.StatusOK, "application/json", pageData)
}
go服务端代码示例
由于实现非常简单，更多玩法待各位开发，欢迎交流~
附录：
Demo地址：关注后私信我发你