Software Engineer Encyclopedia
0%
Domain 03 · Backend Engineering & Web Development · Topic 3.9

gRPC مع ASP.NET Core: RPC وProtocol Buffers

gRPC

مفاهيم RPC وprotobuf و.proto service definitions وgenerated clients وunary/streaming calls وdeadlines/cancellation/errors/auth وgRPC مقابل REST وJSON transcoding.

  • Intermediate
  • ~13 min read
  • 11 sections
  • 14 code examples
  • 1 diagrams
  • 3 questions
  • Priority L3 · Optional
  • .NET 10 · ASP.NET Core 10 · Grpc.AspNetCore / Grpc.Net.Client (check aligned package versions)

المتطلبات قبل ما تبدأ

C# و.NET (المجال 02) والـ HTTP/Networking (درس 1.2).

مستوى التعمق المطلوب

BASICS + SMALL APPBuild a small example; advanced streaming can wait.

01

RPC و Protocol Buffers

Service contract before transport
Deep dive

REST/HTTP عادة يصمم interaction حول resources؛ gRPC يصممها حول remote procedure calls: client ينادي method على service عن بعد كأنها method call، لكن الشبكة تظل غير موثوقة وبطيئة وقابلة للفشل. gRPC يستخدم HTTP/2 في السيناريو القياسي و Protocol Buffers كـ schema-driven binary serialization.

ملف .proto هو contract language-independent يعرّف messages و services. الـ code generator ينتج strongly typed client/server stubs للغات مدعومة. أرقام fields جزء من wire contract؛ لا تعيد استخدام رقم محذوف ولا تغير معنى field موجود في breaking way.

Protobufinventory.proto
syntax = "proto3";

option csharp_namespace = "Inventory.Grpc";
package inventory.v1;

service Inventory {
  rpc GetStock (GetStockRequest) returns (GetStockReply);
  rpc WatchStock (WatchStockRequest) returns (stream StockUpdate);
}

message GetStockRequest { int32 product_id = 1; }
message GetStockReply {
  int32 product_id = 1;
  int32 available_quantity = 2;
}
message WatchStockRequest { int32 product_id = 1; }
message StockUpdate { int32 product_id = 1; int32 quantity = 2; }

Generated code يحتوي base service class و client. أنت تنفذ service implementation وتستخدم client stub؛ لا تكتب serialization plumbing بنفسك.

Protocol Buffers: Schema و Wire Format

gRPC غالباً يستخدم Protocol Buffers (Protobuf) كـ interface definition language و serialization format. ملف .proto يحدد package و messages و service methods. أدوات build تولد C#‎ message types و client/server base classes. على عكس JSON الذي يحمل أسماء properties نصياً غالباً، Protobuf wire format يستخدم field numbers؛ لذلك أرقام الحقول جزء من compatibility contract ولا يعاد استخدامها بعد حذف field.

Protobufcatalog.proto
syntax = "proto3";

package catalog.v1;
option csharp_namespace = "Catalog.Grpc.V1";

message GetProductRequest {
  int32 id = 1;
}

message ProductReply {
  int32 id = 1;
  string name = 2;
  string price = 3;
}

service CatalogService {
  rpc GetProduct (GetProductRequest) returns (ProductReply);
}

لا تغير field number من 2 إلى 5 كأنه refactor عادي؛ clients القديمة ستقرأ schema بطريقة مختلفة. احجز الأرقام المحذوفة باستخدام reserved. أضف fields اختيارية جديدة بأرقام جديدة، وكن حذراً عند تغيير type أو معنى field. string price في المثال لتوضيح contract فقط؛ اختيار decimal representation يحتاج اتفاقاً واضحاً مثل integer minor units أو decimal string.

02

gRPC في رسمة: من الـ .proto للـ wire

From contract to wire
Basics
inventory.protoGenerated clienttyped methods + deadlineGenerated base classyou override methodsHTTP/2 stream: headers + protobuf messagestrailers: grpc-status, grpc-messageField numbers, not names, go on the wire → never reuse a number
One .proto generates both sides; calls travel as protobuf frames over one HTTP/2 connection
03

Service Definitions و Unary Calls

Implement the generated service
Practical
C#InventoryGrpcService.cs
public sealed class InventoryGrpcService(IStockReader stock)
    : Inventory.InventoryBase
{
    public override async Task<GetStockReply> GetStock(
        GetStockRequest request, ServerCallContext context)
    {
        if (request.ProductId <= 0)
            throw new RpcException(new Status(StatusCode.InvalidArgument,
                "product_id must be positive"));

        var quantity = await stock.GetAvailableAsync(
            request.ProductId, context.CancellationToken);

        return new GetStockReply
        {
            ProductId = request.ProductId,
            AvailableQuantity = quantity
        };
    }
}

