© ����-���� BASE, Inc. � Building API server-side architecture for Beginners GopherCon ���� ����.��.�� - @hgsgtk © ����-���� BASE, Inc. � Talk abstract • A practical approach to build server-side not be ignored © ����-���� BASE, Inc. �� Go beginners have a lot of questions� How to implement API server by net/http package How to write an unit test How to use interface type - Go basic questions implement API server by net/http package How to write an unit test - Go basic questions - ex. “Adopt clean architecture!” How to use interface type © ����-���� BASE, Inc. How to implement API server

从 0 到 1 搭建十亿级包 裹 API Versioning 杨利航 AfterShip 高级研发工程师 这是 API Versioning 吗？ 目 录 Why 01 What 02 How 03 Takeaway 04 Why Part 1/4 1. SaaS 产品的特点 2. API 的重要性 3. 我们 API 面临的挑战 1.1 SaaS 产品的特点 SaaS 1.2 API 的重要性 API 也是产品的一部分，而不仅仅是技术。对于 SaaS 产品，提供 API 服务几乎是与企业级用户合作的必须项，特别是在海外。 - 自动化 - 通过 API，企业可以利用 SaaS 产品的功能来构建自动 化流程和工作流程。 - 定制化 - 通过 API，企业可以开发自己的应用程序、插件或集成 其他工具，以满足特定的业务需求。 - 数据集成 - 通过 API，企业可以灵活地与 - OAuth2.0 - … 1.2.2 AfterShip API 的演进路线 业务量从十万级到十亿级，从没有 API 到高标准的 API。不是因为 API 做好了所以业务增长了，而是良 好的 API 设计才能支撑业务增长。 1.3 我们 API 面临的挑战 挑战一、变更不规律，打乱客户更新计划 向后兼容 - API 的稳定性要求避免破坏性的更改。在进行更新或修改时，应 保持对现有

3.4 Go的http包详解 3.5 小结 4.表单 4.1 处理表单的输入 4.2 验证表单的输入 4.3 预防跨站脚本 4.4 防止多次递交表单 4.5 处理文件上传 4.6 小结 5.访问数据库 5.1 database/sql接口 5.2 使用MySQL数据库 5.3 使用SQLite数据库 5.4 使用PostgreSQL数据库 5.5 使用beedb库进行ORM开发 5.6 //有些机器显示如下，例如ubuntu10.04 x86_64 GNU/Linux 32位系统显示 <一段描述> i686 i686 i386 GNU/Linux Mac 安装 Mac 安装 访问下载地址，32位系统下载go1.0.3.darwin-386.pkg，64位系统下载go1.0.3.darwin-amd64.pkg，双击下载文件， 一路默认安装点击下一步，这个时候go已经安装到你 如果出现go的Usage信息，那么说明go已经安装成功了；如果出现该命令不存在，那么可以检查一下自己的PATH环境 变中是否包含了go的安装目录。 Linux 安装 Linux 安装 访问下载地址，32位系统下载go1.0.3.linux-386.tar.gz，64位系统下载go1.0.3.linux-amd64.tar.gz， 假定你想要安装Go的目录为 $GO_INSTALL_DIR，后面替换为相应的目录路径。

新旧模型对比：任务和worker 14.8 惰性生成器的实现 14.9 实现 Futures 模式 第 15 章 网络，模板和网页应用 15.1 tcp服务器 15.2 一个简单的网页服务器 15.3 访问并读取页面 15.4 写一个简单的网页应用 第 16章 常见的陷阱与错误 16.1 误用短声明导致变量覆盖 16.2 误用字符串 16.3 发生错误时使用defer关闭一个文件 16.4 （书中会使用大家所熟知的缩写 “OO” 来表示面向对象）。 本书将会从最基础的概念讲起，同时也会讨论一些类似在应用 goroutine 和 channel 时有多少种不同的模式， 如何在 Go 语言中使用谷歌 API，如何操作内存，如何在 Go 语言中进行程序测试和如何使用模板来开发 Web 应 用这些高级概念和技巧。 在本书的第一部分，我们将会讨论 Go 语言的起源（第 1 章），以及如何安装 Go 语言（第 此，你绝对不可 以忽略书中的 130 个代码练习，这将对你学习好 Go 语言有很大的帮助。比如，我们就为斐波那契算法提供了 13 个不同的版本，而这些版本都使用了不同的概念和技巧。 你可以通过访问本书的 官方网站 下载书中的代码（译者注：所有代码文件已经包括在 GitHub 仓库中），并获得 有关本书的勘误情况和内容更新。 为了让你在成为 Go 语言大师的道路上更加顺利，我们会专注于一些特别的章节以提供

