官方文档:ACTable官方文档地址
开源项目不容易,如果觉得本项目对您的工作还是有帮助的话,请在帮忙点以下Star,谢谢
ACTable技术交流QQ群:746531106
A.C.Table是对Mybatis做的增强功能,支持SpringBoot以及传统的SpringMvc项目结构,简单配置即可,该框架是为了能够使习惯了hibernate框架的开发者能够快速的入手Mybatis, “A.C.Table” 本意是自动建表的意思,A.C.Table是一个基于Spring和Mybatis的Maven项目,增强了Mybatis的功能,过配置model注解的方式来创建表,修改表结构,并且实现了共通的CUDR功能提升开发效率,同时能够兼容tk.mybatis,如需使用依赖tk.mybatis的pom依赖即可,目前仅支持Mysql,后续会扩展针对其他数据库的支持。
Javadoc文档:https://apidoc.gitee.com/sunchenbin/mybatis-enhance
A.C.Table是采用了Spring、Mybatis技术的Maven结构,详细介绍如下:
基本使用规范
1.需要依赖mybatis-enhance-actable-1.4.1.RELEASE.jar
<dependency>
<groupId>com.gitee.sunchenbin.mybatis.actable</groupId>
<artifactId>mybatis-enhance-actable</artifactId>
<version>1.4.1.RELEASE</version>
</dependency>
<!-- 如需使用tk.mybatis同时需要依赖该jar包,之前1.3.1和1.3.0版本默认依赖了,但是有的小伙伴使用mybatis-plus会有冲突,所以这一版本默认不依赖,如需使用自行依赖即可 -->
<dependency>
<groupId>tk.mybatis</groupId>
<artifactId>mapper-spring-boot-starter</artifactId>
<version>2.1.5</version>
</dependency>
2.需要配置对于actable支持的配置
actable.table.auto=update
actable.model.pack=com.xxx.store.model(ps:要扫描的用于建表做依据的model目录)
actable.database.type=mysql
本系统提供四种模式:
2.1 当actable.table.auto=create时,系统启动后,会将所有的表删除掉,然后根据model中配置的结构重新建表,该操作会破坏原有数据。
2.2 当actable.table.auto=update时,系统会自动判断哪些表是新建的,哪些字段要修改类型等,哪些字段要删除,哪些字段要新增,该操作不会破坏原有数据。
2.3 当actable.table.auto=none时,系统不做任何处理。
2.4 当actable.table.auto=add,新增表/新增字段/新增索引/新增唯一约束的功能,不做做修改和删除 (只在版本1.0.9.RELEASE及以上支持)。
2.5 actable.model.pack这个配置是用来配置要扫描的用于创建表的对象的包名
2.6 actable.database.type这个是用来区别数据库的,预计会支持这四种数据库mysql/oracle/sqlserver/postgresql,但目前仅支持mysql
- 支持actable的mybatis配置(必备的配置)
<!-- mybatis的配置文件中需要做两项配置,因为mybatis-enhance-actable项目底层是直接依赖mybatis的规范执行sql的,因此需要将其中的mapping和dao映射到一起 -->
1. classpath*:com/gitee/sunchenbin/mybatis/actable/mapping/*/*.xml
2. com.gitee.sunchenbin.mybatis.actable.dao.*
- 扫描actable的包到spring容器中管理(必备的配置)
1. com.gitee.sunchenbin.mybatis.actable.manager.*
Springboot+Mybatis的项目使用步骤方法
- 首先pom文件依赖actable框架
<dependency>
<groupId>com.gitee.sunchenbin.mybatis.actable</groupId>
<artifactId>mybatis-enhance-actable</artifactId>
<version>1.4.1.RELEASE</version>
</dependency>
<!-- 如需使用tk.mybatis同时需要依赖该jar包,之前1.3.1和1.3.0版本默认依赖了,但是有的小伙伴使用mybatis-plus会有冲突,所以这一版本默认不依赖,如需使用自行依赖即可 -->
<dependency>
<groupId>tk.mybatis</groupId>
<artifactId>mapper-spring-boot-starter</artifactId>
<version>2.1.5</version>
</dependency>
- 项目的application.properties文件配置例如下面
# actable的配置信息
actable.table.auto=update
actable.model.pack=com.xxx.store.model(ps:要扫描的model目录)
actable.database.type=mysql
# mybatis的配置信息,key也可能是:mybatis.mapper-locations
mybatis.mapperLocations=classpath*:com/gitee/sunchenbin/mybatis/actable/mapping/*/*.xml;自己的mapper.xml没有可不填
- springboot启动类需要做如下配置
1. 通过注解@ComponentScan配置,扫描actable要注册到spring的包路径"com.gitee.sunchenbin.mybatis.actable.manager.*"
2. 通过注解@MapperScan配置,扫描mybatis的mapper,路径为"com.gitee.sunchenbin.mybatis.actable.dao.*"
传统Spring+Mybatis的Web项目使用步骤方法
- 首先pom文件依赖actable框架
<dependency>
<groupId>com.gitee.sunchenbin.mybatis.actable</groupId>
<artifactId>mybatis-enhance-actable</artifactId>
<version>1.4.1.RELEASE</version>
</dependency>
<!-- 如需使用tk.mybatis同时需要依赖该jar包 -->
<dependency>
<groupId>tk.mybatis</groupId>
<artifactId>mapper-spring-boot-starter</artifactId>
<version>2.1.5</version>
</dependency>
- 在你的web项目上创建个目录比如config下面创建个文件autoCreateTable.properties文件的内容如下:
actable.table.auto=update
actable.model.pack=com.xxx.store.model(ps:要扫描的model目录)
actable.database.type=mysql
- spring的配置文件中需要做如下配置:
<!-- 自动扫描(自动注入mybatis-enhance-actable的Manager)必须要配置,否则扫描不到底层的mananger方法 -->
<context:component-scan base-package="com.gitee.sunchenbin.mybatis.actable.manager.*" />
<!-- 这是mybatis-enhance-actable的功能开关配置文件,其实就是将上面第2点说的autoCreateTable.properties文件注册到spring中,以便底层的mybatis-enhance-actable的方法能够获取到-->
<bean id="configProperties" class="org.springframework.beans.factory.config.PropertiesFactoryBean">
<property name="locations">
<list>
<value>classpath*:config/autoCreateTable.properties</value>
</list>
</property>
</bean>
<bean id="propertyConfigurer" class="org.springframework.beans.factory.config.PreferencesPlaceholderConfigurer">
<property name="properties" ref="configProperties" />
</bean>
<!-- mybatis的配置文件中需要做两项配置,因为mybatis-enhance-actable项目底层是直接依赖mybatis的规范执行sql的,因此需要将其中的mapping和dao映射到一起 -->
1. classpath*:com/gitee/sunchenbin/mybatis/actable/mapping/*/*.xml
2. com.gitee.sunchenbin.mybatis.actable.dao.*
举例这两个配置配置的详细位置
<!-- myBatis文件 -->
<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
<property name="dataSource" ref="dataSource" />
<!-- 自动扫描entity目录, 省掉Configuration.xml里的手工配置 -->
<property name="mapperLocations">
<array>
<value>classpath*:自己的mappring.xml没有可不填</value>
<value>classpath*:com/gitee/sunchenbin/mybatis/actable/mapping/*/*.xml</value>
</array>
</property>
<property name="typeAliasesPackage" value="自己的model.*没有可不填" />
<!-- <property name="configLocation" value="classpath:core/mybatis-configuration.xml" /> -->
</bean>
<!-- 如果不使用tk.mybatis需要使用这个bean成如下: -->
<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
<property name="basePackage" value="com.gitee.sunchenbin.mybatis.actable.dao.*;自己的dao.*没有可不填" />
<property name="sqlSessionFactoryBeanName" value="sqlSessionFactory" />
</bean>
<!-- 如果要使用tk.mybatis需要使用这个bean成如下: -->
<bean class="tk.mybatis.spring.mapper.MapperScannerConfigurer">
<property name="basePackage" value="com.gitee.sunchenbin.mybatis.actable.dao.*;自己的dao.*没有可不填"/>
<property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"/>
<property name="properties">
<value>
mappers=tk.mybatis.mapper.common.Mapper,tk.mybatis.mapper.common.special.InsertListMapper
</value>
</property>
</bean>
代码用途讲解
1. MySqlCharsetConstant.java这个对象里面配置的是mysql的数据类型,这里配置的类型越多,意味着创建表时能使用的类型越多
2. @Column.java也是一个自定义的注解,用于标记model中的字段上,作为创建表的依据如不标记,不会被扫描到,有几个属性用来设置字段名、字段类型、长度等属性的设置,详细请看代码上的注释
3. @Table.java也是一个自定义的注解,用于标记在model对象上,有一个属性name,用于设置该model生成表后的表名,如不设置该注解,则该model不会被扫描到
4. @Index.java是一个自定义注解,用于标记在model中的字段上,表示为该字段创建索引,有两个属性一个是设置索引名称,一个是设置索引字段,支持多字段联合索引,如果都不设置默认为当前字段创建索引
5. @Unique.java是一个自定义注解,用于标记在model中的字段上,表示为该字段创建唯一约束,有两个属性一个是设置约束名称,一个是设置约束字段,支持多字段联合约束,如果都不设置默认为当前字段创建唯一约束
6. @TableComment用来配置表的注释,可用来替代@Table的comment
7. @IsKey/@IsAutoIncrement/@IsNotNull用来代替 @Column中的isKey/isAutoIncrement/isNull三个属性,当然旧的配置方式仍然是支持的
8. @ColumnComment字段注释,用来替代@Column中的comment
9. @DefaultValue字段默认值,用来替代@Column中的defaultValue
10.@ColumnType字段类型,用来替代@Column中的type,取值范围MySqlTypeConstant.java中的枚举
11.@TableCharset表字符集,用来替代@Table中的charset,取值范围MySqlCharsetConstant.java中的枚举
12.@TableEngine表引擎类型,用来替代@Table中的engine,取值范围MySqlEngineConstant.java中的枚举
13.支持javax.persistence包中的部分注解,用于对tk.mybatis做支持
javax.persistence.Column 同 com.gitee.sunchenbin.mybatis.actable.annotation.Column
javax.persistence.Column.name 同 com.gitee.sunchenbin.mybatis.actable.annotation.Column.name
javax.persistence.Column.length 同 com.gitee.sunchenbin.mybatis.actable.annotation.Column.length
javax.persistence.Column.scale 同 com.gitee.sunchenbin.mybatis.actable.annotation.Column.decimalLength
javax.persistence.Table 同 com.gitee.sunchenbin.mybatis.actable.annotation.Table
javax.persistence.Id 同 com.gitee.sunchenbin.mybatis.actable.annotation.IsKey
13.系统启动后会去自动调用SysMysqlCreateTableManagerImpl.java的createMysqlTable()方法,没错,这就是核心方法了,负责创建、删除、修改表。
model的写法例子(这里的@Table和@Column都是用的actable中的,也支持使用javax.persistence包下的@Table和@Column以及@Id)
@Builder
@Data
@NoArgsConstructor
@AllArgsConstructor
@Table(name = "test")
@TableComment("测试表")
@TableEngin(MySqlEngineConstant.InnoDB)
@TableCharset(MySqlCharsetConstant.UTF8MB4)
public class UserEntity extends BaseModel{
private static final long serialVersionUID = 5199200306752426433L;
// 第一种主键设置方式
@Column(name = "id",type = MySqlTypeConstant.INT,length = 11,isKey = true,isAutoIncrement = true)
private Integer id;
// 第二种简化的主键设置方式
@IsKey
@IsAutoIncrement
@Column
@ColumnType(MySqlTypeConstant.INT)
private Integer id;
// 第一种设置索引的方法,这种方法会在数据库默认创建索引名称为actable_idx_{login_name},索引字段为login_name
@Index
// 第二种设置索引的方法,这种方法会在数据库创建索引名称为actable_idx_{t_idx_login_name},索引字段为login_name
@Index("t_idx_login_name")
// 第三种设置索引的方法,这种方法会在数据库创建索引名称为actable_idx_{t_idx_login_name},索引字段为login_name
@Index(value="t_idx_login_name",columns={"login_name"})
// 第四种设置索引的方法,可以设置联合索引,这种方法会在数据库创建索引名称为actable_idx_{login_name_mobile},索引字段为login_name和mobile
@Index(columns={"login_name","mobile"})
// 第五种设置索引的方法,可以设置联合索引,这种方法会在数据库创建索引名称为actable_idx_{login_name_mobile},索引字段为login_name和mobile
@Index(value="t_idx_login_name_mobile",columns={"login_name","mobile"})
// 唯一约束的注解的使用方法,跟@Index相同
@Unique
@Column(name = "login_name",type = MySqlTypeConstant.VARCHAR,length = 111)
private String loginName;
// column的简化写法,不配置默认使用当前属性名作为字段名,当前类型默认转换至mysql支持的类型
@Column
private String mobile;
// column的简化写法,根据需要设置注解属性
@Column(name = "createTime")
private Date create_time;
@Column(name = "update_time",type = MySqlTypeConstant.DATETIME)
private Date update_time;
@Column(name = "number",type = MySqlTypeConstant.DECIMAL,length = 10,decimalLength = 2)
private BigDecimal number;
// 第一种设置字段非空的方法
@Column(name = "lifecycle",type = MySqlTypeConstant.CHAR,length = 1,isNull=false)
// 第二种设置字段非空的方法
@IsNotNull
@Column
private String lifecycle;
@Column
@DefaultValue("111")
@ColumnComment("昵称")
private String realName;
}
@Column不设置类型时的默认转换规则如下(建议类型使用对象类型不要用基本数据类型)
javaToMysqlTypeMap.put("class java.lang.String", MySqlTypeConstant.VARCHAR);
javaToMysqlTypeMap.put("class java.lang.Long", MySqlTypeConstant.BIGINT);
javaToMysqlTypeMap.put("class java.lang.Integer", MySqlTypeConstant.INT);
javaToMysqlTypeMap.put("class java.lang.Boolean", MySqlTypeConstant.BIT);
javaToMysqlTypeMap.put("class java.math.BigInteger", MySqlTypeConstant.BIGINT);
javaToMysqlTypeMap.put("class java.lang.Float", MySqlTypeConstant.FLOAT);
javaToMysqlTypeMap.put("class java.lang.Double", MySqlTypeConstant.DOUBLE);
javaToMysqlTypeMap.put("class java.math.BigDecimal", MySqlTypeConstant.DECIMAL);
javaToMysqlTypeMap.put("class java.sql.Date", MySqlTypeConstant.DATE);
javaToMysqlTypeMap.put("class java.util.Date", MySqlTypeConstant.DATE);
javaToMysqlTypeMap.put("class java.sql.Timestamp", MySqlTypeConstant.DATETIME);
javaToMysqlTypeMap.put("class java.sql.Time", MySqlTypeConstant.TIME);
共通的CUDR功能使用
1.使用方法很简单,大家在manager或者Controller中直接注入BaseCRUDManager这个接口就可以了
2.旧的BaseMysqlCRUDManager类废弃了请不要使用
3.注意:接口调用方法时传入的对象必须是modle中用于创建表的对象才可以
4.最新版本1.3.0.RELEASE引入了对tk.mybatis的支持,方便更灵活的CUDR,仅限于使用javax.persistence的注解Column/Table/Id时生效
AC.Table支持tk.mybatis框架的CUDR方法
请参考tk.mybatis官方文档使用即可。
import com.gitee.sunchenbin.mybatis.actable.annotation.Index;
import com.gitee.sunchenbin.mybatis.actable.annotation.IsAutoIncrement;
import com.gitee.sunchenbin.mybatis.actable.annotation.IsKey;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;
import javax.persistence.Column;
import javax.persistence.Id;
import javax.persistence.Table;
import java.io.Serializable;
import java.util.Date;
@Builder
@Data
@NoArgsConstructor
@AllArgsConstructor
@Table(name = "user_entity")
public class UserEntity extends UserEntity1 implements Serializable {
@Id
@IsKey
@IsAutoIncrement
@Column
private Long id;
@Column(name = "login_name")
@Index
private String loginName;
@Column(name = "nick_name")
private String nickName;
@Column(name = "real_name")
private String realName;
@Column(name = "password")
private String password;
@Column(name = "mobile")
private String mobile;
@Column(name = "istrue")
private Boolean isTrue;
@Column(name = "it")
private Integer it;
@Column
private Date createTime;
@Column
private Date modifyTime;
}
import com.alex.orderapi.dao.entity.UserEntity;
import tk.mybatis.mapper.common.Mapper;
public interface UserMapper extends Mapper<UserEntity> {
}
@RequestMapping("/select/user1")
public String select1(HttpServletRequest request) {
userMapper.insert(UserEntity.builder().loginName("s").createTime(new Date()).realName("v").password("r").mobile("1").build());
userMapper.insert(UserEntity.builder().loginName("s").createTime(new Date()).realName("v").password("r").mobile("2").build());
userMapper.insert(UserEntity.builder().loginName("s").createTime(new Date()).realName("v").password("r").mobile("3").build());
userMapper.insert(UserEntity.builder().loginName("s").createTime(new Date()).realName("v").password("r").mobile("4").build());
userMapper.insert(UserEntity.builder().loginName("s").createTime(new Date()).realName("v").password("r").mobile("5").build());
userMapper.insert(UserEntity.builder().loginName("s").createTime(new Date()).realName("v").password("r").mobile("6").build());
userMapper.insert(UserEntity.builder().loginName("s").createTime(new Date()).realName("v").password("r").mobile("7").build());
userMapper.insert(UserEntity.builder().loginName("s").createTime(new Date()).realName("v").password("r").mobile("8").build());
userMapper.insert(UserEntity.builder().loginName("s").createTime(new Date()).realName("v").password("r").mobile("9").build());
userMapper.insert(UserEntity.builder().loginName("s").createTime(new Date()).realName("v").password("r").mobile("10").build());
userMapper.insert(UserEntity.builder().loginName("s").createTime(new Date()).realName("v").password("r").mobile("11").build());
userMapper.insert(UserEntity.builder().loginName("s").createTime(new Date()).realName("v").password("r").mobile("12").build());
userMapper.insert(UserEntity.builder().loginName("s").createTime(new Date()).realName("v").password("r").mobile("13").build());
userMapper.insert(UserEntity.builder().loginName("s").createTime(new Date()).realName("v").password("r").mobile("14").build());
userMapper.insert(UserEntity.builder().loginName("s").createTime(new Date()).realName("v").password("r").mobile("2").build());
List<UserEntity> userEntities1 = userMapper.selectAll();
List<UserEntity> select = userMapper.select(UserEntity.builder().mobile("2").build());
Example example = new Example(UserEntity.class);
example.createCriteria().andEqualTo("mobile","3").andEqualTo("loginName","s");
List<UserEntity> userEntities = userMapper.selectByExample(example);
UserEntity v = userMapper.selectOne(UserEntity.builder().id(30L).build());
UserEntity userEntity = userMapper.selectByPrimaryKey(10);
List<UserEntity> userEntities2 = userMapper.selectByRowBounds(UserEntity.builder().build(), new RowBounds(0, 3));
List<UserEntity> userEntities3 = userMapper.selectByExampleAndRowBounds(Example.builder(UserEntity.class).build(), new RowBounds(3, 3));
Example example1 = new Example(UserEntity.class);
example1.setOrderByClause("id desc");
List<UserEntity> userEntities4 = userMapper.selectByExampleAndRowBounds(example1, new RowBounds(0, 3));
return "selectAll: " + JSON.toJSONString(userEntities1) +
"<p> select: " + JSON.toJSONString(select) +
"<p> selectByExample:" + JSON.toJSONString(userEntities) +
"<p> selectOne:" + JSON.toJSONString(v) +
"<p> selectByPrimaryKey:" + JSON.toJSONString(userEntity) +
"<p> selectByRowBounds:" + JSON.toJSONString(userEntities2) +
"<p> selectByExampleAndRowBounds:" + JSON.toJSONString(userEntities3) +
"<p> selectByExampleAndRowBounds:" + JSON.toJSONString(userEntities4);
}
BaseCRUDManager使用代码示例
@Controller
public class TestController{
@Autowired
private TestManager testManager;
@Autowired
private BaseCRUDManager baseCRUDManager;
/**
* 首页
*/
@RequestMapping("/testDate")
@ResponseBody
public String testDate(){
UserEntity insert = baseCRUDManager.insert(UserEntity.builder().loginName("111").build());
UserEntity insertSelective = baseCRUDManager.insertSelective(UserEntity.builder().loginName("222").build());
List<UserEntity> userEntities1 = baseCRUDManager.selectAll(UserEntity.class);
boolean b = baseCRUDManager.updateByPrimaryKey(UserEntity.builder().id(1L).mobile("1111").build());
boolean b1 = baseCRUDManager.updateByPrimaryKeySelective(UserEntity.builder().id(2L).mobile("1111").build());
UserEntity userEntity = baseCRUDManager.selectOne(UserEntity.builder().id(1L).mobile("1111").build());
UserEntity userEntity1 = baseCRUDManager.selectByPrimaryKey(UserEntity.builder().id(8L).mobile("1111").build());
List<UserEntity> select = baseCRUDManager.select(UserEntity.builder().mobile("1111").build());
int i = baseCRUDManager.selectCount(UserEntity.builder().build());
int sss = baseCRUDManager.delete(UserEntity.builder().realName("sss").build());
int i1 = baseCRUDManager.deleteByPrimaryKey(UserEntity.builder().id(5L).loginName("222").build());
boolean b2 = baseCRUDManager.existsByPrimaryKey(UserEntity.builder().id(1L).build());
boolean b3 = baseCRUDManager.existsByPrimaryKey(UserEntity.builder().id(222L).build());
UserEntity user = new UserEntity();
user.setCurrentPage(1);
user.setPageSize(5);
LinkedHashMap<String, String> ordermap = new LinkedHashMap<>();
ordermap.put("id",BaseModel.ASC);
user.setOrderBy(ordermap);
PageResultCommand<UserEntity> search = baseCRUDManager.search(user);
PageResultCommand<UserEntity> search3 = baseCRUDManager.search(user, 1, 5, ordermap);
return "success";
}
}
AC.Table支持的共通类BaseCRUDManager的CUDR方法接口文档如下
/**
* 根据实体对象的非Null字段作为Where条件查询结果集,如果对象的属性值都为null则返回全部数据等同于selectAll
* @param t 实体对象
* @param <T> 实体对象类型
* @return List实体对象列表
* @version 支持版本1.1.0.RELEASE
*/
<T> List<T> select(T t);
/**
* 根据实体对象的@IsKey主键字段的值作为Where条件查询结果,主键字段不能为null
* @param t 实体对象(只设置主键值即可,其他字段值不会读取)
* @param <T> 实体对象类型
* @return 实体对象
* @version 支持版本1.1.0.RELEASE
*/
<T> T selectByPrimaryKey(T t);
/**
* 查询表全部数据
* @param clasz 实体对象的class
* @param <T> 实体对象类型
* @return List实体对象列表
* @version 支持版本1.1.0.RELEASE
*/
<T> List<T> selectAll(Class<T> clasz);
/**
* 根据实体对象的非Null字段作为Where条件查询结果集的Count,如果对象的属性值都为null则Count全表
* @param t 实体对象
* @param <T> 实体对象类型
* @return 结果数量
* @version 支持版本1.1.0.RELEASE
*/
<T> int selectCount(T t);
/**
* 根据实体对象的非Null字段作为Where条件查询结果集,如果对象的属性值都为null则返回结果集的第一条使用的limit 1
* @param t 实体对象
* @param <T> 实体对象类型
* @return 实体对象
* @version 支持版本1.1.0.RELEASE
*/
<T> T selectOne(T t);
/**
* 根据实体对象的非Null字段作为Where条件进行删除操作,如果对象的属性值都为null则删除表全部数据
* @param t 实体对象
* @param <T> 实体对象类型
* @return 返回成功条数
* @version 支持版本1.1.0.RELEASE
*/
<T> int delete(T t);
/**
* 根据实体对象的@IsKey主键字段的值作为Where条件进行删除操作,主键字段不能为null
* @param t 实体对象(只设置主键值即可,其他字段值不会读取)
* @param <T> 实体对象类型
* @return 返回成功条数
* @version 支持版本1.1.0.RELEASE
*/
<T> int deleteByPrimaryKey(T t);
/**
* 根据实体对象的@IsKey主键字段的值作为Where条件查询该数据是否存在,主键字段不能为null
* @param t 实体对象(只设置主键值即可,其他字段值不会读取)
* @param <T> 实体对象类型
* @return true存在,fasle不存在
* @version 支持版本1.1.0.RELEASE
*/
<T> boolean existsByPrimaryKey(T t);
/**
* 根据实体对象保存一条数据,主键如果没有设置自增属性则必须不能为null
* @param t 实体对象
* @param <T> 实体对象类型
* @return 实体对象
* @version 支持版本1.1.0.RELEASE
*/
<T> T insert(T t);
/**
* 根据实体对象保存一条数据,如果属性值为null则不插入默认使用数据库的字段默认值,主键如果没有设置自增属性则必须不能为null
* @param t 实体对象
* @param <T> 实体对象类型
* @return 实体对象
* @version 支持版本1.1.0.RELEASE
*/
<T> T insertSelective(T t);
/**
* 根据实体对象主键作为Where条件更新其他字段数据,主键必须不能为null
* @param t 实体对象
* @param <T> 实体对象类型
* @return 更新结果
* @version 支持版本1.1.0.RELEASE
*/
<T> boolean updateByPrimaryKey(T t);
/**
* 根据实体对象主键作为Where条件更新其他字段数据,如果其他字段属性值为null则忽略更新,主键必须不能为null
* @param t 实体对象
* @param <T> 实体对象类型
* @return 更新结果
* @version 支持版本1.1.0.RELEASE
*/
<T> boolean updateByPrimaryKeySelective(T t);
/**
* 直接根据sql查询数据,并根据指定的对象类型转化后返回
*
* @param sql 动态sql
* @param beanClass 返回list对象类型
* @param <T> 实体对象类型
* @return list的实体对象类型
* @version 支持版本1.1.0.RELEASE
*/
<T> List<T> query(String sql, Class<T> beanClass);
/**
* 直接根据sql查询返回数据
*
* @param sql 自定义的sql
* @return list map结构的数据
* @version 支持版本1.1.0.RELEASE
*/
List<LinkedHashMap<String, Object>> query(String sql);
/**
* 根据实体对象的非Null字段作为Where条件查询结果集,如果对象的属性值都为null则返回全部数据等同于selectAll+分页
*
* @param t 实体对象
* @param currentPage 分页参数查询第几页,默认1
* @param pageSize 分页参数每页显示的条数,默认10
* @param orderby 分页使用的排序,有序的Map结构{key(要排序的字段名),value(desc/asc)}
* @param <T> 实体类型
* @return PageResultCommand分页对象类型
* @version 支持版本1.1.1.RELEASE
*/
<T> PageResultCommand<T> search(T t, Integer currentPage, Integer pageSize,LinkedHashMap<String,String> orderby);
/**
* 根据实体对象的非Null字段作为Where条件查询结果集,如果对象的属性值都为null则返回全部数据等同于selectAll+分页
* @param t 实体对象
* @param <T> 实体对象类型
* @return PageResultCommand分页对象类型
* @version 支持版本1.1.1.RELEASE
*/
<T> PageResultCommand<T> search(T t);
######### mybatis增加功能自动创建表——A.C.Table版本说明################
-
该版本修复了修改主键同时修改其类型引起的error(版本1.0.1)
-
该版本修复了根据model创建时没有创建父类中的字段的问题(ps:目前只支持扫描一层继承)(版本1.0.1)
-
该版本增加了对唯一约束的支持(版本1.0.1)
-
从原有的框架中剥离出来,支持任意结构的spring+mybatis的框架使用(版本1.0.1)
-
再次声明A.C.Table目前仅支持mysql数据库(版本1.0.1)
-
修复了不同数据库中有相同表名时,启动报错的问题。(版本1.0.2)
-
修复了model属性名与表字段名不一致时公共的查询方法查不出数据的问题。(版本1.0.2)
-
增加了对公共的CUDR方法的优化,保存成功会返回id,query查询时可以设置参数进行分页查询(pageSize:int类型标识每页数量,currentPage:int类型标识当前第几页,start:int类型从第几条开始,orderField:string类型排序字段,sortStr:string类型排序方式(desc,asc))(版本1.0.3)
-
增加了对Mysql的longtext和mediumtext两种字段类型的支持,公共的CUDR方法的优化,原query方法更正为search,现query方法支持动态sql查询,原orderField字段只支持单个字段的排序,现修改为orderBy字段,支持数据类型为LinkedHashMap<String, String>,有序,key为字段名,value为排序方式(版本1.0.4)
-
增加对mysql数据库(timestamp/time/date/float/bit)五种数据类型的支持(版本1.0.5)
-
增加对springboot框架的支持(版本1.0.5)
-
删除旧版本在@Colum中实现唯一约束的方式(版本1.0.6.RELEASE)
-
增加了新的唯一约束实现方式@Unique,支持多字段聚合约束(版本1.0.6.RELEASE)
-
增加了索引创建方式@Index,支持多字段聚合索引(版本1.0.6.RELEASE)
-
修复query查询方法无法返回父类字段数据的bug(版本1.0.6.RELEASE)
-
修复原本是主键,现在依然主键,修改该字段的其他信息时会报multiple primary key defined(例如id为int(11),改为int(10)后,就可重现次bug)(版本1.0.7.RELEASE)
-
增加对字段备注的支持,使用方式@Column的comment属性(版本1.0.7.RELEASE)
-
修复issues/IZ6WQ:bit类型的默认值设置失败,默认值可以使用0、1、true、false(版本1.0.8.1.RELEASE)
-
修复issues/IYTJ1:使用@Unique进行联合约束,启动项目自动创建表结构后,删除联合约束报错(版本1.0.8.1.RELEASE)
-
迭代issues/IYW9F:mybatis.model.pack支持多包扫描","或者";"隔开(版本1.0.8.1.RELEASE)
-
修复issues/I160LP:drop拼写的问题(版本1.0.9.RELEASE)
-
优化issues/I1IENW:@Index,@Unique创建索引和唯一约束的实现逻辑,默认会给索引名和约束名增加前缀actable_idx_和actable_uni_方便更新删除时只针对这两个前缀的进行删除更新,避免删掉手动创建的字段的索引约束 (版本1.0.9.RELEASE)
-
修复issues/I16OZQ::@Index,@Unique在只设置了索引名称没有设置索引字段时,报错的bug,并且原有name改为value,原有value改为columns(版本1.0.9.RELEASE)
-
迭代issues/I1IF5E:增加对tinyint/smallint/mediumint/year/blob/longblob/mediumblob/tinytext/tinyblob/binary字段类型的支持 (版本1.0.9.RELEASE)
-
迭代issues/I1IF5Q:框架模式新增add模式,本模式下只具备,新增表/新增字段/新增索引/新增唯一约束的功能,不会做修改和删除 (版本1.0.9.RELEASE)
-
迭代issues/I193FC:@Column的name属性改为非必填,不填默认使用属性名作为表字段名 (版本1.0.9.RELEASE)
-
迭代issues/I193FC:@Column的type属性改为非必填,不填默认使用属性的数据类型进行转换,转换失败的字段不会添加 (版本1.0.9.RELEASE)
支持java类型转mysql类型如下:
java.lang.String java.lang.Long java.lang.Integer java.lang.Boolean java.math.BigInteger java.lang.Float java.lang.Double java.math.BigDecimal java.sql.Date java.util.Date java.sql.Timestamp java.sql.Time
本次迭代至1.0.9.RELEASE,极大的简化了注解的使用复杂度,在保留原有复杂的自定义配置能力的同时,增加了更多的默认适配能力 也就是对于@Column标签如果对字段命名等没有任何要求的情况下,直接使用标签即可,无需配置类型等参数,会默认根据上面支持的类型去进行匹配转换
-
迭代issues/I1ILS6:@IsKey/@IsAutoIncrement/@IsNotNull用来代替 @Column中的isKey/isAutoIncrement/isNull三个属性,当然旧的配置方式仍然是支持的 (版本1.0.9.RELEASE)
-
紧急修复1.0.9.RELEASE版本CUDR的bug,请不要使用1.0.9.RELEASE版本(版本1.0.9.1.RELEASE)
-
迭代issues/I1IVXK:BaseMysqlCRUDManager该工具类废弃,请勿使用,新增工具类BaseCRUDManager,新的insert接口取消了对主键的integer类型的限定,主键可以自由使用类型(版本1.1.0.RELEASE)
新增工具类BaseCRUDManager的方法列表如下,详细接口文档见文档结尾部分:
<T> List<T> select(T t); <T> T selectByPrimaryKey(T t); <T> List<T> selectAll(Class<T> clasz); <T> int selectCount(T t); <T> T selectOne(T t); <T> int delete(T t); <T> int deleteByPrimaryKey(T t); <T> boolean existsByPrimaryKey(T t); <T> T insert(T t); <T> T insertSelective(T t); <T> boolean updateByPrimaryKey(T t); <T> boolean updateByPrimaryKeySelective(T t); <T> List<T> query(String sql, Class<T> beanClass); List<LinkedHashMap<String, Object>> query(String sql);
-
迭代issues/I1JC91:工具类BaseCRUDManager新增对分页查询的支持,新增两个search接口一个实体中包含分页字段,一个通过方法参数传递分页字段(版本1.1.1.RELEASE)
新增工具类BaseCRUDManager的方法列表如下,详细接口文档见文档结尾部分:
<T> PageResultCommand<T> search(T t, Integer currentPage, Integer pageSize,LinkedHashMap<String,String> orderby); <T> PageResultCommand<T> search(T t);
-
建表的字段时如果@Column没有设置字段名,那么默认会读属性的名字,根据驼峰转换逻辑,进行转换例如loginName会转换为login_name作为字段名,如果没有驼峰也就是全是小写字母,那么直接作为字段名,如果设置了Column(name="LOGIN_NAME")那么默认创建的字段会转换为小写,也就是login_name,所以字段名都会强制转换为小写(版本1.2.0.RELEASE,该版本对于之前建表字段名使用大写的项目不向下兼容,要升级至此版本需谨慎)
-
修复索引约束创建完成后,修改字段名的情况下报错的bug(版本1.2.0.RELEASE,该版本对于之前建表字段名使用大写的项目不向下兼容,要升级至此版本需谨慎)
-
为了防止配置信息引起歧义(版本1.2.0.RELEASE,该版本对于之前建表字段名使用大写的项目不向下兼容,要升级至此版本需谨慎)
mybatis.table.auto 变为 actable.table.auto mybatis.model.pack 变为 actable.model.pack mybatis.database.type 变为 actable.database.type
-
修复建表时没有读取继承类中的字段信息的问题(版本1.2.0.RELEASE,该版本对于之前建表字段名使用大写的项目不向下兼容,要升级至此版本需谨慎)
-
迭代issues/I1LUAZ:修复实体对象字段有多个大写,转换为列名时,只转换了第一个下划线,提供对@Table标签的驼峰转换的支持,不填表名默认使用类名驼峰转换(版本1.2.1.RELEASE)
-
支持使用javax.persistence的Column/Table/Id等注解生成及更新表(版本1.3.0.RELEASE)
javax.persistence.Column = com.gitee.sunchenbin.mybatis.actable.annotation.Column javax.persistence.Column.name = com.gitee.sunchenbin.mybatis.actable.annotation.Column.name javax.persistence.Column.length = com.gitee.sunchenbin.mybatis.actable.annotation.Column.length javax.persistence.Column.scale = com.gitee.sunchenbin.mybatis.actable.annotation.Column.decimalLength javax.persistence.Table = com.gitee.sunchenbin.mybatis.actable.annotation.Table javax.persistence.Id = com.gitee.sunchenbin.mybatis.actable.annotation.IsKey
-
引入对tk.mybatis的支持,方便更灵活的CUDR,仅限于使用javax.persistence包的Column/Table/Id等注解时生效,如使用actable的注解则只支持BaseCRUDManager(版本1.3.0.RELEASE)
-
增加对json数据类型的支持(版本1.3.0.RELEASE)
-
增加注解@ColumnComment字段注释,用来替代@Column中的comment(版本1.3.0.RELEASE)
-
增加注解@DefaultValue字段默认值,用来替代@Column中的defaultValue(版本1.3.0.RELEASE)
-
增加注解@ColumnType字段类型,用来替代@Column中的type,取值范围MySqlTypeConstant中的枚举(版本1.3.0.RELEASE)
-
增加注解@TableComment用来配置表的注释,可用来替代@Table的comment(版本1.3.0.RELEASE)
-
迭代issues/I24UU4:增加注解@TableCharset用来配置表的字符集,可用来替代@Table的charset,取值范围MySqlCharsetConstant中的枚举(版本1.3.1.RELEASE)
-
增加注解@TableEngine用来配置表的注释,可用来替代@Table的engine,取值范围MySqlEngineConstant中的枚举(版本1.3.1.RELEASE)
-
删除默认依赖tk.mybatis的pom配置,避免跟其他框架冲突,如需使用自行依赖即可,只要依赖tk.mybatis的pom,actable可以完全兼容使用(版本1.3.2.RELEASE)
-
修复bug,当设置bit类型的默认值时,启动时会一直日志输出修改改字段的日志记录(版本1.4.0.RELEASE,该版本不向下兼容需修改少量代码,谨慎升级)
-
修复bug,当使用默认的字段类型时,可以通过@Column的length和decimalLength来配置长度(版本1.4.0.RELEASE,该版本不向下兼容需修改少量代码,谨慎升级)
-
@ColumnType增加length和decimalLength两个属性用来配置该类型的长度(版本1.4.0.RELEASE,该版本不向下兼容需修改少量代码,谨慎升级)
-
优化注解@Column的type字段以及注解@ColumnType的value字段,类型从String改为枚举类型,枚举类为MySqlTypeConstant(版本1.4.0.RELEASE,该版本不向下兼容需修改少量代码,谨慎升级)
-
优化注解@TableCharset的value和@TableEngine的value字段类型从String改为枚举类型,枚举类为MySqlCharsetConstant和MySqlEngineConstant(版本1.4.0.RELEASE,该版本不向下兼容需修改少量代码,谨慎升级)
-
修复bug,当id使用Long类型时,采用BaseCRUDManagerImpl中的保存和更新方法时报错的问题(版本1.4.0.RELEASE,该版本不向下兼容需修改少量代码,谨慎升级)
-
优化引入对mybatis-plus的支持,方便更灵活的CUDR,支持@TableName/@TableField/@TableId三个注解(版本1.4.0.RELEASE,该版本不向下兼容需修改少量代码,谨慎升级)
-
移除@LengthCount和@LengthDefault两个注解(版本1.4.0.RELEASE,该版本不向下兼容需修改少量代码,谨慎升级)
-
issues/I28XQY:新增java默认转换LocalDateTime/LocalDate/LocalTime数据类型的支持(版本1.4.1.RELEASE)
-
修正DOUBLE和FLOAT支持设置小数长度(版本1.4.1.RELEASE)
-
Table标签新增属性isSimple表示是否开启简单的配置模式,如果开启,实体的属性可以不打@Column的标签全部按照默认规则驼峰转换创建字段,默认为false不开启(版本1.4.1.RELEASE)
-
Table标签新增属性excludeFields用来标记排除属性名,排除掉的属性不参与建表(版本1.4.1.RELEASE)