Unary call = request واحد و response واحدة. الـ server يرمي RpcException مع gRPC status code مناسب. لا تسرّب internal exception message. أمثلة status codes: InvalidArgument، NotFound، Unauthenticated، PermissionDenied، DeadlineExceeded، Unavailable، Internal.

C#Client call
using var channel = GrpcChannel.ForAddress("https://localhost:7042");
var client = new Inventory.InventoryClient(channel);
var reply = await client.GetStockAsync(
    new GetStockRequest { ProductId = 42 },
    deadline: DateTime.UtcNow.AddSeconds(3));
Console.WriteLine(reply.AvailableQuantity);

Server Implementation و Generated Client

في ASP.NET Core server تسجل gRPC services وتعمل map للـ service class المولدة من proto. كل method تستقبل request message و ServerCallContext، وترجع response message. العميل يستخدم generated client ويستدعي RPC method. خليك واضح إن gRPC ليس مجرد REST JSON endpoint؛ الـ contract والـ transport و error model مختلفين.

C#Server implementation
public sealed class CatalogGrpcService(IProductQuery query)
    : CatalogService.CatalogServiceBase
{
    public override async Task<ProductReply> GetProduct(
        GetProductRequest request, ServerCallContext context)
    {
        var product = await query.FindAsync(
            request.Id, context.CancellationToken);

        if (product is null)
            throw new RpcException(new Status(
                StatusCode.NotFound, "Product was not found."));

        return new ProductReply
        {
            Id = product.Id,
            Name = product.Name,
            Price = product.Price.ToString(CultureInfo.InvariantCulture)
        };
    }
}
C#Client call with deadline
var client = new CatalogService.CatalogServiceClient(channel);
var reply = await client.GetProductAsync(
    new GetProductRequest { Id = 42 },
    deadline: DateTime.UtcNow.AddSeconds(3),
    cancellationToken: cancellationToken);

في production استخدم channel/client lifetime مدروس؛ لا تنشئ channel جديدة لكل call بلا داعٍ. مرر deadline و cancellation، وتعامل مع RpcException status codes. لا ترجع exception message الداخلية للعميل كأنها public error contract.

Channel Lifetime و Client Reuse

gRPC channel تمثل connection infrastructure وتُعاد استخدامها لعدة calls؛ لا تنشئ channel جديدة لكل RPC من غير سبب. استخدم typed/named client patterns أو DI registration المناسب لـ Grpc.Net.ClientFactory حسب app. راقب channel lifetime و DNS/service discovery behavior عند تغيير endpoints. generated client عادة lightweight wrapper فوق channel، ويمكن إعادة استخدامه.

في client code، حدد deadline، cancellation، auth credentials، retry policy إن كانت مدروسة، و metadata. لا تجعل retry policy تعيد command غير idempotent تلقائياً. اختبر call failure عند server unavailable و deadline exceeded.

04

Streaming و Deadlines و Cancellation

Four RPC shapes
Deep dive
ShapeDirectionMeaning
Unary1 request → 1 responseTypical command/query
Server streaming1 request → response streamServer pushes updates
Client streamingrequest stream → 1 responseClient uploads a sequence
Bidirectionalstream ↔ streamTwo-way conversation

Streaming يقلل الحاجة لتحميل كل البيانات مرة واحدة لكنه يضيف concerns مثل backpressure، cancellation، partial completion، flow control، connection lifetime، و resource cleanup. Deadline يحدد الوقت الأقصى الذي ينتظره client؛ لازم propagate للـ downstream operations. Cancellation token يجب أن يوقف العمل قدر الإمكان.

C#Server streaming implementation
public override async Task WatchStock(
    WatchStockRequest request,
    IServerStreamWriter<StockUpdate> responseStream,
    ServerCallContext context)
{
    await foreach (var update in _stock.WatchAsync(
        request.ProductId, context.CancellationToken))
    {
        await responseStream.WriteAsync(new StockUpdate
        {
            ProductId = update.ProductId,
            Quantity = update.Quantity
        });
    }
}

Unary و Streaming و Backpressure

PatternDirectionTypical use
Unary1 request → 1 responseLookup or command
Server streaming1 request → many responsesLive feed / export stream
Client streamingmany requests → 1 responseUpload/batch aggregation
Bidirectionalmany ↔ manyInteractive sessions

