The OfficeFloor Spring Boot tutorial series covers the YAML endpoint model and its integration with the wider Spring ecosystem. Each tutorial is a complete, runnable Spring Boot project.
The full series with narrated explanations is on the website: https://officefloor.net/tutorials/index.html. Each entry below links to its runnable source on GitHub.
- Getting Started — from zero to a running REST endpoint: one dependency, one YAML file. See also Getting Started.
- Spring REST HTTP Server — the YAML endpoint model in depth: naming conventions, multi-method service classes, multiple path variables, custom response headers.
- Spring Boot 3 REST — choosing the correct version-specific starter for your Spring Boot generation.
- Spring REST to OfficeFloor Conversion Reference — the mechanical substitutions to convert a Spring MVC
@RestControllerinto YAML composition.
Composing an endpoint from small, single-purpose functions wired together in YAML — the function is the unit of composition, the YAML is the specification.
- Function — multi-function endpoints with
next:andoutputs:(Continuation Injection). - Variable — passing state downstream between functions via
Out<T>/@Val, without coupling caller to callee. - Governance — wrapping function execution with cross-cutting concerns via
govern:. - Exception — handling exceptions (escalations) via
escalations:and global handlers. - REST CRUD Orchestration — a full CRUD resource built from
Load/Buildproducers,Apply/Saveactions andRespondWithresponders for GET, POST, PUT and DELETE. - Filtering and Pagination — collection endpoints with an optional query-parameter filter combined with pagination.
- Related Entities — two related entities showing a shared
Loadreused across endpoints and an ownership-scoped load that finds a child within its parent. - Resolving References — a
Resolvefunction that enriches an entity by looking up managed references, shared across create and update. - Problem Detail Errors — structured RFC 7807 error responses via office-level escalation handlers (domain 404, validation 400 with field errors, catch-all 500).
- Testing Functions — unit testing individual functions with the shipped
MockVarandMockObjectResponse, and one integration test for the wiring. - Orchestration Patterns and Naming — the function naming conventions and the DTO to entity to DTO data-flow, plus the one-shot request body,
@Validordering and variable reference-semantics rules.
Capabilities OfficeFloor provides over and above Spring MVC, through its function and thread injection.
- Managed Object — OfficeFloor Managed Objects, the native unit of state.
- Supplier — supplying a library of related managed objects from a single declaration.
- Team — Thread Injection: assigning threads/pools to functions.
- Data JPA — Spring Data JPA with YAML composition and transaction governance.
- Security — securing endpoints with Spring Security.
- Validation — Bean Validation with YAML composition.
- Qualifier —
@Qualifierinjection into service methods. - Actuator — Spring Boot Actuator production endpoints.
- OpenAPI — YAML endpoints appearing in generated OpenAPI documentation.
- CORS — configuring Cross-Origin Resource Sharing.
- Servlet — direct injection of
jakarta.servlet.http.HttpServletRequest. - Thymeleaf — server-side HTML rendering from service methods.
- Kotlin — endpoint logic in Kotlin.
- Scala — endpoint logic in Scala.
- JavaScript — JavaScript via GraalVM.
- Cats Effect — using Cats Effect within a handler.
- ZIO — using ZIO within a handler.