您现在的位置是:首页 > 文章详情

FlexSQL 安卓版,无需写 SQL 语句的 ORM,自动同步表结构

日期:2025-08-20点击:25

FlexSQL For Android

1.引入Gradle依赖

implementation 'cn.vonce:flexsql-android:1.7.0'
annotationProcessor 'cn.vonce:flexsql-android:1.7.0'

2.标注实体类

//实体类基类
@Data
public class BaseEntity {

    @SqlId(type = IdType.SNOWFLAKE_ID_16)
    @SqlColumn(notNull = true, remarks = "唯一id")//字段不能为null,表字段注释
    private Long id;

    @SqlColumn(remarks = "创建者")//表字段注释
    private Long creator;

    @SqlDefaultValue(with = FillWith.INSERT)
    @SqlColumn(remarks = "创建时间")//表字段注释
    private Date createTime;

    @SqlColumn(remarks = "更新者")//表字段注释
    private Long updater;

    @SqlDefaultValue(with = FillWith.UPDATE)
    @SqlColumn(remarks = "更新时间")//表字段注释
    private Date updateTime;

    @SqlLogically
    @SqlColumn(remarks = "是否删除(0正常 1删除)")//表字段注释
    private Boolean deleted;

}

//构建项目(Rebuild Project)后会根据实体类生成字段常量,例如User类生成的常量类是User$,例如获取id字段是User$.id$
@Data
//autoAlter设置为true,实体类有变动时自动同步表结构
@SqlTable(autoAlter = true, value = "t_user", remarks = "用户")
public class User extends BaseEntity {

    @SqlColumn(notNull = true, remarks = "用户名")//字段不能为null,表字段注释
    private String userName;

    @SqlColumn(remarks = "姓名")//表字段注释
    private String nickName;

    @SqlColumn(notNull = true, remarks = "手机号码")//表字段注释
    private String mobilePhone;

    @SqlColumn(notNull = true, remarks = "密码")//表字段注释
    private String password;

    @SqlColumn(notNull = true, remarks = "性别")//表字段注释
    private Integer gender;

    @SqlColumn(remarks = "年龄")//表字段注释
    private Integer age;

    @SqlColumn(remarks = "电子邮箱")//表字段注释
    private String email;

    @SqlColumn(remarks = "头像", oldName = "head_portrait")//表字段注释,修改表字段名称需要在oldName指定旧的名称
    private String avatar;

    @SqlDefaultValue(with = FillWith.INSERT)
    @SqlColumn(notNull = true, remarks = "状态(0正常 1停用)")//字段不能为null,表字段注释
    private UserStatus status;

}
 

3.获取连接(建议在上一步把所有表字段关系建立好,第一次获取连接时会自动创建表结构)

public class MainActivity extends AppCompatActivity {

    private SqlBeanHelper<Essay, String> essaySqlBeanHelper;
    //private SqlBeanHelper<User, String> userSqlBeanHelper;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        //方式一,单库模式
        SQLiteHelper.init(this, "testdb", 1);//建议放在MainActivity或继承的Application
        essaySqlBeanHelper = SQLiteHelper.db().get(Essay.class);

        //方式二,多库模式
        //essaySqlBeanHelper = SQLiteHelper.db(this, "testdb1", 1).get(Essay.class);
        //userSqlBeanHelper = SQLiteHelper.db(this, "testdb2", 1).get(User.class);

    }
}
 

4.CRUD操作


public class MainActivity extends AppCompatActivity {

