JAVA與JS卡片定點(diǎn)定時(shí)更新的對(duì)比總結(jié)

由上可見(jiàn)，兩者的大體思路是相同的：即先在config.json文件中修改配置，然后對(duì)具體的xxxxlmpl中的updateFormData()進(jìn)行重寫。不同的是，JS卡片式通過(guò)創(chuàng)建一個(gè)ZSONOject實(shí)例，然后封裝在FormBindingData的實(shí)例中的辦法更新數(shù)據(jù);而JAVA卡片則是通過(guò)創(chuàng)建ComponentProvider的實(shí)例，通過(guò)它來(lái)更新數(shù)據(jù)。因而，在調(diào)用MainAbility的方法updateForm()的時(shí)候，JS卡片的第二個(gè)實(shí)參是bingding Data,而JAVA卡片是componentProvider。

卡片的跳轉(zhuǎn)事件：

運(yùn)作機(jī)制示意圖如下：

JS卡片的跳轉(zhuǎn)事件步驟

1.在對(duì)應(yīng)卡片的index.json文件中添加跳轉(zhuǎn)配置

相關(guān)參數(shù)意義具體如下：

2.在index.hml中，在標(biāo)簽image中添加一個(gè)屬性onclick，并將值設(shè)置為剛剛在index.json中定義的action的名稱“startSecondAbility”

3.根據(jù)key的值“params”獲得一個(gè)字符串格式的JSON數(shù)據(jù);然后，調(diào)用ZSONObject.stringToZSON()將其轉(zhuǎn)換為一個(gè)ZSONObject的實(shí)例data;最后，從data中分別獲得”param1”和”param2”這兩個(gè)key對(duì)應(yīng)的value。

JAVA卡片的跳轉(zhuǎn)事件步驟

1.打開(kāi)MainWidget3Impl，在方法bindFormData()中，當(dāng)卡片尺寸為2*4時(shí)，調(diào)用componentProvider的方法setIntentAgent()，傳入的第一個(gè)實(shí)參是標(biāo)題在布局文件中的id，第二個(gè)實(shí)參是用于頁(yè)面跳轉(zhuǎn)的IntentAgent實(shí)例。代碼如下所示：

2.定義方法getStartAbilityIntentAgent()的具體實(shí)現(xiàn)，代碼如下：

總結(jié)

Java卡片要通過(guò)IntentAgent來(lái)設(shè)置事件，相比之下JS似乎顯得要方便一些。

卡片的消息事件

JS卡片的消息事件步驟

1.在對(duì)應(yīng)卡片的index.json文件中添加信息事件配置

相關(guān)參數(shù)意義具體如下：

2.重寫方法onTriggerFormEvent()，代碼如下：

message是一個(gè)字符串格式的JSON數(shù)據(jù);然后，調(diào)用ZSONObject.stringToZSON()將message轉(zhuǎn)換為一個(gè)ZSONObject的實(shí)例data;最后，從data中分別獲得”p1”和”p2”這兩個(gè)key對(duì)應(yīng)的value。

服務(wù)卡片常用到的數(shù)據(jù)庫(kù)

數(shù)據(jù)持久化

概念:數(shù)據(jù)持久化就是將內(nèi)存中的數(shù)據(jù)模型轉(zhuǎn)換為存儲(chǔ)模型,以及將存儲(chǔ)模型轉(zhuǎn)換為內(nèi)存中的數(shù)據(jù)模型的統(tǒng)稱

好處：

1、程序代碼重用性強(qiáng)，即使更換數(shù)據(jù)庫(kù)，只需要更改配置文件，不必重寫程序代碼。

2、業(yè)務(wù)邏輯代碼可讀性強(qiáng)，在代碼中不會(huì)有大量的SQL語(yǔ)言，提高程序的可讀性。

3、持久化技術(shù)可以自動(dòng)優(yōu)化，以減少對(duì)數(shù)據(jù)庫(kù)的訪問(wèn)量，提高程序運(yùn)行效率。

數(shù)據(jù)持久化對(duì)象的基本操作有：保存、更新、刪除、查詢等。

輕量級(jí)偏好數(shù)據(jù)庫(kù)

輕量級(jí)數(shù)據(jù)庫(kù)官方文檔鏈接

