我如何实现外包的java项目生成器

为何做出这样的技术选型#

由于我自己的服务器资源紧张，也不想在这上面多花钱，就想到webassembly这个技术。全部编译成静态资源托管到cloudflare的page上面，就如同我这个博客一样。面对这样的需求我一下子就想到对wasm支持比较好的rust、golang和kotlin，但是由于我对rust不怎么感兴趣也没学过就成了golang与kotlin二选一的结局了。最后考虑到kotlin跨平台目前使用的前端UI还是jetpack，我自己对android开发不熟悉，最后选了golang的go-app来实现这一需求。至于js呢，js对于二进制文件的处理以及io方面的操作不是很方便，加上go标准库的优秀以及wasm运行效率上区别，还有就是我想用些有趣的方式去实现。

重要功能的实现#

模板#

模板资源就是一个个的特殊的java项目，里面的关键位置使用了golang标准库中的template来实现替换，并在编译时将这些文件一起编译到可执行文件中。在调用替换方法后会将前端传来的参数在里面一一替换。
不同的模板自己实现自己的生成逻辑，最后统一实现生成函数接口，给调用者。

示例代码#

统一生成zip压缩包二进制文件接口#

1
type TemplateData interface {
2
 GenZip() ([]byte, error)
3
}

1
func (data WebTemplateData) GenZip() ([]byte, error) {
2
 var buf bytes.Buffer
3
 zw := zip.NewWriter(&buf)
4
 defer zw.Close()
5

6
 // 遍历assets/gradle/web/2目录下所有文件
7
 err := fs.WalkDir(distFS, fmt.Sprintf("assets/gradle/web/%d", data.SpringBootVersion), func(path string, d fs.DirEntry, walkErr error) error {
8
  if walkErr != nil {
9
   return walkErr
10
  }
11

12
  // 计算相对路径（去除assets/gradle/web/2前缀）
13
  relPath := strings.TrimPrefix(path, fmt.Sprintf("assets/gradle/web/%d/", data.SpringBootVersion))
14
  if relPath == path { // 处理根目录情况
15
   relPath = ""
16
  }
17

18
  // 替换文件路径
19
  if strings.Contains(relPath, "moduleName") {
20
   relPath = strings.ReplaceAll(relPath, "moduleName", data.ModuleName)
21
  }
22

23
  if d.IsDir() {
24
   // 跳过根目录的创建（relPath为空时不创建）
25
   if relPath != "" {
26
    // 创建目录条目（zip目录需要以/结尾）
27
    _, err := zw.Create(relPath + "/")
28
    return err
29
   }
30
   return nil
31
  }
32
  // 判断文件是否需要替换
33
  var fileData []byte
34
  if strings.Contains(relPath, "build.gradle.kts") {
35
   strData, err := data.GenBuildKts()
36
   if err != nil {
37
    return err
38
   }
39
   fileData = []byte(strData)
40
  } else if strings.Contains(relPath, "settings.gradle.kts") {
41
   strData, err := data.GenSettingsKts()
42
   if err != nil {
43
    return err
44
   }
45
   fileData = []byte(strData)
46
  } else if strings.Contains(relPath, "application.properties") {
47
   strData, err := data.GenApplication()
48
   if err != nil {
49
    return err
50
   }
51
   fileData = []byte(strData)
52
  } else if strings.Contains(relPath, "run.sh") {
53
   strData, err := data.GenRunSh()
54
   if err != nil {
55
    return err
56
   }
57
   fileData = []byte(strData)
58
  } else if strings.Contains(relPath, "start_web.sh") {
59
   strData, err := data.GenStartWebSh()
60
   if err != nil {
61
    return err
62
   }
63
   fileData = []byte(strData)
64
  } else if strings.Contains(relPath, "dk_product_component.yaml.j2") {
65
   strData, err := data.GenBlueprint()
66
   if err != nil {
67
    return err
68
   }
69
   fileData = []byte(strData)
70
  } else if strings.Contains(relPath, "README.md") {
71
   strData, err := data.GenReadme()
72
   if err != nil {
73
    return err
74
   }
75
   fileData = []byte(strData)
76
  } else {
77
   // 读取文件内容
78
   fileDataS, err := distFS.ReadFile(path)
79
   if err != nil {
80
    return err
81
   }
82
   fileData = fileDataS
83
  }
84

85
  info, err := d.Info()
86
  if err != nil {
87
   return err
88
  }
89
  // 创建文件头
90
  fh, err := zip.FileInfoHeader(info)
91
  if err != nil {
92
   return err
93
  }
94
  fh.Name = relPath       // 设置文件在zip中的路径
95
  fh.Method = zip.Deflate // 使用默认压缩算法
96

97
  // 写入文件内容
98
  fileWriter, err := zw.CreateHeader(fh)
99
  if err != nil {
100
   return err
101
  }
102
  _, err = fileWriter.Write(fileData)
103
  return err
104
 })
105

106
 if err != nil {
107
  return nil, err
108
 }
109

110
 // 确保所有数据写入buffer
111
 if err := zw.Close(); err != nil {
112
  return nil, err
113
 }
114

115
 return buf.Bytes(), nil
116
}

模板内容替换逻辑#

