自学HarmonyOS应用开发（62）- 使用对象关系映射数据库保存设定信息

面向对象思考

发布于 2021-08-06 13:17:44

5180

发布于 2021-08-06 13:17:44

文章被收录于专栏：C++核心准则原文翻译C++核心准则原文翻译

除了地图数据，秒表应用还有一些其他希望保存的数据，例如上次定位的位置，地图画面的缩放比例等。本文介绍通过对象关系映射数据库技术保存这些信息的方法。

通用的设定信息表

下面的代码定义了用于保存设定信息的通用的表结构：

@Entity(tableName = "setting",
        ignoredColumns = {"LABEL"},
        indices = {@Index(value = {"segment", "item"}, name = "setting_index", unique = true)})
public class Setting extends OrmObject {
    static final HiLogLabel LABEL = new HiLogLabel(HiLog.LOG_APP, 0x00301, "Setting");
    @PrimaryKey(autoGenerate = true)
    private Integer id;
    private String segment;
    private String item;
    private String value;

    public Integer getId(){ return id; }

    public String getSegment(){ return segment; }

    public String getItem(){ return item; }

    public String getValue(){ return value; }

    public void setId(Integer integer) { id = integer; }

    public void setSegment(String string) { segment = string; }

    public void setItem(String string) { item = string; }

    public void setValue(String string) { value = string;}
}

表的结构很简单，除了自增长的id之外，字段segment，item和value用于保存设定值信息。

方便使用的帮助方法

为了方便设计者使用这个表，我们还为这个数据表提供了若干帮助函数。首先是向数据库写入数据的setStringValue:

static public void setStringValue(OrmContext db, String seg, String i, String v){
    HiLog.info(LABEL, "Setting.setStringValue,seg=%{public}s, item=%{public}s, v=%{public}s!", seg, i, v);
    OrmPredicates query = db.where(Setting.class).equalTo("segment", seg).and().equalTo("item", i);
    List<Setting> svs = db.query(query);
    String ret = null;
    if (svs.size() > 0) {
        Setting sv = (Setting) svs.get(0);
        sv.value = v;
        db.update(sv);
        HiLog.info(LABEL, "Setting.setStringValue update!");
    }
    else {
        Setting sv = new Setting();
        sv.segment = seg;
        sv.item = i;
        sv.value = v;
        db.insert(sv);
        HiLog.info(LABEL, "Setting.setStringValue insert!");
    }
    db.flush();
}

如果第一次向数据库增加设定项，则调用数据库插入功能；如果相同数据项已经存在，则调用数据库更新功能。

接下来是从数据库获取数据的getStringValue方法：

static public String getStringValue(OrmContext db, String seg, String i, String v){
    //HiLog.info(LABEL, "Setting.getStringValue,seg=%{public}s, item=%{public}s, v=%{public}s!", seg, i, v);
    OrmPredicates query = db.where(Setting.class).equalTo("segment", seg).and().equalTo("item", i);
    List<Setting> svs = db.query(query);
    String ret = null;
    if (svs.size() > 0) {
        Setting sv = (Setting) svs.get(0);
        ret = sv.value;
    } else {
        ret = v;
    }
    return ret;
}

有了这两个存取字符串的帮助方法之后，Setting类又提供了存取其他类型变量的方法：

static public void setIntValue(OrmContext db, String seg, String i, int v){
    setStringValue(db, seg, i, String.format("%d", v));
}

static public int getIntValue(OrmContext db, String seg, String i, int v){
    String str_v = String.format("%d", v);
    String str_ret = getStringValue(db, seg, i, str_v);
    int ret = (int)Double.parseDouble(str_ret);
    return ret;
}

static public void setDoubleValue(OrmContext db, String seg, String i, double v){
    setStringValue(db, seg, i, String.format("%f", v));
    HiLog.info(LABEL, "Setting.setDoubleValue End!");
}

static public double getDoubleValue(OrmContext db, String seg, String i, double v){
    String ret = getStringValue(db, seg, i, String.format("%f", v));
    return Double.valueOf(ret).doubleValue();
}

使用对象关系映射数据库保存设定信息

下面的代码是在秒表应用中实际使用Setting类存取设定值的代码：

private void loadLocation(){
    double latitude = Setting.getDoubleValue(dbContext, getClass().getName(), "latitude", 0);
    double longitude = Setting.getDoubleValue(dbContext, getClass().getName(), "longitude", 0);
    if(latitude != 0 && longitude != 0){
        tileMap.setGcj02Location(new TrailPoint(latitude, longitude));
    }
}
private void saveLocation(){
    TrailPoint location = tileMap.getGcj02Location();
    if(location != null) {
        Setting.setDoubleValue(dbContext, getClass().getName(), "latitude", location.lat);
        Setting.setDoubleValue(dbContext, getClass().getName(), "longitude", location.lon);
    }
}

private void loadSettings(){
    int zoom = Setting.getIntValue(dbContext, getClass().getName(), "zoom", 0);
    if(zoom != 0){
        tileMap.setZoom(zoom);
    }
}

private void saveSettings(){
    Setting.setIntValue(dbContext, getClass().getName(), "zoom", tileMap.getZoom());
}

参考代码