Doma 2.22.0にて、SQLをアノテーションに記述するための機能を実験的に追加する

sql-annotation.md

追加するアノテーションは @Sql の1つのみ

• 前提として@Sql 導入前までのバージョンとの互換性は維持する
• @Sql のFQNは org.seasar.doma.experimental.Sql

Selectの場合

（これまで通り）SQLをファイルから読む

@Select
Emp select();

SQLをアノテーションから読む

@Sql("select * from emp")
@Select
Emp select();

Insertの場合

（これまで通り）SQLを自動で組み立てる

@Insert
int insert(Emp e);

SQLをアノテーションから読む

@Sql("insert into ...")
@Insert
int insert(Emp e);

（これまで通り）SQLをファイルから読む

@Insert(sqlFile = true)
int insert(Emp e);

エラー（アノテーションとファイルのどちらのSQLを使えばいいのかわからないので）

@Sql("insert into ...")
@Insert(sqlFile = true)
int insert(Emp e);

その他エラー

@Sql をサポートしていないアノテーションと一緒に注釈するケース

@Sql("insert into ...")
@Procedure
void execute(String value);

@Sql をデフォルトメソッドに注釈するケース

@Sql("insert into ...")
default int doSomething(String value) {
  ...
}