本书将会从最基础的概念讲起，同时也会讨论一些类似在应用 goroutine 和 channel 时有多少种不同的模 Go入门指南 - 1 - 本文档使用 看云 构建 式，如何在 Go 语言中使用谷歌 API，如何操作内存，如何在 Go 语言中进行程序测试和如何使用模板来 开发 Web 应用这些高级概念和技巧。 在本书的第一部分，我们将会讨论 Go 语言的起源（第 1 章），以及如何安装 Go 语言（第 案。因此，你绝对不可以忽略书中的 130 个代码练习，这将对你学习好 Go 语言有很大的帮助。比如，我 们就为斐波那契算法提供了 13 个不同的版本，而这些版本都使用了不同的概念和技巧。 你可以通过访问本书的 官方网站 下载书中的代码（译者注：所有代码文件已经包括在 GitHub 仓库中）， 并获得有关本书的勘误情况和内容更新。 为了让你在成为 Go 语言大师的道路上更加顺利，我们会专注于一些特别的章节以提供 App Engine 上的 Go Tour，你也可以通过执行命令 go install go-tour.googlecode.com/hg/gotour 安装到你的本地机器上。对于中文读者，可以访问该 指南的 中文版本，或通过命令 go install https://bitbucket.org/mikespook/go-tour-zh/gotour 进行 安装。 1.2 语言的主要特性与发展的环境和影响因素

要求会比较高 经典MVC模式 代码分层设计-三层架构模式 表示层 - UI 位于三层构架的最上层，与用户直接接触，主要是B/S中 的 WEB页面，也可以是API接口。 业务逻辑层 - BLL 对具体问题进行逻辑判断与执行操作。 数据访问层 - DAL 实现数据的增删改查等操作，并将操作结果反馈到业务逻辑层 BLL。 模型定义层 - Model 也常用Entity实体对象来表示，主要用于数据库表的映射对象。 也常用Entity实体对象来表示，主要用于数据库表的映射对象。 代码分层设计-项目代码结构 对象封装设计 第五部分 • 包与对象封装 • 资源明明规范 • 对象封装示例 • 对象访问安全 对象封装设计-包与对象封装 痛点： • 没有代码分层设计，代码耦合高 • 单包职责过大，维护成本高 • 包命名困难，易出现重复包名， 使用困惑，开发效率低 • 包管理困难，容易出现 cycle import 循环引用问题 在三层架构设计模式下，我们的业务包命名 仅会有 api、dao、model、service四个包。 每个业务包仅对外暴露 实例化的对象 用于 该业务领域的具体功能逻辑封装，同一层级 下不同的业务领域逻辑通过不同文件来分别 管理。 包对外的公开对象采用 业务领域名称 来命 名，包内部的数据结构定义采用 业务领域名 称+分层名称 来命名。 对象封装设计-对象封装示例1 api访问service层对象 访问service层对象具体操作

slice 或者 array 基础上来获 取一个 slice 这个例子里面slice的容量是8，新版本里面可以指定这个容量 上面这个的容量就是 7-2 ，即5。这样这个产生的新的 slice 就没办法访问最后的三个元素。 如果 slice 是这样的形式 array[:i:j] ，即第一个参数为空，默认值就是0。 map 看下面的代码， map 的读取和设置也类似 slice 一样，通过 key 像调用了 panic 。这一过程继续向上，直到发生 panic 的 goroutine 中所有调用的函数返回，此时程 序退出。 panic 可以直接调用 panic 产生。也可以由运行时错误产生，例如访问越界的数组。 Recover 是一个内建的函数，可以让进入 panic 状态的 goroutine 恢复过来。 recover 仅在延迟函数中有效。 在正常的执行过程中，调用 recover 会返回 赋值"Astaxie"给P的name属性. P.age = 25 // 赋值"25"给变量P的age属性 fmt.Printf("The person's name is %s", P.name) // 访问P的name属性. package main import "fmt" // 声明一个新的类型 type person struct { name string age int

