同学们好!成功登录《我家租房网》系统的用户,会在搜索页面的右上角看到自己的用户名,初始用户名为手机号。这时如果点击该用户名,则会进入用户页面。在用户页面的个人信息栏中会显示当前登录用户的头像、用户名和手机号等用户信息,同时还包含一个用于修改用户信息的页面链接。这节课我们将实现获取用户名和手机号的功能。
我们将首先实现支持用户信息获取的后端微服务,再在前端服务器中添加路由处理函数并远程调用后端微服务,最后再将前后端连在一起做完整的功能测试。
首先我们来实现后端服务器。
第一步是创建特定的微服务。
创建微服务的过程还是和先前一样,直接在back-end工程目录下执行go-micro命令,子命令为new,参数为service,微服务名为GetUser。
接着,需要修改一下go-micro为我们自动生成的接口描述。在back-end工程目录下的GetUser微服务目录中,有一个名为proto的子目录,这就是存放接口描述脚本及其Go代码文件的地方。现阶段里面只有一个名为GetUser.proto的ProtoBuf脚本文件。我们需要对该文件做一些修改:
x1...
2message CallRequest {
3 string username = 1;
4}
5
6message User {
7 uint64 user_id = 1;
8 string name = 2;
9 string mobile = 3;
10 string real_name = 4;
11 string id_card = 5;
12 string avatar_url = 6;
13}
14
15message CallResponse {
16 string errno = 1;
17 string errmsg = 2;
18 User data = 3;
19}
20...
这段代码描述的是,前端服务器和后端微服务之间的数据交换格式。CallRequest表示前端提供给后端的请求数据,其中包含字符串形式的用户名。CallResponse表示后端返回给前端的响应数据,其中包含错误代码、错误描述和用户信息。用户信息中含有用户ID、用户名、手机号、真实姓名、身份证号和头像URL等六个字段。
有了用ProtoBuf语言描述的远程调用接口,我们还需要把它编译成基于Go语言的程序代码。在GetUser微服务目录中执行make命令,并携带四个目标参数,它们是init、proto、update和tidy。
在GetUser微服务目录下,创建一个名为model的子目录,表示该微服务的模型层。在该子目录中创建mysql.go文件,封装所有与操作MySQL数据库有关的代码。在实际编写数据库访问代码之前,我们可以先把之前为前端服务器编写的mysql.go文件中的内容原封不动地复制到这里:
xxxxxxxxxx
1011package model
2
3import (
4 _ "github.com/go-sql-driver/mysql"
5 "github.com/jinzhu/gorm"
6 "time"
7)
8
9// 用户表
10type User struct {
11 ID uint `json:"id"` // 用户ID
12 Name string `json:"name" gorm:"size:32;unique"` // 用户名
13 Password_hash string `json:"password_hash" gorm:"size:128"` // 密码哈希
14 Mobile string `json:"mobile" gorm:"size:11;unique"` // 手机号
15 Real_name string `json:"real_name" gorm:"size:32"` // 真实姓名
16 Id_card string `json:"id_card" gorm:"size:20"` // 身份证号
17 Avatar_url string `json:"avatar_url" gorm:"size:256"` // 头像URL
18 Houses []*House `json:"houses"` // 房屋集
19 Orders []*Order `json:"orders"` // 订单集
20}
21
22// 房屋表
23type House struct {
24 gorm.Model
25 User_id uint `json:"user_id"` // 房主用户ID
26 Area_id uint `json:"area_id"` // 归属地区ID
27 Title string `json:"title" gorm:"size:64"` // 标题
28 Address string `json:"address" gorm:"size:512"` // 地址
29 Room_count int `json:"room_count" gorm:"default:1"` // 房间数
30 Acreage int `json:"acreage" gorm:"default:0"` // 面积
31 Price int `json:"price"` // 价格
32 Unit string `json:"unit" gorm:"size:32;default:''"` // 房间配置
33 Capacity int `json:"capacity" gorm:"default:1"` // 容纳人数
34 Beds string `json:"beds" gorm:"size:64;default:''"` // 床铺配置
35 Deposit int `json:"deposit" gorm:"default:0"` // 押金
36 Min_days int `json:"min_days" gorm:"default:1"` // 最少入住天数
37 Max_days int `json:"max_days" gorm:"default:0"` // 最多入住天数
38 Order_count int `json:"order_count" gorm:"default:0"` // 预定订单数
39 Index_image_url string `json:"index_image_url" gorm:"size:256;default:''"` // 主图片URL
40 Facilities []*Facility `json:"facilities" gorm:"many2many:houses_facilities"` // 设施集
41 Images []*Image `json:"images"` // 图片集
42 Orders []*Order `json:"orders"` // 订单集
43}
44
45// 城区表
46type Area struct {
47 ID uint `json:"id"` // 城区ID
48 Name string `json:"name" gorm:"size:32"` // 城区名
49 Houses []*House `json:"houses"` // 房屋集
50}
51
52// 设施表
53type Facility struct {
54 ID uint `json:"id"` // 设施ID
55 Name string `json:"name" gorm:"size:32"` // 设施名
56 Houses []*House `json:"houses"` // 房屋集
57}
58
59// 图片表
60type Image struct {
61 ID uint `json:"id"` // 图片ID
62 Url string `json:"url" gorm:"size:256"` // 图片URL
63 House_id uint `json:"house_id"` // 所属房屋ID
64}
65
66// 订单表
67type Order struct {
68 gorm.Model
69 User_id uint `json:"user_id"` // 下单用户ID
70 House_id uint `json:"house_id"` // 预定房屋ID
71 Begin_date time.Time `json:"begin_date" gorm:"type:datetime"` // 预定起始日
72 End_date time.Time `json:"end_date" gorm:"type:datetime"` // 预定终止日
73 Days int `json:"days"` // 预定天数
74 House_price int `json:"house_price"` // 房屋价格
75 Amount int `json:"amount"` // 总金额
76 Status string `json:"status" gorm:"default:'WAIT_ACCEPT'"` // 状态
77 Comment string `json:"comment" gorm:"size:512"` // 评论
78 Credit bool `json:"credit"` // 征信良好
79}
80
81var db *gorm.DB // 数据库连接池
82
83// 初始化数据库
84func InitDB() error {
85 var err error
86
87 // 连接数据库
88 if db, err = gorm.Open("mysql",
89 "root:123456@tcp(127.0.0.1:3306)/ihomedb?"+
90 "charset=utf8&parseTime=True&loc=Local"); err == nil {
91 // 设置最大连接数和最大空闲连接数
92 db.DB().SetMaxOpenConns(100)
93 db.DB().SetMaxIdleConns(10)
94
95 // 创建表
96 return db.AutoMigrate(new(User), new(House),
97 new(Area), new(Facility), new(Image), new(Order)).Error
98 }
99
100 return err
101}
修改GetUser微服务目录中的main.go文件,添加对InitDB函数的调用,将服务发现改为Consul,绑定IP地址和端口:
xxxxxxxxxx
161...
2func main() {
3 // 初始化数据库
4 if err := model.InitDB(); err != nil {
5 logger.Fatal(err)
6 }
7 ...
8 srv.Init(
9 micro.Name(service),
10 micro.Version(version),
11 micro.Registry(consul.NewRegistry()),
12 micro.Address("127.0.0.1:9006"),
13 )
14 ...
15}
16...
程序启动伊始,即完成对数据库的初始化。其中包括两个动作,其一是连接ihomedb数据库并获得连接池对象,其二是在该数据库中创建表。当然,如果这些表已经存在,则不再创建。接着,在服务器对象的初始化部分,指示其注册到Consul服务器,同时绑定本机的9006端口。
接下来,我们为GetUser微服务编写与数据持久化有关的代码。
打开GetUser微服务目录下,model子目录中的mysql.go文件,在其中添加有关从MySQL数据库中读取用户信息的代码:
xxxxxxxxxx
81...
2// 从MySQL数据库中读取用户信息
3func ReadUser(username string) (User, error) {
4 var user User
5 err := db.Where("name=?", username).First(&user).Error
6 return user, err
7}
8...
定义名为ReadUser的函数,用于从MySQL数据库中读取用户信息。该函数以从参数传入的用户名为条件,从用户表中查询特定用户的用户信息,并将查询结果和错误对象返回给函数的调用者。
在完成GetUser微服务模型层的所有开发工作之后,我们将着手编写用于处理获取用户信息业务的代码。
打开GetUser微服务目录下,handler子目录中的GetUser.go文件,在其中的Call方法里,添加与获取用户信息有关的操作:
xxxxxxxxxx
281...
2// 获取用户信息
3func (e *GetUser) Call(ctx context.Context, req *pb.CallRequest, rsp *pb.CallResponse) error {
4 logger.Infof("Received GetUser.Call request: %v", req)
5
6 // 从MySQL数据库中读取用户信息
7 user, err := model.ReadUser(req.Username)
8 if err != nil {
9 logger.Error(err)
10 rsp.Errno = utils.ERROR_DATABASE
11 rsp.Errmsg = utils.StrError(rsp.Errno)
12 return nil
13 }
14
15 rsp.Data = &pb.User{
16 UserId: uint64(user.ID),
17 Name: user.Name,
18 Mobile: user.Mobile,
19 RealName: user.Real_name,
20 IdCard: user.Id_card,
21 AvatarUrl: user.Avatar_url,
22 }
23
24 rsp.Errno = utils.ERROR_OK
25 rsp.Errmsg = utils.StrError(rsp.Errno)
26 return nil
27}
28...
这里首先调用模型层的ReadUser函数,从MySQL数据库中读取用户信息。若读到,则将该用户的用户信息填入响应对象的特定字段中,否则,设置错误响应并返回。
在完成GetUser后端服务器的开发后,我们需要为前端服务器添加一条路由,并在路由处理函数中完成对后端微服务远程方法的调用。
前端和后端共用同一套接口描述。
因此,这里我们将GetUser微服务目录下proto子目录中的所有文件,原封不动地复制到front-end工程目录proto子目录下的GetUser目录中。
这里我们要为获取用户信息添加一条路由,GET方法结合/api/v1.0/user路径,处理函数名为GetUser。
在front-end工程目录下的main.go文件中添加一条路由:
xxxxxxxxxx
91...
2func main() {
3 ...
4 // 路由匹配
5 ...
6 apiv10.GET("/user", controller.GetUser)
7 ...
8}
9...
这里我们调用了路由对象的GET方法,为获取用户信息添加了一条路由,将GET方法结合/user路径,路由到controller包的GetUser函数。将GetUser函数定义在controller包里是因为该函数的主要任务是执行业务逻辑,属于MVC中的C,即控制器层的部分。
当然,在controller包里真的得有GetUser函数。为此,我们打开front-end工程目录下controller子目录中的user.go文件。在该文件的import部分增加一行,同时定义GetUser函数:
xxxxxxxxxx
341...
2import (
3 ...
4 pbGetUser "iHome/front-end/proto/GetUser"
5 ...
6)
7...
8// 获取用户信息
9func GetUser(ctx *gin.Context) {
10 // 从Session中读取用户名
11 username := model.ReadUsername(ctx)
12 if username == "" {
13 rsp := make(map[string]string)
14 rsp["errno"] = utils.ERROR_USER_NOT_LOGIN
15 rsp["errmsg"] = utils.StrError(rsp["errno"])
16 ctx.JSON(http.StatusOK, rsp)
17 return
18 }
19
20 // 调用微服务
21 srv := micro.NewService(micro.Registry(consul.NewRegistry()))
22 srv.Init()
23 c := pbGetUser.NewGetUserService("getuser", srv.Client())
24 rsp, err := c.Call(context.Background(), &pbGetUser.CallRequest{
25 Username: username,
26 })
27 if err != nil {
28 fmt.Println(err)
29 return
30 }
31
32 ctx.JSON(http.StatusOK, rsp)
33}
34...
这段代码通过Consul服务发现,获取了有关名为getuser的微服务的信息,远程调用了其中的GetUser对象的Call方法。该方法以包含用户名的请求对象为参数,并返回包含错误代码、错误描述和用户信息的响应对象。将该响应对象序列化为一个JSON字符串,编码到HTTP响应中,回传给浏览器。
至此,我们已经完成获取用户信息的全部开发工作。下面我们将对这部分功能进行测试。
启动Consul服务器、UserLogin、GetUser后端微服务和前端服务器。通过登录页面登录系统,点击位于搜索页面右上角的用户名,初始用户名即手机号,进入用户页面。当前登录用户的用户名和手机号,显示在用户页面的个人信息栏中。您可能已经注意到了,当前登录用户的头像现在还不能正确显示,有关上传和获取用户头像的功能,我们将在后续课程中予以实现。
谢谢大家,我们下节课再见!