数据库接口使用示例

Posted 2020-11-14 ustc-cc

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了数据库接口使用示例相关的知识，希望对你有一定的参考价值。

考虑到我们的接口文档可能不是很清晰，昨天对接的时候也发现UI人员对我们的接口逻辑不太理解，所以这里写几个典型范例。虽然对接也快对接完了（逃，但是这样至少免得以后忘记了。

（注：这里的代码都测试过，放在HeartTraceappsrcandroidTestjavacomexampledelldbexamples中。持续性更新。）

几个基本原则

任何新建的对象，在insert之前，是不会到数据库里的！！！！！！不管怎样都不会！！！！！！！！！

任何已有的对象，在修改之后，如果不update，修改也不会被更新到数据库里！！！！！！！！！不管怎样都不会！！！！！！！！！！

只有通过getAll, getByRestrict, getAllLabel等方法获取的Diary Sentence Label Diarybook Sentencebook对象才指向数据库中的一个表项，直接new的会被认为是一个新的表项！！！

注：

Diary要求：text（日记内容）可以为空，date（日期）不能为空，diary book（日记本）可以为空（TODO：这个以后肯定会改成不能为空的！）

Diary要求：text（日记内容）可以为空，date（日期）不能为空，sentence book（日记本）不能为空

Diarybook要求：name（名字）不能为空，且彼此不能重复

Sentencebook要求：name（名字）不能为空，且彼此不能重复

获取、释放DatabaseHelper

方法1：

        // 获取
        DatabaseHelper helper = new DatabaseHelper(context); // 这个context视情况而定，可能是this或者getApplicationContext()

        // 释放
        helper.close();

方法2：

        // 获取
        DatabaseHelper helper = OpenHelperManager.getHelper(context, DatabaseHelper.class); // context同上

        // 释放
        OpenHelperManager.releaseHelper();

Example 0. 将一个新的日记插入已有日记本，并插入标签

前提：diarybook是一个已经插入数据库的日记本，helper是已有的databaseHelper

        Diary diary = new Diary("hiasjfhlaf");
        diary.setDate();
        diary.setDiarybook(diarybook);
        diary.insert(helper);

        Label label1 = new Label("label1");
        Label label1.insert(helper);

        label2 = new Label("label2");
        label2.insert(helper);

        diary.insertLabel(helper, label1);
        diary.insertLabel(helper, label2);

        List<Label> list = diary.getAllLabel(helper);
        assertEquals(2, list.size());
        for(Label l : list) {
            Log.d(getClass().getName(), "testExample0: label " + l.getLabelname());
        }

如果想要对已有的diary进行insertLabel操作，其实完全同理。

Example 1. 通过名字判断某个瓶子是否存在；如果不存在，则新建这个瓶子。并将新建的小纸条插入这个瓶子

前提：helper是已有的DatabaseHelper，bookName是已有的String。

        Sentencebook b = Sentencebook.getByName(helper, bookName);
        if(b == null) {
            b = new Sentencebook(bookName);
            b.insert(helper);
        }

        Sentence sentence = new Sentence("adfjanvnavop");
        sentence.setDate();
        sentence.setSentencebook(b);
        sentence.insert(helper);

Example 2. 通过单个Label查找所有的Diary

前提：helper是已有的DatabaseHelper，label已经在数据库内（这个很重要，不然会报错的）。

        List<Label> labelList = new ArrayList();
        labelList.add(label);

        List<Diary> d = Diary.getByRestrict(helper, null, null, null, labelList, true);