返回发烧友论坛
发 帖  

[文章]OpenHarmony 3.1 Beta版本关键特性解析——探秘隐式查询

OpenHarmony开发者
2022-03-22 18:35:18
阅读量0
OpenHarmony应用开发
0
0
（以下内容来自开发者分享，不代表 OpenHarmony 项目群工作委员会观点）

徐浩

隐式查询是 OpenAtom OpenHarmony（以下简称“OpenHarmony”）的一个基础能力，被广泛应用于各种应用中（如视频播放、阅读器播放等）。应用通过隐式查询可以借助其他应用提供的能力，从而减少开发者工作量，同时给用户带来更好的体验。

那么隐式查询是什么？隐式查询是如何实现的？等等一连串疑问想必是开发者们最关心的问题，本期将对这些问题进行详细的解答。

一、什么是隐式查询？

当一个应用执行某操作时，如果应用自己不具备此操作需要的能力，则会触发系统的隐式查询功能。系统去查找其他具备此项能力的应用，并通过应用选择器展示给用户，让用户选择使用哪个应用来完成操作。

为了帮助大家理解，我们来举个例子：

在微信中打开 pdf 文件时， 如果没有设置默认的 pdf 文件阅读器，那么系统会通过隐式查询查找所有具备 pdf 阅读能力的应用，并通过应用选择器将其展示给用户进行选择。

二、隐式查询代码解析

从上面隐式查询的定义，我们了解到：
1. 查询方应用需要执行要执行的操作。
2. 其他应用需要声明自己具备的能力。

下面我们结合示例，看看具体的代码实现吧。

第一步：在查询方应用的 Ability 中通过 want 信息指定要执行的操作。

want 信息示例代码如下：

  1. "want"{  
  2.       "action":"action.system.play",  
  3.       "entities":["entity.system.video", "entity.system.camera"],  
  4.       "uri" :"[url]https://www.test.com:8080/query/student/name"[/url],  
  5.       "type":"text/plain"  
  6.   }
复制代码

当应用调用 startAbility 接口启动 Ability 时，通过 want 信息中的 action、entities、uri 和 type 属性指定要执行的操作。

第二步：在其他应用的配置文件 config.json 中通过 skills 参数声明具备的能力。

skills 信息示例代码如下：

  1. "skills": [  
  2.     {  
  3.       "actions": ["action.system.play"],  
  4.       "entities": ["entity.system.video", "entity.system.camera"],  
  5.       "uris": [  
  6.         {  
  7.           "scheme": "https",  
  8.           "host": "[url]www.test.com[/url]",  
  9.           "port": "8080",  
  10.           "path": "query/student/name",  
  11.            "pathStartWith":"query/student",  
  12.           "pathRegex":"query/.*/name",
  13.           "type": "text/plain"  
  14.         }  
  15.       ]  
  16.     }  
  17.   ]
复制代码

完成上面两步，系统就可以进行隐式查询了。系统按照隐式查询规则，将其他应用的 skills 信息与查询方应用的 want 信息进行匹配，然后将匹配成功的应用通过应用选择器展示给用户进行选择。

下面我们为大家详细讲解隐式查询的匹配规则。

三、隐式查询匹配规则详解

系统将其他应用的 skills 信息（包含 actions、entities 和 uris 属性）与查询方应用的 want 信息（包含 action、entities、uri 和 type 属性）进行匹配，具体匹配规则如下：

1. action 匹配规则

将其他应用 skills 信息中的 actions 与查询方应用 want 信息中的 action 进行匹配。
  • 如果 skills 信息中的 actions 为空，匹配不通过。
  • 如果 skills 信息中的 actions 不为空，且其包含 want 信息中的 action（可以为空），匹配通过。否则匹配不通过。

2. entities 匹配规则

将其他应用 skills 信息中的 entities 与查询方应用 want 信息中的 entities 进行匹配。
  • 如果 skills 信息中的 entities 为空，则只有当 want 信息中的 entities 为空时才匹配通过。否则匹配不通过。
  • 如果 skills 信息中的 entities 不为空，且其包含 want 信息中的 entities（可以为空），匹配通过。否则匹配不通过。

3. uri 匹配规则

将其他应用 skills 信息的 uris 中的 scheme、host、port、path、pathStartWith 和 pathRegex 属性拼接成uri（scheme://host:port/(path;pathStartWith;pathRegex)），将此 uri 与查询方应用 want 信息中的 uri 进行匹配。其中，path 为完整路径匹配，pathStartWith 为前缀匹配，pathRegx 为正则匹配。

skills 信息的 uris 中的 type 与 want 信息中的 type 进行匹配，支持*通配符匹配。
  • 如果 skills 信息拼接的 uri 为空，则只有当 want 信息中的 uri 为空时才匹配通过。否则匹配不通过。
  • 如果 skills 信息拼接的 uri 不为空，且其包含 want 信息中的 uri（不可以为空），uri 匹配通过。否则匹配不通过。

4. type 匹配规则

将其他应用 skills 信息的 uris 中的 type 与查询方应用 want 信息中的 type 进行匹配，支持*通配符匹配。
  • 如果 skills 信息中的 type 为空，则只有当 want 信息中的 type 为空时才匹配通过。否则匹配不通过。
  • 如果 skills 信息中的 type 不为空，且其包含 want 信息中的 type（不可以为空），匹配通过。否则匹配不通过。

