Определение пользовательских типов данных
Создавайте пользовательские объектные и скалярные типы, а также перечисления в схеме GraphQL для представления данных приложения.
«Определение пользовательских типов данных» — бесплатный урок GraphQL APIs with Spring Boot на CoddyKit. Это урок 1 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения GraphQL APIs with Spring Boot, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс GraphQL APIs with Spring Boot содержит 4 уроков всего.
Части этого урока еще не переведены и отображаются на английском.
Custom Types: Your Data's Blueprint
In GraphQL, data types are like blueprints for your application's information. They define the shape and kind of data that can be queried or modified.
While GraphQL provides some basic types, you'll often need to define your own to perfectly match your application's unique data structure.
GraphQL's Building Blocks
GraphQL has built-in scalar types like String, Int, Boolean, Float, and ID. These are fundamental, single-value types.
But real-world data is complex! This is where Object Types come in. They let you define objects with multiple fields, each having its own type.
Crafting Object Types
You define an object type using the type keyword in GraphQL's Schema Definition Language (SDL). Think of it as creating a custom class or struct.
Each field within an object type has a name and a type. Fields can be other object types, scalar types, or even lists of types.
Example: A 'Book' Object
Let's imagine we're building an API for a library. We'd need a way to represent a book. Here's how you might define a Book object type:
type Book {
id: ID!
title: String!
author: String
publicationYear: Int
}The ! after a type means the field is non-nullable – it must always have a value.
Beyond Basic Scalars
Sometimes, built-in scalars aren't specific enough. For example, a Date field could be a String, but what if you need to ensure a specific format?
Custom Scalar Types allow you to define your own scalar types with specific serialization, parsing, and validation rules. This ensures data consistency.
Declaring Custom Scalars
Defining a custom scalar in your schema is straightforward. You use the scalar keyword, followed by the name of your new scalar type.
Later, your Spring Boot application will need to provide the actual logic for handling this custom scalar's data transformations.
scalar Date
type Event {
id: ID!
name: String!
eventDate: Date!
}Enums for Fixed Values
Enum Types (short for 'enumeration') are special scalar types that represent a finite set of possible values. They're great for fields where you want to restrict choices to a predefined list.
Using enums makes your schema more self-documenting and helps prevent invalid data from being sent to your API.
Defining an Enum Type
For our library API, a book might have a specific status. We can define an enum for this:
enum BookStatus {
AVAILABLE
CHECKED_OUT
LOST
REPAIR
}Now, any field using BookStatus can only have one of these four values.
Combining Your Custom Types
Let's update our Book type to use our new BookStatus enum and a custom Date scalar.
scalar Date
enum BookStatus {
AVAILABLE
CHECKED_OUT
LOST
}
type Book {
id: ID!
title: String!
author: String
publicationYear: Int
status: BookStatus!
lastCheckedOut: Date
}This shows how custom types build a richer, more precise schema.
Check Your Understanding
Which of the following statements about GraphQL custom data types are TRUE?
Recap: Your Data's Foundation
You've learned how to define custom data types in GraphQL using SDL!
- Object Types (
type) structure complex data. - Custom Scalar Types (
scalar) handle specific data formats. - Enum Types (
enum) restrict field values to a finite set.
These tools are crucial for building a precise and robust GraphQL schema that accurately represents your application's domain.
Часто задаваемые вопросы
Урок «Определение пользовательских типов данных» бесплатный?
Да — полный текст урока «Определение пользовательских типов данных» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс GraphQL APIs with Spring Boot, подпишись на CoddyKit PRO. Курс GraphQL APIs with Spring Boot содержит 4 уроков всего.
Чему я научусь в уроке «Определение пользовательских типов данных»?
Создавайте пользовательские объектные и скалярные типы, а также перечисления в схеме GraphQL для представления данных приложения. Ты практикуешь GraphQL APIs with Spring Boot с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.
Нужен ли мне опыт, чтобы начать GraphQL APIs with Spring Boot?
Предыдущий опыт не требуется. GraphQL APIs with Spring Boot на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 1 из 4.
Сколько времени занимает урок «Определение пользовательских типов данных»?
Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.
Можно ли писать и запускать код в этом уроке GraphQL APIs with Spring Boot?
Да. Каждый урок GraphQL APIs with Spring Boot включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.
Все уроки этого курса
- Определение пользовательских типов данных
- Реализация резолверов данных
- Выполнение простых запросов GraphQL
- Мутации GraphQL: изменение данных