NestJS Enterprise Backend APIs · Lezione

Fondamenti di GraphQL

Comprenda i concetti fondamentali di GraphQL, incluse query, mutation, subscription e il linguaggio di definizione degli schemi (SDL).

Lezione 1 di 312 passaggi

Fondamenti di GraphQL è una lezione NestJS Enterprise Backend APIs gratuita su CoddyKit. Questa è la lezione 1 di 3. 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 NestJS Enterprise Backend APIs, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso NestJS Enterprise Backend APIs include 3 lezioni in totale.

Parti di questa lezione non sono ancora state tradotte e vengono mostrate in inglese.

What is GraphQL?

Welcome to GraphQL! It's a powerful query language for APIs and a runtime for fulfilling those queries with your existing data.

Think of it as asking for exactly what you need, nothing more, nothing less. This helps make your APIs efficient and flexible.

GraphQL vs. REST APIs

Traditionally, REST APIs often require multiple requests to fetch all necessary data, leading to "over-fetching" or "under-fetching".

  • Over-fetching: Getting more data than you need.
  • Under-fetching: Needing multiple requests to get all data.

GraphQL solves this by letting clients define the exact data structure they want in a single request.

The Core: GraphQL Schema

At the heart of every GraphQL API is its schema. This schema acts as a contract between the client and the server.

It defines all the data types and operations (queries, mutations, subscriptions) that clients can perform. It's like a blueprint for your API.

Defining Schemas with SDL

GraphQL schemas are written using the Schema Definition Language (SDL). It's a simple, human-readable syntax.

SDL allows you to specify your API's capabilities and data structures clearly. It's language-agnostic, meaning it works with any backend language.

schema {
  query: Query
}

type Query {
  hello: String
}

Building Blocks: Object Types

The most fundamental component of a GraphQL schema is the Object Type. It represents a type of object you can fetch from your service.

Each object type has fields, which are specific pieces of data it can hold. Fields can also be other object types!

type User {
  id: ID!
  name: String!
  email: String
  posts: [Post!]
}

type Post {
  id: ID!
  title: String!
  content: String
}

Data Types: Scalars & Lists

Scalar types are the basic building blocks that resolve to a single value, like String, Int, Float, Boolean, and ID (a unique identifier).

List types allow a field to return a list of a certain type, indicated by []. The ! means a field is Non-Null, so it must always return a value.

type Product {
  id: ID!         # Non-null ID
  name: String!   # Non-null String
  price: Float!   # Non-null Float
  tags: [String!] # List of non-null Strings
  inStock: Boolean
}

Fetching Data with Queries

Queries are how clients request data from a GraphQL server. You specify the exact fields you want to receive.

This ensures you only get the data you ask for, avoiding over-fetching common in REST APIs.

query GetProductNames {
  products {
    id
    name
  }
}

Dynamic Queries with Arguments

Fields in GraphQL can take arguments, allowing you to pass parameters to customize the data fetched. This is useful for filtering or finding specific items.

Arguments are defined in the schema and used by the client when making a query.

query GetProductById {
  product(id: "prod123") {
    id
    name
    price
  }
}

Modifying Data with Mutations

While queries are for reading data, mutations are for writing, updating, or deleting data on the server.

Like queries, mutations also specify what data to return after the operation, ensuring immediate feedback on changes.

mutation CreateNewProduct {
  createProduct(name: "New Gadget", price: 99.99) {
    id
    name
  }
}

Real-time Updates: Subscriptions

Subscriptions are a special type of operation that allows clients to receive real-time updates from the server when specific events occur.

This is perfect for features like live chat, notifications, or real-time dashboards. It typically uses WebSockets.

Schema Fundamentals Check

Consider the following GraphQL SDL snippet for an Author type:

type Author {
  id: ID!
  name: String!
  books: [Book!]
}

Which of the following statements are true about the books field?

GraphQL Fundamentals Recap

Great job! You've learned the core concepts of GraphQL:

  • It's a query language for APIs, offering precise data fetching.
  • The schema defines the API's capabilities using SDL.
  • You use queries to read, mutations to write, and subscriptions for real-time data.

Next, we'll see how to integrate GraphQL into a NestJS application!

Gratis per iniziare

Impara TypeScript con un tutor IA — gratis

Scrivi ed esegui vero codice nel tuo browser, ricevi aiuto istantaneo da un tutor IA disponibile 24/7, e riprendi da dove hai lasciato sul web o nell'app.

Corsi
20
Lezioni
76

Domande Frequenti

La lezione «Fondamenti di GraphQL» è gratuita?

Sì — il testo completo di «Fondamenti di GraphQL» è 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 NestJS Enterprise Backend APIs, passa a CoddyKit PRO. Il corso NestJS Enterprise Backend APIs include 3 lezioni in totale.

Cosa imparerò in «Fondamenti di GraphQL»?

Comprenda i concetti fondamentali di GraphQL, incluse query, mutation, subscription e il linguaggio di definizione degli schemi (SDL). Eserciti NestJS Enterprise Backend APIs 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 NestJS Enterprise Backend APIs?

Non è richiesta alcuna esperienza precedente. NestJS Enterprise Backend APIs su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 1 di 3.

Quanto tempo richiede la lezione «Fondamenti di GraphQL»?

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 NestJS Enterprise Backend APIs?

Sì. Ogni lezione NestJS Enterprise Backend APIs 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

  1. Fondamenti di GraphQL
  2. Configurazione di NestJS con GraphQL
  3. Resolver e subscription
← Torna a NestJS Enterprise Backend APIs