gRPC og højtydende API'er · Lektion

Serverreflection og dynamiske klienter

Aktivér gRPC-serverreflection, så værktøjer og klienter kan finde tjenester og meddelelsesskemaer under kørsel uden forudkompilerede stubs.

Lektion 4 af 413 trin

Serverreflection og dynamiske klienter er en gratis gRPC og højtydende API'er-lektion på CoddyKit. Dette er lektion 4 af 4. Du kan læse hele lektionen gratis nedenfor — og derefter øve dig praktisk i browseren med en indbygget kodeeditor og en AI-vejleder, der er tilgængelig døgnet rundt. Den er en del af læringsforløbet i gRPC og højtydende API'er, og dine fremskridt synkroniseres på tværs af nettet og CoddyKit-appen. gRPC og højtydende API'er-kurset indeholder 4 lektioner i alt.

Problemet med at finde stubber

Normalt har en klient brug for, at .proto-filerne er kompileret til stubber, før den kan kalde en tjeneste. Det er upraktisk for fejlfindingsværktøjer og generiske klienter.

Serverrefleksion lader en server beskrive sin egen API under kørsel.

Hvad refleksion eksponerer

Refleksionstjenesten besvarer spørgsmål som:

Hvilke tjenester er hostet på denne server?
Hvilke metoder har en tjeneste?
Hvad er skemaerne for anmodnings- og svarmeddelelser?

Den returnerer de underliggende FileDescriptorProto-data.

Aktivering af refleksion i Go

Registrer refleksionstjenesten på din gRPC-server med ét enkelt kald.

import 'google.golang.org/grpc/reflection'

s := grpc.NewServer()
pb.RegisterServiceServer(s, &svc{})
reflection.Register(s)

Aktivering af refleksion i Java

I Java skal du tilføje ProtoReflectionService, når du opbygger serveren.

Server server = ServerBuilder.forPort(9090)
  .addService(new MyServiceImpl())
  .addService(ProtoReflectionService.newInstance())
  .build();

Visning af tjenester med grpcurl

Når refleksion er aktiveret, kan grpcurl vise tjenester uden en proto-fil.

grpcurl -plaintext localhost:9090 list

Beskrivelse af en metode

Du kan undersøge en metodes input- og outputskema direkte fra serveren.

grpcurl -plaintext localhost:9090 describe my.pkg.Service.GetUser

Kald uden stubber

Refleksion lader dig kalde metoder ved at sende JSON; værktøjet omsætter det til protobuf ved hjælp af det fundne skema.

grpcurl -plaintext -d '{"id": 7}' localhost:9090 my.pkg.Service.GetUser

Dynamiske klienter i kode

Biblioteker kan opbygge meddelelser dynamisk ud fra deskriptorer, der hentes via reflection, så generiske gateways og administratorværktøjer kan fungere med enhver gRPC-server.

Reflection-protokollen

Reflection er selv en gRPC-tjeneste: grpc.reflection.v1.ServerReflection. Den bruger en tovejsstrøm, hvor klienter stiller spørgsmål, og serveren sender deskriptorer tilbage som en strøm.

Sikkerhedsovervejelser

Reflection afslører hele din API-overflade. I produktion:

Deaktivér den ved offentligt eksponerede grænser, eller
begræns den til interne netværk eller godkendte kaldere

Den er uvurderlig under udvikling og i staging.

Hvornår skal du bruge den

Reflection er særligt nyttig til fejlfinding, opbygning af generiske brugergrænseflader (som BloomRPC/Postman) og administratorværktøjer. Til applikationsklienter med høj gennemstrømning er prækompilerede stubs stadig hurtigere og sikrere.

Hurtigt tjek

Test din viden om reflection.

Besvar den i den interaktive lektion

Opsummering

Du har lært om server-reflection og dynamiske klienter:

Reflection lader en server beskrive sin egen API under kørsel
Aktivér den med reflection.Register (Go) eller ProtoReflectionService (Java)
Værktøjer som grpcurl kan vise en liste, beskrive og kalde uden stubs
Dynamiske klienter opbygger meddelelser ud fra hentede deskriptorer
Begræns reflection i produktion af hensyn til sikkerheden

Gratis at komme i gang

Lær gRPC og højtydende API'er med en AI-underviser — gratis

Skriv og kør rigtig kode i din browser, få øjeblikkelig hjælp fra en AI-underviser døgnet rundt, og fortsæt, hvor du slap, på web eller i appen.

Kurser: 12
Lektioner: 48

Start gratis Se hele kurset

Ofte stillede spørgsmål

Er lektionen “Serverreflection og dynamiske klienter” gratis?

Ja — hele teksten til “Serverreflection og dynamiske klienter” kan læses gratis her på nettet. Hvis du vil øve dig interaktivt med en indbygget kodeeditor og en AI-vejleder døgnet rundt og få adgang til resten af gRPC og højtydende API'er-kurset, skal du opgradere til CoddyKit PRO. gRPC og højtydende API'er-kurset indeholder 4 lektioner i alt.

Hvad lærer jeg i “Serverreflection og dynamiske klienter”?

Aktivér gRPC-serverreflection, så værktøjer og klienter kan finde tjenester og meddelelsesskemaer under kørsel uden forudkompilerede stubs. Du øver dig i gRPC og højtydende API'er med praktisk kode, som du kører direkte i browseren, og en AI-vejleder døgnet rundt besvarer dine spørgsmål, mens du arbejder dig gennem lektionen.

Skal jeg have erfaring for at begynde på gRPC og højtydende API'er?

Der kræves ingen tidligere erfaring. gRPC og højtydende API'er på CoddyKit er tilrettelagt for både begyndere og øvede, så du kan starte her eller fra begyndelsen og lære i dit eget tempo. Dette er lektion 4 af 4.

Hvor lang tid tager lektionen “Serverreflection og dynamiske klienter”?

De fleste CoddyKit-lektioner tager cirka 5–10 minutter. Hver lektion er kort og interaktiv, så du gør løbende fremskridt og kan fortsætte, hvor du slap – på både web og app.

Kan jeg skrive og køre kode i denne gRPC og højtydende API'er-lektion?

Ja. Alle gRPC og højtydende API'er-lektioner har en indbygget kodeeditor, så du kan skrive og køre rigtig kode direkte i din browser og få øjeblikkelig feedback fra AI – uden lokal opsætning.

Alle lektioner i dette kursus

← Tilbage til gRPC og højtydende API'er