domaframework/doma — pull request #50 by nakamura-to (2014-12-24 13:27:35+00:00)
Title: [WIP] SQLに呼び出し元の情報をコメントで添付できるようにしました

データベース側のログからSQLの発行場所を特定できるようにするためです。

この機能の使用例を示します。

`Config` の実装クラスで次のように記述します。

```java
@SingletonConfig
public class AppConfig implements Config {
...
private CommentAttacher commentAttacher = new CallerCommentAttacher();

public CommentAttacher getCommentAttacher() {
return commentAttacher;
}
}
```

Daoの定義は次のものだとします。

```java
package sample;
...
@Dao(config = AppConfig.class)
public interface EmpDao {
@Select
List selectAll();
}
```

上記のDaoメソッドに対応するSQLファイルは次のものだとします。

```sql
select * from emp
```

このとき、`Config` の実装クラスの設定により、実行されるSQLは次のものになります（先頭の行にDaoのクラス名とメソッド名を含んだコメントが追加されます）。

```sql
/** sample.EmpDao.selectAll */
select * from emp
```

`Config` の実装クラスで `CallerCommentAttacher` を使わない場合は、以前のバージョンと同じ挙動になります。

SQLに追加するコメントの内容は、 `CommentAttacher` の実装クラスでカスタマイズできます。