Mapper 模板

占位符说明

占位符	说明	示例
{basePackage}	项目基础包路径	cn.szhn.poc.service
{module}	业务模块名称（小驼峰）	demostu, teacher
{Xxx}	业务实体名称（大驼峰）	DemoStu, Teacher
{作者名}	代码作者	彭业庆
{yyyy-MM-dd}	创建日期	2026-05-13

模板代码

package {basePackage}.domain.{module}.mapper;

import {basePackage}.domain.{module}.model.{Xxx}DO;
import cn.com.digitalhainan.mybatis.mapper.BaseMapper;

/**
 * <p>{业务名称}Mapper接口</p>
 *
 * @author {作者名}
 * @since {yyyy-MM-dd}
 */
public interface {Xxx}Mapper extends BaseMapper<{Xxx}DO> {
    // 简单 CRUD 由基类提供，复杂查询在 XML 中实现
}

关键规约

规约项	要求
基类继承	继承 cn.com.digitalhainan.mybatis.mapper.BaseMapper<{Xxx}DO>（脚手架提供，非 MyBatis-Plus 原生）
方法定义	简单 CRUD 无需定义，复杂查询在 XML 中实现
文档注释	必须添加 @author 和 @since