Android之xUtils3.0數據庫框架詳解

NO IMAGE

在Android 開發中,數據庫模塊是必不可少的.現在也有許多非常好用流行的數據庫快速開發框架.今天主要介紹下xUtils下封裝的數據庫模塊.

Android 常用數據庫開發框架

在這裡列一下Android開發中常用的數據庫框架,有情趣的可以自行了解下,順便儲備點知識.

1.OrmLite
對象關係映射Lite(ORM Lite)提供了一些簡單,輕量級的功能,用於將Java對象持久保存到SQL數據庫,同時避免了更多標準ORM包的複雜性和開銷。

2.LitePal
LitePal是一個開源的Android庫,允許開發人員非常容易地使用SQLite數據庫。您可以完成大部分數據庫操作,而無需編寫SQL語句,包括創建或升級表,crud操作,聚合函數等.LitePal的設置也非常簡單,您可以在不到5分鐘中將其集成到項目中。

3.GreenDao
greenDAO是一款輕巧快捷的Android版ORM,可將對象映射到SQLite數據庫。greenDAO針對Android進行了高度優化,性能卓越,佔用內存極少。

4.DBFlow
一個功能強大,功能強大且非常簡單的ORM android數據庫庫,帶有註釋處理功能。
該庫建立在速度,性能和可接近性的基礎之上。它不僅消除了大多數用於處理數據庫的樣板代碼,而且還提供了一個強大而簡單的API來管理交互。

5.Realm
Realm是一個直接在手機,平板電腦或可穿戴設備中運行的移動數據庫。此存儲庫包含Realm的Java版本的源代碼,該版本目前僅在Android上運行。


xutils3.0數據庫模塊詳解

項目加載

1.添加依賴
在app的build.gradle下添加以下依賴:

compile 'org.xutils:xutils:3.5.0'

對於gradle3.0以上,compile已經被廢棄了,需要使用api
如下:

api 'org.xutils:xutils:3.5.0'

2.配置權限
在AndroidManifest中添加權限:

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>

3.初始化
在application的onCreate中初始化:

@Override
public void onCreate() {
    super.onCreate();
    x.Ext.init(this);
    x.Ext.setDebug(BuildConfig.DEBUG); // 是否輸出debug日誌, 開啟debug會影響性能.
    ...
}

以上就是xutils3.0的使用配置了,配置好並且初始化好下面我們就可以愉快的使用了

xutils-DB使用

1.創建數據庫幫助類:DatabaseOpenHelper


/**
 * 數據庫幫助類
 * Created by darryrzhong on 2018/9/23.
 */

public class DatabaseOpenHelper {
  private DbManager.DaoConfig daoConfig;
  private static DbManager dbManager;
  private final String DB_NAME="history.db";//數據庫名
  private final int VERSION = 1;


  private DatabaseOpenHelper(){
      //初始化數據庫配置信息
      daoConfig = new DbManager.DaoConfig()
              .setDbName(DB_NAME)//設置數據庫名稱
              .setDbVersion(VERSION)//設置初始版本號
              .setDbOpenListener(new DbManager.DbOpenListener() {//監聽數據庫打開
                  @Override
                  public void onDbOpened(DbManager db) {
                     db.getDatabase().enableWriteAheadLogging();
                      //開啟WAL, 對寫入加速提升巨大(作者原話)
                  }
              })
              .setDbUpgradeListener(new DbManager.DbUpgradeListener() {//監聽數據庫更新
                  @Override
                  public void onUpgrade(DbManager db, int oldVersion, int newVersion) {

                  }
              });
      dbManager= x.getDb(daoConfig);//獲取數據庫管理類
  }

  //單例設計
  public static DbManager getInstance(){
     if (dbManager==null){
         DatabaseOpenHelper databaseOpenHelper = new DatabaseOpenHelper();
     }
     return dbManager;
  }
}

2.創建JavaBean數據實體類
先介紹下註解字段意思:

注意必須添加註解字段,否則數據庫無法識別,且實體類必須要有無參構造,否則數據庫可能創建不成功

@Table(name = "details") 表名

 @Column(name = "userid") 字段名

實體類如下:


/**
* 歷史記錄詳情表
* Created by darryrzhong on 2018/7/23.
*/
@Table(name = "details")//表名即實體類名
public class HistoryDetails {
@Column(name = "id",isId = true,autoGen = true)//主鍵,自增
private int id;
@Column(name = "userid")
private String userid;
@Column(name = "photo")
private String photo;//視頻封面
@Column(name = "title")
private String title;//視頻標題
@Column( name = "detail")
private String detail;//視頻分類and時長
@Column(name = "date")
private String date;//觀看日期
@Column(name = "desc")
private String desc;//視頻詳情
@Column(name = "blurred")
private String blurred;//模糊圖片
@Column(name = "video")
private String video;//視頻播放地址
@Column(name = "collect")
private int collect;//收藏量
@Column(name = "share")
private int share;//分享量
@Column(name = "reply")
private int reply;//回覆量
/**
* 無參數構造法不可私有化,否則數據庫表格創建異常
* 若使用無參構造,容易引起數據插入只有一條。
*/
public HistoryDetails(){
}
/**
*
* @param photo 視頻封面
* @param title 視頻標題
* @param detail 視頻分類And時間
*@param date 觀看日期
* @param desc 視頻詳情
*@param blurred 迷糊圖片
* @param video 視頻播放地址
* @param collect 收藏量
* @param share 分享量
* @param reply 回覆量
* */
public HistoryDetails(String photo, String title, String detail, String date, String desc, String blurred, String video, int collect, int share, int reply,String userid) {
this.photo = photo;
this.title = title;
this.detail = detail;
this.date = date;
this.desc = desc;
this.blurred = blurred;
this.video = video;
this.collect = collect;
this.share = share;
this.reply = reply;
this.userid = userid;
}
public String getPhoto() {
return photo;
}
public void setPhoto(String photo) {
this.photo = photo;
}
public String getTitle() {
return title;
}
public void setTitle(String title) {
this.title = title;
}
public String getDetail() {
return detail;
}
public void setDetail(String detail) {
this.detail = detail;
}
public String getDate() {
return date;
}
public void setDate(String date) {
this.date = date;
}
public String getDesc() {
return desc;
}
public void setDesc(String desc) {
this.desc = desc;
}
public String getBlurred() {
return blurred;
}
public void setBlurred(String blurred) {
this.blurred = blurred;
}
public String getVideo() {
return video;
}
public void setVideo(String video) {
this.video = video;
}
public int getCollect() {
return collect;
}
public void setCollect(int collect) {
this.collect = collect;
}
public int getShare() {
return share;
}
public void setShare(int share) {
this.share = share;
}
public int getReply() {
return reply;
}
public void setReply(int reply) {
this.reply = reply;
}
public String getUserid() {
return userid;
}
public void setUserid(String userid) {
this.userid = userid;
}
}

