## 實現Mapper 推薦通過繼承已有接口BaseMapper來實現Mapper ```java public interface UserMapper extends BaseMapper<UserEntity> { } ``` BaseMapper 具備很多內置的CRUD方法，因此有了UserMapper后，同樣可以不寫任何SQL，可以輕易的完成常用操作。例如 ```java //得到UserMapper接口的一個代理實現類，如果使用spring框架，則可以自動注入mapper UserMapper mapper = sqlManager.getMapper(UserMapper.class); List<UserEntity> list = mapper.all(); boolean isExist = mapper.exist(2); UserEntity me = mapper.unique(1); me.setName("newName"); mapper.updateById(me); ``` BaseMapper是BeetlSQL3提供的一個默認的類（你可以完成自己的BaseMapper，參考《定義自己的Mapper》），BaseMapper定義如下 ```java /** * BaseMapper.定義了一個Mapper接口，并內置了多個方法 * 開發者可以定義自己的"BaseMapper",并使用AutoMapper注解來申明這是內置的，beetlsql會調用其注解使用的接口 * @param <T> the generic type * @author xiandafu */ public interface BaseMapper<T> { /** * 通用插入，插入一個實體對象到數據庫，所以字段將參與操作，除非你使用ColumnIgnore注解 *SqlResource * @param entity */ @AutoMapper(InsertAMI.class) void insert(T entity); /** * 插入實體到數據庫，對于null值不做處理 * * @param entity */ @AutoMapper(InsertTemplateAMI.class) void insertTemplate(T entity); /** * 批量插入實體。此方法不會獲取自增主鍵的值，如果需要，建議不適用批量插入，適用 * <pre> * insert(T entity,true); * </pre> * * @param list */ @AutoMapper(InsertBatchAMI.class) void insertBatch(List<T> list); /** * 根據主鍵更新對象，所以屬性都參與更新。也可以使用主鍵ColumnIgnore來控制更新的時候忽略此字段 * @param entity * @return */ @AutoMapper(UpdateByIdAMI.class) int updateById(T entity); /** * 根據主鍵更新對象，只有不為null的屬性參與更新 * * @param entity * @return */ @AutoMapper(UpdateTemplateByIdAMI.class) int updateTemplateById(T entity); /** * 按照主鍵更新更新或插入,自增或者序列id自動賦值給entity * @param entity 待更新/插入的實體對象 * @return 如果是插入操作，返回true，如果是更新，返回false */ @AutoMapper(UpsertAMI.class) boolean upsert(T entity); /**按照主鍵更新或插入，更新失敗，會調用插入，屬性為空的字段將不更新或者插入。自增或者序列id自動賦值給entity * @param entity 待更新/插入的實體對象 * @return */ @AutoMapper(UpsertByTemplateAMI.class) int upsertByTemplate(T entity); /** * 根據主鍵刪除對象，如果對象是復合主鍵，傳入對象本生即可 * * @param key * @return */ @AutoMapper(DeleteByIdAMI.class) int deleteById(Object key); /** * 根據主鍵獲取對象，如果對象不存在，則會拋出一個Runtime異常 * * @param key * @return */ @AutoMapper(UniqueAMI.class) T unique(Object key); /** * 根據主鍵獲取對象，如果對象不存在，返回null * * @param key * @return */ @AutoMapper(SingleAMI.class) T single(Object key); /** * 根據一批主鍵查詢 * @param key * @return */ @AutoMapper(SelectByIdsAMI.class) List<T> selectByIds(List<?> key); default boolean exist(Object key){ return this.getSQLManager().exist(this.getTargetEntity(),key); } /** * 根據主鍵獲取對象，如果在事物中執行會添加數據庫行級鎖(select * from table where id = ? for update)，如果對象不存在，返回null * * @param key * @return */ @AutoMapper(LockAMI.class) T lock(Object key); /** * 返回實體對應的所有數據庫記錄 * * @return */ @AutoMapper(AllAMI.class) List<T> all(); /** * 返回實體在數據庫里的總數 * * @return */ @AutoMapper(AllCountAMI.class) long allCount(); /** * 模板查詢，返回符合模板得所有結果。beetlsql將取出非null值（日期類型排除在外），從數據庫找出完全匹配的結果集 * * @param entity * @return */ @AutoMapper(TemplateAMI.class) List<T> template(T entity); /** * 模板查詢，返回一條結果,如果沒有，返回null * * @param entity * @return */ @AutoMapper(TemplateOneAMI.class) <T> T templateOne(T entity); /** * 符合模板得個數 * * @param entity * @return */ @AutoMapper(TemplateCountAMI.class) long templateCount(T entity); /** * 執行一個jdbc sql模板查詢 * * @param sql * @param args * @return */ @AutoMapper(ExecuteAMI.class) List<T> execute(String sql, Object... args); /** * 執行一個更新的jdbc sql * * @param sql * @param args * @return */ @AutoMapper(ExecuteUpdateAMI.class) int executeUpdate(String sql, Object... args); @AutoMapper(GetSQLManagerAMI.class) SQLManager getSQLManager(); /** * 返回一個Query對象 * * @return */ @AutoMapper(QueryAMI.class) Query<T> createQuery(); /** * 返回一個LambdaQuery對象 * * @return */ @AutoMapper(LambdaQueryAMI.class) LambdaQuery<T> createLambdaQuery(); /** * 得到mapper的范型類 * @return */ @AutoMapper(GetTargetEntityAMI.class) Class getTargetEntity(); } ``` BaseMapper提供了POJO常用的CRUD方法，每個BaseMapper的接口方法都是通過@AutoMapper注解申明一個實現類,實現類調用SQLManager相關得API。 關于此實現類，可以參考《擴展BeetlSQL3》 除了BaseMapper提供的方法外，你還可以為Mapper添加各種訪問數據庫的方法，說明如下