Schema-Modularisierung mit Type Extensions
Halten Sie große GraphQL-Schemas wartbar, indem Sie sie auf mehrere SDL-Dateien aufteilen und gemeinsame Root-Typen mit dem Schlüsselwort extend in Spring Boot erweitern.
Schema-Modularisierung mit Type Extensions ist eine kostenlose GraphQL APIs with Spring Boot-Lektion auf CoddyKit. Dies ist Lektion 4 von 4. Du kannst die komplette Lektion unten kostenlos lesen – dann übst du sie direkt im Browser mit einem integrierten Code-Editor und einem KI-Tutor rund um die Uhr. Sie ist Teil des GraphQL APIs with Spring Boot-Lernpfads, und dein Fortschritt wird über Web und CoddyKit-App synchronisiert. Der GraphQL APIs with Spring Boot-Kurs umfasst insgesamt 4 Lektionen.
Teile dieser Lektion wurden noch nicht übersetzt und werden auf Englisch angezeigt.
The Monolithic Schema Problem
As an API grows, a single schema.graphqls file becomes thousands of lines, hard to navigate and prone to merge conflicts.
Modularization splits the schema by feature so each team owns a focused slice.
Modularization vs Stitching
This is different from schema stitching. Stitching merges schemas from separate services. Modularization splits one service's schema into many files that load into the same runtime.
Multiple SDL Files in Spring
Spring for GraphQL automatically loads every .graphqls file under src/main/resources/graphql/ and merges them into one schema.
graphql/
book.graphqls
author.graphqls
review.graphqlsThe Single Root Problem
GraphQL allows only one Query type. If two files both declare type Query, the schema fails to build with a duplicate-type error.
Extending the Root Type
Declare type Query once, then use extend type Query in other files to add fields. The pieces merge into one root.
# book.graphqls
type Query { books: [Book!]! }
# author.graphqls
extend type Query { authors: [Author!]! }Extending Object Types
extend works on any object type, not just roots. A reviews module can add a field to Book without editing the book file.
# review.graphqls
extend type Book {
reviews: [Review!]!
}Resolvers Stay Modular Too
Each module gets its own controller. The extended field on Book is resolved by a @SchemaMapping in the review module's controller.
@Controller
public class ReviewController {
@SchemaMapping(typeName = "Book")
public List<Review> reviews(Book book) {
return reviewService.forBook(book.getId());
}
}Sharing Common Types
Cross-cutting types like PageInfo or shared enums live in a common.graphqls file. Every module references them without redefining.
# common.graphqls
type PageInfo {
hasNextPage: Boolean!
endCursor: String
}Organizing by Feature
Group SDL files and controllers by feature, not by GraphQL kind. Keep book.graphqls next to BookController mentally, so a feature change touches one cohesive area.
Validation at Startup
Spring assembles and validates the merged schema at startup. If an extend references a type that does not exist, the application fails fast with a clear error, catching mistakes early.
Best Practices
Keep modular schemas healthy:
- Declare each root type once, extend elsewhere
- One SDL file and controller per feature
- Centralize shared types in a common file
- Let startup validation guard your merges
Quick Check
Test your schema modularization knowledge.
Recap
You modularized a large schema:
- Split SDL into multiple feature files Spring auto-merges
- Declare root types once, add fields with
extend - Extend any object type from another module
- Centralize shared types and keep resolvers modular
Modular schemas scale cleanly across teams and features.
Häufig gestellte Fragen
Ist die Lektion „Schema-Modularisierung mit Type Extensions“ kostenlos?
Ja — der vollständige Text von „Schema-Modularisierung mit Type Extensions“ ist hier im Web kostenlos zu lesen. Um sie interaktiv zu üben (integrierter Code-Editor und 24/7 KI-Tutor) und den Rest des GraphQL APIs with Spring Boot-Kurses freizuschalten, upgrade auf CoddyKit PRO. Der GraphQL APIs with Spring Boot-Kurs umfasst insgesamt 4 Lektionen.
Was lerne ich in „Schema-Modularisierung mit Type Extensions“?
Halten Sie große GraphQL-Schemas wartbar, indem Sie sie auf mehrere SDL-Dateien aufteilen und gemeinsame Root-Typen mit dem Schlüsselwort extend in Spring Boot erweitern. Du übst GraphQL APIs with Spring Boot mit praktischem Code, den du direkt im Browser ausführst, und ein 24/7 KI-Tutor beantwortet deine Fragen während du die Lektion bearbeitest.
Brauche ich Erfahrung, um GraphQL APIs with Spring Boot zu starten?
Keine Vorkenntnisse erforderlich. GraphQL APIs with Spring Boot auf CoddyKit ist für Anfänger bis fortgeschrittene Lernende strukturiert, sodass du hier starten oder von Anfang an beginnen und in deinem eigenen Tempo voranschreiten kannst. Dies ist Lektion 4 von 4.
Wie lange dauert die Lektion „Schema-Modularisierung mit Type Extensions“?
Die meisten CoddyKit-Lektionen dauern etwa 5–10 Minuten. Jede ist kompakt und interaktiv, sodass du stetig Fortschritte machst und genau dort weitermachst, wo du aufgehört hast – im Web und in der App.
Kann ich in dieser GraphQL APIs with Spring Boot-Lektion Code schreiben und ausführen?
Ja. Jede GraphQL APIs with Spring Boot-Lektion enthält einen integrierten Code-Editor, sodass du echten Code direkt in deinem Browser schreibst und ausführst und sofort KI-Feedback erhältst — ohne lokale Einrichtung erforderlich.
Alle Lektionen in diesem Kurs
- Benutzerdefinierte Directives erstellen
- Grundlagen des Schema Stitching
- Mehrere GraphQL-Schemas zusammenführen
- Schema-Modularisierung mit Type Extensions