去忘记
在 Milkio 的世界里,我们精心将开发的复杂性藏于幕后。对于那些经验丰富的开发者,可能会发现,有些习惯在这里并不适用,甚至会让你略感困惑。请暂时放下你以往的知识,全心投入到 Milkio 所带来的全新体验中吧!
接下来的章节,将会为那些初次接触 Milkio 的资深开发者们揭示一些常见的困惑和误区。如果你是新手,对某些内容感到迷惑也无需气馁,这恰恰说明 Milkio 正在保护你,让你远离那些过时的老旧知识。因此,这部分内容你可以跳过。
使用 VS Code 扩展启动 HTTP 服务器
Milkio 的 VS Code 扩展是不可或缺的。为了实现跨运行时的无缝体验和提升开发效率,Milkio 将自动重载和执行生成阶段等功能无缝地整合到了 VS Code 扩展中。这意味着,仅仅运行 bun dev
后,你的代码改动不会自动生效,因为 VS Code 扩展并未介入。因此,无需再通过繁琐的终端命令来启动工程,只需在 VS Code 中点击几下即可。
客户端访问服务器时,避免直接使用 Fetch 或 Axios
每个 Milkio 工程都配有一个专属的客户端包。当客户端安装了这个包后,你可以享受到自动补全和类型推断的便利,并且可以轻松地与后端共享类型信息。而使用 Fetch 或 Axios 直接发送请求将无法获得这些好处。
因此,请记得使用你的 Milkio 工程的客户端包进行请求发送,而不是直接使用 Fetch 或 Axios。
不再有 HTTP 方法和 form-data/urlencoded
在 Milkio 的框架下,我们不再区分不同的 HTTP 方法,简单地说,所有的 API 都默认为 POST 方法。同时,为了保证类型安全,我们也不支持 form-data 或 urlencoded 这样的参数传递方式,因为它们难以保留类型信息。
因此,请不要使用 form-data 或 urlencoded 来传递数据。Milkio 支持 JSON,并在此基础上扩展了更多类型和文件传输等特性。详细信息可以参考 TSON。
测试驱动开发,告别 Postman
在 Milkio 中,你不应该依赖于 Postman 这类工具来调试或测试你的 API,而应该使用 Milkio 内置的测试功能。你应该利用 Milkio 的测试功能来调试你的 API,并在调试完成后,将这些测试用例转化为测试案例,这样你不仅避免了在 Postman 中重复定义 API,还能享受到类型安全带来的好处。Milkio 提供了 Cookbook,可以自动生成文档,因此,你不再需要使用 Postman 等工具了。