登录 立即注册
安币:

安卓巴士 - 安卓开发 - Android开发 - 安卓 - 移动互联网门户

XOrmlite 一个方便实用的OrmLite数据库框架,支持一键集成

[复制链接]
来自: xuexiangjys 分类: Android精品源码 上传时间: 2018-5-11 00:00:59
Tag:
立即下载
收藏

项目介绍:

XOrmlite

xormlite api

一个方便实用的OrmLite数据库框架,支持一键集成。

关于我

github csdn

特征

  • 支持通过@DataBase进行数据库配置。

  • 支持自动生成数据库管理仓库DataBaseRepository

  • 支持内部存储和外部存储两种数据库。

  • 支持自定义数据库存储位置。

  • 支持自定义数据库打开、升级以及降级的接口。

  • 支持事务操作、回滚等。

  • 提供了常用的数据库操作API。

1、演示(请star支持)

2、如何使用

目前支持主流开发工具AndroidStudio的使用,直接配置build.gradle,增加依赖即可.

2.1、Android Studio导入方法,添加Gradle依赖

1.先在项目根目录的 build.gradle 的 repositories 添加:

allprojects {
     repositories {
        ...
        maven { url "https://jitpack.io" }
    }
}

2.然后在dependencies添加:

dependencies {
  ...
  implementation 'com.github.xuexiangjys.XOrmlite:xormlite-runtime:1.0.0'
  annotationProcessor 'com.github.xuexiangjys.XOrmlite:xormlite-compiler:1.0.0'
}

2.2、数据库注册配置

1.使用@DataBase进行数据库注册配置。属性如下:

  • name :数据库的名称,必填。

  • version :数据库的版本, 默认版本为1

  • type :数据库的存放类型,默认是内部存储DataBaseType.INTERNAL

  • path :数据库存放的路径,只对外部存储的数据库起作用,默认的地址为:/storage/emulated/0/Android/xormlite/databases/

【注意】@DataBase必须注册在Application类上才起作用。

@DataBase(name = "external", type = DataBaseType.EXTERNAL, path = "/storage/emulated/0/xormlite/databases")
public class ExternalApp extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
    }
}

2.使用@DataBase注册完后,请编译一下项目:build -> Rebuild Project,之后会自动生成数据库管理仓库: 数据库名 + DataBaseRepository 的Java文件。文件的生成路径如下:

例如上面我们注册的数据库名为:external,自动生成的数据库管理仓库为 ExternalDataBaseRepository。

3.初始化数据库管理仓库,设置数据库实现接口。

  • 内部存储的数据库需要需要实现IDatabase接口。

  • 外部存储的数据库需要需要实现IExternalDataBase接口。

@DataBase(name = "internal", type = DataBaseType.INTERNAL)
public class App extends Application {
    @Override
    public void onCreate() {
        super.onCreate();

        InternalDataBaseRepository.getInstance()
                .setIDatabase(new InternalDataBase())  //设置内部存储的数据库实现接口
                .init(this);

        ExternalDataBaseRepository.getInstance()
                .setIDatabase(new ExternalDataBase(  //设置外部存储的数据库实现接口
                        ExternalDataBaseRepository.DATABASE_PATH,
                        ExternalDataBaseRepository.DATABASE_NAME,
                        ExternalDataBaseRepository.DATABASE_VERSION))
                .init(this);
    }
}

2.3、数据库服务获取

数据库管理仓库DataBaseRepository提供了获取数据库操作服务的API getDataBase, 传入标有@DatabaseTable的数据库实体类Class, 获取对应的数据库操作服务DBService

DBService<Student> mDBService = InternalDataBaseRepository.getInstance().getDataBase(Student.class);

2.4、数据库操作

DBService提供了丰富的数据库操作API,详细API请点击参见

以下简要介绍一部分API:

插入

  • insert: 插入单条数据。

  • insertData: 插入单条数据(返回被插入的对象)。

  • insertDatas: 批量添加,返回插入数据的数量。

