### 使用模板文件 稍微做個復雜項目的人都知道，把復雜SQL放到專門的SQL里維護是個很好的辦法。（BeetlSQL3 提供了專門的插件來維護SQL） 默認情況下，sql文件位于classpath的sql目錄下，可以在resources目錄下新建一個sql目錄，并在sql目錄下新建一個user.md文件 內容如下 ```markdown select === ?```sql select * from sys_user u where 1=1 -- @ if(isNotEmpty(name)){ and name like #{name} -- @ } order by u.id desc ?``` ``` 如下代碼可以訪問并執行這個sql語句 ```java SqlId id = SqlId.of("user","select"); Map map = new HashMap(); map.put("name","n"); List<UserEntity> list = sqlManager.select(id,UserEntity.class,map); ``` sqlManager.select將會查詢user.md文件下的select片段，并執行，執行結果映射成UserEntity對象。 一個markdown文件可以包含任意多個sql片段，格式如下 ```markdown 文件一些說明，放在頭部可有可無，如果有說明，可以是任意文字 SQL標示 === 以*開頭的注釋,可選 SQL語句 SQL標示2 === SQL語句 2 ``` 使用SqlId指明sql文件位置不方便，更常見的是在mapper方法里調用 ```java @SqlResource("user") /*sql文件在user.md里*/ public interface UserMapper extends BaseMapper<UserEntity> { /** * 調用sql文件user.md#select,方法名即markdown片段名字 * @param name * @return */ List<UserEntity> select(String name); } ``` 這里的select方法沒有任何注解，意思是調用sql文件執行，sql文件通過@SqlResource申明，sql片段名字則同方法名，sql中用的參數則同方法參數，調用起來非常方便