Go Academy · Ders

Protocol Buffers ve .proto Dosyaları

İleti türleri, hizmetler ve protoc kod oluşturma

Protocol Buffers ve .proto Dosyaları, CoddyKit'te ücretsiz bir Go Academy dersidir. Bu, 4 dersinin 1. dersidir. Aşağıdan dersin tamamını ücretsiz okuyabilir, sonra tarayıcıda yerleşik kod editörü ve 7/24 yapay zeka koçu ile uygulamalı olarak pratik yapabilirsin. Bu, Go Academy öğrenme yolunun bir parçasıdır ve ilerlemeniz web ve CoddyKit uygulaması arasında senkronize olur. Go Academy kursu toplamda 4 dersten oluşur.

Protocol Buffers nedir?

Protocol Buffers (protobuf), Google tarafından geliştirilen, dilden bağımsız bir ikili serileştirme biçimidir. JSON'dan daha küçük ve hızlıdır; gRPC için standart kablo biçimidir.

.proto dosyası söz dizimi

İletileri ve hizmetleri bir .proto dosyasında tanımlayın:

syntax = "proto3";
package user;
option go_package = "github.com/example/user/pb";

message User {
    int64 id   = 1;
    string name = 2;
    string email = 3;
}

service UserService {
    rpc GetUser (GetUserRequest) returns (User);
}
message GetUserRequest { int64 id = 1; }

Alan numaraları

Her alanın, ikili kodlamada kullanılan benzersiz bir numarası (etiketi) vardır. Şema kullanıma alındıktan sonra mevcut alan numaralarını hiçbir zaman değiştirmeyin — bu, uyumluluğu bozar.

proto3 varsayılanları

proto3'te tüm alanların varsayılan değerleri vardır (sayılar için 0, dizeler için "", bool değerleri için false). Zorunlu ve isteğe bağlı ayrımı yoktur — eksik alanlar varsayılan değeri alır.

protoc'ı yükleme

protobuf derleyicisini ve Go eklentisini yükleyin:

brew install protobuf
go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest

Go kodu oluşturma

Go yapılarını ve gRPC taslaklarını oluşturmak için protoc'ı çalıştırın:

protoc --go_out=. --go_opt=paths=source_relative \
       --go-grpc_out=. --go-grpc_opt=paths=source_relative \
       user/user.proto

Oluşturulan türler

protoc şunları oluşturur: her ileti için bir Go yapısı, alıcı yöntemleri, bir hizmet arayüzü, uygulanmamış bir sunucu yapısı ve tüm RPC yöntemlerini içeren bir istemci yapısı.

Tekrarlanan alanlar

Bir listeyi temsil etmek için repeated kullanın (Go diliminde karşılığı vardır):

message ListUsersResponse {
    repeated User users = 1;
}

Numaralandırmalar

proto3'te numaralandırmalar tanımlayın. İlk değer 0 olmalıdır (varsayılan değer):

enum Role {
    ROLE_UNSPECIFIED = 0;
    ROLE_USER        = 1;
    ROLE_ADMIN       = 2;
}

İyi bilinen türler

google/protobuf paketi yaygın türler sağlar: Timestamp, Duration, Struct (JSON benzeri), Any. Bunları .proto dosyanıza içe aktarın.

import "google/protobuf/timestamp.proto";
message Event { google.protobuf.Timestamp created_at = 1; }

Geriye dönük uyumluluk kuralları

Güvenli değişiklikler: yeni alanlar eklemek, yeni ileti türleri eklemek, yeni numaralandırma değerleri eklemek. Güvensiz değişiklikler: alan numaralarını değiştirmek, alan türlerini değiştirmek, alanları kaldırmak (bunlar sessizce varsayılan değere dönüşür).

Hızlı Kontrol

Bir protobuf mesajındaki alan numaralarıyla ilgili hangi koşul sağlanmalıdır?

Özet: Protocol Buffers

Temel noktalar:

.proto, mesajları (alanlar + türler) ve hizmetleri (RPC'ler) tanımlar
Alan numaraları kalıcıdır; bunları asla yeniden kullanmayın veya değiştirmeyin
protoc + Go eklentisi, Go yapılarını ve gRPC istemci-sunucu taslaklarını oluşturur
Tekrarlanan alanlar → dilimler; numaralandırmalar 0'dan başlamalıdır

Sıkça Sorulan Sorular

“Protocol Buffers ve .proto Dosyaları” dersi ücretsiz mi?

Evet — “Protocol Buffers ve .proto Dosyaları” dersin tüm metni burada web'de ücretsiz olarak okunabilir. Etkileşimli olarak pratik yapmak (yerleşik kod editörü ve 7/24 yapay zeka koçu) ve Go Academy kursunun geri kalanını açmak için CoddyKit PRO'ya yükselt. Go Academy kursu toplamda 4 dersten oluşur.

“Protocol Buffers ve .proto Dosyaları” dersinde ne öğreneceğim?

İleti türleri, hizmetler ve protoc kod oluşturma Go Academy ile uygulamalı kodu tarayıcıda doğrudan çalıştırarak pratik yaparsın ve 7/24 yapay zeka koçu dersi çalışırken sorularını yanıtlar.

Go Academy öğrenmeye başlamak için deneyim gerekli mi?

Önceden deneyim gerekmez. CoddyKit'te Go Academy, başlangıçtan ileri seviyeye kadar yapılandırıldığı için buradan başlayabilir veya başından başlayıp kendi hızında ilerleme yapabilirsin. Bu, 4 dersinin 1. dersidir.

“Protocol Buffers ve .proto Dosyaları” dersi ne kadar sürer?

Çoğu CoddyKit dersi yaklaşık 5–10 dakika sürer. Her biri kısa ve etkileşimli olduğu için sabit ilerleme yaparsın ve web ile uygulama arasında tam olarak bıraktığın yerden devam edebilirsin.

Bu Go Academy dersinde kod yazıp çalıştırabilir miyim?

Evet. Her Go Academy dersi yerleşik bir kod editörü içerir, bu sayede tarayıcıda gerçek kod yazıp çalıştırabilir ve anlık yapay zeka geri bildirimi alırsın — yerel kurulum gerekli değildir.

Bu kursun tüm dersleri

← Go Academy Sayfasına Dön