The quarkus-for-spring-developers/examples repository provides practical code examples accompanying the Quarkus for Spring Developers eBook. The repository is organized by chapter, with each project structured as a self-contained unit without parent-child dependencies. The examples span six chapters covering introductory concepts through cloud-native deployment, with Chapter 1 containing no code examples while Chapters 2 through 6 each include corresponding implementations.
The repository serves a specific educational purpose: enabling readers to replicate the code examples shown in the eBook. To support this goal, the maintainers keep the example code synchronized with the book's content, ensuring that readers can follow along successfully. However, the repository also acknowledges that frameworks evolve, and the code may demonstrate different or improved approaches than what appears in the original book text. When new editions of the eBook are published, the examples are updated to reflect new patterns and best practices.
A significant aspect of this repository is the version management strategy. The book's chapter text uses Quarkus 2.1.4.Final and Spring Boot 2.5.4, representing the versions current at the time of writing. However, the examples repository itself runs substantially newer versions: Quarkus 2.16.12.Final and Spring Boot 2.7.16. This gap reflects the maintainers' commitment to keeping dependencies current while preserving the book's original code examples. The repository includes detailed documentation of new framework features that could affect the examples but have not yet been incorporated, such as RESTEasy Reactive's automatic blocking detection, Panache Reactive's TestReactiveTransaction annotation, and the deprecation of NativeImageTest in favor of QuarkusIntegrationTest.
The repository covers essential topics for Spring developers transitioning to Quarkus. The examples demonstrate Quarkus capabilities in areas including dependency injection, configuration management, testing strategies, microservices patterns, and Kubernetes-native development.
The repository's maintenance history reveals practical challenges in maintaining example code. This change reflects real-world testing concerns that developers encounter when working with containerized services.
The repository explicitly notes that Spring Boot 3, Spring 6, and Spring Cloud 2022.0 have been released but are not yet reflected in the examples due to their requirement for Java 17 and the significant impact they would have on the code examples. This decision prioritizes maintaining alignment with the current eBook edition while acknowledging the existence of newer framework versions.
Classified within the Quarkus and Spring migration domain, this repository serves Java developers seeking to understand how Spring concepts map to Quarkus implementations. The examples address REST APIs, dependency injection, configuration patterns, testing approaches, and cloud-native considerations, making it a practical resource for developers evaluating or adopting Quarkus as an alternative to Spring Boot for their applications.
