Protobuf tanımı

.proto dosyasıyla mesaj tanımlamayı öğrenirsin.

Protobuf tanımı

gRPC'de sözleşme bir .proto dosyasında yazılır: mesajlar (veri yapıları) ve servis (çağrılabilecek yöntemler).

syntax = "proto3";
package selam;
option go_package = "example.com/app/selampb";

message SelamIstek { string ad = 1; }
message SelamYanit { string mesaj = 1; }

service Selamlayici {
  rpc Selam(SelamIstek) returns (SelamYanit);
}

Alan numaraları (= 1) ikili kodlamada alanın kimliğidir.

Türler ve tekrar eden alanlar

Protobuf türleri Go'ya doğrudan eşlenir: string → string, int32 → int32, bool → bool. repeated alan dilim olur, iç içe mesaj işaretçi olur:

message Sepet {
  string sahip = 1;
  repeated string urunler = 2;  // []string
}

Alan silerken numarasını reserved ile ayırmak, yanlışlıkla yeniden kullanılmasını engeller.

Uygulama Mesaj karşılığı

message Sepet { string sahip = 1; repeated string urunler = 2; } mesajının Go karşılığını elle yaz: type Sepet struct { Sahip string; Urunler []string }. Sepet{"ada", []string{"kalem", "defter"}} için ürün sayısını yazdır.

Örnek çözümü göster

package main

import "fmt"

type Sepet struct {
    Sahip string
    Urunler   []string
}

func main() {
    s := Sepet{"ada", []string{"kalem", "defter"}}
    fmt.Println(len(s.Urunler))
}

Kendini test et

Yayındaki bir mesajın alan numarasını değiştirmek neden tehlikelidir?
- Hiçbir etkisi olmaz
- Eski istemciler veriyi yanlış alana çözer
- Mesaj büyür
- Derleme yavaşlar
Cevabı göster

Eski istemciler veriyi yanlış alana çözer — İkili biçimde alan adı değil numara gönderilir; numara değişirse eski ve yeni kod veriyi farklı yorumlar.

Liste alanı

message Siparis {
  ____ string urunler = 1;
}

Cevabı göster

message Siparis {
  repeated string urunler = 1;
}

proto ve Go

string ad = 1

Ad string
repeated int32 puan = 2

Puan []int32
message

struct
service

Arayüz (interface)

Sıradaki ders: protoc ile derleme

Deneyiminizi Geliştiriyoruz

Çerez Tercihleri

Kesinlikle Gerekli Çerezler

Analitik Çerezler