Go Academy · Lezione

Implementare un servizio gRPC unary

Server e client con grpc-go

Implementare un servizio gRPC unary è una lezione Go Academy gratuita su CoddyKit. Questa è la lezione 2 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Go Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Go Academy include 4 lezioni in totale.

Che cos'è una RPC unaria?

Una RPC unaria è il pattern gRPC più semplice: il client invia una richiesta e riceve una risposta, in modo simile a una normale chiamata di funzione sulla rete.

Implementazione del server

Implementi l'interfaccia generata. Incorpori la struct Unimplemented*Server per garantire la compatibilità futura:

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
}

Avvio del server

Crei un server gRPC, registri l'implementazione e ascolti su una porta TCP:

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

Connessione del client

Si connetta al server e crei uno stub client:

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

Esecuzione di una chiamata unaria

Chiami il metodo RPC sullo stub client come se fosse una funzione locale:

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)

Gestione degli errori

gRPC utilizza codici di stato. Restituisca gli errori con status.Errorf e li verifichi con 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 */ }

Propagazione del contesto

Il contesto passato alla chiamata RPC del client trasferisce al server le scadenze e la cancellazione. Il server dovrebbe passarlo alle chiamate downstream (database, altre RPC).

TLS in produzione

In produzione, sostituisca le credenziali non sicure con TLS:

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

UnimplementedServer

L'inclusione di pb.UnimplementedXxxServer fornisce implementazioni stub di tutti i metodi RPC, che restituiscono lo stato Unimplemented. In questo modo il server continua a compilare quando vengono aggiunte nuove RPC al proto prima che Lei le implementi.

grpc.Dial e grpc.NewClient

grpc.Dial è deprecato nelle versioni più recenti. Utilizzi grpc.NewClient, che non stabilisce subito una connessione, ma lo fa in modo differito alla prima chiamata RPC.

Servizio di reflection

Registri il servizio di reflection gRPC per consentire a strumenti come grpcurl di analizzare i servizi disponibili senza il file .proto:

reflection.Register(grpcSrv)

Verifica rapida

Qual è lo scopo dell'inclusione di pb.UnimplementedXxxServer in una struct server gRPC?

Riepilogo: gRPC unaria

Punti chiave:

Implementi l'interfaccia generata e incorpori UnimplementedServer
grpc.NewServer() + Register + Serve su un listener TCP
Client: grpc.NewClient + NewXxxClient generato
Utilizzi status.Errorf/status.Code per la gestione degli errori gRPC

Domande Frequenti

La lezione «Implementare un servizio gRPC unary» è gratuita?

Sì — il testo completo di «Implementare un servizio gRPC unary» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Go Academy, passa a CoddyKit PRO. Il corso Go Academy include 4 lezioni in totale.

Cosa imparerò in «Implementare un servizio gRPC unary»?

Server e client con grpc-go Eserciti Go Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare Go Academy?

Non è richiesta alcuna esperienza precedente. Go Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 2 di 4.

Quanto tempo richiede la lezione «Implementare un servizio gRPC unary»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione Go Academy?

Sì. Ogni lezione Go Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

← Torna a Go Academy