JAVA與JS卡片定點定時更新的對比總結(jié)

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

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

運作機制示意圖如下：

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

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

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

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

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

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

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

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

總結(jié)

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

卡片的消息事件

JS卡片的消息事件步驟

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

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

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

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

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

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

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

好處：

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

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

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

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

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

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

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

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

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

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

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

插入與修改：

首先獲取指定文件對應(yīng)的Preferences實例，然后借助Preferences API將數(shù)據(jù)寫入Preferences實例，通過flush或者flushSync將Preferences實例持久化。其中flush為異步地寫入，flushSync為同步寫入。flush()會立即更改內(nèi)存中的Preferences對象，但會將更新異步寫入磁盤。flushSync()更改內(nèi)存中的數(shù)據(jù)的同時會將數(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單實例

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); 

注冊觀察者

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實例注冊觀察者 
PreferencesObserverImpl observer = new PreferencesObserverImpl(); 
preferences.registerObserver(observer); 
// 修改數(shù)據(jù) 
preferences.putInt("intKey", 3); 
preferences.flush(); 
// 修改數(shù)據(jù)后，observer的onChange方法會被回調(diào) 
// 向preferences實例注銷觀察者 
preferences.unRegisterObserver(observer); 

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

/** 
   * Map[保存]到偏好型數(shù)據(jù)庫 
   * @param preferences  數(shù)據(jù)庫的Preferences實例 
   * @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實例， 
      } 
      preferences.flushSync();//4.通過flush()或者flushSync()將Preferences實例持久化。 
  } 
 
  /** 
   *  從偏好型數(shù)據(jù)庫[讀取]Map 
   * @param preferences  數(shù)據(jù)庫的Preferences實例 
   * @return  要讀取的map 
   */ 
  public static Map<String,?> GetCookieMap(Preferences preferences){ 
      Map<String, ?> map = new HashMap<>(); 
      map = preferences.getAll();//3.讀取數(shù)據(jù) 
      return map; 
  } 

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

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

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

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

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

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

compileOptions{         
    annotationEnabled true     
}  

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

//數(shù)據(jù)庫有三個表，User，Book， AllDataType三個表，版本號為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ù)庫實體類并配置對應(yīng)的屬性(如對應(yīng)表的主鍵，外鍵等)。數(shù)據(jù)表必須與其所在的數(shù)據(jù)庫在同一個模塊中。

@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ù)類型為包裝類型時，自增主鍵才能生效。 
    @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.使用對象數(shù)據(jù)操作接口OrmContext創(chuàng)建數(shù)據(jù)庫。

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

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

查詢數(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.注冊觀察者

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

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

@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; 
        } 
 
        //初始化時先在線更新一下卡片 
        onUpdateForm(formId); 
 
        // TODO 獲取添加到桌面的服務(wù)卡片ID 
 
        // 存儲卡片信息。對象關(guān)系映射數(shù)據(jù)庫2.通過對象數(shù)據(jù)操作接口OrmContext，創(chuàng)建一個別名為“FormDatabase”，數(shù)據(jù)庫文件名為“FormDatabase.db”的數(shù)據(jù)庫 
        ormContext = databaseHelper.getOrmContext("FormDatabase", "FormDatabase.db", MyOrmDatabase.class); 
        // 對象關(guān)系映射數(shù)據(jù)庫3.實例化數(shù)據(jù)表 
        HiLog.info(TAG, "存儲卡片信息: formId=" + formId + ",formName=" + formName + ",dimension=" + dimension); 
        Form form = new Form(formId, formName, dimension); 
        // 對象關(guān)系映射數(shù)據(jù)庫4.添加方法 
        ormContext.insert(form); 
        ormContext.flush(); 
 
 
        return formController.bindFormData(); 
    } 

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

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

WebView組件的使用

WebView組件官方文檔

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

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

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

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

2.使用load方法加載Web頁面

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

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

什么是JSON文件

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

JSON生成Java實體類

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

什么是Cookie

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

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

運作機制如下圖：

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

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

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

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

Cookie相關(guān)方法

CookieStore官方文檔

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

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

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

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

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

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