Jak komponenty komunikują się w systemie (APIs)?

Question

Accepted Answer

W systemie komponenty (usługi, klienty) komunikują się za pośrednictwem **API** i różnych protokołów — synchronicznych (REST, gRPC) i asynchronicznych (messaging/kolejki). Zrozumienie, jak komponenty się komunikują, jest fundamentalne dla projektowania systemów złożonych z wielu części.

## Komunikacja synchroniczna (request/response)

```text
The caller WAITS for a response (blocking):
  REST (HTTP) → most common; resources over HTTP (JSON) → simple, ubiquitous, web-friendly
  gRPC → high-performance RPC (binary, HTTP/2) → fast, typed; good for internal services
  GraphQL → flexible queries (client requests exactly what it needs)
→ for: direct request/response where the caller needs an answer now
```

## Komunikacja asynchroniczna (messaging)

```text
The caller does NOT wait (decoupled, non-blocking):
  MESSAGE QUEUES (RabbitMQ, SQS) → send a message; a consumer processes it later
  EVENT STREAMING (Kafka) → publish events; consumers react
  PUB/SUB → broadcast events to subscribers
→ for: decoupling, background work, handling spikes, event-driven systems
  ✓ resilience (queue buffers), scalability, decoupling  ✗ more complexity, eventual consistency
```

## Wybór i uwarunkowania

```text
SYNC → when the caller needs an immediate response; simpler request/response
ASYNC → when decoupling, resilience, or background processing matters (don't block)
→ Also: API design (clear contracts), versioning, error handling, timeouts/retries,
  authentication, rate limiting → robust communication between components
```

## Dlaczego to ważne

Zrozumienie, jak komponenty komunikują się za pośrednictwem API, jest fundamentalne, ponieważ **systemy zbudowane są z wielu części, które muszą się komunikować**, dlatego zrozumienie komunikacji jest niezbędne do ich projektowania.

Systemy składają się z usług i klientów, które wchodzą w interakcje, a sposób ich komunikacji jest fundamentalnym aspektem projektowania systemu.

Zrozumienie **komunikacji synchronicznej** (request/response, gdzie wywołujący czeka) — **REST** (wszechobecne podejście HTTP/JSON), **gRPC** (wydajny RPC dla usług wewnętrznych) i GraphQL (elastyczne zapytania) — obejmuje powszechne sposoby bezpośrednich wywołań między komponentami z oczekiwaniem na odpowiedź.

Zrozumienie **komunikacji asynchronicznej** (zdecentralizowanej, nieblokującej) — **kolejki komunikatów** (wysyłanie wiadomości do późniejszego przetworzenia), **event streaming** (Kafka) i pub/sub — jest równie ważne, ponieważ umożliwia **decentralizację, odporność (kolejki buforują obciążenie), skalowalność i systemy oparte na zdarzeniach**, kosztem większej złożoności i ostatecznej spójności.

Zrozumienie **rozróżnienia między synchroniczną a asynchroniczną komunikacją i kiedy stosować każdą z nich** — synchroniczną, gdy wywołujący potrzebuje natychmiastowej odpowiedzi, asynchroniczną, gdy ma znaczenie decentralizacja, odporność lub przetwarzanie w tle — jest kluczowym zagadnieniem projektowym, które znacząco wpływa na charakterystykę systemu.

Zrozumienie dodatkowych uwarunkowań (jasne kontrakty API, wersjonowanie, obsługa błędów, timeouty/ponowne próby, uwierzytelnianie, ograniczanie tempa) odzwierciedla projektowanie solidnej komunikacji.

Ponieważ systemy składają się z części komunikujących się ze sobą i sposób ich komunikacji (synchroniczny vs asynchroniczny, protokoły i uwarunkowania projektowe) fundamentalnie kształtuje system, a ponieważ zrozumienie komunikacji między komponentami jest niezbędne do projektowania systemów wielokomponentowych, zrozumienie, jak komponenty komunikują się za pośrednictwem API, jest niezbędną, fundamentalną wiedzą z zakresu projektowania systemów — fundamentalne dla projektowania systemów złożonych z wielu oddziałujących na siebie części, obejmujące synchroniczną i asynchroniczną komunikację łączącą komponenty, i centralne dla architektury rozproszonych, opartych na usługach systemów powszechnych dzisiaj.