spring-mvc-to-boot-migrator

Spring MVC to Spring Boot Migrator

Overview

This skill automatically migrates Spring MVC applications to Spring Boot, transforming build configuration, annotations, XML configuration, controllers, and tests while preserving existing functionality. It handles Maven and Gradle projects, creates incremental git commits, and generates detailed migration summaries.

Quick Start

Basic Usage

# Navigate to your Spring MVC project
cd /path/to/spring-mvc-project

# Run migration (auto-detects Maven or Gradle)
python scripts/migrate.py .

# Or specify build tool explicitly
python scripts/migrate.py . --build-tool maven

The migration process will:

1. Create a migration branch
2. Analyze your codebase
3. Update build configuration
4. Migrate annotations
5. Convert configuration files
6. Update tests
7. Generate a summary report

Example Migration

# Migrate Spring MVC project
python scripts/migrate.py /path/to/project

# Output:
# ✓ Detected build tool: maven
# ✓ Detected Spring version: 5.3.20
# ✓ Created migration branch: migrate-spring-mvc-to-boot
# ✓ Analyzing codebase...
# ✓ Found 8 controllers
# ✓ Found 12 services
# ✓ Found 15 test files
# ✓ Migrating build configuration...
# ✓ Migrating annotations...
# ✓ Migrating configuration...
# ✓ Migrating tests...
# ✓ Migration completed successfully!

Supported Migration Paths

Spring MVC → Spring Boot

What gets migrated:

1. Build Configuration
2. Maven: Add Spring Boot parent, update dependencies, add Spring Boot plugin
3. Gradle: Add Spring Boot plugin, update dependencies

1. Annotations
2. @Controller + @ResponseBody → @RestController
3. @RequestMapping(method = RequestMethod.GET) → @GetMapping
4. Similar for @PostMapping, @PutMapping, @DeleteMapping
5. Update imports from javax. to jakarta.

1. Configuration
2. XML configuration → Java configuration + application.properties
3. web.xml → Spring Boot auto-configuration
4. Create Spring Boot main application class

1. Tests
2. JUnit 4 → JUnit 5
3. @RunWith(SpringRunner.class) → @SpringBootTest
4. Manual MockMvc setup → @AutoConfigureMockMvc

Example transformation:

Before (Spring MVC):

@Controller
@RequestMapping("/users")
public class UserController {

    @RequestMapping(method = RequestMethod.GET)
    @ResponseBody
    public List<User> getUsers() {
        return userService.findAll();
    }
}

After (Spring Boot):

@RestController
@RequestMapping("/users")
public class UserController {

    @GetMapping
    public List<User> getUsers() {
        return userService.findAll();
    }
}

Migration Process

Phase 1: Preparation

The migration tool automatically:

• Validates the repository is a git repo
• Detects build tool (Maven or Gradle)
• Detects current Spring version
• Creates a migration branch
• Analyzes codebase structure

Phase 2: Build Configuration Migration

Maven projects:

• Adds Spring Boot parent POM
• Replaces individual Spring dependencies with Spring Boot starters
• Adds Spring Boot Maven plugin
• Updates dependency versions

Gradle projects:

• Adds Spring Boot plugin
• Adds dependency management plugin
• Replaces dependencies with Spring Boot starters
• Updates build configuration

Phase 3: Annotation Migration

Updates Java annotations:

• Controller annotations (@RestController)
• Request mapping annotations (@GetMapping, @PostMapping, etc.)
• Import statements (javax. → jakarta.)
• Creates Spring Boot main application class with @SpringBootApplication

Phase 4: Configuration Migration

Converts configuration:

• XML configuration → Java configuration classes
• web.xml → Spring Boot auto-configuration
• Creates application.properties with common settings
• Identifies manual conversion needs for complex XML configs

Phase 5: Test Migration

Updates test files:

• JUnit 4 → JUnit 5 annotations
• Test runner annotations
• MockMvc setup
• Test context configuration
• Assertion methods

Phase 6: Summary Generation

Creates comprehensive report:

• Total changes made
• Files modified by category
• Migration plan executed
• Next steps for manual review
• Saved as MIGRATION_SUMMARY.json

Using the Migration Scripts

Main Migration Script

python scripts/migrate.py <repo_path> [--build-tool <maven|gradle|auto>]

# Options:
#   repo_path: Path to the Spring MVC repository
#   --build-tool: Build tool (default: auto-detect)

Individual Migration Modules

You can also run individual migration steps:

from migrate_build import BuildMigrator
from migrate_annotations import AnnotationMigrator
from migrate_config import ConfigMigrator
from migrate_tests import TestMigrator

# Run specific migration
migrator = AnnotationMigrator(repo_path)
migrator.migrate()

Post-Migration Steps

After migration completes:

1. Review the changes

``bash git log --oneline git diff main..migrate-spring-mvc-to-boot ``

1. Build the project

```bash # Maven mvn clean package

# Gradle gradle clean build ```

1. Run the application

```bash # Maven mvn spring-boot:run

# Gradle gradle bootRun

# Or run JAR directly java -jar target/myapp.jar ```

1. Run tests

```bash # Maven mvn test

# Gradle gradle test ```

1. Manual review needed for:
2. Complex XML configuration (convert to Java config)
3. Custom servlet filters
4. Advanced security configuration
5. Third-party integrations
6. Custom view resolvers

1. Test endpoints

``bash curl http://localhost:8080/users ``

1. Merge when ready

``bash git checkout main git merge migrate-spring-mvc-to-boot ``

Reference Documentation

• references/migration_guide.md - Comprehensive step-by-step migration guide covering all aspects from build configuration to testing, with detailed examples and troubleshooting
• references/framework_comparison.md - Detailed comparison of Spring MVC and Spring Boot including architecture, configuration, controllers, testing, and deployment

Example Code

Example controller files are provided in assets/:

• UserController_Before.java - Spring MVC controller before migration
• UserController_After.java - Spring Boot controller after migration

Compare these files to understand the transformations applied.

Migration Summary

After migration, review MIGRATION_SUMMARY.json:

{
  "source_framework": "Spring MVC",
  "target_framework": "Spring Boot",
  "build_tool": "maven",
  "total_changes": 35,
  "changes_by_type": {
    "build": 5,
    "annotation": 12,
    "config": 6,
    "test": 12
  },
  "files_modified": [...],
  "next_steps": [...]
}

Tips

• Always backup your code before migration
• Review each migration commit individually
• Test thoroughly after migration
• Convert complex XML configs to Java configuration manually
• Update documentation to reflect Spring Boot conventions
• Enable Spring Boot Actuator for production monitoring
• Use Spring Boot DevTools for development
• Consult reference documentation for complex patterns
• Run tests frequently during manual adjustments

Troubleshooting

Issue: Application won't start

• Solution: Check for @SpringBootApplication annotation and correct package structure

Issue: Controllers not found

• Solution: Ensure controllers are in same package or sub-package as Application class

Issue: Build fails

• Solution: Run mvn clean install or gradle clean build to refresh dependencies

Issue: Tests fail

• Solution: Update JUnit 4 to JUnit 5, check test annotations

Issue: Database connection fails

• Solution: Update connection properties in application.properties

See references/migration_guide.md for detailed troubleshooting.

Benefits of Migration

1. Reduced Configuration: 80% less configuration code
2. **Faster De