How spring-projects-experimental/spring-boot-migrator works
Spring Boot Migrator (SBM) scans Java/Maven projects, evaluates migration recipes, and applies selected automated changes or provides migration guidance. The principal CLI workflow is scan, inspect applicable recipes, then apply a selected recipe; a separate Spring Boot 3 upgrade web UI lets users select recipes and view an upgrade report. The graph also preserves the documented JEE-to-Boot and Boot-upgrade recipe families. Internal links without sampled call sites are dashed; unsampled recipe capabilities are represented at their listed directories.
Main entry points: recipe Recipe engine · commands Command engine · ProjectContext.java Project context · ReportController.java Report controller
Components 19
User interfaces
- CLI shell
applications/spring-shell/src/main/java/org/springframework/sbm/SpringShellApplication.java - CLI commands
applications/spring-shell/src/main/java/org/springframework/sbm/shell - Upgrade web UI
applications/spring-boot-upgrade/src/main/resources/static/js
Migration engine
- Command engine
components/sbm-core/src/main/java/org/springframework/sbm/engine/commands - Project context
components/sbm-core/src/main/java/org/springframework/sbm/engine/context/ProjectContext.java - Project parsing
components/sbm-core/src/main/java/org/springframework/sbm/project/parser - Project resources
components/sbm-core/src/main/java/org/springframework/sbm/project/resource - Precondition checks
components/sbm-core/src/main/java/org/springframework/sbm/engine/precondition - Recipe engine
components/sbm-core/src/main/java/org/springframework/sbm/engine/recipe - Java source API
components/sbm-core/src/main/java/org/springframework/sbm/java/api - OpenRewrite
components/sbm-core/src/main/java/org/springframework/sbm/openrewrite
Recipe capabilities
- Boot upgrade recipes
components/sbm-recipes-boot-upgrade/src/main/java/org/springframework/sbm/boot - JEE migration recipes
components/sbm-recipes-jee-to-boot/src/main/java/org/springframework/sbm/jee - Mule migration recipes
components/sbm-recipes-mule-to-boot/src/main/java/org/springframework/sbm/mule - Rewrite recipes
components/openrewrite-spring-recipes/src/main/java/org/springframework/sbm/RewriteRecipesRepository.java
Upgrade reporting
- Report controller
applications/spring-boot-upgrade/src/main/java/org/springframework/sbm/ReportController.java - Upgrade report
applications/spring-boot-upgrade/src/main/java/org/springframework/sbm
Other components
- Developer
- Target project
Connections 21
- Developer → CLI shell: runs commands
- Developer → Upgrade web UI: uses upgrade UI
- Developer → Target project: chooses project
- CLI shell → CLI commands: dispatches commands
- CLI commands → Command engine: invokes operations
- Upgrade web UI → Report controller: submits recipes
- Report controller → Command engine: applies recipes
applications/spring-boot-upgrade/src/main/java/org/springframework/sbm/ReportController.java - Report controller → Upgrade report: returns report
applications/spring-boot-upgrade/src/main/java/org/springframework/sbm/ReportController.java - Command engine → Project context: operates on context
components/sbm-core/src/main/java/org/springframework/sbm/engine/commands/ApplyCommand.java - Project context → Project resources: searches resources
components/sbm-core/src/main/java/org/springframework/sbm/engine/context/ProjectContext.java - Project parsing → Project context: initializes context
- Command engine → Precondition checks: checks applicability
- Command engine → Recipe engine: runs recipes
components/sbm-core/src/main/java/org/springframework/sbm/engine/commands/ApplyCommand.java - Project context → OpenRewrite: runs recipe
components/sbm-core/src/main/java/org/springframework/sbm/engine/context/ProjectContext.java - Project context → Java source API: exposes Java sources
components/sbm-core/src/main/java/org/springframework/sbm/engine/context/ProjectContext.java - Recipe engine → Boot upgrade recipes: provides recipes
- Recipe engine → JEE migration recipes: provides recipes
components/sbm-recipes-jee-to-boot/src/main/java/org/springframework/sbm/jee/jaxws/GenerateWebServices.java - Recipe engine → Mule migration recipes: provides recipes
components/sbm-recipes-mule-to-boot/src/main/java/org/springframework/sbm/mule/MigrateRamlToSpringController.java - Recipe engine → Rewrite recipes: discovers recipes
- Boot upgrade recipes → Upgrade report: builds upgrade guidance
applications/spring-boot-upgrade/src/main/java/org/springframework/sbm/ReportController.java - Target project → Project parsing: is parsed from