Add bidirectional conversion between SQL files and @Sql annotations

[xterao]

Summary

This PR implements bidirectional conversion functionality between SQL files and @SQL annotations in Doma DAO methods, allowing developers to seamlessly switch between these
two SQL definition approaches.

Changes

New Features

• SQL Annotation to File Conversion (ConvertSqlAnnotationToFileAction)

  • Converts @SQL, @select, @update, @insert, @delete,@BatchUpdate, @BatchInsert, @BatchDelete, and @script annotations to external SQL files
  • Automatically creates SQL files in the appropriate META-INF directory structure
  • Preserves SQL formatting during conversion

• SQL File to Annotation Conversion (ConvertSqlFileToAnnotationAction)

  • Converts external SQL files back to @SQL annotations
  • Maintains proper formatting and escaping of SQL content
  • Removes SQL files after successful conversion

• SQL Annotation Converter Utility (SqlAnnotationConverter)

  • Core conversion logic for both directions
  • Handles SQL formatting using the new dedicated formatter
  • Manages file operations and annotation manipulation

Infrastructure Improvements

• Dedicated SQL Formatter (InjectionSqlFormatter)
  • Extracted SQL formatting logic for use outside of the main formatter functionality
  • Enables consistent SQL formatting across different features
  • Supports formatting tasks with configurable options

Testing

• Verify @SQL annotation to file conversion works correctly
• Verify SQL file to @SQL annotation conversion maintains formatting
• Test conversion for all supported annotation types (@select, @update, @insert, @delete, @script)
• Confirm SQL files are created in correct directory structure
• Validate that existing formatter functionality remains unaffected
• Check that all existing tests pass

� Generated with Claude Code

Co-Authored-By: Claude [email protected]

[Copilot]

Pull Request Overview

This PR implements bidirectional conversion functionality between SQL files and @SQL annotations in Doma DAO methods, enabling developers to seamlessly switch between inline SQL annotations and external SQL files.

• SQL annotation to file conversion: Converts @SQL, @select, @update, @insert, @delete, @BatchUpdate, @BatchInsert, @BatchDelete, and @script annotations to external SQL files with automatic formatting
• SQL file to annotation conversion: Converts external SQL files back to @SQL annotations with proper escaping and formatting
• Infrastructure improvements: New dedicated SQL formatter and comprehensive test coverage for both conversion directions

Reviewed Changes

Copilot reviewed 85 out of 85 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
New test data files	Expected output files for testing both conversion directions across different DAO annotation types
ConvertSqlFileToAnnotationActionTest.kt	Test cases for SQL file to @SQL annotation conversion functionality
ConvertSqlAnnotationToFileActionTest.kt	Test cases for @SQL annotation to SQL file conversion functionality
DomaToolsBundle*.properties	Internationalized messages for the new conversion actions
Intention descriptions	HTML documentation for the new intention actions
plugin.xml	Plugin registration for the two new intention actions
DaoInjectionSqlVisitor.kt	Refactored to use the new dedicated InjectionSqlFormatter
SqlInjectionPostProcessor.kt	Updated to use the new InjectionSqlFormatter
InjectionSqlFormatter.kt	New dedicated SQL formatter for injection contexts
PsiDaoMethod.kt	Enhanced to handle SQL file deletion when overwriting existing files
SqlAnnotationConverter.kt	Core conversion logic handling both directions with SQL formatting
ConvertSqlFileToAnnotationAction.kt	Intention action for converting SQL files to @SQL annotations
ConvertSqlAnnotationToFileAction.kt	Intention action for converting @SQL annotations to SQL files

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.
You can also share your feedback on Copilot code review for a chance to win a $100 gift card. Take the survey.}