goapi自动构建系统(GoAmis快速搭建建议动态网站)
goapi自动构建系统(GoAmis快速搭建建议动态网站)其中redis-data-helper目录下就是工具的所有代码,amis.tmpl文件为首页模板,通过渲染index.json的配置初始化页面。其余每个JSON文件对应一个组件。整个项目为单页应用。工程示例先看最终效果:示例使用方式:在命令行执行命令后自动打开浏览器,自动跳转到工具web页面首页。
近日有个想法,之前写的命令行工具在使用中逐渐发现交互方式过于原始,自己用的很爽,但是给项目组其他同事使用时就捉襟见肘,于是想给工具加个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
<!DOCTYPE html>
<html lang="zh-hans">
<head>
<meta charset="UTF-8"/>
<title>goAmis</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
<meta name="viewport" content="width=device-width initial-scale=1 maximum-scale=1"/>
<meta http-equiv="X-UA-Compatible" content="IE=Edge"/>
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/amis@1.2.3/sdk/sdk.css"/>
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/amis@1.2.3/sdk/helper.css"/>
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/amis@1.2.3/sdk/iconfont.css"/>
<script src="https://cdn.jsdelivr.net/npm/amis@1.2.3/sdk/sdk.js"></script>
<style>
html
body
.app-wrapper {
position: relative;
width: 100%;
height: 100%;
margin: 0;
padding: 0;
}
</style>
</head>
<body>
<div id="root" class="app-wrapper"></div>
<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>
</body>
</html>
说明:
{{ .getConfigAddr }} & {{ .pageSchemaApi }} 会在页面返回之前将数据渲染进去返回给浏览器,这两个变量最终指向的是页面的布局json文件,index.json
下面看index.json文件实现:
{
"type": "page"
"body": [
{
"type": "alert"
"body": [
{
"type": "tpl"
"tpl": " Lwp-Postman 是由 <a href=\"#\">小飞</a> 基于 <a target=\"_blank\" href=\"https://baidu.github.io/amis/zh-CN/docs/index\">Amis</a> 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地址:关注后私信我发你