Streaming لا يعني أن الذاكرة مجانية. اقرأ واكتب message-by-message، احترم cancellation، لا تجمع كل stream في List ضخمة، وضع limits على message size ومدة الاتصال. في bidirectional streaming، client و server يقرآن ويكتبان بشكل مستقل؛ صمم synchronization/error completion بوضوح.

C#Server streaming method shape
public override async Task StreamProducts(
    StreamProductsRequest request,
    IServerStreamWriter<ProductReply> responseStream,
    ServerCallContext context)
{
    await foreach (var product in query.StreamAsync(
        request.CategoryId, context.CancellationToken))
    {
        await responseStream.WriteAsync(new ProductReply
        {
            Id = product.Id,
            Name = product.Name
        });
    }
}

Deadline Propagation و Cancellation

Deadline يحدد آخر وقت مقبول لاكتمال RPC. لو service A تستدعي B ثم C، لازم الميزانية الزمنية تنتقل downstream؛ لا تعطي كل hop timeout كامل مستقل فيتجاوز مجموع الزمن deadline الأصلي. استخدم cancellation token القادم من ServerCallContext عند DB/network operations. لما deadline ينتهي، العميل قد يحصل على DeadlineExceeded، لكن server code لازم يتوقف فعلياً عند cancellation.

لا تعمل retry بلا حدود داخل gRPC service. retries تحتاج idempotent operation أو request deduplication، overall deadline، backoff، و retryable status codes. لا تعيد محاولة InvalidArgument أو PermissionDenied.

Streaming Error Semantics

في unary RPC، failure عادة يظهر كـ gRPC status في نهاية call. في streaming RPC، ممكن تكون رسائل اتبعت بالفعل قبل failure؛ client لا يستطيع افتراض أن stream كلها transaction واحدة. صمم message sequence أو checkpoint/resume لو partial delivery له أثر. استخدم event IDs/sequence numbers عند الحاجة، واجعل consumer idempotent.

Cancellation في stream قد يأتي من client أو deadline أو server shutdown. أوقف producer بسرعة، وتخلص من resources، ولا تكمل database reads بعد أن client أغلق stream. لا تخزن كل messages في memory لتسهيل retry؛ stream كبيرة تحتاج backpressure و bounded buffering.

05

Authentication و Compatibility

Metadata, TLS, and protobuf evolution
Deep dive

gRPC metadata headers تحمل auth credentials مثل bearer token؛ استخدم TLS، وطبق ASP.NET Core authentication/authorization policies على service/method. لا تضع secrets داخل protobuf message أو logs. JSON transcoding يسمح بإتاحة HTTP/JSON surface لبعض gRPC methods مع annotations/configuration، لكنه لا يحول gRPC إلى REST كامل بشكل تلقائي.

Protobuf evolution rules: لا تغيّر field number، لا تستخدم رقم field قديم محذوف، استخدم reserved للأرقام/names التي أزيلت، أضف fields اختيارية جديدة بأرقام جديدة، وفكر في default values عند قراءة messages قديمة. الـ package/service versioning جزء من contract strategy.

ProtobufSafe field removal pattern
message GetStockReply {
  int32 product_id = 1;
  int32 available_quantity = 2;
  reserved 3;
  reserved "legacy_note";
  string warehouse_code = 4;
}

Status Codes و Authentication و Versioning

gRPC يستخدم status codes خاصة به مثل InvalidArgument و Unauthenticated و PermissionDenied و NotFound و AlreadyExists و Unavailable و DeadlineExceeded. اختار status يعبّر عن semantics، ولا تحوّل كل failure إلى Internal. Metadata يمكن أن تحمل auth headers أو tracing context، لكن لا تضع secrets في logs.

للتوافق، أضف fields جديدة بأرقام جديدة، لا تعِد استخدام المحذوف، ولا تغيّر meaning field موجود. يمكن استخدام package/version namespace مثل catalog.v1 عندما breaking change ضروري. JSON transcoding يتيح HTTP/JSON gateway لبعض gRPC services، لكنه يحتاج annotations/configuration، ولا يجعل كل gRPC capability مطابقة تلقائياً لـ REST.

Protobuf Compatibility و Testing

قواعد Protobuf المهمة: لا تعِد استخدام field numbers المحذوفة؛ استخدم reserved numbers/names؛ أضف fields جديدة بدلاً من تغيير معنى القديمة؛ لا تغيّر type إلى نوع wire-incompatible؛ وتجنب تغيير cardinality/oneof semantics من غير خطة. اختبر generated clients من version أقدم مع server جديد إذا كان compatibility مطلوباً.