輕量級(jí)偏好數(shù)據(jù)庫(kù)在服務(wù)卡片開(kāi)發(fā)中的使用場(chǎng)景

根據(jù)輕量級(jí)偏好數(shù)據(jù)庫(kù)的特點(diǎn)，在服務(wù)卡片的開(kāi)發(fā)中，涉及到保存網(wǎng)絡(luò)上的內(nèi)容時(shí)，可以使用輕量級(jí)偏好數(shù)據(jù)庫(kù)來(lái)存儲(chǔ)cookie信息。

輕量級(jí)偏好數(shù)據(jù)庫(kù)的創(chuàng)建(獲取preference實(shí)例)

context = getContext(); 
databaseHelper = new DatabaseHelper(context); 
filename = "preference_db";//文件名，不能為空，也不能包含路徑 
preferences = databaseHelper.getPreferences(filename); 

輕量級(jí)偏好數(shù)據(jù)庫(kù)的插入，刪除，修改，查詢

插入與修改：

首先獲取指定文件對(duì)應(yīng)的Preferences實(shí)例，然后借助Preferences API將數(shù)據(jù)寫入Preferences實(shí)例，通過(guò)flush或者flushSync將Preferences實(shí)例持久化。其中flush為異步地寫入，flushSync為同步寫入。flush()會(huì)立即更改內(nèi)存中的Preferences對(duì)象，但會(huì)將更新異步寫入磁盤。flushSync()更改內(nèi)存中的數(shù)據(jù)的同時(shí)會(huì)將數(shù)據(jù)同步寫入磁盤。由于flushSync()是同步的，建議不要從主線程調(diào)用它，以避免界面卡頓。

異步寫入代碼：

preferences.putInt("number",number); 
preferences.putString("fruit","apple"); 
preferences.flush(); 

同步寫入的代碼：

preferences.putInt("intKey", 3); 
preferences.putString("StringKey", "String value"); 
bool result = preferences.flushSync(); 

查詢：

int value = preferences.getInt("intKey", 0); 

刪除：

1.刪除preferen單實(shí)例

DatabaseHelper databaseHelper = new DatabaseHelper(context); 
String fileName = "name"; // fileName表示文件名，其取值不能為空，也不能包含路徑。 
databaseHelper.removePreferencesFromCache(fileName); 

2.刪除指定文件

DatabaseHelper databaseHelper = new DatabaseHelper(context); 
String fileName = "name"; // fileName表示文件名，其取值不能為空，也不能包含路徑。 
boolean result = databaseHelper.deletePreferences(fileName); 

注冊(cè)觀察者

private class PreferencesObserverImpl implements Preferences.PreferencesObserver { 
    
    @Override     
    public void onChange(Preferences preferences, String key) { 
        if ("intKey".equals(key)) { 
           HiLog.info(LABLE, "Change Received：[key=value]");         
        }     
    } 
} 
 
// 向preferences實(shí)例注冊(cè)觀察者 
PreferencesObserverImpl observer = new PreferencesObserverImpl(); 
preferences.registerObserver(observer); 
// 修改數(shù)據(jù) 
preferences.putInt("intKey", 3); 
preferences.flush(); 
// 修改數(shù)據(jù)后，observer的onChange方法會(huì)被回調(diào) 
// 向preferences實(shí)例注銷觀察者 
preferences.unRegisterObserver(observer); 

