云原生项目实践DevOps(GitOps)+K8S+BPF+SRE，从0到1使用Golang开发生产级麻将游戏服务器—第8篇

麻将牌 (Mahjong tiles) 抽象和编码实战

一句话描述麻将游戏业务：

• 三人模式<三人两房>只用 条 子和 筒 子两种花色共 72 张牌。
• 四人模式<血战到底>使用 筒、条、万 三种花色共 108 张牌。

系列文章

1. Golang开发生产级麻将游戏服务器—第1篇
2. Golang开发生产级麻将游戏服务器—第2篇
3. Golang开发生产级麻将游戏服务器—第3篇
4. Golang开发生产级麻将游戏服务器—第4篇
5. Golang开发生产级麻将游戏服务器—第5篇
6. Golang开发生产级麻将游戏服务器—第6篇
7. Golang开发生产级麻将游戏服务器—第7篇

介绍

这将是一个完整的，完全践行 DevOps/GitOps 与 Kubernetes 上云流程的 Golang 游戏服务器开发的系列教程。

这个系列教程是对开源项目 Nanoserver 的完整拆解，旨在帮助大家快速上手 Golang（游戏）服务器后端开发。通过实践去理解 Golang 开发的精髓 —— Share memory by communication(通过通信共享内存)。

同时这个项目可能还会涉及到 Linux 性能调优（BPF 相关的工具）和系统保障（SRE）的相关的工作。

Step-By-Step 开发 Mahjong Server

• 单体架构理解 Mahjong Server 业务 -> Nano Distributed Game Server（分布式） + 微服务 改造。
• Demo：go-mahjong-server

牌（Tiles）抽象

定义 Tile struct

type Tile struct {
	Id    int
	Suit  int
	Rank  int
	Index int
}

• Id：108 张牌，用 0~107 标识每一张牌。
• Suit：三种花色，用 0~2 标识每一种花色（0：条，1：筒，2：万）。
• Rank：9 种点数，用 1~9 标识（如：1条，9条，1筒，9筒，1万，9万等…）。
• Index：索引（条：1~9，筒：11~19，万：21~29）。

通过一张表来理解

三种花色，每种类型牌的索引（Index）：

所有牌（这里是 108 张）的 ID 编号：

编码实战

通过 ID 获取 Tile

一个算术问题，没啥好说的。

• 三种花色，每种有 9 类不同的牌，每类又有 4 张相同的牌。

internal/game/tile.go

func TileFromID(id int) *Tile {
	if id < 0 {
		panic("illegal tile id")
	}
	var (
		tmp = id / 4
		h   = tmp / 9
		v   = tmp%9 + 1
		i   = h*10 + v
	)
	return &Tile{Suit: h, Rank: v, Index: i, Id: id}
}

编写单元测试函数

TileFromID 函数上右击选择 Generate Unit Tests For Function，我们编写它的单元测试函数。

internal/game/tile_test.go

func TestTileFromID(t *testing.T) {
	type args struct {
		id int
	}
	tests := []struct {
		name string
		args args
		want *Tile
	}{
    // 定义一堆用例
		{"1条", args{id: 0}, &Tile{Suit: 0, Rank: 1, Index: 1, Id: 0}},
		{"1条", args{id: 1}, &Tile{Suit: 0, Rank: 1, Index: 1, Id: 1}},
		{"1条", args{id: 2}, &Tile{Suit: 0, Rank: 1, Index: 1, Id: 2}},
		{"1条", args{id: 3}, &Tile{Suit: 0, Rank: 1, Index: 1, Id: 3}},
		{"9条", args{id: 35}, &Tile{Suit: 0, Rank: 9, Index: 9, Id: 35}},
		{"1筒", args{id: 36}, &Tile{Suit: 1, Rank: 1, Index: 11, Id: 36}},
		{"1筒", args{id: 37}, &Tile{Suit: 1, Rank: 1, Index: 11, Id: 37}},
		{"1筒", args{id: 38}, &Tile{Suit: 1, Rank: 1, Index: 11, Id: 38}},
		{"1筒", args{id: 39}, &Tile{Suit: 1, Rank: 1, Index: 11, Id: 39}},
		{"9筒", args{id: 71}, &Tile{Suit: 1, Rank: 9, Index: 19, Id: 71}},
		{"1万", args{id: 72}, &Tile{Suit: 2, Rank: 1, Index: 21, Id: 72}},
		{"1万", args{id: 73}, &Tile{Suit: 2, Rank: 1, Index: 21, Id: 73}},
		{"1万", args{id: 74}, &Tile{Suit: 2, Rank: 1, Index: 21, Id: 74}},
		{"1万", args{id: 75}, &Tile{Suit: 2, Rank: 1, Index: 21, Id: 75}},
		{"9万", args{id: 107}, &Tile{Suit: 2, Rank: 9, Index: 29, Id: 107}},
	}
	for _, tt := range tests {
		t.Run(tt.name, func(t *testing.T) {
			if got := TileFromID(tt.args.id); !reflect.DeepEqual(got, tt.want) {
				t.Errorf("TileFromID() = %v, want %v", got, tt.want)
			}
		})
	}
}

执行：

cd internal/game/mahjong 
go test -v tile_test.go tile.go mahjong.go

我是为少
微信：uuhells123
公众号：***下午茶
加我微信（互相学习交流），关注公众号（获取更多学习资料~）

有疑问加站长微信联系（非本文作者）