租辆酷车小程序开发(二)—— 接入微服务GRPC
vscode中golang的配置
- 设置依赖管理
go env -w GO111MODULE=on
go env -w GOPROXY=https://goproxy.cn,direct
GO111MODULE=auto 在$GOPATH/src 外面且根目录有go.mod 文件时,开启模块支持
GO111MODULE=off 无模块支持,go会从GOPATH 和 vendor 文件夹寻找包
GO111MODULE=on 模块支持,go会忽略GOPATH和vendor文件夹,只根据go.mod下载依赖
-
安装go插件
-
view —— Command Palatte —— 选择Go: Install/Update Tools 安装所有工具
-
在coolcar目录下新建server目录,使用File-Add Folder to Workspace添加server目录到vscode
这里不能直接打开coolcar目录,因为go的插件与项目根目录有关,所以我们在这里分别将wx和server目录添加到我们的workspace
- file —— preference —— setting
- server目录下输入go mod init coolcar 新建go文件测试能否正常运行
三种执行方法:
Run —— Run Without Debugging
命令行—— go run hello.go
Code Runner插件
断点调试:
添加断点 —— Run —— Start Debugging
GRPC
gRPC 是Google公司开发的一个高性能、开源和通用的 RPC 框架,面向移动和 HTTP/2 设计。
RPC(Remote Procedure Call)远程过程调用,是一种通过网络从远程计算机程序上请求服务,而不需要了解底层网络技术的协议,简单的理解是一个节点请求另一个节点提供的服务。RPC只是一套协议,基于这套协议规范来实现的框架都可以称为 RPC 框架,比较典型的有 Dubbo、Thrift 和 gRPC。
向服务器发送请求需要关注的问题:
- 协议:http/http2/TCP
- 服务器地址:api.coolcar.cn
- 路径:/trip
- 参数
- 数据类型
- 数据编码:JSON/XML/Protobuf
- 安全性:token
- 错误处理:http status
GRPC:
- 协议:HTTP/2
- 方法:POST
- 路径:服务器地址/Service/Method(Ps:地址/TripService/GetTrip)
- 参数:body
- 安全性:HTTP2协议/header中存放token
- 数据:二进制
- 数据结构:二进制数据使用ProtoBuf进行编码
优点:
- 高效的数据传输
- 语言无关的领域模型定义
其他DSL/IDL:
- Thrift
- Swagger
- 使用yaml描述
- 描述REST API
- Goa
ProtoBuf编译器的安装
-
安装protobuf编译器
https://github.com/protocolbuffers/protobuf/releases
下载解压后,将bin目录添加到环境变量,在终端执行protoc命令可以看到对应输出 -
安装go语言插件,(本项目使用的grpc gateway是v1版本,目前grpc gateway已经有较大的更新),这三个插件安装在GOPATH的bin目录下
go install github.com/grpc-ecosystem/grpc-gateway/protoc-gen-grpc-gateway@latest
go install github.com/grpc-ecosystem/grpc-gateway/protoc-gen-swagger@latest
go install github.com/golang/protobuf/protoc-gen-go@latest
protoc-gen-go:生成go语言代码
protoc-gen-grpc-gateway:生成grpc-gateway代码
protoc-gen-swagger:从protoc生成swagger‘
ProtoBuf的使用
.proto文件
vscode中安装vscode-proto3插件
server目录下新建proto目录,在proto目录下新建trip.proto文件
proto文件只是定义了一种传输的数据格式,不包含方法
// 语法
syntax = "proto3";
// proto文件的package,用处不大
package coolcar;option go_package="coolcar/proto/gen/go;trippb";// 定义数据格式(不存在方法只是定义一种数据结构)
message Trip {// (二进制数据流不知道字段在哪里开始在哪里结束所以要在变量后声明字段顺序,与json不同的是json中:后面跟的是对应的数据)string start = 1; // 第一个字段string end = 2; // 第二个字段int64 duration_sec = 3; // 注明单位int64 fee_cent = 4;
}
option go_package="coolcar/proto/gen/go;trippb";
:定义了引用的格式,生成的go代码的package为trippb,导入go代码时使用import trippb "coolcar/proto/gen/go"
导入
生成go语言代码
protoc -I =. --go_out=paths=source_relative:gen/go trip.proto
-I=.
:输入目录为当前目录--go_out=paths=source_relative:gen/go
go_out
:生成go语言代码paths=source_relative
:相对路径,xx=xx是送给go_out插件的参数gen/go
:生成go语言的路径
trip.proto
:源文件
生成文件如下,这里的package为.proto文件中go_package所定义
使用生成的代码
导入使用该生成的文件,路径在.proto文件的option go_package="coolcar/proto/gen/go;trippb
中定义
fmt.Println(&trip)
:输出要取地址,否则会有警告,这里建议在使用proto时一律取地址
b, err := proto.Marshal(&trip)
:编码为二进制流
err = proto.Unmarshal(b, &trip2)
:将二进制流解码
服务器将Marshal的二进制数据流通过grpc服务的tcp端口发给客户端,客户端收到后Unmarshal就可以获得原始数据
b, err = json.Marshal(&trip2)
:编码为json格式方便交互(在trip.pb.go中已经定义了对应的json字段)
微服务之间通过grpc传递二进制流互相通信,暴露给前端小程序使用json进行通信
package mainimport (trippb "coolcar/proto/gen/go""encoding/json""fmt""google.golang.org/protobuf/proto"
)func main() {trip := trippb.Trip{Start: "abc",End: "def",DurationSec: 3600,FeeCent: 10000,}fmt.Println(&trip)// 二进制流编码b, err := proto.Marshal(&trip)if err != nil {panic(err)}fmt.Printf("%X\n", b)// 二进制流解码var trip2 trippb.Trip// 需要加地址才能写入err = proto.Unmarshal(b, &trip2)if err != nil {panic(err)}// 凡是引用一律加地址fmt.Println(&trip2)// 转jsonb, err = json.Marshal(&trip2)if err != nil {panic(err)}fmt.Printf("%s\n", b)
}
proto的数据类型
Trigger Suggest 快捷键可以查看可选类型
复合类型
message Location {double latiture = 1;double longitude = 2;
}
message Trip {string start = 1;Location start_pos = 5;string end = 2;Location end_pos = 6;int64 duration_sec = 3;int64 fee_cent = 4;
}### repeate
repeated类型
定义go语言中的切片
repeated Location path_locations = 7;
=> PathLocations []*Location
message Location{double latitude = 1;double longitude =2;
}
message Trip {string start = 1; Location start_pos = 5; //新加字段序号往后排repeated Location path_locations = 7;string end = 2; Location end_pos = 6;int64 duration_sec = 3; int64 fee_cent = 4;
}
生成的go语言代码如下:
使用方法:
枚举类型
message Location{double latitude = 1;double longitude =2;
}
enum TripStatus{TS_NOT_SPECIFIED = 0;NOT_STARTED = 1;IN_PROGRESS = 2;FINISHED = 3;PAID = 4;
}
message Trip {string start = 1; Location start_pos = 5; //新加字段序号往后排repeated Location path_locations = 7;string end = 2; Location end_pos = 6;int64 duration_sec = 3; int64 fee_cent = 4;TripStatus status = 8;
}
生成的go语言代码
使用方法:
ProtoBuf字段的可选性
问题:软件更新后新老版本的message字段不同,新老版本同时存在,如何处理新老版本之间的数据传输
假设新版本新加了TripStatus字段,此时当新版本向老版本传输数据时,老版本会忽略该字段
老版本向新版本传输数据时,缺少了TripStatus字段,但是ProtoBuf中字段都是可选的,这里TripStatus的值会被赋为零值
go语言中每个类型都有一个零值,0,“”,false等
ProtoBuf中对字段赋零值和不填的效果是一样的(这里无法区分该值是赋值为0还是根本没有填,如果必须区分可以新加一个bool字段表明是否有值),若将这里DurationSec赋值为0,则跟没填的效果一样
打印结果为:
这里的DurationSec不会被打印出来
在系统设计的时候需要为每个字段设计合适的零值:
例如:假设要新增一个功能可以让没有登陆的用户也可以使用我们的产品,我们需要区分这个行程是已登录的用户还是未登录的用户
假设在message新加了一个字段bool isFromLoggedInUser
,判断是否为登录的用户,这里老版本没有这个字段在向新版本传输数据时会赋值为false,即将所有老版本的用户都视为未登录的用户,这是错误的,因为老系统只允许登录的用户,也就是说老系统的用户都是已登录的用户。
应该添加的字段是bool isFromGuestUser
,这样老版本的用户该字段都为false,都不是未登录的用户,只有在新版本添加该功能后才会有用户被设置为true
GRPC服务器及客户端
定义服务
proto文件中添加如下定义
message GetTripRequest {string id = 1;
}message GetTripResponse {string id = 1;Trip trip = 2;
}service TripService{rpc GetTrip (GetTripRequest) returns (GetTripResponse);
}
使用protoc -I =. --go_out=plugins=grpc,paths=source_relative:gen/go trip.proto
命令生成代码,这里新加了一个plugins=grpc参数
plugins=grpc, paths=source_relative 是两个参数
gen/go 是生成代码的路径
在生成的go语言代码中可以使用Go to Symbol in Editor搜索TripService
可以看到TripServiceClient是一个接口,其中包括GetTripRequest、GetTripResponse等
同样TripServiceServer也是一个接口
要实现这两个功能只需要实现这个接口即可
实现TripServiceServer接口
在server下新建tripservice目录,在目录下新建trip.go
定义Service结构体实现GetTrip方法,这样Service就实现了TripServiceServer接口
package tripimport ("context"trippb "coolcar/proto/gen/go"
)type Service struct{}func (*Service) GetTrip(c context.Context, req *trippb.GetTripRequest) (*trippb.GetTripResponse, error) {return &trippb.GetTripResponse{Id: req.Id,Trip: &trippb.Trip{Start: "abc",End: "def",DurationSec: 3600,FeeCent: 10000,StartPos: &trippb.Location{Latitude: 30,Longitude: 120,},EndPos: &trippb.Location{Latitude: 35,Longitude: 115,},PathLocations: []*trippb.Location{{Latitude: 31,Longitude: 119,},{Latitude: 32,Longitude: 118,},},Status: trippb.TripStatus_IN_PROGRESS,},}, nil
}
启动服务
1. 设置监听端口
2. 创建grpc.server
3. 将之前实现的TripServiceServer接口注册到server服务器
4. 服务器与监听端口绑定
package mainimport (trippb "coolcar/proto/gen/go"trip "coolcar/tripservice""log""net""google.golang.org/grpc"
)func main() {// 监听端口lis, err := net.Listen("tcp", ":8081")if err != nil {// 不使用panic,Fatalf:输出之后程序退出log.Fatalf("failed to listen: %v", err)}s := grpc.NewServer()trippb.RegisterTripServiceServer(s, &trip.Service{})// 如果s.Serve没有出错的话会一直监听不会退出,如果出错则直接将返回的error输出log.Fatal(s.Serve(lis))
}
建立客户端向服务器发送请求
在server下新建client目录,目录下新建main.go
1. 建立到服务端的连接
2. 由连接建立client
3. 通过新建的client调用GetTrip方法,传入方法参数,交给server实现的方法处理
grpc.Dial如果不加第二个参数直接运行会报错提示不安全,我们按照错误的提示添加了第二个参数即可正常运行
这里调用的GetTrip方法为client调用的服务器上的方法,这个方法正是在之前实现接口时所实现的方法
package mainimport ("context"trippb "coolcar/proto/gen/go""fmt""log""google.golang.org/grpc""google.golang.org/grpc/credentials/insecure"
)func main() {// 设置日志格式log.SetFlags(log.Lshortfile)// 建立连接conn, err := grpc.Dial("localhost:8081", grpc.WithTransportCredentials(insecure.NewCredentials()))if err != nil {log.Fatalf("cannot connect server: %v", err)}// 新建clienttsClient := trippb.NewTripServiceClient(conn)// 调用GetTrip方法r, err := tsClient.GetTrip(context.Background(), &trippb.GetTripRequest{Id: "trip456"})if err != nil {log.Fatalf("cannot call GetTrip: %v", err)}fmt.Println(r)
}
执行结果:
完整流程:
- 在proto文件中定义server接口要实现GetTrip方法,在这里只给出了GetTrip的定义没有给出具体的实现
- 然后我们在第一步中实现了TripServiceServer接口,在这里第一次实现了GetTrip方法
- 随后在建立服务端的时候将实现了TripServiceServer接口的Service结构体注册到服务器
- 在客户端向服务器发送请求调用GetTrip方法,传入方法参数
REST vs RPC
HTTP协议
HTTP协议是基于TCP传输的,TCP协议只负责可靠的传输数据没有规定数据传输的格式,HTTP负责规定TCP协议传输的数据
Method:GET、PUT、POST、DELETE…
URL
DATA
RPC
RPC(Remote Procedure Call),远程过程调用,其中Procedure通常认为就是一个函数,RPC不需要指定远程服务器的地址,因为RPC是在已经建立连接的TCP服务之上的,只需要给定函数名称和函数参数就可以调用。
RPC在前后端之间的通信仍需借用HTTP协议,因为浏览器或小程序最方便的仍是发送HTTP请求,将RPC服务暴露在网上有两种风格的接口
RPC
- Method
- POST
- URL
- api.service.com/GetTrip
- api.service.com/CreateTrip
- Data
- GetTripRequest
- CreateTripRequest
REST
method是一个动词,动作的对象是url是一个名词
- C
- POST api.service.com/trip (POST是动词,后面跟的url是一个名词)
- Data:JSON
- R
- GET api.service.com/trip/{id}
- U
- PUT api.service.com/trip/{id}
- Data:JSON
- D
- DELETE api.service.com/trip/{id}
前端请求GRPC服务的两种方案架构
要想把GRPC服务直接给前端(小程序/web)使用,还需要GRPC over HTTP,小程序不能直接发GRPC请求,只能发HTTP请求。
假设项目中有一个微服务的架构其中有很多GRPC的server,在系统内部GRPC之间都通过TCP连接进行通信,这里的问题在于怎样把内部的GRPC服务暴露给前端的小程序(Web)
- GRPC Gateway
- GRPC Web Proxy
GRPC Web Proxy
该方案是给Web端使用的,Web端与GRPC Web Proxy建立HTTP连接,传输的是二进制数据流(之前protobuf序列化得到的二进制数据流),Web Proxy接收到二进制数据后,会分析其调用的GRPC服务的具体参数,然后将该二进制数据送到后台具体的GRPC服务,这里的GRPC Web Proxy也称为反向代理,外部请求发到服务集群时一律是发到GRPC Web Proxy,然后再由GRPC Web Proxy将请求分发到内网不同的服务上,在整个过程中传输的数据都是二进制数据。这个方案需要在Web端就将数据编码为二进制数据,这在go语言中比较容易,但是在html和js中比较麻烦。
GRPC Gateway
gRPC Gateway 是一个用于将 gRPC 服务暴露为 RESTful API 的代理工具。它通过在 gRPC 服务和 HTTP 请求之间提供一个转换层,使得使用 HTTP 和 RESTful 接口的客户端也可以与 gRPC 服务进行通信。简而言之,gRPC Gateway 允许你通过 HTTP REST 请求访问 gRPC 服务,从而使得你可以同时享受 gRPC 的高效性和 HTTP/JSON 的兼容性。
GRPC Gateway在小程序和web端都可以使用,前端通过HTTP协议向GRPC Gateway传输JSON格式的字符串,GRPC Gateway也是反向代理,将请求分发给内网的服务,但是GRPC Gateway在分发之前需要首先将JSON转为二进制数据流。
为什么要使用GRPC需要复杂的代理转发还要用GRPC进行开发呢?直接用REST API 内部都用HTTP协议直接进行传输不是更方便吗?
无论用GRPC还是REST API都要搭建一个类似的结构,内网各种服务之间畅通通信,内网到外网都需要反向代理向外暴露一个服务接口,不可能由微服务本身直接向外界暴露接口,对内对外总是要分成两部分来考虑,中间代理层无法省略,所以我们不如在代理层做一个GRPC的转换使得内网的服务都在GRPC中完成,GRPC的服务开发是非常方便的
GRPC Gateway的实现
定义接口
定义http rest层面上暴露的接口,在proto目录下新建trip.yaml文件
selector中coolcar为proto文件的package,TripService为服务名,GetTrip为定义的方法
对应selector的服务,暴露的接口为method为get,url为 /trip/{id}
type: google.api.Service
config_version: 3http:rules:- selector: coolcar.TripService.GetTripget: /trip/{id}
当收到的请求url方法为get并且请求路径为/trip/{id}就可以解析出请求的方法为TripService.GetTrip
生成代码
执行命令:
protoc -I =. --go_out=plugins=grpc,paths=source_relative:gen/go trip.proto
protoc -I =. --grpc-gateway_out=paths=source_relative,grpc_api_configuration=trip.yaml:gen/go trip.proto
在proto/gen/go目录下生成了trip.pb.go和trip.pb.gw.go文件,trip.pb.gw.go在一开始就说明了该文件是一个反向代理,将gRPC转换为RESTful接口
开启gateway服务
在main.go(服务端)中新建函数
- context:在后面仔细讲,这里生成了一个没有具体内容的上下文,在这个上下文中连接后端的grpc服务,并在之后为上下文添加cancel的能力,在服务结束后断开连接
- mux: multiplexer 一对多,分发器
- “localhost:8081”:tripservice的地址
- []grpc.DialOption:连接方式,这里选择不安全的方式,不加这个可能会提示连接不安全报错
- trippb.RegisterTripServiceHandlerFromEndpoint:注册服务
这里的trippb.RegisterTripServiceHandlerFromEndpoint函数就是建立了下图红色箭头所示的连接
在context的基础上建立连接,连接注册在mux上,连接对象是localhost:8081 - http.ListenAndServe(“:8080”, mux):gateway的监听端口
func startGRPCGateway() {// context在后面仔细讲,这里生成了一个没有具体内容的上下文,在这个上下文中连接后端的grpc服务c := context.Background()// 为上下文添加cancel的能力,cancel是一个函数,调用cancel连接就会被断开c, cancel := context.WithCancel(c)// 服务结束断开连接defer cancel()// mux: multiplexer 一对多,分发器mux := runtime.NewServeMux()// 通过context c连接,c在函数返回后就会被cancel掉,这个连接注册在NewServeMux上:8081,连接方式为insecure通过tcp明文连接err := trippb.RegisterTripServiceHandlerFromEndpoint(c,mux,"localhost:8081",[]grpc.DialOption{grpc.WithTransportCredentials(insecure.NewCredentials())},)if err != nil {log.Fatalf("cannot start grpc gateway: %v", err)}// http监听地址,8081是tripservice的地址与gateway的地址是不同的err = http.ListenAndServe(":8080", mux)if err != nil {log.Fatalf("cannot listen and server: %v", err)}
}
go 关键字用于启动一个新的并发执行的goroutine。Go语言中的goroutine是轻量级的线程,它们在Go运行时中被多路复用到线程上,当你在一个函数调用前加上go关键字时,Go运行时会为该函数创建一个新的goroutine,并立即开始执行,而不会阻塞调用它的goroutine。这意味着你可以同时运行多个函数,它们可以独立地执行,并且可以相互通信。
启动该服务,在浏览器(http协议) 访问http://localhost:8080/trip/123,可以看到返回数据
- 此处的流程为从Web端发送请求/trip/123到GRPC Gateway,GRPC Gateway在初始化的时候就建立了到8081端口的连接
- 根据yaml文件的配置将该请求翻译为针对GetTrip的请求,并且可以得到url中的id就是真正送给gettrip的id,注意yaml中的id对应的就是GetTripRequest中的id这里需要对应(这里具体的实现可以看trip.pb.gw.go的源码进一步理解)
- 接收到请求后GetTrip就可以获取tripid为123的行程返回二进制数据到Gateway,Gateway将数据转为JSON形式返回给Web
小程序访问GRPC Gateway
直接在app.ts中发送request请求
// app.ts
App<IAppOption>({globalData: {},onLaunch() {wx.request({url: 'http://localhost:8080/trip/trip123',method: 'GET',success: console.log,fail: console.error})// 登录wx.login({success: res => {console.log(res.code)// 发送 res.code 到后台换取 openId, sessionKey, unionId},})},
})
每个微信小程序需要事先设置通讯域名,小程序只可以跟指定的域名进行网络通信。
https://developers.weixin.qq.com/miniprogram/dev/framework/ability/network.html
我们在本地调试的时候可以设置为不校验合法域名
访问返回结果:
数据类型填坑
小程序的返回中duration和fee都是string的形式,但是我们希望是number的形式,考虑原因是duration和fee在proto文件中的数据类型是int64,因为太大了所以转为了字符串,我们尝试将类型改为int32重新生成就是number的格式
枚举类型传输的本质是一个数值,这里的IN_PROGRESS实际上是2,考虑兼容性我们将这里的status设置为数值
在定义gateway服务的mux时添加转换方式
mux := runtime.NewServeMux(runtime.WithMarshalerOption(runtime.MIMEWildcard, &runtime.JSONPb{EnumsAsInts: true,OrigName: true,},))
小程序项目结构调整
为了给小程序加入proto类型需要引入第三方包,为了引入第三方包需要首先调整小程序的目录结构,把小程序所有的内容都移动到miniprogram目录下
- 在miniprogram目录下新建appoption.ts,将typeings目录下的index.d.ts的内容复制到apption.ts中,删除typings目录(可以生成的文件都可以删掉,使用npm install都可以再生成)
- 删除package-lock.json(npm安装时生成的文件)
- 剩下的文件移动到miniprogram目录下
- project.config.json中删除miniprogramRoot,此时该文件已经在miniprogram目录下了
- tsconfig.json中删除typeRoots,typings我们已经删除了
- miniprogram目录下运行npm install命令
- 在tsconfig.json中添加"types": [“miniprogram-api-typings”]。这样就可以在小程序中正常使用type了,此时的目录为wx/miniprogram/node_modules/miniprogram-api-typings/types
- 运行npm run tsc,解决报错
- 重新在开发者工具中导入项目,项目根目录为wx/miniprogram
调整后的项目如下所示:
https://github.com/shn-1/coolcar2024/tree/0d606611189fa9cf222859a0ade14608635ee9f8
小程序请求的强类型化
把protobuf转为ts代码,可以获取接收数据的类型
-
小程序目录miniprogram下运行
npm install protobufjs
,注意要把package.json中的安装版本设置为6.11.4
-
新建miniprogram/service/proto_gen目录,在server/proto目录下运行命令,从protobuf生成js文件
../../wx/miniprogram/node_modules/.bin/pbjs -t static -w es6 trip.proto --no-create --no-decode --no-verify --no-delimited -o ../../wx/miniprogram/service/proto_gen/trip_pb.js
-
server/proto目录下运行命令,从js文件生成ts文件
../../wx/miniprogram/node_modules/.bin/pbts -o ../../wx/miniprogram/service/proto_gen/trip_pb.d.ts ../../wx/miniprogram/service/proto_gen/trip_pb.js
在app.ts中获取返回值这里直接编译运行会报错,需要在小程序开发工具的本地设置中开启将JS编译成ES5,并且在trip_pb.js的开头添加
import * as $protobuf from "protobufjs";
这里只拿到了部分的返回值,这是因为在传参的时候存在驼峰命名和下划线命名,在生成的Trip的接口定义中使用的都是驼峰命名,因此需要把下划线命名改为驼峰命名才能识别
一种方式是在后端将mux的OrigName设置为false,这样传递的参数都是驼峰命名
但是约定在通常网络传输中都是使用下划线命名
第二种方法,我们将OrigName改回false,在小程序上安装npm install camelcase-keys
,这里的版本为6.2.2
在传递参数的时候将其转换为驼峰命名,在开发工具中重新构建npm
此时接收到的就是驼峰命名
这里接收到的status是2,我们需要解析出2对应的实际字符串
console.log('status is', coolcar.TripStatus[getTripRes.trip?.status!])
通过以上的方法我们可以.出接受数据的内容有哪些,方便开发
通过proto文件定义,既可以在go语言中实现也可以在typescript中实现,两端都通过proto文件定死,保证了前后端对接口的理解一致
项目目录中的miniprogram_npm是通过开发者工具构建npm生成的,它是node_modules的子集,只有在dependencies中的库才会被编译进miniprogram_npm,当小程序打包发布时miniprogram_npm会被打包发给所有的用户,node_modules不会打包,这里的protobufjs文件有些大,暂时可以接受,后期可以再优化
我们在trip_pb.js中添加了一行代码import * as $protobuf from "protobufjs";
当重新生成这个文件时这段代码又没有了,这里需要通过shell脚本实现,将生成的文件暂存,然后将代码先输出到js文件,再将暂存的文件追加到js文件后,再删除临时文件
$PBTS_BIN_DIR/pbjs -t static -w es6 trip.proto --no-create --no-encode --no-decode --no-verify --no-delimited -o $PBTS_OUT_DIR/trip_pb_tmp.js
echo 'import * as $protobuf from "protobufjs";\n' > $PBTS_OUT_DIR/trip_pb.js
cat $PBTS_OUT_DIR/trip_pb_tmp.js >> $PBTS_OUT_DIR/trip_pb.js
rm $PBTS_OUT_DIR/trip_pb_tmp.js
miniprogram_npm是通过开发工具构建npm生成的,我们不希望将它也上传到git仓库,在.gitignore中添加miniprogram_npm (在vscode终端直接使用code ..\..\.gitignore
就可以在vscode中打开该文件)
trip_pb.js等虽然是生成的文件,但是执行的命令比较复杂,所以我们将它也上传到git仓库,在.gitignore中添加!**/wx/miniprogram/service/proto_gen/*.js
修改README
相关文章:
租辆酷车小程序开发(二)—— 接入微服务GRPC
vscode中golang的配置 设置依赖管理 go env -w GO111MODULEon go env -w GOPROXYhttps://goproxy.cn,direct GO111MODULEauto 在$GOPATH/src 外面且根目录有go.mod 文件时,开启模块支持 GO111MODULEoff 无模块支持,go会从GOPATH 和 vendor 文件夹寻找包…...
leetcode 208. 实现 Trie (前缀树)
Trie(发音类似 "try")或者说 前缀树 是一种树形数据结构,用于高效地存储和检索字符串数据集中的键。这一数据结构有相当多的应用情景,例如自动补全和拼写检查。 请你实现 Trie 类: Trie() 初始化前缀树对象…...
kafka进阶_3.消费消息
文章目录 一、消费消息概览1.1、消费示例代码1.2、消费过程 二、消费者组2.1、push & pull2.2、消费者组 三、调度器Coordinator四、消费者分配策略4.1、引言4.2、分配基本流程4.3、分配策略4.3.1、轮询分配策略4.3.2、轮询分配策略 五、消费偏移量5.1、起始偏移量5.2、指定…...
预测未来 | MATLAB实现Transformer时间序列预测未来
预测未来 | MATLAB实现Transformer时间序列预测未来 预测效果 基本介绍 1.Matlab实现Transformer时间序列预测未来; 2.运行环境Matlab2023b及以上,data为数据集,单变量时间序列预测; 3.递归预测未来数据,可以控制预…...
VirtualBox7.0.6安装配置
VirtualBox7.0.6安装配置 提示:这里可以添加系列文章的所有文章的目录,目录需要自己手动添加 文章目录 VirtualBox7.0.6安装配置1.安装虚拟机1.1安装虚拟机的必要条件1.1.1开启虚拟化1.1.1.1检查虚拟化是否开启1.1.1.2 开启虚拟化 1.2 安装虚拟机1.1创建…...
Spring Boot英语知识分享网站:技术与实践
2相关技术 2.1 MYSQL数据库 MySQL是一个真正的多用户、多线程SQL数据库服务器。 是基于SQL的客户/服务器模式的关系数据库管理系统,它的有点有有功能强大、使用简单、管理方便、安全可靠性高、运行速度快、多线程、跨平台性、完全网络化、稳定性等,非常…...
HarmonyOS4+NEXT星河版入门与项目实战(22)------动画(属性动画与显示动画)
文章目录 1、属性动画图解2、案例实现-小鱼移动游戏1、代码实现2、代码解释3、资源图片4、实现效果3、显示动画4、案例修改-显示动画5、总结1、属性动画图解 这里我们用一张完整的图来汇整属性动画的用法格式和使用的主要属性范围,如下所示: 2、案例实现-小鱼移动游戏 1、代…...
AI赋能公共服务转型升级 | 第十届中国行业互联网大会暨腾讯云TVP行业大使三周年庆典公共服务专场圆满举办!
引言 党的二十大报告把“基本公共服务实现均等化”作为 2035 年我国发展的总体目标之一,强调要“健全基本公共服务体系,提高公共服务水平”。AI 作为新质生产力的核心驱动力之一,正在公共服务领域发挥着越来越重要的作用。 2024 年 10 月 2…...
网络基础 - 地址篇
一、IP 地址 IP 协议有两个版本,IPv4 和 IPv6IP 地址(IPv4 地址)是一个 4 字节,32 位的正整数,通常使用 “点分十进制” 的字符串进行表示,例如 192.168.0.1,用点分割的每一个数字表示一个字节,范围是 0 ~…...
chrome允许http网站打开摄像头和麦克风
第一步 chrome://flags/#unsafely-treat-insecure-origin-as-secure 第二步 填入网址,点击启用 第三步 重启 Chrome:设置完成后,点击页面底部的 “Relaunch” 按钮,重新启动 Chrome 浏览器,使更改生效。...
uniapp前端开发,基于vue3,element plus组件库,以及axios通讯
简介 UniApp 是一个基于 Vue.js 的跨平台开发框架,旨在通过一次开发、编译后运行在多个平台上,如 iOS、Android、H5、以及小程序(微信小程序、支付宝小程序、百度小程序等)等。UniApp 为开发者提供了统一的开发体验,使…...
STM32-- 串口发送数据
while(USART_GetFlagStatus(USART2,USART_FLAG_TXE)RESET);?? 答: 这行代码: while(USART_GetFlagStatus(USART2, USART_FLAG_TXE) RESET);的作用是等待串口 USART2 的发送数据寄存器(TXE,Transmit Dat…...
网络安全提示
如果您是企业主或 IT 经理,您应该知道计算机安全的重要性。从保护密码安全的基础知识到网络钓鱼、恶意软件等的危险,本文将为您提供您需要了解的有关网络安全的信息。 每年,互联网都变得越来越大,这意味着我们为黑客和网络犯罪分…...
【计算机网络】多路转接之epoll
epoll也是一种linux中的多路转接方案(epoll也是只负责IO过程中的"等") 一、epoll相关接口的使用 1.epoll_create int epoll_create(int size); 功能:创建一个epoll模型 ① int size:没意义了 >0就行 返回值:返回一个文件…...
nextjs+nestjs+prisma写todolist全栈项目
技术栈 nextjsnestjsprisma所学知识 Nextjs组件渲染,状态,路由docker启动Mysql容器prisma操作Mysql(CRUD)允许跨域请求APITanStack Query异步状态管理fetch api服务器组件预请求数据nestjs 管道和异常处理检测id是否正整数Docker启动Mysql容器 compose.yml name: todoLis…...
重构代码之将双向关联改为单向关联
在代码重构中,双向关联改为单向关联是指将原本双向关联转变为单向关联。这种重构方式有助于简化对象模型和提高代码的可维护性,减少不必要的耦合。下面是对这个重构技巧的详细讲解。 一、为什么需要将双向关联改为单向关联? 减少耦合&#…...
Linux介绍与安装指南:从入门到精通
1. Linux简介 1.1 什么是Linux? Linux是一种基于Unix的操作系统,由Linus Torvalds于1991年首次发布。Linux的核心(Kernel)是开源的,允许任何人自由使用、修改和分发。Linux操作系统通常包括Linux内核、GNU工具集、图…...
深度学习中的正则化模型是什么意思?
一、定义 在深度学习中,正则化是一种用于防止过拟合的技术。过拟合是指模型在训练数据上表现非常好,但在新的、未见过的数据(测试数据)上表现很差的情况。正则化模型就是通过在损失函数中添加额外的项来约束模型的复杂度…...
rabbitMq两种消费应答失败处理方式
在rabbitMq消费端,有三种应答模式: none:不处理。即消息投递给消费者后立刻 ack 消息会立刻从MQ删除。非常不安全,不建议使用 manual:手动模式。需要自己在业务代码中调用api,发送 ack 或 rejectÿ…...
windows C#-使用反射访问特性
你可以定义自定义特性并将其放入源代码中这一事实,在没有检索该信息并对其进行操作的方法的情况下将没有任何价值。 通过使用反射,可以检索通过自定义特性定义的信息。 主要方法是 GetCustomAttributes,它返回对象数组,这些对象在…...
java中链表的数据结构的理解
在 Java 中,链表是一种常见的数据结构,可以通过类的方式实现自定义链表。以下是关于 Java 中链表的数据结构和实现方式的详细介绍。 1. 自定义链表结构 Java 中链表通常由一个节点类 (ListNode) 和可能的链表操作类构成。 节点类 (ListNode) 这是链表…...
ctfshow
1,web153 大小写绕过失败 使用.user.ini 来构造后⻔ php.ini是php的⼀个全局配置⽂件,对整个web服务起作⽤;⽽.user.ini和.htaccess⼀样是⽬录的配置⽂件,.user.ini就是⽤户⾃定义的⼀个php.ini,我们可以利⽤这个⽂件来构造后⻔和…...
【AI绘画】Midjourney进阶:色调详解(下)
博客主页: [小ᶻ☡꙳ᵃⁱᵍᶜ꙳] 本文专栏: AI绘画 | Midjourney 文章目录 💯前言💯Midjourney中的色彩控制为什么要控制色彩?为什么要在Midjourney中控制色彩? 💯色调纯色调灰色调暗色调 💯…...
lanqiaoOJ 3747:繁忙的精神疗养院 ← STL queue
【题目来源】https://www.lanqiao.cn/problems/3747/learning/【题目描述】 心灵之园是一家知名的精神疗养院,为了提供更优质的服务,他们专门设立了一个 VIP 诊室和一个普通诊室。VIP 诊室主要接待特殊需求的高级会员,而普通诊室则服务所有的…...
Local Changes不展示,DevEco Studio的git窗口中没有Local Changes
DevEco Studio的git窗口中,没有Local Changes,怎么设置可以调出? 进入File-->Settings-->Version Control,将Use non-modal commit interface前的勾选框取消勾选,点击OK即可在打开git窗口,就可以看到…...
探索Python项目模板化的新纪元 —— Copier库揭秘
文章目录 **探索Python项目模板化的新纪元 —— Copier库揭秘**1. 背景介绍:为何Copier成为Python开发者的新宠?2. Copier究竟是什么?3. 如何安装Copier?4. 简单库函数使用方法创建模板从Git URL创建项目使用快捷方式动态文件生成…...
导入100道注会cpa题的方法,导入试题,自己刷题
一、问题描述 复习备考的小伙伴们,往往希望能够利用零碎的时间和手上的试题,来复习和备考 用一个能够导入自己试题的刷题工具,既能加强练习又能利用好零碎时间,是一个不错的解决方案 目前市面上刷题工具存下这些问题 1、要收费…...
使用NAS开启无纸化办公,Docker部署开源文档管理系统『Paperless-ngx』
使用NAS开启无纸化办公,Docker部署开源文档管理系统『Paperless-ngx』 哈喽小伙伴们好,我是Stark-C~ 对于文案类的办公场景来说,手头堆放最多的可能就是各种文档文件,以及各种用过的打印废纸。 这么多年来,不管是领…...
docker安装mysql
1.拉取mysql镜像 docker pull mysql:5.7 2.启动mysql容器 docker run -d -e MYSQL_ROOT_PASSWORD123456 -e MYSQL_TCP_PORT3307 -p 3307:3307 -v /SDXL/wjz/docker_mysql_log:/var/log/mysql -v /SDXL/wjz/docker_mysql_data:/var/lib/mysql -v /SDXL/wjz/docker_mysql_conf:/e…...
9、深入剖析PyTorch的nn.Sequential及ModuleList源码
文章目录 1. train&eval2. 求导数3. 参数更新4. ModuleList,Sequential5. Parameter&Parameter_List&ParmeterDict 1. train&eval train 模式:表示的是神经网络的训练模式,能够进行样本学习,通过样本来更新权重weighteval 模…...
idea初始化设置
下载idea: https://www.jetbrains.com/idea/ 安装idea 安装插件: Rainbow BracketsLombokMybatisXSonarLintMaven HelperCodeGeeX(国内AI插件可用) 设置idea注释模板: 设置代码注释模板: https://blo…...
【C/C++】内存管理详解:从new/delete到智能指针的全面解析
文章目录 更多文章C/C中的传统内存管理方式new和delete运算符malloc和free函数传统内存管理的弊端 智能指针的崛起智能指针的定义与作用C11引入的标准智能指针 详解C标准智能指针std::unique_ptr特点使用方法适用场景 std::shared_ptr特点使用方法适用场景 std::weak_ptr特点使…...
Vue.Draggable使用nested-with-vmodel进行拖拽
Vue.Draggable使用nested-with-vmodel进行拖拽 1. 介绍 draggable是一个基于Sortable.js的Vue组件,用于实现拖拽功能。它支持触摸设备、拖拽和选择文本、智能滚动、不同列表之间的拖拽等功能,并且与Vue的视图模型同步刷新,兼容Vue2的过…...
MySQL 中的乐观锁与悲观锁
文章目录 MySQL 中的乐观锁与悲观锁一、引言二、乐观锁(一)原理(二)应用场景(三)示例代码 三、悲观锁(一)原理(二)应用场景(三)示例代…...
面试题分享(一)
实习的项目 成员规模 用到过哪些设计模式? 策略、单例、工厂、代理 责任链模式了解吗? 责任链模式(Chain of Responsibility Pattern)是一种行为型设计模式,目的是为了避免请求的发送者与接收者之间的耦合关系。通…...
用天翼云搭建一个HivisionIDPhoto证件照处理网站
世人不必记我,我不记世人。 HivisionIDPhoto证件照处理网站 世人不必记我,我不记世人。项目地址项目搭建与修改前端后端遇到的坑 成果图 前段时间工作需要频繁处理证件照,当时同事推荐一个证件照小程序(要看广告)&…...
Conda环境迁移到内网
文章目录 一、conda是什么? conda环境迁移 二、迁移方法 1.docker方式 2.conda包方式 3.conda指定目录创建环境 4.pip方式 5.单个包安装 总结 前言 搞Python,使用conda是避免不了的,利用conda可以方便的管理多个不同的虚拟环境&…...
React Hooks中use的细节
文档 useState useState如果是以函数作为参数,那要求是一个纯函数,不接受任何参数,同时需要一个任意类型的返回值作为初始值。 useState可以传入任何类型的参数作为初始值,当以一个函数作为参数进行传入的时候需要注意ÿ…...
Android 16 开发者预览版抢先使用
Android 16 开发者预览版 获取 Android 16在 Google Pixel 设备上获取 Android 16设置 Android 模拟器 设置 Android 16 SDK获取 Android Studio安装 SDK更新应用的 build 配置 获取 Android 16 你可以通过以下任一方式获取 Android 16 在 Google Pixel 设备上获取 Android 1…...
蓝桥杯c++算法秒杀【6】之动态规划【上】(数字三角形、砝码称重(背包问题)、括号序列、组合数问题:::非常典型的必刷例题!!!)
下将以括号序列、组合数问题超级吧难的题为例子讲解动态规划 别忘了请点个赞收藏关注支持一下博主喵!!!! ! ! ! ! 关注博主,更多蓝桥杯nice题目静待更新:) 动态规划 一、数字三角形 【问题描述】 上图给出了…...
c#:winform引入bartender
1、vs新建项目 ①选择Windows窗体应用(.NET Framework) 2、将bartender引入vs中 ①找到bartender的安装目录,复制Seagull.BarTender.Print.dll文件 ②粘贴到项目->bin->Debug文件,并可创建Model文件夹:为了存放…...
Zabbix 模板翻译自动化教程
在企业 IT 运维管理中,Zabbix 作为一款强大的开源监控平台被广泛应用。而 Zabbix 模板作为监控配置的重要组成部分,用来定义监控项、触发器、图形等。随着国际化的需求增加,Zabbix 模板的翻译工作变得日益重要,特别是在需要为不同…...
HarmonyOS开发:DevEco Studio的Beta3(5.0.5.200)新增和增强特性
新增特性 DevEco Studio支持开发API 13工程。DevEco Profiler Frame模板新增Lost Frames和Hitch Time泳道,用于识别和优化卡顿和丢帧现象。具体请参考Frame分析。hvigor-config.json5中properties下新增ohos.arkCompile.noEmitJs字段,用于指定ArkTS编译…...
macOS安装nvm node
macOS安装nvm macOS安装nvm创建 nvm 工作目录配置环境变量使用 nvm查看可用的 Node.js 版本安装特定版本 macOS安装nvm brew install nvm创建 nvm 工作目录 mkdir ~/.nvm配置环境变量 vim ~/.zshrc# nvm export NVM_DIR"$HOME/.nvm" [ -s "/opt/homebrew/opt…...
SpringBoot 集成MQTT实现消息订阅
1、引入依赖 <!--MQTT start--><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-integration</artifactId></dependency><dependency><groupId>org.springframework.integrat…...
VM+Ubuntu18.04+XSHELL+VSCode环境配置
前段时间换了新电脑,准备安装Linux学习环境:VM虚拟机、Ubuntu18.04操作系统、XSHELL、XFTP远程连接软件、VSCode编辑器等,打算把安装过程记录一下。 1. 虚拟机介绍 为什么要用虚拟机? 想学习Linux操作系统,一般有3种…...
C#上机练习66-70
66.数组x中存有20个四位整数,请编制函数,求出正整数的个数tn。以及各位数字之和是偶数的数的个数tc,以及满足条件的这些数的算术平均ta.,将tn,tc,ta在控制台输出。 67.数组x中存有20个四位整数,请编制函数…...
pip 与当前python环境版本不匹配, pyenv, pipenv, conda
目录 pip 与当前python环境不匹配解决pip版本不一致 CondaPyenv pip 与当前python环境不匹配 电脑中安装了多个python虚拟环境, 有anaconda创建的虚拟环境,也有pyenv创建的虚拟环境,但是环境变量配置的是anaconda的路径 从而导致在vscode中选择的python版本是3.8.10,而pip却是…...
HAProxy面试题及参考答案(精选80道面试题)
目录 什么是 HAProxy? HAProxy 主要有哪些功能? HAProxy 的关键特性有哪些? HAProxy 的主要功能是什么? HAProxy 的作用是什么? 解释 HAProxy 在网络架构中的作用。 HAProxy 与负载均衡器之间的关系是什么? HAProxy 是如何实现负载均衡的? 阐述 HAProxy 的四层…...
ElasticSearch为什么不能在query阶段直接返回_id,从而避免fetch?
整理自Github的一个issue,也正好解答了我的疑惑 https://github.com/elastic/elasticsearch/issues/17159 提问 是否可以避免搜索的fetch阶段并仅返回文档ID?查询阶段结束时是否有_id,这样当我只需要_id时,fetch就多余了?可以通过…...