輕量級(jí)數(shù)據(jù)庫(kù)在服務(wù)卡片中的使用例子：(摘抄自亮子力的嗶哩嗶哩卡片

/** 
   * Map[保存]到偏好型數(shù)據(jù)庫(kù) 
   * @param preferences  數(shù)據(jù)庫(kù)的Preferences實(shí)例 
   * @param map  要保存的map 
   */ 
  public static void SaveMap(Preferences preferences,Map<String,String> map){ 
      // 遍歷map 
      for (Map.Entry<String, String> entry : map.entrySet()) { 
          HiLog.info(TAG,entry.getKey() + "=" + entry.getValue()); 
          preferences.putString(entry.getKey(),entry.getValue());//3.將數(shù)據(jù)寫入Preferences實(shí)例， 
      } 
      preferences.flushSync();//4.通過(guò)flush()或者flushSync()將Preferences實(shí)例持久化。 
  } 
 
  /** 
   *  從偏好型數(shù)據(jù)庫(kù)[讀取]Map 
   * @param preferences  數(shù)據(jù)庫(kù)的Preferences實(shí)例 
   * @return  要讀取的map 
   */ 
  public static Map<String,?> GetCookieMap(Preferences preferences){ 
      Map<String, ?> map = new HashMap<>(); 
      map = preferences.getAll();//3.讀取數(shù)據(jù) 
      return map; 
  } 

對(duì)象關(guān)系映射數(shù)據(jù)庫(kù)

對(duì)象關(guān)系映射數(shù)據(jù)庫(kù)官方文檔

對(duì)象關(guān)系數(shù)據(jù)庫(kù)在服務(wù)卡片中的應(yīng)用

對(duì)象關(guān)系數(shù)據(jù)庫(kù)在服務(wù)卡片中主要用作存儲(chǔ)卡片的信息，如卡片id，卡片名字，卡片大小等。

對(duì)象關(guān)系數(shù)據(jù)庫(kù)的創(chuàng)建

1.配置“build.gradle”文件，這里僅展示使用注解處理器的模塊為“com.huawei.ohos.hap”模塊，則需要在模塊的“build.gradle”文件的ohos節(jié)點(diǎn)中添加以下配置：

compileOptions{         
    annotationEnabled true     
}  

2.構(gòu)造對(duì)象關(guān)系映射數(shù)據(jù)庫(kù)：創(chuàng)建數(shù)據(jù)庫(kù)類并配置對(duì)應(yīng)的屬性

//數(shù)據(jù)庫(kù)有三個(gè)表，User，Book， AllDataType三個(gè)表，版本號(hào)為1 
@Database(entities = {User.class, Book.class, AllDataType.class}, version = 1)  
public abstract class BookStore extends OrmDatabase {  
} 

3.構(gòu)造數(shù)據(jù)表，即創(chuàng)建數(shù)據(jù)庫(kù)實(shí)體類并配置對(duì)應(yīng)的屬性(如對(duì)應(yīng)表的主鍵，外鍵等)。數(shù)據(jù)表必須與其所在的數(shù)據(jù)庫(kù)在同一個(gè)模塊中。

@Entity(tableName = "user", ignoredColumns = {"ignoredColumn1", "ignoredColumn2"}, 
    indices = {@Index(value = {"firstName", "lastName"}, name = "name_index", unique = true)})  
public class User extends OrmObject {  
    // 此處將userId設(shè)為了自增的主鍵。注意只有在數(shù)據(jù)類型為包裝類型時(shí)，自增主鍵才能生效。 
    @PrimaryKey(autoGenerate = true)  
    private Integer userId;    
    private String firstName;    
    private String lastName;    
    private int age;    
    private double balance;    
    private int ignoredColumn1;  
    private int ignoredColumn2;  
  
    // 需添加各字段的getter和setter方法。  
} 

4.使用對(duì)象數(shù)據(jù)操作接口OrmContext創(chuàng)建數(shù)據(jù)庫(kù)。

// context入?yún)㈩愋蜑閛hos.app.Context，注意不要使用slice.getContext()來(lái)獲取context，請(qǐng)直接傳入slice，否則會(huì)出現(xiàn)找不到類的報(bào)錯(cuò)。 
DatabaseHelper helper = new DatabaseHelper(this);  
 
OrmContext context = helper.getOrmContext("BookStore", "BookStore.db", BookStore.class);  

5.對(duì)象關(guān)系映射數(shù)據(jù)庫(kù)的增刪改查

查詢數(shù)據(jù)：

OrmPredicates query = context.where(User.class).equalTo("lastName", "San");  
List<User> users = context.query(query); 

更新數(shù)據(jù)：更新數(shù)據(jù)有兩種方法，這里僅貼出其中一種

// 更新數(shù)據(jù) 
OrmPredicates predicates = context.where(User.class); 
predicates.equalTo("age", 29); 
List<User> users = context.query(predicates); 
User user = users.get(0); 
user.setFirstName("Li"); 
context.update(user); 
context.flush(); 

刪除數(shù)據(jù)：刪除數(shù)據(jù)也有兩種方法，這里也僅貼出其中一種，另一種方法可以到官方文檔查看

// 刪除數(shù)據(jù) 
OrmPredicates predicates = context.where(User.class); 
predicates.equalTo("age", 29); 
List<User> users = context.query(predicates); 
User user = users.get(0); 
context.delete(user); 
context.flush(); 

6.注冊(cè)觀察者

// 定義一個(gè)觀察者類。 
private class CustomedOrmObjectObserver implements OrmObjectObserver { 
    @Override     
    public void onChange(OrmContext changeContext, AllChangeToTarget subAllChange) { 
        // 用戶可以在此處定義觀察者行為 
    } 
} 
 
// 調(diào)用registerEntityObserver方法注冊(cè)一個(gè)觀察者observer。 
CustomedOrmObjectObserver observer = new CustomedOrmObjectObserver(); 
context.registerEntityObserver("user", observer); 
 
// 當(dāng)以下方法被調(diào)用，并flush成功時(shí)，觀察者observer的onChange方法會(huì)被觸發(fā)。其中，方法的入?yún)⒈仨殲?span id="k6zqhab033oa"    class="func">User類的對(duì)象。 
public <T extends OrmObject> boolean insert(T object) 
public <T extends OrmObject> boolean update(T object) 
public <T extends OrmObject> boolean delete(T object) 

對(duì)象關(guān)系映射數(shù)據(jù)庫(kù)在服務(wù)卡片中的應(yīng)用實(shí)例

@Entity(tableName = "form") 
public class Form extends OrmObject { 
    @PrimaryKey() 
    // 卡片id 
    private Long formId; 
 
    // 卡片名稱 
    private String formName; 
 
    // 卡片名稱 
    private int dimension; 
 
    /** 
     * 有參構(gòu)造 
     * 
     * @param formId 卡片id 
     * @param formName 卡片名 
     * @param dimension 卡片規(guī)格 
     */ 
    public Form(Long formId, String formName, int dimension) { 
        this.formId = formId; 
        this.formName = formName; 
        this.dimension = dimension; 
    } 

protected ProviderFormInfo onCreateForm(Intent intent) { 
        HiLog.info(TAG, "onCreateForm"); 
        long formId = intent.getLongParam(AbilitySlice.PARAM_FORM_IDENTITY_KEY, INVALID_FORM_ID); 
        String formName = intent.getStringParam(AbilitySlice.PARAM_FORM_NAME_KEY); 
        int dimension = intent.getIntParam(AbilitySlice.PARAM_FORM_DIMENSION_KEY, DEFAULT_DIMENSION_2X2); 
        HiLog.info(TAG, "onCreateForm: formId=" + formId + ",formName=" + formName); 
        FormControllerManager formControllerManager = FormControllerManager.getInstance(this); 
        FormController formController = formControllerManager.getController(formId); 
        formController = (formController == null) ? formControllerManager.createFormController(formId, 
                formName, dimension) : formController; 
        if (formController == null) { 
            HiLog.error(TAG, "Get null controller. formId: " + formId + ", formName: " + formName); 
            return null; 
        } 
 
        //初始化時(shí)先在線更新一下卡片 
        onUpdateForm(formId); 
 
        // TODO 獲取添加到桌面的服務(wù)卡片ID 
 
        // 存儲(chǔ)卡片信息。對(duì)象關(guān)系映射數(shù)據(jù)庫(kù)2.通過(guò)對(duì)象數(shù)據(jù)操作接口OrmContext，創(chuàng)建一個(gè)別名為“FormDatabase”，數(shù)據(jù)庫(kù)文件名為“FormDatabase.db”的數(shù)據(jù)庫(kù) 
        ormContext = databaseHelper.getOrmContext("FormDatabase", "FormDatabase.db", MyOrmDatabase.class); 
        // 對(duì)象關(guān)系映射數(shù)據(jù)庫(kù)3.實(shí)例化數(shù)據(jù)表 
        HiLog.info(TAG, "存儲(chǔ)卡片信息: formId=" + formId + ",formName=" + formName + ",dimension=" + dimension); 
        Form form = new Form(formId, formName, dimension); 
        // 對(duì)象關(guān)系映射數(shù)據(jù)庫(kù)4.添加方法 
        ormContext.insert(form); 
        ormContext.flush(); 
 
 
        return formController.bindFormData(); 
    } 

網(wǎng)絡(luò)編程的相關(guān)知識(shí)

這部分在我平時(shí)的學(xué)習(xí)未曾接觸過(guò)，在大家眼中很平常的概念，在我這里都是全新的知識(shí)，所以會(huì)有較多的概念記錄。

WebView組件的使用

WebView組件官方文檔

WebView提供在應(yīng)用中集成Web頁(yè)面的能力。

服務(wù)卡片的開(kāi)發(fā)中一般只需要加載Web頁(yè)面，則常用操作如下：

1.配置應(yīng)用的網(wǎng)絡(luò)權(quán)限(如未配置網(wǎng)絡(luò)權(quán)限的話)

{ 
  ... 
  "module": { 
    ... 
    "reqPermissions": [ 
      { 
        "name": "ohos.permission.INTERNET" 
      } 
    ], 
    ... 
  } 
} 

2.使用load方法加載Web頁(yè)面

這里僅貼出使用xml方式布局的代碼，使用代碼方式布局可參看官方文檔

WebView webView = (WebView) findComponentById(ResourceTable.Id_webview); 
webView.getWebConfig().setJavaScriptPermit(true);  // 如果網(wǎng)頁(yè)需要使用JavaScript，增加此行；如何使用JavaScript下文有詳細(xì)介紹   
final String url = EXAMPLE_URL; // EXAMPLE_URL由開(kāi)發(fā)者自定義 
webView.load(url); 

什么是JSON文件

JSON的全稱為JavaScript Object Notation，是輕量級(jí)的文本數(shù)據(jù)交換格式，JSON實(shí)際上是JavaScript的一個(gè)子集。重要的是，許多API請(qǐng)求返回值都是josn格式的結(jié)果。

JSON生成Java實(shí)體類

網(wǎng)上有很多相關(guān)的工具，如何自己編寫我暫且還未學(xué)會(huì)，就決定先應(yīng)用現(xiàn)有的工具了

什么是Cookie

由于HTTP是一種無(wú)狀態(tài)協(xié)議,服務(wù)器沒(méi)有辦法單單從網(wǎng)絡(luò)連接上面知道訪問(wèn)者的身份,因此就使用Cookie作為辨識(shí)訪問(wèn)者的一種標(biāo)志。

Cookie是一段不超過(guò)4KB的小型文本數(shù)據(jù)，由一個(gè)名稱(Name)、一個(gè)值(Value)和其它幾個(gè)用于控制Cookie有效期、安全性、使用范圍的可選屬性組成。

運(yùn)作機(jī)制如下圖：

客戶端請(qǐng)求服務(wù)器，如果服務(wù)器需要記錄該用戶狀態(tài)，就使用response向客戶端瀏覽器頒發(fā)一個(gè)Cookie，客戶端瀏覽器會(huì)把Cookie保存起來(lái)。當(dāng)瀏覽器再請(qǐng)求該網(wǎng)站時(shí)，瀏覽器把請(qǐng)求的網(wǎng)址連同該Cookie一同提交給服務(wù)器。服務(wù)器檢查該Cookie，

以此來(lái)辨認(rèn)用戶狀態(tài)。服務(wù)器還可以根據(jù)需要修改Cookie的內(nèi)容。

實(shí)際就是頒發(fā)一個(gè)通行證，每人一個(gè)，無(wú)論誰(shuí)訪問(wèn)都必須攜帶自己通行證。這樣服務(wù)器就能從通行證上確認(rèn)客戶身份了。這就是Cookie的工作原理。

cookie 可以讓服務(wù)端程序跟蹤每個(gè)客戶端的訪問(wèn)，但是每次客戶端的訪問(wèn)都必須傳回這些Cookie，如果 Cookie 很多，這無(wú)形地增加了客戶端與服務(wù)端的數(shù)據(jù)傳輸量。

Cookie相關(guān)方法

CookieStore官方文檔

卡片開(kāi)發(fā)的基本步驟總結(jié)

1.選擇已有的卡片模板，或者自行繪制卡片樣式

2.對(duì)卡片進(jìn)行初始化的設(shè)置

3.建立數(shù)據(jù)庫(kù)(對(duì)象關(guān)系映射數(shù)據(jù)庫(kù)存儲(chǔ)卡片信息，涉及網(wǎng)絡(luò)的可以用輕量級(jí)數(shù)據(jù)庫(kù)存儲(chǔ)cookie

4.給卡片上面的組件添加響應(yīng)的事件

5.實(shí)現(xiàn)卡片的功能