鸿蒙Serverless云函数搭建，告别传统后端？

鸿蒙Serverless云函数搭建，告别传统后端？

[本文正在参加星光计划3.0-夏日挑战赛]

在6月19号，我在深圳分会场参与了“消失的服务器”HSD线下活动，HSD线下活动主要讲解了华为Serverless如何帮助开发者无服务器构建应用。在后面的限时Codelabs中，要求利用云函数做一个猜数字的安卓应用或者鸿蒙应用。我选择了后者，碍于没有提前做准备，集成云函数环境耗费了太多时间，也踩了很多坑，导致最后没能完成。本文将从零开始集成云函数服务，在云端完成猜数字的函数，Serverless服务或许是正在被引导的一种方向。

0. Serverless

关于Serverless服务，在华为开发者论坛上有一篇博文讲得非常详细，读者可仔细阅读。
Serverless服务帮您无服务器构建应用
那么Serverless到底有哪些优点，能帮我们做哪些事情呢？

• 成本可控化
  在传统的开发模式中，一款APP从开发到上架，其中的业务分析，架构设计，商业运营，后期运维，这期间有非常多的沟通时间，成本，较长的开发周期。Serverless云服务，恰好能够提供这样一系列的针对性的云服务，让原先未知的不可控的成本开销，变得似乎可以量化。
• 专注业务开发
  Serverless提供认证服务、云服务、云数据库、云托管、云存储以及Serverless模板等构建能力，统一构建自动弹性伸缩的后端服务。具有跨平台、上限快、低成本、免运维等特点。那么这样，大多数后端逻辑如果都基于Serverless开发，那么只需要聚焦业务代码的开发即可，关于后端的管理和运维都交给了云服务。

我粗浅的理解，一个前端开发者也能借助Serverless的简易便捷性，在低学习成本下，也能快速从前到后构建一个APP。

1.准备工作

1.3 业务分析

我们需要利用云函数，在云端判断猜测是否正确，应用端只负责接收用户传入的猜测的数字和传递随机数，数字传入云函数，云函数判断是大了，还是小了，还是猜对了，并且返回应用端。
说白了，这个判断在云端完成，HarmonyOS应用侧只负责编写页面，接收数据，返回结果，不做任何判断的事情。

1.2 创建应用，创建项目

• 创建一个应用，并且在AppGallery Connect创建项目，注意包名一致哦！
• 在HarmonyOS侧的云函数集成方式，目前只能在JAVA侧，不过由于HarmonyOS存在JS，JAVA的混合开发模式，编程语言倒不是问题。

2.集成云函数服务

这个环节，也是我踩坑比较多的环节，导致最后没能完成！

2.2 添加配置文件

2.2.1 我们进入到前文创建好的项目页面

选择下载配置文件，不包含密匙。

配置文件中默认会包含AGC为应用分配的客户端密钥和API密钥信息，但是经过尝试存在一定BUG。所以我们选择不包含密匙，在应用启动时候再分配密匙。

2.2.2 添加进入HarmonyOS项目工程的应用级目录

2.2.3 添加依赖

进入应用级的adle文件。

添加依赖, implementation ‘com.huawei.agconnect:agconnect-function-harmony:1.3.1.300’

dependencies {implementation fileTree(dir: 'libs', include: ['*.jar', '*.har'])testImplementation 'junit:junit:4.13.1'ohosTestImplementation 'com.stkit:runner:2.0.0.200'/*****************添加云函数依赖*********************/implementation 'com.huawei.agconnect:agconnect-function-harmony:1.3.1.300'
}

我们可以看到关键词，function这里对应的就是云函数的服务，还有云数据库之类的服务也有对应的关键词，但是似乎存在一定的bug，并且服务版本较低，相对提供给安卓的服务还是有一定差距。

2.3 启动应用时，分配密匙

前面我们在工程文件中放入了不含密匙的配置文件，我们需要在应用启动时候分配密匙。

• 我们先把前文的配置文件复制一份到resources/rawfile/目录下
  
• 我们进入JAVA文件夹中，打开MyApplication进行编写。

