GraphQL APIs with Spring Boot · 강의

중첩 객체 및 관계 모델링

계층형 데이터를 표현하고 서로 다른 타입 간의 관계를 정의하는 스키마를 설계합니다.

중첩 객체 및 관계 모델링은(는) CoddyKit의 무료 GraphQL APIs with Spring Boot 강의입니다. 이것은 4개 중 1번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 GraphQL APIs with Spring Boot 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. GraphQL APIs with Spring Boot 강의에는 총 4개의 강의가 포함되어 있습니다.

이 강의의 일부는 아직 번역되지 않았으며 영어로 표시됩니다.

Why Nested Data Matters

Real-world data is rarely flat. It has connections and hierarchies, like an author having multiple books, or a product having many reviews. GraphQL excels at modeling these complex relationships naturally.

This lesson explores how to design your schema to represent data with nested objects and various relationships, making your API more intuitive and powerful.

Understanding Nested Types

A nested object means one type contains another type as a field. For example, an Author might have a list of Book objects they've written.

This allows clients to fetch related data (like all books by an author) in a single GraphQL request, reducing over-fetching and under-fetching.

Defining Nested Types in SDL

In GraphQL's Schema Definition Language (SDL), you define nested types directly. Here, an Author type includes a list of Book objects.

Notice the [Book!]! syntax, meaning a non-null list of non-null books.

type Book {
  id: ID!
  title: String!
  publicationYear: Int
}

type Author {
  id: ID!
  name: String!
  books: [Book!]! # List of books by this author
}

type Query {
  author(id: ID!): Author
}

Java Models for Nested Data

In Spring Boot, your Java data models (POJOs or records) should mirror your GraphQL schema. This makes mapping data between your backend and the GraphQL API straightforward.

You'll typically have separate classes for each GraphQL type, with fields matching the schema.

// src/main/java/com/example/model/Author.java
class Author {
  private String id;
  private String name;
  private List<Book> books;

  // Constructor, getters, setters...
}

// src/main/java/com/example/model/Book.java
class Book {
  private String id;
  private String title;
  private Integer publicationYear;

  // Constructor, getters, setters...
}

How Nested Fields are Resolved

When a client requests an Author and its books, Spring Boot GraphQL will first resolve the Author object. Then, it will look for a way to resolve the books field on that Author.

Often, if your Java object has a matching getter (e.g., getBooks()), Spring Boot GraphQL can automatically fetch the nested list.

Querying Nested Data

Clients can fetch all nested data with a single, clear query. This is a major advantage of GraphQL compared to traditional REST APIs, where you might need multiple requests or complex join logic on the client.

Notice how books and its fields are queried directly within the author field.

query GetAuthorWithBooks {
  author(id: "author-1") {
    id
    name
    books {
      id
      title
      publicationYear
    }
  }
}

Simulating Nested Data Resolution

This simplified Java code demonstrates how a data fetcher might prepare an Author object that already contains its associated Book objects. This structure is then ready for GraphQL to expose.

Run it to see how the nested data is represented.

import java.util.Arrays;
import java.util.List;

// Simplified Book class
class Book {
  String id;
  String title;
  Integer publicationYear;

  public Book(String id, String title, Integer publicationYear) {
    this.id = id;
    this.title = title;
    this.publicationYear = publicationYear;
  }

  // Getters for GraphQL to access fields
  public String getId() { return id; }
  public String getTitle() { return title; }
  public Integer getPublicationYear() { return publicationYear; }
}

// Simplified Author class
class Author {
  String id;
  String name;
  List<Book> books;

  public Author(String id, String name, List<Book> books) {
    this.id = id;
    this.name = name;
    this.books = books;
  }

  // Getters for GraphQL to access fields
  public String getId() { return id; }
  public String getName() { return name; }
  public List<Book> getBooks() { return books; }
}

public class Main {
  public static void main(String[] args) {
    // Create some books
    Book book1 = new Book("b1", "The Martian", 2011);
    Book book2 = new Book("b2", "Project Hail Mary", 2021);
    List<Book> authorsBooks = Arrays.asList(book1, book2);

    // Create an author with their books
    Author author = new Author("a1", "Andy Weir", authorsBooks);

    // Demonstrate accessing the nested data
    System.out.println("Author: " + author.getName());
    System.out.println("Books written:");
    for (Book book : author.getBooks()) {
      System.out.println("  - " + book.getTitle() + " (" + book.getPublicationYear() + ")");
    }
  }
}

Understanding Relationships: One-to-Many

The Author to Book example we've used is a classic "one-to-many" relationship: one author can write many books.

GraphQL schema naturally supports this by defining a field as a list of another type (e.g., books: [Book!]!), making it easy to fetch all related items.

Referencing Related Objects

Sometimes, data isn't directly embedded or available in a single object. For instance, a Book might only store an authorId internally, not the full Author object.

You can still model this in GraphQL by making Author a field on Book. Spring Boot GraphQL will then resolve the Author field by fetching the complete Author object based on the authorId.

type Book {
  id: ID!
  title: String!
  author: Author! # Reference to the Author type
}

type Author {
  id: ID!
  name: String!
}

Check Your Understanding

Consider a GraphQL schema for an e-commerce application. A Product can have many Reviews, and each Review is written by a specific User.

Recap: Modeling Relationships

In this lesson, you learned how to model nested objects and relationships in your GraphQL schema. We covered:

Defining fields that are lists of other types (e.g., books: [Book!]!) to represent one-to-many relationships.
Mirroring these hierarchical structures in your Spring Boot data models.
Understanding how GraphQL automatically resolves these nested fields, often via Java getters.
Querying complex, hierarchical data efficiently with a single GraphQL request.

Mastering nested objects and relationships is key to building powerful and intuitive GraphQL APIs that truly reflect your application's data structure.

자주 묻는 질문

“중첩 객체 및 관계 모델링” 강의는 무료인가요?

네 — “중첩 객체 및 관계 모델링” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 GraphQL APIs with Spring Boot 강의 전체를 잠금 해제할 수 있습니다. GraphQL APIs with Spring Boot 강의에는 총 4개의 강의가 포함되어 있습니다.

“중첩 객체 및 관계 모델링”에서 뭘 배우나요?

계층형 데이터를 표현하고 서로 다른 타입 간의 관계를 정의하는 스키마를 설계합니다. 브라우저에서 직접 실행하는 실습 코드로 GraphQL APIs with Spring Boot을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

GraphQL APIs with Spring Boot을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 GraphQL APIs with Spring Boot은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 1번째 강의입니다.

“중첩 객체 및 관계 모델링” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 GraphQL APIs with Spring Boot 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 GraphQL APIs with Spring Boot 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← GraphQL APIs with Spring Boot(으)로 돌아가기