教程介绍
现代软件架构已经逐渐从单体架构转向微服务架构,在微服务架构中服务间通信采用轻量级通信机制。对于轻量级通信的协议而言,通常基于 HTTP 和 RPC ,能让服务间的通信变的标准化并且无状态化。此外开发模式也越来越多的采用前后端分离的模式,在前后端分离的模式中,前后端通信一般是通过 HTTP 进行通信。
不管是微服务架构,还是前后端分离模式,都需要一个 HTTP API 服务器。而且在日后的开发生涯中可能需要构建很多个大大小小的 API 服务器,所以很多时候做 Go 语言后台开发其实就是做 API 开发。有很多种方法可以用来构建 API,很多企业构建 API 时,采用一种叫 REST 风格的方式来构建 API,它虽然调用性能不及 RPC,但维护性和扩展性更好,也更通用。由于本教程不讨论微服务之间的高频调用场景, 而 REST 在实际开发中,能够满足绝大部分的需求场景,基于它的其他优势,本教程采用 REST 风格来构建 API 服务器。此外,在媒体类型上选择了 JSON,因为它的内容更加紧凑,数据展现形式直观易懂,开发测试都非常方便。REST + JSON,这也是 Go API 开发中很常用的组合。
构建一个简单的 API 服务器很简单,但构建一个生产就绪的 API 服务还有很多工作要做。所谓的生产就绪,至少需要满足如下各方面:
1.需要读取配置文件、记录日志
2.需要连接数据库
3.需要对数据库做增删改查等操作
4.需要自定义业务错误码
5.需要进行 API 身份验证
6.需要给 API 增加 Swagger 文档
7.API 服务器需要满足高稳定性,高性能的要求
8.API 需要做高可用
….
可以看到要构建一个可以运行在生产环境中的 API 服务器有许多工作要做。本教程希望花尽可能短的时间,来教初学者了解和学习 Go API 开发的所有环节和功能点。构建中需要用到很多 Go 包,笔者也根据经验筛选出了一些非常优秀的 Go 包来使用,另外教程中很多地方也会附上笔者的开发经验和建议,希望对读者有一定的帮助。
你会学到什么
本教程是一个实战类的教程,旨在让初学者花尽可能短的时间,通过尽可能详细的步骤,历经 17 个 demo,最终一步步构建出一个生产级的 API 服务器。
从开发准备到 API 设计,再到 API 实现、测试和部署,每一步都详细介绍了如何去构建。通过本教程的学习,你将学到如下知识点:
知识点很多,跟着教程一节一节进行学习,你将完整的学会如何用 Go 做 API 开发。
适宜人群
掌握一定 Go 语法基础,零 Go 服务器研发经验,想通过一个完整的实战,来系统学习 Go 服务器开发的同学
有意从事 Go 服务器开发,但尚未入门或入门尚浅的同学
有过 Go 服务器开发经验,但想了解某一部分构建方法的同学
你应该具备什么
基本的 Go 语言编程知识
基本的 Linux/Uinx 命令行知识
本教程主要面向初学者,希望能无偿分享笔者的一些 API 研发经验,如遇到一些不太合理的地方还请多多包涵 :-) ,欢迎指正交流。
本次发布只讲解实战系列的 1-7 节。
本系列文章转载自公众号:腾讯游戏存储与计算技术 微信号: game_infra