查询

  • queryAll: 查询所有的数据。

  • queryAllOrderBy: 查询所有的数据并根据列名进行排序,返回一个对象集合。

  • queryAndOrderBy: 有条件的排序查询,返回一个对象集合。

  • queryById: 根据id查询出一条数据。

  • queryByField: 根据条件查询,返回一个对象集合。

  • queryByColumn: 根据条件查询,返回一个对象集合。

  • queryForColumnFirst: 根据条件查询,返回第一个符合条件的对象。

  • indistinctQueryForColumn: 根据条件模糊查询,返回一个对象集合。

  • queryDataBySql: 根据sql语句查询,返回对象的集合。

更新

  • updateData: 使用对象更新一条记录(注意:对象必须带唯一标识ID,且该方法不能更新ID字段)。

  • updateDataByColumn: 根据某一或多个条件更新对象。

  • updateDataBySQL: 根据条件做update时直接使用sql语句进行更新,sql语句中必须包含关键字【INSERT,DELETE,UPDATE】。

删除

  • deleteData: 根据对象删除一条记录(注意:对象必须带唯一标识ID,否则方法不起作用)。

  • deleteDatas: 批量删除(注意:对象必须带唯一标识ID,否则方法不起作用)【大数据量的删除不起左右,会报too many SQL variables错误】。

  • deleteAll: 删除所有数据。

  • deleteById: 根据id删除一条记录。

其他

  • executeSql: 执行sql语句。

  • getQueryBuilder: 返回QueryBuilder。

  • getUpdateBuilder: 返回UpdateBuilder。

  • getDeleteBuilder: 返回DeleteBuilder。

事务操作

  • doInTransaction: 执行事务操作。

  • beginTransaction: 开启数据库事务操作。

  • commit: 提交事务。

  • rollBack: 事务回滚。

2.5、数据库操作示例

1.插入单条数据

Student student = new Student();
student.setUserName("xuexiang");
student.setSex("男");
student.setAge((int) (Math.random() * 100));

try {
    mDBService.insert(student);
} catch (SQLException e) {
    e.printStackTrace();
}

2.更新数据库某一字段

try {
    mDBService.updateDataByColumn("username", "xxxx", "username", "xuexiang");
} catch (SQLException e1) {
    e1.printStackTrace();
}

3.执行事务插入

try {
    mDBService.doInTransaction(new Callable<Boolean>() {
        @Override
        public Boolean call() throws Exception {
            for (int i = 0; i < mTempList.size(); i++) {
                mDBService.insert(mTempList.get(i));
            }
            return true;
        }
    });
} catch (SQLException e) {
    e.printStackTrace();
    ToastUtils.toast("事务执行失败!");
}

4.执行事务删除

try {
    mDBService.doInTransaction(new Callable<Boolean>() {
        @Override
        public Boolean call() throws Exception {
            for (int i = 0; i < mTempList.size(); i++) {
                mDBService.deleteData(mTempList.get(i));
            }
            return true;
        }
    });
    mStudentAdapter.updateList(mDBService.queryAll());
} catch (SQLException e) {
    e.printStackTrace();
    ToastUtils.toast("事务执行失败!");
}

联系方式

相关源码推荐:

我来说两句
所有评论(34)
乱世佳人520 2018-5-11 10:36:20
安卓巴士是个不错的网站,我来顶个贴~
回复
ILI 2018-5-11 10:54:21
感谢分享,安卓巴士有你更精彩:lol
回复
mpl 2018-5-11 10:59:56
学习学习!
回复
apkbus热心网友 2018-5-11 11:14:23
精华内容,楼主V5!
回复
bug是啥 2018-5-11 11:15:22
楼主是好人,回个帖会有安币吗?
回复
belle 2018-5-11 11:23:22
每次我都积极回帖的,想要安币~
回复
yukong 2018-5-11 11:32:42
感谢大神~
回复
12345下一页
上传代码
查看数:579 收藏数:10 下载数:11 点赞数:0
状态:已购或VIP 售价:15(原价:15)金钱 下载权限:初级码农 
代码贡献英雄榜
用户名 下载数
联系我们
首页/微信公众账号投稿

帖子代码编辑/版权问题

QQ:435399051,769657487

如何获得代码达人称号

如何成为签约作者

联系我们
关闭
合作电话:
13802416937
Email:
435399051@qq.com
商务市场合作/投稿
问题反馈及帮助
联系我们

广告投放| 下载客户端|申请友链|手机版|站点统计|安卓巴士 ( 粤ICP备15117877号 )

快速回复 返回顶部 返回列表