当应用的以上四个属性都匹配通过，此应用才会被应用选择器展示给用户进行选择。

四、典型隐式查询匹配示例

为了让大家更好地理解，下面我们看看几个典型的匹配示例：

示例1：

查询方应用的 want 信息示例代码：

  1. featureAbility.startAbility({  
  2.     "want": {  
  3.       "action": "action.system.play"  
  4.     }, }).then((data) => {})
复制代码

其他应用的 skills 信息示例代码：

  1. "skills": [   
  2.     {   
  3.       "actions": ["action.system.play"]   
  4.     }   
  5.   ]
复制代码

  • skills 信息中的 actions 不为空，且其包含 want 信息中的 action，action 匹配通过。
  • skills 信息中的 entities 为空，want 信息中的 entities 也为空，entities 匹配通过。同理，uri 和 type 也匹配通过。

此示例，四个属性均匹配成功，则此应用匹配成功，会被应用选择器展示给用户进行选择。

示例2：

查询方应用的 want 信息示例代码：

  1. featureAbility.startAbility({  
  2.     "want": {  
  3.       "type": "prefixType/suffixType",  
  4.     }, }).then((data) => {})
复制代码

其他应用的 skills 信息示例代码：

  1. "skills": [  
  2.     {  
  3.        "actions": ["action.system.play"],
  4.       "uris": [  
  5.         {  
  6.           "type": "prefixType/suffixType"  
  7.         }  
  8.       ]  
  9.     }  
  10.   ]
复制代码

  • skills 信息中的 actions 不为空， want 信息中的 action 为空，action 匹配通过。
  • skills 信息中的 entities 为空，want 信息中的 entities 也为空，entities 匹配通过。同理，uri 也匹配通过。
  • skills 信息中的 type 不为空，且其包含 want 信息中的 type，type 匹配通过。

此示例，四个属性均匹配成功，则此应用匹配成功，会被应用选择器展示给用户进行选择。

示例3：

查询方应用的 want 信息示例代码：

  1. featureAbility.startAbility({  
  2.     "want": {  
  3.       "type": "text/plain",  
  4.       "uri": "[url]https://www.test.com:8080/query/student"[/url]  
  5.     }, }).then((data) => {})  
复制代码

其他应用的 skills 信息示例代码：

  1. "skills": [  
  2.     {  
  3.        "actions": ["action.system.play"],
  4.       "uris": [  
  5.         {  
  6.           "scheme": "https",  
  7.           "host": "[url]www.test.com[/url]",  
  8.           "port": "8080",  
  9.           "path": "query/student",  
  10.           "type": "text/*"  
  11.         }  
  12.       ]  
  13.     }  
复制代码

  • skills 信息中的 actions 不为空， want 信息中的 action 为空，action 匹配通过。
  • skills 信息中的 entities 为空，want 信息中的 entities 也为空，entities 匹配通过。
  • skills 信息的 uris 中 scheme、host、port 和 path 属性拼接出 uri 为 https://www.test.com:8080/query/student，与 want 信息中的 uri 一致，uri 匹配通过。
  • skills 信息中的 type 为 text/*（*表示通配），want 信息中的 type 为 text/plain，type 匹配通过。

此示例，四个属性均匹配成功，则此应用匹配成功，会被应用选择器展示给用户进行选择。

示例4：

查询方应用的 want 信息示例代码：

  1. featureAbility.startAbility({  
  2.     "want": {  
  3.       "action": "action.system.play",  
  4.       "entities":["entity.system.video"],  
  5.       "type": "text/plain",  
  6.       "uri": "[url]https://www.test.com/query/student"[/url]  
  7.     }, }).then((data) => {})
复制代码

其他应用的 skills 信息示例代码：

  1. "skills": [  
  2.     {  
  3.       "actions": ["action.system.play"],  
  4.       "entities": ["entity.system.video"],  
  5.       "uris": [  
  6.         {  
  7.           "scheme": "https",  
  8.           "host": "[url]www.test.com[/url]",  
  9.           "pathStartWith": "query",  
  10.           "type": "text/plain"  
  11.         }  
  12.       ]  
  13.     }  
  14.   ]
复制代码

  • skills 信息中的 actions 不为空， want 信息中的 action 为空，action 匹配通过。
  • skills 信息中的 entities 为空，want 信息中的 entities 也为空，entities 匹配通过。
  • skills 信息的 uris 中 scheme、host、port 和 path 属性拼接出 uri 为 https://www.test.com:8080/query/student，与 want 信息中的 uri 一致，uri 匹配通过。
  • skills 信息中的 type 为 text/*（*表示通配），want 信息中的 type 为 text/plain，type 匹配通过。

此示例，四个属性均匹配成功，则此应用匹配成功，会被应用选择器展示给用户进行选择。

通过以上示例，相信大家已经清楚隐式查询匹配规则了。我们在全文介绍了隐式查询是什么，并对隐式查询的相关代码和匹配规则进行了深入剖析。

隐式查询，你都 get 到了吗？希望开发者们可以将隐式查询应用于更多的场景和领域中。


举报

回帖

声明：本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人，不代表电子发烧友网立场。文章及其配图仅供工程师学习之用，如有内容图片侵权或者其他问题，请联系本站作侵删。 侵权投诉
链接复制成功，分享给好友