多环境调度 业务数据统⼀调度 集群核⼼服务 Helm 镜像服务 Add-on filebeat / telegraf 监控 ⽇志 HPA Operator 注册中⼼ 配置中⼼ API ⽹关 微服务拓扑 全链路追踪 错误分析 ⽇志分析 主动监控 浏览器监控 APP 监控 慢SQL JVM 诊断 ⾃定义告警 APM 微服务管理 资源管理 标签管理 系统监控 集群管理 系统异常状况汇总 特点: 智能 通知分组 ⽇志分析 访问明细: 应⽤⽇志明细 Docker 报告: 应⽤⽇志搜索 错误⽇志定位 分布式⽇志查询 特点: 分布式⽀持 错误归集 浏览器洞察 访问明细: 设备 浏览器 访问路径 性能明细 (Resource Timing & Navigation Timing API) 报告: ⻚⾯性能 Ajax性能 ⻚⾯错误 特点: 特点: ⽆埋点的实现⽅案 运⾏时拓扑 访问明细: TraceId SpanId 报告: 实时⽹络拓扑图 实时调⽤延迟展示 特点: 实时反应系统状况 运营决策 视⻆: 系统资源使⽤，系统健康度 报告: 周报 ⽇报 ⼤盘 特点: 提供⾼视⻆的IT运营决策分析 Erda 的可观察性能⼒ 可观察性数据采集 - ⾃动发现并识别 services、 jobs 和 addons

协议设计：职责单一不适用； — 合并请求； ž TCP Handshake影响RTT; — keepalived&长连接； ž API动态加速； — proxy模式&动态CDN； SOA ž Web站点是PHP开发的，通过RPC交互； ž rpc和api都是基于Go开发的服务； ž 国内DNS->VIP->lvs->tengine->Go; ž 海外DNS->ELB Service之间通过Thrift或者net/rpc通讯； ž 依赖redis sdk访问redis； ž 直连mysql； ž 用户的所有业务逻辑基于Go处理； Service ž 服务应该是无状态的； ž api服务出现瓶颈的时候，直接scale out； ž graceful restart依赖健康检测； ž api质量监控，使用日志来追踪，通过本 地日志+flume+hdfs+hive； ž grpc支持http2，方便移动端app使用； Cache ž 模仿cpu使用多级cache； ž L1 cache：不经常修改，大量访问对性 能要求极致的，我们使用go map缓存信 息，使用COW保证无锁更新和访问； ž 使用redis作为核心的cache store； ž 使用hash mod region方式对cache进行 扩展； goconf

包名必须小写且符合Unix文件命令规则 – 包名全称，规则：[git仓库]/[用户]/[仓库路径] • 包里文件 – 源代码 – 测试代码 – API文档 – 其他资源文件 按规则可找到源代码，方便阅读 包导出名 • 包中定义的 – 类型 – 常量 – 变量 – 函数 • 如果首字母大写，则是全局可访问的 函数申明 • 使用 func 关键字申明函数 • 在包中定义函数，在函数中不能定义函数 • 参数类型在参数名的右边 函数值不只包含地址指针，还包含隶属函数的实例 – 匿名函数与函数变量 – 函数变量类型与函数签名 • 函数闭包 – 包函数 adder 隶属应用程序栈 – adder 返回的函数隶属 adder 执行时创建在堆中的栈 – 返回函数访问隶属函数实例的变量称为“闭包” Go语言入门资源 • 语言概览 – 官方Go指南，gotour – 系统的学习，go语言教程 • 程序结构 – 包/子包（main） • Go源代码 – 函数（main