ample.random;import com.huawei.agconnect.AGConnectInstance;
import com.huawei.agconnect.AGConnectOptionsBuilder;
import ohos.aafwk.ability.AbilityPackage;
import source.RawFileEntry;
import source.Resource;
import source.ResourceManager;public class MyApplication extends AbilityPackage {@Overridepublic void onInitialize() {Initialize();in();}private void in(){//添加如下代码try {AGConnectOptionsBuilder builder = new AGConnectOptionsBuilder();ResourceManager resourceManager = getResourceManager();// agconnect-services.json 文件路径RawFileEntry rawFileEntry =  RawFileEntry("resources/rawfile/agconnect-services.json");Resource resource = rawFileEntry.openRawFile();builder.setInputStream(resource );// 如果您的json文件中不存在client_id、client_secret和api_key参数，需通过以下接口设置builder.setClientId("865143442517281664");builder.setClientSecret("6CDCF90B48310A1A80DF1B818848133BF3AE1EA8A61BE09C628894B262E7FC93");builder.setApiKey("DAEDADSYJyrB0DwxGwAReXl8nyYuCugvsdM4iCRmgf+jZhm+vzyPf+ViiznkGCTSI51Tv9JzxVpQlTjJuddZnqu9VuQ3nymhk8M7MA==");AGConnectInstance.initialize(this, builder);} catch (Exception e) {e.printStackTrace();}
//TODO: 添加代码结束}
}

注意：
代码中所需要的，client_id、client_secret和api_key参数分别来自于AGC构建的对应的项目页面上。

2.4 添加权限！！！！！

进入config.json文件
在"abilities"下添加

      {"permissions": ["com.DataAbilityShellProvider.PROVIDER"],"name": "com.provider.AGConnectInitializeAbility","type": "data",//j.card 此处为自己工程的包名"uri": "dataability://j.card.AGConnectInitializeAbility"}

至此，应用侧环境配置完成，下面为项目编写猜数字的云函数。

3.编写云函数

3.1 创建云函数

• 我们在我的项目页面，左侧栏上找到云函数，点击进入。
  
• 点击，立即开通。
  
• 点击，创建函数，进入到创建函数页面。
  这里的函数名称自拟，我们可以看到这里提供了在线编辑函数，或者上传其他编程语言的压缩包。这里我们在线进行Javascript编程。
  

3.2 编写云函数

我们进行在线的云函数编写。

• 业务代码

let myHandler = function(event, context, callback, logger) { var res = new context.v, { "res-type":&#v", "faas-content-type":"json", 
},"application/json", "200"); //定义一个全局变量，接收用户传来的数据var guess_num; //定义一个全局变量，接收应用端生成的随机数var random_num;//random_num = il(Math.random()*100); if (event.body) { //如果传过来的是一个对象 那么解析，获取对应数据。var _body = JSON.parse(event.body); //设置随机数random_num =_body.random_num;//当前猜测的数据 guess_num = _body.guess_num; } else { guess_num = event.guess_num; } //定义一个变量 用来返回结果var result="";//执行猜测函数result = randNumgame(guess_num);res = result; //返回结果context.callback(res); function randNumgame (inputNum) { var resultString; //判断猜测数据是否合法if (!isNumber(inputNum)) { resultString = "input is not a number"; } else { var remainder = inputNum; //大于正确数据if(remainder>random_num)resultString="大了";//等于正确数据else if(remainder ==random_num)resultString = "正确"elseresultString = "小了"} //返回字符串结果return resultString; 
} //判断数据是否合法function isNumber (input) { if (parseInt(input).toString == "NaN") { return false; } else { return true; } 
} 
} ; Handler =myHandler;

• 函数创建完成后，点击右上角保存保存
  

3.3 添加触发器

• 选择触发器，点击添加触发器
  
• 创建成功后，查看信息，找到函数的标识符号
  
  这个名称非常重要，是我们进入函数的标识！

至此，云函数已经编写配置完成了，接下来是应用的简单编写。

4. HarmonyOS侧应用

4.1 启动云函数功能

启动云函数功能，只需要实例化AGConnectFunction即可

private AGConnectFunction function;
function = Instance();

我们对云函数的调用都是通过function实现的