اختبر gRPC service مباشرة أو عبر in-process test server، واختبر status codes وال metadata وال deadline/cancellation وال stream termination. لا تكتفِ باختبار mapping function؛ transport behavior جزء من العقد.

Metadata و Interceptors

gRPC metadata تشبه HTTP headers وتحمل authentication credentials أو correlation context أو tracing baggage. لا تضع بيانات كبيرة فيها، ولا تسجل authorization metadata. Interceptors تسمح بسلوك مشترك حول RPC calls مثل logging أو metrics أو exception translation. خلي interceptor عاماً وخفيفاً؛ authorization على resource بعينه تظل في service/use case.

الـ deadline و cancellation لازم ينتقلان downstream. لو server استقبل request ثم استدعى DB أو service أخرى، مرر cancellation token و deadline budget. لا تبدأ background work من RPC ثم تعتمد على ServerCallContext بعد انتهاء call؛ انقل durable work إلى queue/job system.

Error Model و Rich Error Details

gRPC status code يحدد category، والـ status description نص قصير. لا ترسل stack trace أو SQL error في description. لو تحتاج structured error details، استخدم protobuf error detail contract معروفاً بين client/server، مع مراعاة package interoperability. client يجب أن يتعامل مع status code لا مع string message.

فرّق بين InvalidArgument و FailedPrecondition و AlreadyExists و NotFound و Unauthenticated و PermissionDenied و Unavailable و DeadlineExceeded. لا تجعل كل business conflict Internal. اختبر mapping من application error إلى gRPC status بشكل مستقل.

06

gRPC vs REST: إمتى تستخدم كل واحد؟

Internal service communication decisions
Basics
CriteriongRPCREST/JSON
ContractProtobuf schema + generated stubsURI/resources + OpenAPI/JSON
PayloadCompact binaryHuman-readable JSON
StreamingFirst-class streaming RPC patternsSSE/streaming/WebSocket patterns separate
Browser supportUsually gRPC-Web/proxy or transcodingNative browser HTTP support
Typical fitService-to-service, typed contractsPublic APIs, browser/mobile integrations

gRPC قد يكون مناسباً للتواصل الداخلي بين ‎.NET services ذات contracts واضحة وطلب latency/streaming، بينما REST غالباً أسهل للعملاء المتنوعين والـ browser. لا تختَر gRPC لمجرد أنه binary أسرع؛ قِس serialization/network/compute كامل، وقيّم gateway/tooling/observability والتوافق.

gRPC ولا REST؟

REST/JSON غالباً أسهل للمتصفح والعملاء العامة والـ debugging المباشر والـ caching التقليدي. gRPC مناسب جداً للـ service-to-service communication، contracts generated، strongly typed clients، HTTP/2، streaming، والرسائل الثنائية compact. browser support يحتاج gRPC-Web أو transcoding، ولا تفترض أن كل network/proxy يدعم HTTP/2 end-to-end.

لا تختار gRPC لمجرد أنه أسرع في benchmark صغير؛ قِس serialization, payload, latency, throughput، وتعقيد التشغيل. لو API public لموبايل أو SPA، REST غالباً أبسط. لو internal services تتبادل typed commands/streams، gRPC يستحق النظر.

07

Server Registration و Transport Requirements

Wire generated code into ASP.NET Core
Practical
C#Program.cs — gRPC server setup
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddGrpc();
builder.Services.AddScoped<IStockReader, StockReader>();
var app = builder.Build();
app.MapGrpcService<InventoryGrpcService>();
app.MapGet("/", () => "Use a gRPC client to call this service.");
app.Run();

ملف .proto يضاف كـ Protobuf item في project file مع GrpcServices="Server" أو "Client" أو "Both" بحسب المشروع، وتحتاج packages المتوافقة مثل Grpc.AspNetCore أو Grpc.Net.ClientFactory/Grpc.Net.Client حسب الدور. في production تأكد من HTTP/2/TLS support عبر reverse proxies/load balancers؛ بعض hosting configurations قد تتطلب HTTP/2 over TLS أو gRPC-Web للمتصفحات. لا تفترض أن أي proxy يدعم trailers/streaming دون ضبط.

gRPC errors ترجع status/trailers وليس نفس body structure الخاص بـ Problem Details. إن كنت تعرض API خارجية، قد تحتاج gateway/transcoding layer وتوثيق كيف تتحول أخطاء gRPC إلى HTTP statuses.

