Directiva @oneOf (Input Unions): validarea exclusivă a exact unui singur câmp de intrare în GraphQL

Specificația oficială GraphQL a introdus directiva `@oneOf` pentru a rezolva problema istorică a ‘Input Unions’. Aplicată pe un tip de intrare (`input`), `@oneOf` forțează clientul să furnizeze exact o singură proprietate dintre cele declarate, garantând că nu pot fi transmise simultan două argumente mutual exclusive (ex: logare prin email SAU telefon).

Uniuni de Intrare cu Validare Exclusivă la Nivel de Schemă

Elimină scrierea manuală a codului de validare ‘if (a && b) throw error’ în funcțiile de rezolvare.

# Tip de intrare cu directiva @oneOf:
input FindUserInput @oneOf {
  id: ID
  email: String
  username: String
}

# Cerere validă (conține EXACT un singur câmp):
query Find {
  user(by: { email: "contact@dexblog.ro" }) {
    id
    name
  }
}

Utilizarea corectă a acestei funcționalități în arhitectura GraphQL garantează o comunicare optimă între client și server, elimină supra-încărcarea rețelei și asigură scalabilitatea sistemelor moderne.