4.2 调用云函数

 private void getWeek(int num) {HashMap<String,Integer> map = new HashMap();//两个对象，分别对应JS云函数中的 random_num  和 guess_nummap.put("random_num",random_num);map.put("guess_num", num);/*注意！ 这里的“guess-test” 就是我们在触发器配置信息里面的标识*/function2.wrap("guess-$latest").call(map).addOnCompleteListener(new OnHarmonyCompleteListener<FunctionResult>() {@Overridepublic void onComplete(HarmonyTask<FunctionResult> task) {if (task.isSuccessful()) {//获取返回值，对应JS云函数中的resString value = Result().getValue();HiLog.info(LABEL,value);tx.setText(value);//如果正确 再刷新随机数if(value=="正确"){random_num=new Random().nextInt(100);}} else {Exception e = Exception();if (e instanceof AGCFunctionException) {AGCFunctionException functionException = (AGCFunctionException) e;int errCode = Code();String message = Message();(LABEL,message);}// ...}}});}

4.3 简单Demo

• 界面
  
• MainAbilitySlice

ample.random.slice;ample.random.ResourceTable;
import com.huawei.agconnect.AGConnectInstance;
import com.huawei.agconnect.AGConnectOptionsBuilder;
import com.huawei.agconnect.auth.AGConnectAuthCredential;
import com.huawei.agconnect.function.AGCFunctionException;
import com.huawei.agconnect.function.AGConnectFunction;
import com.huawei.agconnect.function.FunctionResult;
import com.huawei.hmf.tasks.HarmonyTask;
import com.huawei.hmf.tasks.OnHarmonyCompleteListener;
import ohos.aafwk.ability.AbilitySlice;
import t.Intent;
import ohos.agpponents.Button;
import ohos.agpponents.Component;
import ohos.agpponents.Text;
import ohos.agpponents.TextField;
import source.RawFileEntry;
import source.Resource;
import source.ResourceManager;
import ohos.hiviewdfx.HiLog;
import ohos.hiviewdfx.HiLogLabel;
import ohos.utils.zson.ZSONObject;import java.util.HashMap;
import java.util.Random;public class MainAbilitySlice extends AbilitySlice {private AGConnectFunction function2 ;private TextField textField;private Text tx;private Button btn;private int random_num;private static final HiLogLabel LABEL = new HiLogLabel(0, 0, "=>JAVA:" );@Overridepublic void onStart(Intent intent) {Start(intent);super.setUIContent(ResourceTable.Layout_ability_main);//启动AGC服务start();//生成随机数Random r = new Random();random_num = r.nextInt(100);//测试控件textField = (TextField) findComponentById(ResourceTable.Id_tf);btn = (Button) findComponentById(ResourceTable.Id_btn);tx= (Text) findComponentById(ResourceTable.Id_tx);//绑定事件，点击一次进行数字猜测btn.setClickedListener(new Component.ClickedListener() {@Overridepublic void onClick(Component component) {getWeek(Integer.Text()));HiLog.info(LABEL, String.valueOf(Integer.Text())));}});}private void start(){//启动函数try {function2= Instance();} catch (Exception e) {e.printStackTrace();}}private void getWeek(int num) {HashMap<String,Integer> map = new HashMap();//两个对象，分别对应JS云函数中的 random_num  和 guess_nummap.put("random_num",random_num);map.put("guess_num", num);/*注意！ 这里的“guess-test” 就是我们在触发器配置信息里面的标识*/function2.wrap("guess-$latest").call(map).addOnCompleteListener(new OnHarmonyCompleteListener<FunctionResult>() {@Overridepublic void onComplete(HarmonyTask<FunctionResult> task) {if (task.isSuccessful()) {//获取返回值，对应JS云函数中的resString value = Result().getValue();HiLog.info(LABEL,value);tx.setText(value);//如果正确 再刷新随机数if(value=="正确"){random_num=new Random().nextInt(100);}} else {Exception e = Exception();if (e instanceof AGCFunctionException) {AGCFunctionException functionException = (AGCFunctionException) e;int errCode = Code();String message = Message();(LABEL,message);}// ...}}});}@Overridepublic void onActive() {Active();}@Overridepublic void onForeground(Intent intent) {Foreground(intent);}
}

5. 结果

关于codelab的内容其实是非常简单的，只是在环境配置上走了不少弯路，尤其是权限的赋予非常重要。在Serverless的加持下，开发人员能够专注于核心业务的开发，一些运维后端的处理可以交由云端托管。目前Serverless的全套服务在安卓上有非常多的案例，也比较好适配。鸿蒙开发上似乎资料不多，案例较少，但未来Serverless势必会全套适配鸿蒙开发。届时，必大有可为。