1
func (data WebTemplateData) GenBuildKts() (string, error) {
2
 // 读取嵌入的模板文件
3
 buildBytes, err := distFS.ReadFile(fmt.Sprintf("assets/gradle/web/%d/build.gradle.kts", data.SpringBootVersion))
4
 if err != nil {
5
  return "", err // 改为返回错误而非 panic
6
 }
7

8
 // 解析模板内容
9
 tpl, err := template.New("buildGradle").Parse(string(buildBytes))
10
 if err != nil {
11
  return "", err
12
 }
13

14
 var result strings.Builder
15
 if err := tpl.Execute(&result, data); err != nil {
16
  return "", err
17
 }
18
 return result.String(), nil // 返回生成后的内容和错误
19

20
}

UI#

UI使用了go-app这个项目来操作dom元素，其中的难点是css样式和二进制文件保存。其中样式借助tailwind来写组件，再将他们排列组合。二进制文件的保存就很麻烦了，首先在dom树中添加了一个a标签，url上填入了压缩包的base64编码的字符串，在模拟点击触发使得浏览器下载压缩包，然后再移除这个元素。

示例代码#

UI 组件#

以button为例看起来其实和大部分的前端ui框架差不多

1
package compose
2

3
import "github.com/maxence-charriere/go-app/v10/pkg/app"
4

5
// Button 通用按钮组件（Tailwind版，类名拆分）
6
// btnType 可选值："primary"（默认）、"secondary"、"tertiary"、"warning"、"danger"
7
func Button(name, btnType string) app.HTMLButton {
8
 button := app.Button().
9
  Type("submit").
10
  Text(name).
11
  // 通用基础样式（每个类名单独作为字符串参数）
12
  Class(
13
   "rounded-md",
14
   "px-4",
15
   "py-2",
16
   "text-sm",
17
   "font-medium",
18
   "border",
19
   "border-transparent",
20
   "cursor-pointer",
21
   "transition-all",
22
   "duration-200",
23
   "ease-in-out",
24
  )
25

26
 // 根据类型设置具体样式（每个类名单独作为字符串参数）
27
 switch btnType {
28
 case "primary": // 主按钮
29
  button = button.Class(
30
   "bg-[#5072a7]",
31
   "text-white",
32
   "hover:bg-[#466492]",
33
   "active:bg-[#3d577c]",
34
  )
35

36
 case "secondary": // 次要按钮
37
  button = button.Class(
38
   "bg-white",
39
   "text-[#6c757d]",
40
   "border-[#6c757d]",
41
   "hover:bg-[#f8f9fa]",
42
   "active:bg-[#e9ecef]",
43
  )
44

45
 case "tertiary": // 第三级按钮
46
  button = button.Class(
47
   "bg-transparent",
48
   "text-[#5072a7]",
49
   "hover:bg-[#f0f4f8]",
50
   "active:bg-[#e6edf3]",
51
  )
52

53
 case "warning": // 警告按钮
54
  button = button.Class(
55
   "bg-[#ffc107]",
56
   "text-[rgba(0,0,0,0.85)]",
57
   "hover:bg-[#ffca2c]",
58
   "active:bg-[#ffb700]",
59
  )
60

61
 case "danger": // 危险按钮
62
  button = button.Class(
63
   "bg-[#dc3545]",
64
   "text-white",
65
   "hover:bg-[#e04b59]",
66
   "active:bg-[#c82333]",
67
  )
68

69
 default: // 默认主按钮
70
  button = button.Class(
71
   "bg-[#5072a7]",
72
   "text-white",
73
   "hover:bg-[#466492]",
74
   "active:bg-[#3d577c]",
75
  )
76
 }
77
 return button
78
}

操作dom元素保存二进制文件#

1
package template
2

3
import (
4
 "encoding/base64"
5

6
 "github.com/maxence-charriere/go-app/v10/pkg/app"
7
)
8

9
func SaveZipDataLocally(ctx app.Context, e app.Event, zipBytes []byte, fileName string) {
10

11
 // 将ZIP文件内容编码为Base64
12
 b64Data := base64.StdEncoding.EncodeToString(zipBytes)
13

14
 // 创建Data URL
15
 dataURL := "data:application/zip;base64," + b64Data
16

17
 // 确保DOM操作在安全的上下文中执行
18
 ctx.Defer(func(ctx app.Context) {
19
  // 创建下载链接
20
  a := app.Window().Get("document").Call("createElement", "a")
21
  a.Set("href", dataURL)
22
  a.Set("download", fileName)
23

24
  // 添加到DOM并触发点击
25
  app.Window().Get("document").Get("body").Call("appendChild", a)
26
  a.Call("click")
27

28
  // 移除链接
29
  a.Call("remove")
30

31
 })
32
}

积累#

熟悉goalng的一些偏门用法。
更加熟悉外包项目中的模板渲染。
脱离框架后发现自己还挺行的。

踩坑#

前端组建和样式太难写了，最后还是借助了tailwind来写样式。
wasm中调用浏览器事件的难度超乎我的想象。
野心太大想要同时维护native app和web app，导致工作量太大了，使得功能迭代太慢了。
互联网上可以借鉴的文章太少了只能自己一点点尝试。

有成功帮我摸到鱼吗#

目前来说有但是不多，摸鱼的时间被我拿去优化这个生成器和学习zig去了。虽然提高了工作效率，但是也有可能导致需要完成的工作量变得更多，工资也不会涨。

吐槽#

用vscode在windwos上写go是真的卡，我自己电脑的配置本身也不低了，对比goland和zed简直卡暴了，开箱即用还得是goland。

项目地址#

gendk