Einen unären gRPC-Service implementieren
Server und Client mit grpc-go
Einen unären gRPC-Service implementieren ist eine kostenlose Go Academy-Lektion auf CoddyKit. Dies ist Lektion 2 von 4. Du kannst die komplette Lektion unten kostenlos lesen – dann übst du sie direkt im Browser mit einem integrierten Code-Editor und einem KI-Tutor rund um die Uhr. Sie ist Teil des Go Academy-Lernpfads, und dein Fortschritt wird über Web und CoddyKit-App synchronisiert. Der Go Academy-Kurs umfasst insgesamt 4 Lektionen.
Was ist ein unärer RPC?
Ein unärer RPC ist das einfachste gRPC-Muster: Der Client sendet eine Anfrage und empfängt eine Antwort, ähnlich wie bei einem normalen Funktionsaufruf über das Netzwerk.
Serverimplementierung
Implementieren Sie das generierte Interface. Binden Sie die Struktur Unimplemented*Server für Vorwärtskompatibilität ein:
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
}Server starten
Erstellen Sie einen gRPC-Server, registrieren Sie die Implementierung und lauschen Sie an einem TCP-Port:
lis, _ := net.Listen("tcp", ":50051")
grpcSrv := grpc.NewServer()
pb.RegisterUserServiceServer(grpcSrv, &userServer{})
log.Fatal(grpcSrv.Serve(lis))Clientverbindung
Stellen Sie eine Verbindung zum Server her und erstellen Sie einen Client-Stub:
conn, err := grpc.NewClient("localhost:50051", grpc.WithTransportCredentials(insecure.NewCredentials()))
if err != nil { log.Fatal(err) }
defer conn.Close()
client := pb.NewUserServiceClient(conn)Einen unären Aufruf durchführen
Rufen Sie die RPC-Methode über den Client-Stub auf, als wäre sie eine lokale Funktion:
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)Fehlerbehandlung
gRPC verwendet Statuscodes. Geben Sie mit status.Errorf Fehler zurück und prüfen Sie sie mit 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 */ }Kontextweitergabe
Der an den Client-RPC-Aufruf übergebene Kontext überträgt Zeitlimits und Abbruchsignale an den Server. Der Server sollte ihn an nachgelagerte Aufrufe (Datenbank, andere RPCs) weitergeben.
TLS für den Produktionseinsatz
Ersetzen Sie unsichere Anmeldedaten in der Produktion durch TLS:
creds, _ := credentials.NewServerTLSFromFile("cert.pem", "key.pem")
grpcSrv := grpc.NewServer(grpc.Creds(creds))UnimplementedServer
Das Einbinden von pb.UnimplementedXxxServer stellt Stub-Implementierungen für alle RPC-Methoden bereit, die den Status Unimplemented zurückgeben. Dadurch wird sichergestellt, dass der Server kompiliert, wenn dem Proto neue RPCs hinzugefügt wurden, bevor Sie sie implementieren.
grpc.Dial vs grpc.NewClient
grpc.Dial ist in neueren Versionen veraltet. Verwenden Sie grpc.NewClient, das nicht sofort eine Verbindung herstellt, sondern erst beim ersten RPC-Aufruf verzögert.
Reflection-Service
Registrieren Sie den gRPC-Reflection-Service, damit Tools wie grpcurl verfügbare Services ohne die .proto-Datei untersuchen können:
reflection.Register(grpcSrv)Kurzer Test
Welchen Zweck erfüllt das Einbinden von pb.UnimplementedXxxServer in eine gRPC-Serverstruktur?
Zusammenfassung: Unäres gRPC
Wichtige Punkte:
- Generiertes Interface implementieren; UnimplementedServer einbinden
- grpc.NewServer() + Register + Serve auf einem TCP-Listener
- Client: grpc.NewClient + generierter NewXxxClient
- status.Errorf/status.Code für die gRPC-Fehlerbehandlung verwenden
Häufig gestellte Fragen
Ist die Lektion „Einen unären gRPC-Service implementieren“ kostenlos?
Ja — der vollständige Text von „Einen unären gRPC-Service implementieren“ ist hier im Web kostenlos zu lesen. Um sie interaktiv zu üben (integrierter Code-Editor und 24/7 KI-Tutor) und den Rest des Go Academy-Kurses freizuschalten, upgrade auf CoddyKit PRO. Der Go Academy-Kurs umfasst insgesamt 4 Lektionen.
Was lerne ich in „Einen unären gRPC-Service implementieren“?
Server und Client mit grpc-go Du übst Go Academy mit praktischem Code, den du direkt im Browser ausführst, und ein 24/7 KI-Tutor beantwortet deine Fragen während du die Lektion bearbeitest.
Brauche ich Erfahrung, um Go Academy zu starten?
Keine Vorkenntnisse erforderlich. Go Academy auf CoddyKit ist für Anfänger bis fortgeschrittene Lernende strukturiert, sodass du hier starten oder von Anfang an beginnen und in deinem eigenen Tempo voranschreiten kannst. Dies ist Lektion 2 von 4.
Wie lange dauert die Lektion „Einen unären gRPC-Service implementieren“?
Die meisten CoddyKit-Lektionen dauern etwa 5–10 Minuten. Jede ist kompakt und interaktiv, sodass du stetig Fortschritte machst und genau dort weitermachst, wo du aufgehört hast – im Web und in der App.
Kann ich in dieser Go Academy-Lektion Code schreiben und ausführen?
Ja. Jede Go Academy-Lektion enthält einen integrierten Code-Editor, sodass du echten Code direkt in deinem Browser schreibst und ausführst und sofort KI-Feedback erhältst — ohne lokale Einrichtung erforderlich.
Alle Lektionen in diesem Kurs
- Protocol Buffers und .proto-Dateien
- Einen unären gRPC-Service implementieren
- Server- und Client-Streaming
- gRPC-Interceptoren und Metadaten