3.創建數據操作類

public class HistoryDB {
private DbManager dbManager;
private boolean succeed;//操作是否成功
boolean idDesc = true;//是否倒序,默認false
private List<HistoryDetails>  details =null;
private HistoryDetails historyDetails;
long count=0;
//初始化的DbManager對象
public HistoryDB(){
dbManager=DatabaseOpenHelper.getInstance();
}
/**
* 將HistoryDetails實例存進數據庫
* 保存新增
* @param historyDetails
*
*/
public void saveHistory(HistoryDetails historyDetails){
try {
dbManager.save(historyDetails);
} catch (DbException e) {
e.printStackTrace();
}
}
/**
* 新增或更新
*
* @param historyDetails
*/
public void saveOrUpdate(HistoryDetails historyDetails){
try {
dbManager.saveOrUpdate(historyDetails);
// Log.e("log","save succeed!");
} catch (DbException e) {
e.printStackTrace();
}
}
/**
* 讀取所有HistoryDetails信息
*
* @return
*/
public List<HistoryDetails> loadHistoryAll(){
try {
details=dbManager.selector(HistoryDetails.class).findAll();
} catch (DbException e) {
e.printStackTrace();
}
return details;
}
/**
* 根據視頻標題讀取HistoryDetails信息
*
* @return
*/
public List<HistoryDetails> loadHistoryByTitle(String title){
try {
details=dbManager.selector(HistoryDetails.class).where("title","==",title).findAll();
} catch (DbException e) {
e.printStackTrace();
}
return details;
}
/**
* 根據用戶id讀取HistoryDetails信息
*
* @return
*/
public List<HistoryDetails> loadHistoryByUserId(String userid){
try {
details=dbManager.selector(HistoryDetails.class).where("userid","==",userid).findAll();
} catch (DbException e) {
e.printStackTrace();
}
return details;
}
/**
* 刪除對象數據
*
*
* @return
*/
public boolean delete(HistoryDetails historyDetails){
try {
dbManager.delete(historyDetails);
succeed=true;
} catch (DbException e) {
succeed=false;
e.printStackTrace();
}
return succeed;
}
/**
* 刪除表
*
* @throws DbException
*/
private void delTable() throws  DbException{
dbManager.dropTable(HistoryDetails.class);
}
//關閉數據庫
public void close(){
try {
dbManager.close();
} catch (IOException e) {
e.printStackTrace();
}
}
}

4.使用數據庫

創建以上操作類,就可以愉快的快速使用數據庫了.

值得注意的是,xutils3並沒有提供單獨創建一張表的方法,他是在你調插入數據庫操作的時候會判斷是否存在這張表,如果不存在就會去創建,所以我們在取數據的時候需要判斷表是否存在

 db = new HistoryDB();
details= db.loadHistoryByUserId(sharedPreferences.getString("userId","000"));
if (details==null||details.size()==0){//如果表為空的話則為null,
tvHint.setVisibility(View.VISIBLE);
compile.setVisibility(View.GONE);
cleanHint.setVisibility(View.GONE);
}

還有一點值得注意就是,xutils插入數據庫時,相同數據是會重複插入的,
所以我們可以按自身需求去解決,例如我這裡保存視頻觀看記錄不需要重複插入數據.
所以我根據id判斷數據是否存在,不存在則插入數據庫保存:

  List<HistoryDetails> temp = hdb.loadHistoryByTitle(title);//同步默認賬戶觀看記錄
if (temp==null){
hdb.saveOrUpdate(historyDetails);//判斷表是否存在
}else if (temp.size()==0){
hdb.saveOrUpdate(historyDetails);//判斷數據是否存在
}

xutils使用就這麼簡單的完成了數據庫的編寫,使用起來步驟簡單明瞭,當然還有很多缺憾,所以數據庫模塊比較繁重的話還是推薦以上介紹的幾種開發框架.

歡迎關注作者darryrzhong,更多幹貨等你來拿喲.

請賞個小紅心!因為你的鼓勵是我寫作的最大動力!

更多精彩文章請關注

相關文章

1024程序員節最新福利之2018最全Android資料集合

1024程序員節最新福利之2018最全java資料集合

1024程序員節最新福利之2018最全H5前端資料集

Android之Activity全面解析