HTTP/2 و Message Limits

gRPC في ‎.NET يعتمد على HTTP/2 في أغلب السيناريوهات، وده يدعم multiplexing والـ streaming. لكن reverse proxy/load balancer/TLS termination يجب أن يكون مضبوطاً لدعم HTTP/2 على hop المناسب. لا تفترض أن كل browser أو proxy يسمح بـ native gRPC. gRPC-Web أو JSON transcoding حلول لبعض client environments لكنها لها قيود مختلفة.

حدد max receive/send message sizes، deadlines، concurrent streams، و connection limits. الرسائل الضخمة قد تستهلك memory، و stream طويل قد يحتفظ بموارد server. لو البيانات كبيرة جداً، object storage + metadata endpoint قد يكون أفضل من إرسال ملف ضخم كـ protobuf message واحدة.

gRPC Production Checklist

  • Set deadlines on client calls and propagate cancellation.
  • Set message size/concurrency limits.
  • Use TLS and authentication metadata securely.
  • Map application errors to meaningful gRPC status codes.
  • Version Protobuf package/schema carefully; reserve removed field numbers.
  • Reuse channels/clients appropriately.
  • Test old/new client compatibility and streaming cancellation.
  • Confirm HTTP/2/proxy support in the actual deployment path.

لو requirement مجرد CRUD public API لموبايل، REST غالباً أقل friction. gRPC يتألق في internal service communication و streaming/typed contracts، لكنه يحتاج ecosystem readiness من clients و proxies/observability.

المستوى المطلوب من gRPC

المطلوب تعرف RPC/Protobuf، تقرأ .proto، تشرح field numbers والتوافق، تفهم generated client/server، تنفذ unary call صغير، وتعرف الأنواع الأربعة للـ streaming ومتى deadlines/cancellation/status codes/authentication مهمة. افهم لماذا gRPC مناسب غالباً للـ internal service-to-service، ولماذا REST أسهل لكثير من browser/mobile public APIs.

08

مثال end-to-end: server streaming مع deadline و cancellation

A realistic streaming service
Practical
ProtobufProtos/inventory.proto
syntax = "proto3";
option csharp_namespace = "Shop.Inventory.V1";
package shop.inventory.v1;                       // version in the package: v2 can live side by side

service Inventory {
  rpc GetStock (GetStockRequest) returns (StockReply);
  rpc WatchStock (WatchStockRequest) returns (stream StockChanged);   // server streaming
}
message GetStockRequest { string sku = 1; }
message StockReply { string sku = 1; int32 available = 2; int64 version = 3; }
message WatchStockRequest { repeated string skus = 1; }
message StockChanged { string sku = 1; int32 available = 2; int64 version = 3; }
// Rules: never reuse a field number; mark removed fields with `reserved 4;` and `reserved "old_name";`
C#InventoryService.cs (server)
public sealed class InventoryService(IStockFeed feed, ILogger<InventoryService> log) : Inventory.InventoryBase
{
    public override async Task WatchStock(WatchStockRequest req, IServerStreamWriter<StockChanged> stream, ServerCallContext ctx)
    {
        if (req.Skus.Count is 0 or > 200)
            throw new RpcException(new Status(StatusCode.InvalidArgument, "1..200 skus required"));

        // ctx.CancellationToken fires when the client cancels, disconnects or the deadline passes
        await foreach (var change in feed.SubscribeAsync(req.Skus, ctx.CancellationToken))
            await stream.WriteAsync(new StockChanged { Sku = change.Sku, Available = change.Available, Version = change.Version });
    }
}
C#client: one channel, deadline on every call, cancellation honoured
builder.Services.AddGrpcClient<Inventory.InventoryClient>(o => o.Address = new Uri("https://inventory.internal"))
       .AddStandardResilienceHandler();            // retries/timeouts for unary calls (be careful with streams)

public async Task WatchAsync(Inventory.InventoryClient client, CancellationToken ct)
{
    using var call = client.WatchStock(new WatchStockRequest { Skus = { "A-1", "B-7" } },
                                       deadline: DateTime.UtcNow.AddMinutes(30), cancellationToken: ct);
    try
    {
        await foreach (var c in call.ResponseStream.ReadAllAsync(ct))
            Console.WriteLine($"{c.Sku}: {c.Available} (v{c.Version})");
    }
    catch (RpcException ex) when (ex.StatusCode == StatusCode.DeadlineExceeded) { /* reconnect with backoff */ }
    catch (RpcException ex) when (ex.StatusCode == StatusCode.Cancelled) { /* we stopped on purpose */ }
}

