Go Academy · Pelajaran

Melaksanakan Perkhidmatan gRPC Unary

Pelayan dan client dengan grpc-go

Pelajaran 2 daripada 413 langkah

Melaksanakan Perkhidmatan gRPC Unary ialah pelajaran Go Academy percuma di CoddyKit. Ini ialah pelajaran 2 daripada 4. Sebanyak 3 pelajaran dalam laluan pembelajaran ini boleh dibaca sepenuhnya secara percuma — selepas itu, CoddyKit PRO membuka akses kepada semua pelajaran, serta latihan praktikal dengan penyunting kod terbina dalam dan tutor kecerdasan buatan yang tersedia 24/7. Pelajaran ini merupakan sebahagian daripada laluan pembelajaran Go Academy, dan kemajuan anda disegerakkan merentas web serta aplikasi CoddyKit. Kursus Go Academy merangkumi sejumlah 4 pelajaran.

Apakah RPC unari?

RPC unari ialah corak gRPC yang paling mudah: klien menghantar satu permintaan dan menerima satu respons, sama seperti panggilan fungsi biasa melalui rangkaian.

Pelaksanaan pelayan

Laksanakan antara muka yang dijana. Benamkan struktur Unimplemented*Server untuk keserasian ke hadapan:

type userServer struct {
    pb.UnimplementedUserServiceServer
    db *sql.DB
}

func (s *userServer) GetUser(ctx context.Context, req *pb.GetUserRequest) (*pb.User, error) {
    // query DB
    return &pb.User{Id: req.Id, Name: "Alice"}, nil
}

Memulakan pelayan

Cipta pelayan gRPC, daftarkan pelaksanaan tersebut dan dengar pada port TCP:

lis, _ := net.Listen("tcp", ":50051")
grpcSrv := grpc.NewServer()
pb.RegisterUserServiceServer(grpcSrv, &userServer{})
log.Fatal(grpcSrv.Serve(lis))

Sambungan klien

Sambungkan ke pelayan dan cipta stub klien:

conn, err := grpc.NewClient("localhost:50051", grpc.WithTransportCredentials(insecure.NewCredentials()))
if err != nil { log.Fatal(err) }
defer conn.Close()
client := pb.NewUserServiceClient(conn)

Membuat panggilan unari

Panggil kaedah RPC pada stub klien seolah-olah kaedah itu ialah fungsi setempat:

ctx, cancel := context.WithTimeout(context.Background(), time.Second)
defer cancel()
user, err := client.GetUser(ctx, &pb.GetUserRequest{Id: 42})
if err != nil { log.Fatalf("error: %v", err) }
fmt.Println(user.Name)

Pengendalian ralat

gRPC menggunakan kod status. Pulangkan ralat dengan status.Errorf dan semaknya dengan status.Code(err):

import "google.golang.org/grpc/status"
import "google.golang.org/grpc/codes"

// Server:
return nil, status.Errorf(codes.NotFound, "user %d not found", req.Id)
// Client:
if status.Code(err) == codes.NotFound { /* handle */ }

Penyebaran konteks

Konteks yang dihantar kepada panggilan RPC klien membawa tarikh akhir dan pembatalan ke pelayan. Pelayan hendaklah meneruskannya kepada panggilan hiliran (pangkalan data, RPC lain).

TLS untuk pengeluaran

Gantikan kelayakan tidak selamat dengan TLS dalam persekitaran pengeluaran:

creds, _ := credentials.NewServerTLSFromFile("cert.pem", "key.pem")
grpcSrv := grpc.NewServer(grpc.Creds(creds))

UnimplementedServer

Membenamkan pb.UnimplementedXxxServer menyediakan pelaksanaan stub bagi semua kaedah RPC yang memulangkan status Unimplemented. Ini memastikan pelayan dapat dikompil apabila RPC baharu ditambahkan pada proto sebelum anda melaksanakannya.

grpc.Dial berbanding grpc.NewClient

grpc.Dial tidak lagi disokong dalam versi yang lebih baharu. Gunakan grpc.NewClient, yang tidak mewujudkan sambungan dengan segera tetapi melakukannya secara tertunda pada panggilan RPC pertama.

Perkhidmatan refleksi

Daftarkan perkhidmatan refleksi gRPC supaya alat seperti grpcurl boleh memeriksa perkhidmatan yang tersedia tanpa fail .proto:

reflection.Register(grpcSrv)

Semakan Pantas

Apakah tujuan membenamkan pb.UnimplementedXxxServer dalam struktur pelayan gRPC?

Jawab dalam pelajaran interaktif

Ringkasan: gRPC Unari

Perkara utama:

Laksanakan antara muka yang dijana; benamkan UnimplementedServer
grpc.NewServer() + Register + Serve pada pendengar TCP
Klien: grpc.NewClient + NewXxxClient yang dijana
Gunakan status.Errorf/status.Code untuk pengendalian ralat gRPC

Percuma untuk bermula

Pelajari Go dengan tutor kecerdasan buatan — percuma

Tulis dan jalankan kod sebenar dalam pelayar anda, dapatkan bantuan segera daripada tutor kecerdasan buatan yang tersedia 24/7, dan sambung semula dari tempat anda berhenti di web atau dalam aplikasi.

Kursus: 51
Pelajaran: 203

Mula belajar secara percuma Lihat kursus penuh

Soalan Lazim

Adakah pelajaran “Melaksanakan Perkhidmatan gRPC Unary” percuma?

Ya — sebanyak 3 pelajaran dalam laluan pembelajaran Go Academy, termasuk “Melaksanakan Perkhidmatan gRPC Unary”, boleh dibaca sepenuhnya secara percuma di web ini. Selepas itu, CoddyKit PRO membuka akses kepada semua pelajaran, serta latihan interaktif dengan penyunting kod terbina dalam dan tutor kecerdasan buatan yang tersedia 24/7. Kursus Go Academy merangkumi sejumlah 4 pelajaran.

Apakah yang akan saya pelajari dalam “Melaksanakan Perkhidmatan gRPC Unary”?

Pelayan dan client dengan grpc-go Anda berlatih Go Academy menggunakan kod praktikal yang dijalankan terus dalam pelayar, manakala tutor kecerdasan buatan 24/7 menjawab soalan anda semasa anda mengikuti pelajaran.

Adakah saya memerlukan pengalaman untuk memulakan Go Academy?

Tiada pengalaman terdahulu diperlukan. Pembelajaran Go Academy di CoddyKit disusun untuk pelajar daripada peringkat pemula hingga lanjutan, jadi anda boleh bermula di sini atau dari awal dan belajar mengikut kadar anda sendiri. Ini ialah pelajaran 2 daripada 4.

Berapa lamakah pelajaran “Melaksanakan Perkhidmatan gRPC Unary” diambil?

Kebanyakan pelajaran CoddyKit mengambil masa kira-kira 5–10 minit. Setiap pelajaran ringkas dan interaktif, jadi anda boleh membuat kemajuan secara berterusan dan menyambung tepat dari tempat anda berhenti di web atau aplikasi.

Bolehkah saya menulis dan menjalankan kod dalam pelajaran Go Academy ini?

Ya. Setiap pelajaran Go Academy menyertakan penyunting kod terbina dalam, jadi anda boleh menulis dan menjalankan kod sebenar terus dalam pelayar serta menerima maklum balas kecerdasan buatan serta-merta — tanpa memerlukan persediaan setempat.

Semua pelajaran dalam kursus ini

← Kembali ke Go Academy