Modularización de esquemas con extensiones de tipos
Mantenga sus esquemas GraphQL grandes y fáciles de mantener dividiéndolos en varios archivos SDL y ampliando los tipos raíz compartidos con la palabra clave extend en Spring Boot.
Modularización de esquemas con extensiones de tipos es una lección gratuita de GraphQL APIs with Spring Boot en CoddyKit. Esta es la lección 4 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de GraphQL APIs with Spring Boot, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de GraphQL APIs with Spring Boot incluye 4 lecciones en total.
Partes de esta lección aún no han sido traducidas y se muestran en inglés.
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.
Aprende GraphQL APIs with Spring Boot con un tutor de IA — gratis
Escribe y ejecuta código real en tu navegador, obtén ayuda instantánea de un tutor de IA disponible 24/7 y continúa donde lo dejaste en la web o en la aplicación.
- Cursos
- 12
- Lecciones
- 48
Preguntas frecuentes
¿La lección «Modularización de esquemas con extensiones de tipos» es gratis?
Sí — el texto completo de «Modularización de esquemas con extensiones de tipos» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de GraphQL APIs with Spring Boot, actualiza a CoddyKit PRO. El curso de GraphQL APIs with Spring Boot incluye 4 lecciones en total.
¿Qué aprenderé en «Modularización de esquemas con extensiones de tipos»?
Mantenga sus esquemas GraphQL grandes y fáciles de mantener dividiéndolos en varios archivos SDL y ampliando los tipos raíz compartidos con la palabra clave extend en Spring Boot. Practicas GraphQL APIs with Spring Boot con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.
¿Necesito experiencia previa para empezar GraphQL APIs with Spring Boot?
No se requiere experiencia previa. GraphQL APIs with Spring Boot en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 4 de 4.
¿Cuánto tiempo toma la lección «Modularización de esquemas con extensiones de tipos»?
La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.
¿Puedo escribir y ejecutar código en esta lección de GraphQL APIs with Spring Boot?
Sí. Cada lección de GraphQL APIs with Spring Boot incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.
Todas las lecciones de este curso
- Creación de directivas personalizadas
- Fundamentos del schema stitching
- Combinación de varios esquemas de GraphQL
- Modularización de esquemas con extensiones de tipos