    private SqlBeanHelper<Essay, String> sqlBeanHelper;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        SQLiteHelper.init(this, "testdb", 1);
        sqlBeanHelper = SQLiteHelper.db().get(Essay.class);

    }

    //查询
    public void select() {
        //查询列表
        List<User> list = userService.select();
        list = sqlBeanHelper.selectBy(Wrapper.where(Cond.gt(User$.id$, 10)).and(Cond.lt(User$.id$, 20)));
        //指定查询
        list = sqlBeanHelper.select(new Select().column(User$.id$, User$.user_name$, User$.mobile_phone$).where().gt(User$.id$, 10));

        //查询一条
        User user = sqlBeanHelper.selectById(1L);
        user = sqlBeanHelper.selectOneBy(Wrapper.where(eq(User$.id$, 1001)));

        //sql语义化查询《20岁且是女性的用户根据创建时间倒序,获取前10条》
        list = sqlBeanHelper.select(new Select().column(User$.id$, User$.user_name$, User$.mobile_phone$).where().eq(User$.age$, 20).and().eq(User$.gender$, 0).back().orderByDesc(User$.create_time$).page(0, 10));

        //联表查询《广州或深圳的18岁的女性用户,根据创建时间倒序,查询前10条用户的信息和地址》
        Select select = new Select();
        select.column(User$.id$, User$.user_name$, User$.mobile_phone$, UserAddress$.province$, UserAddress$.city$, UserAddress$.area$, UserAddress$.details$);
        select.innerJoin(UserAddress.class).on().eq(UserAddress$.id$, User$.id$);
        select.where().eq(User$.age$, 18).and().eq(User$.gender$, 0).and(condition -> condition.eq(UserAddress$.city$, "广州").or().eq(UserAddress$.city$, "深圳"));
        select.orderByDesc(User$.create_time$);
        select.page(0, 10);

        //查询Map
        Map<String, Object> map = sqlBeanHelper.selectMap(select);
        List<Map<String, Object>> mapList = sqlBeanHelper.selectMapList(select);
    }

    //分页
    public void getPageList() {
        // 查询对象
        Select select = new Select();
        PageHelper<User> pageHelper = new PageHelper<>(0, 10);
        pageHelper.paging(select, sqlBeanHelper);
        ResultData<List<Essay>> data = pageHelper.getResultData();
    }

    //统计(函数使用)
    public void getStatistics() {
        Select select = new Select();
        select.column(SqlFun.count(User$.id$), "count").column(SqlFun.avg(User$.age$));
        select.where().gt(SqlFun.date_format(User$.create_time$, "%Y-%m-%d"), "2024-06-24");
        select.groupBy(User$.gender$);
        select.orderByDesc("count");
        List<Map<String, Object>> mapList = sqlBeanHelper.selectMapList(select);
    }

    //更新
    public void update(Essay essay) {
        //根据bean内部id更新
        long i = sqlBeanHelper.updateByBeanId(essay);
        //根据外部id更新
        //i = sqlBeanHelper.updateById(essay, 20);
        //根据条件更新
        //i = sqlBeanHelper.update(new Update<User>().set(User$.gender$, 1).set(User$.name$, "Jovi").setAdd(User$.age$, User$.age$, 1).where().eq(User$.id$, 111).back());
    }

    //删除
    public void deleteById(String[] id) {
        //根据id删除
        long i = sqlBeanHelper.deleteById(id);
        //根据条件删除
        //i = sqlBeanHelper.deleteBy(Wrapper.where(gt(User$.age$, 22)).and(eq(User$.gender$, 1)));
    }

    //插入
    public void add() {
        List<Essay> essayList = new ArrayList<>();
        for (int i = 0; i < 100; i++) {
            Essay essay = new Essay(i, "name" + i);
            essayList.add(essay);
        }
        sqlBeanHelper.insert(essayList);
    }

}
原文链接:https://www.oschina.net/news/367338
关注公众号

低调大师中文资讯倾力打造互联网数据资讯、行业资源、电子商务、移动互联网、网络营销平台。

持续更新报道IT业界、互联网、市场资讯、驱动更新,是最及时权威的产业资讯及硬件资讯报道平台。

转载内容版权归作者及来源网站所有,本站原创内容转载请注明来源。

文章评论

共有0条评论来说两句吧...

文章二维码

扫描即可查看该文章

点击排行

推荐阅读

最新文章