ليه الـ version في الرسالة؟ لو الـ stream اتقطع ورجعت تشترك، ممكن توصلك تحديثات أقدم من اللي عندك. الـ client بيتجاهل أي version أقل من آخر واحد شافه — نفس مبدأ الـ ordering في Messaging.

09

gRPC والمتصفح والـ load balancing

Browsers, JSON transcoding and load balancing
Deep dive
المشكلةالسببالحل
Angular مش قادر ينادي gRPC مباشرةالمتصفح ما بيديش تحكم كامل في HTTP/2 frames والـ trailersgRPC-Web (app.UseGrpcWeb() + client JS)، أو JSON transcoding (نفس الـ service يتعرض كـ REST/JSON بـ annotations في الـ proto)، أو API gateway REST قدام
كل الحمل على pod واحدHTTP/2 connection طويلة العمر؛ L4 load balancer بيوزع connections مش requestsL7 LB/service mesh فاهم HTTP/2، أو client-side load balancing (dns:/// + round_robin) مع headless service في Kubernetes
Retries بتكرر عملياتretry لـ method مش idempotentretry policy لـ methods idempotent بس، أو idempotency key في الـ metadata
رسالة كبيرة بتترفضحد الرسالة الافتراضي (4 MB للاستقبال)streaming لقطع صغيرة بدل رفع الحد بلا حساب
ProtobufJSON transcoding annotation: one implementation, two protocols
import "google/api/annotations.proto";
service Inventory {
  rpc GetStock (GetStockRequest) returns (StockReply) {
    option (google.api.http) = { get: "/v1/stock/{sku}" };     // REST: GET /v1/stock/A-1  -> same C# method
  }
}

القاعدة العملية: gRPC بين الخدمات الداخلية (عقد صارم، أداء، streaming)، و REST/JSON على الحافة للمتصفحات والشركاء. والـ AI: خدمات inference كتير (مثلًا Triton وبعض vector DBs) بتعرض gRPC — فاهم الـ deadlines والـ streaming هنا بيفيدك هناك.

10

أخطاء شائعة في gRPC

Common mistakes
Basics
  • مفيش deadline ← call معلق بيحجز موارد للأبد عند الطرفين.
  • new GrpcChannel لكل call ← connections و handshakes كتير؛ استخدم client factory/channel مشترك.
  • إعادة استخدام field number بعد حذفه ← clients قديمة بتقرأ بيانات غلط بصمت.
  • رمي Exception عادي ← الـ client بيشوف Unknown؛ ارمي RpcException بـ status مناسب.
  • تجاهل ctx.CancellationToken في streaming ← الـ server بيفضل يكتب لـ client مشي.
11

Knowledge Check

gRPC protocol reasoning
Basics
لماذا field numbers في protobuf مهمة؟
هي identifiers في wire format؛ تغييرها أو إعادة استخدامها قد يجعل clients قديمة تقرأ data بمعنى خاطئ.
هل deadline في client يلغي العمل على server تلقائياً؟
ليس بصورة سحرية؛ server يجب أن يراقب cancellation token الناتج عن deadline ويربطه بكل downstream work.
متى تفضل REST؟
Public/browser/mobile APIs أو عندما تحتاج تبادل سهل عبر HTTP/JSON وأدوات عامة ودعم بسيط من العملاء.
↗

المراجع والقراءة الإضافية

References & further reading

الدرس بيشرح الفكرة نفسها؛ الروابط دي للتحقق والتعمق والرجوع لتفاصيل الـ API. (محتاجة إنترنت.)

خريطة التغطية: 14 عنصر من الـ Roadmap ومكان شرحه في الدرس
RoadmapRPC Concepts§01
RoadmapProtocol Buffers§01
Roadmap.proto Files§01
RoadmapService Definitions§01
RoadmapGenerated Clients§01
RoadmapUnary Calls§03
RoadmapStreaming Concepts§04
RoadmapDeadlines and Cancellation§04
RoadmapError Handling§03
RoadmapAuthentication§03
RoadmapgRPC vs REST§03
RoadmapInternal Service Communication§03
SuggestedgRPC JSON transcoding awareness§05
SuggestedProtobuf backward-compatible versioning§05

خلصت الدرس وحليت الأسئلة؟ علّم عليه عشان يتحسب في تقدّمك.

محتويات الدرس