上文（【Codelabs挑戰賽示例講解1】核酸檢測結果認證查詢系統-認證登錄）實作了核酸檢測結果認證查詢系統的認證登錄部分的功能，認證登錄完成后，接下來便是要實作核酸檢測結果資料的匯入與查詢功能，
云資料庫是一款端云協同的資料庫產品，提供端云資料的協同管理、統一的資料模型和豐富的資料管理API介面等能力，完全可以滿足資料的查詢功能，
《Codelabs挑戰賽——零基礎搭建認證查詢系統》活動正在火熱進行中，分享作品有機會獲得華為freebuds pro無線耳機、華為手環6nfc版、聯盟背包等豐厚大禮，快來參與吧>>https://developer.huawei.com/consumer/cn/forum/topic/0202851788421280176?fid=0102822233052010012
集成SDK
1.1 集成SDK
AppGallery Connect以SDK的方式開放了其資料管理功能，在開發資料管理功能之前，首先需要先集成云資料庫SDK，且需要下載AGC提供的JSON檔案獲取應用的基本資訊和資料處理位置資訊等；其次，資料的展示需要依賴表格，此次我們選取了開源的自動化表格框架-SmartTable，同樣也需要先集成SDK，
1. 集成云資料庫和SmartTable SDK之前，請確保您已經完成maven倉、AGC插件及編譯依賴的集成，
2. 在應用級build.gradle檔案下配置集成云資料庫和SmartTable SDK，
dependencies {
//agc-core的依賴
implementation 'com.huawei.agconnect:agconnect-core:1.6.0.300'
implementation 'androidx.appcompat:appcompat:1.3.0'
implementation 'com.google.android.material:material:1.3.0'
implementation 'androidx.constraintlayout:constraintlayout:2.0.4'
testImplementation 'junit:junit:4.+'
androidTestImplementation 'androidx.test.ext:junit:1.1.3'
androidTestImplementation 'androidx.test.espresso:espresso-core:3.4.0'
//云資料庫sdk
implementation 'com.huawei.agconnect:agconnect-cloud-database:1.4.9.300'
compile 'com.github.huangyanbin:SmartTable:2.0'
}上述SDK或依賴添加完成后，需要點擊右上角“Sync Now”等待同步完成，
開發準備
1.1 開通服務
1. 登錄AGC管理臺，點擊“我的專案”，選擇之前創建的專案，
2. 在選單目錄下找到“構建-云資料庫”，點擊右上角“立即開通”，開通后界面如下，至此，云資料庫服務已經開通成功，
1.2 新增云資料庫資料物件
在對云資料庫進行管理前，需要先新增云資料庫資料物件，資料物件主要規定了資料庫存盤區中資料的型別，后續可以到處為物件添加到專案中使用，
1. 在云資料服務界面選擇“物件型別”頁簽，點擊“新增”，物件型別填寫“personInfo”，新增“id”、“name”、“age”、“hasInoculate”、“cardNo”欄位用于存盤檢測人群的身份資料，
2. 設定物件型別的索引或者物件型別中對某個欄位的索引，此處我只設定了對name的索引，可酌情設定，
3. 設定資料管理的權限，此處按我的產品定位選的是管理員和資料創建人擁有所有權限即可，更多角色查看可參考權限管理，
1.3 新增存盤區
資料的增刪查需要在資料存盤區中進行，在進行上述操作管理某個物件型別的資料前需要先創建存盤區，此處，僅需指定存盤區的名稱即可，而后在代碼中往哪個存盤區中插入某個物件型別的資料，
在云資料服務界面選擇“存盤區”頁簽，點擊“新增”，填寫存盤區名稱創建，此處以創建名為“personInfoZone”的存盤區為例介紹，
PS：“資料”頁簽下，可以根據存盤區和物件型別查詢資料，資料插入后可作為云側查詢資料使用，
1.4 匯入資料
您可以選擇“手動匯入”和“批量匯入”兩種方式匯入檢測資料，
1. 手動匯入
在“資料”頁簽下，選擇創建的物件型別及存盤區名稱，點擊“新增”，
按物件型別中的欄位新增資料，此處以“personInfo”為例介紹：
2. 批量匯入
在“資料”頁簽下，選擇創建的物件型別及存盤區名稱，點擊“資料模板”，
說明：資料模板為包含存盤區和物件型別資訊的示例資料json檔案，您可以直接新增資料后匯入，
打開資料模板json檔案，按物件型別欄位新增資料，如下，新增了兩條有效資料：
點擊“… > 匯入”，匯入新增的資料，可增量新增json中的資料，如下圖：
說明：如資料存盤在Excel檔案中，可先轉換為json檔案再新增，Excel轉json方法請自行Google，
1.5 更新組態檔
云資料庫服務開通后，AGC會將云資料庫的物件型別等資訊寫入JSON檔案，故需要重新下載“agconnect-services.json”檔案并在Android Studio專案中更新，詳細可參考系列上篇的“集成SDK-添加組態檔”章節，
界面設計
主功能界面的設計比較簡單，包含以下內容：
1. 檢測資料的展示表格；
2. 登出按鈕，
說明：此處為成功查詢到資料的界面示例，表格初始時為空，
資料物件匯入
在開發準備章節新建的資料物件必須先匯入Android Studio專案才能在代碼中對物件執行新建、插入、修改等操作，具體操作如下：
1. 登錄AGC，進入專案下的云資料庫服務下，
2. 在物件型別頁簽下，點擊右上角“匯出”，匯出檔案格式選擇“java”格式（因為我們開發的是Android專案，針對web等專案，AGC也提供js格式的物件型別格式檔案等），
3. 在src\main\java\com\example\packagename目錄下，新建名為model的package，并將剛剛下載的personInfo物件檔案和物件幫助檔案放在該目錄下，
資料庫初始化
本系統的業務需求為進入主界面即查詢匯入的檢測資料，查詢前需要先對資料庫進行初始化，詳細請參考官方檔案-初始化，
1. 初始化AGConnectCloudDB、資料庫配置和存盤區，初始化后要在生命周期中隨時操作資料庫，故需要定義以下全域變數，
//初始化資料庫
AGConnectCloudDB mCloudDB;
//初始化資料庫配置
CloudDBZoneConfig mConfig;
//初始化存盤區
CloudDBZone mCloudDBZone;
//初始化表格
private SmartTable table;
//云端資料物件List
private static List<personInfo> personInfoList = new ArrayList<>();2. 完成獲取AGConnectCloudDB實體，創建物件型別，打開Cloud DB Zone一系列操作，（personInfo需要換成實際的存盤區名稱，此處Cloud DB Zone的同步配置屬性為快取模式，訪問屬性為公共存盤區），
private void initView() {
//初始化云資料庫
AGConnectCloudDB.initialize(getApplicationContext());
AGConnectInstance instance = AGConnectInstance.buildInstance(new AGConnectOptionsBuilder().setRoutePolicy(AGCRoutePolicy.CHINA).build(getApplicationContext()));
mCloudDB = AGConnectCloudDB.getInstance(instance, AGConnectAuth.getInstance(instance));
Log.i(TAG,"The cloudDB is" + mCloudDB);
try {
mCloudDB.createObjectType(model.ObjectTypeInfoHelper.getObjectTypeInfo());
mConfig = new CloudDBZoneConfig("personInfoZone",
CloudDBZoneConfig.CloudDBZoneSyncProperty.CLOUDDBZONE_CLOUD_CACHE,
CloudDBZoneConfig.CloudDBZoneAccessProperty.CLOUDDBZONE_PUBLIC);
mConfig.setPersistenceEnabled(true);
Task<CloudDBZone> openDBZoneTask = mCloudDB.openCloudDBZone2(mConfig, true);
openDBZoneTask.addOnSuccessListener(new OnSuccessListener<CloudDBZone>() {
@Override
public void onSuccess(CloudDBZone cloudDBZone) {
Log.i("open clouddbzone", "open cloudDBZone success");
mCloudDBZone = cloudDBZone;
//開始系結資料
bindData();
// Add subscription after opening cloudDBZone success
//addSubscription();
}
}).addOnFailureListener(new OnFailureListener() {
@Override
public void onFailure(Exception e) {
Log.w("open clouddbzone", "open cloudDBZone failed for " + e.getMessage());
}
});
} catch (AGConnectCloudDBException e) {
Toast.makeText(DatabaseActivity.this, "initialize CloudDB failed" + e, Toast.LENGTH_LONG).show();
}
}系結并查詢資料
1. 上步中bindData函式的作用是將AGC云端匯入的資料與SmartTable表格框架系結，進而展示，
private void bindData() {
CloudDBZoneQuery<personInfo> query = CloudDBZoneQuery.where(personInfo.class);
queryPersonInfo(query);
}private List<personInfo> queryPersonInfo(CloudDBZoneQuery<personInfo> query) {
if (mCloudDBZone == null) {
Log.w(TAG, "CloudDBZone is null, try re-open it");
return null;
}
Task<CloudDBZoneSnapshot<personInfo>> queryTask = mCloudDBZone.executeQuery(query,
CloudDBZoneQuery.CloudDBZoneQueryPolicy.POLICY_QUERY_FROM_CLOUD_ONLY);
//List<personInfo> tmpInfoList = new ArrayList<>();
queryTask.addOnSuccessListener(new OnSuccessListener<CloudDBZoneSnapshot<personInfo>>() {
@Override
public void onSuccess(CloudDBZoneSnapshot<personInfo> snapshot) {
try {
personInfoList = processQueryResult(snapshot);
} catch (AGConnectCloudDBException e) {
Log.e(TAG, "onfailed: "+e.getErrMsg() );
}
Log.i(TAG, "onSuccess: query result success");
}
}).addOnFailureListener(new OnFailureListener() {
@Override
public void onFailure(Exception e) {
mUiCallBack.updateUiOnError("Query failed");
Log.i(TAG, "onSuccess: query result failed");
}
});
return personInfoList;
}2. processQueryResult為處理并展示云端資料的主函式，此處需要將資料物件中的欄位添加到list中，并添加到SmartTable中，
private List<personInfo> processQueryResult(CloudDBZoneSnapshot<personInfo> snapshot) throws AGConnectCloudDBException {
CloudDBZoneObjectList<personInfo> bookInfoCursor = snapshot.getSnapshotObjects();
List<personInfo> bookInfoList = new ArrayList<>();
List<PersonInfo> list = new ArrayList<>();
table = findViewById(R.id.table);
try {
while (bookInfoCursor.hasNext()) {
personInfo info = bookInfoCursor.next();
bookInfoList.add(info);
list.add(new PersonInfo(info.getId(),info.getName(),info.getAge(),info.getHasInoculate()==true?"是":"否",info.getCardNo()));
//list.add(new PersonInfo(1,"xuhao",34,true,"12321"));
}
} catch (AGConnectCloudDBException e) {
Log.w(TAG, "processQueryResult: " + e.getMessage());
} finally {
snapshot.release();
mCloudDB.closeCloudDBZone(mCloudDBZone);
}
table.setData(list);
table.getConfig().setContentStyle(new FontStyle(50, Color.BLUE));
mUiCallBack.onAddOrQuery(bookInfoList);
return bookInfoList;
}3. 帳號登出后，系統會跳轉到登錄界面，呼叫AGConnectAuth. signOut方法即可，無需過多贅述，
findViewById(R.id.login_out).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
AGConnectAuth.getInstance().signOut();
Intent intent = new Intent();
intent.setClass(DatabaseActivity.this, LoginActivity.class);
startActivity(intent);
Log.i(TAG, "onClick: log out successfully");
}
});至此，核酸檢測結果查詢系統的開發作業已全部完成，運行后登錄系統即可查詢到云資料庫云端全部的檢測資料，
總結
AGC云資料庫服務提供的端云資料同步的能力還是非常實用，免除了服務器部署、資料管理等作業量，當然，除了資料查詢還可以在系統內直接實作新增或洗掉資料等常見資料操作，云資料庫服務提供的能力遠不止查詢而已，
至此，我們完成了核酸檢測結果系統的功能開發，此系統僅為Codelab挑戰賽主題功能的基本實作成功，大家可以基于指導檔案和Demo，結合自己的想象，為AGC Serverless服務的構造更多的可能性，
參考檔案：
如何初始化云資料庫：https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/agc-clouddb-get-started-0000001127676473#section10889116163412
云資料庫云端資料查詢：
https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/agc-clouddb-query-data-0000001080976888
開發準備和集成SDK必讀：
https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/agc-get-started-android-0000001058210705
SmartTable原專案及集成指導：
https://github.com/huangyanbin/smartTable
附另一篇示例講解：【Codelabs挑戰賽示例講解1】核酸檢測結果認證查詢系統-認證登錄
轉載請註明出處，本文鏈接：https://www.uj5u.com/yidong/458693.html
標籤：其他