顯式Want與隱式Want匹配規(guī)則

在啟動目標應用組件時，會通過顯式[Want]或者隱式[Want]進行目標應用組件的匹配，這里說的匹配規(guī)則就是調(diào)用方傳入的[want]參數(shù)中設置的參數(shù)如何與目標應用組件聲明的配置文件進行匹配。

顯式Want匹配原理

顯式[Want]匹配原理如下表所示。

隱式Want匹配原理

隱式[Want]匹配原理如下表所示。

從隱式Want的定義，可得知：

• 調(diào)用方傳入的want參數(shù)，表明調(diào)用方需要執(zhí)行的操作，并提供相關數(shù)據(jù)以及其他應用類型限制。
• 待匹配應用組件的skills配置，聲明其具備的能力（[module.json5配置文件]參數(shù)）。

系統(tǒng)將調(diào)用方傳入的want參數(shù)（包含action、entities、uri和type屬性）與已安裝待匹配應用組件的skills配置（包含actions、entities、uris和type屬性）依次進行匹配。當四個屬性匹配均未配置，隱式匹配失敗。當四個屬性匹配均通過，則此應用才會被應用選擇器展示給用戶進行選擇。

want參數(shù)的action匹配規(guī)則

將調(diào)用方傳入的want參數(shù)的action與待匹配應用組件的skills配置中的actions進行匹配。

• 調(diào)用方傳入的want參數(shù)的action為空，待匹配Ability的skills配置中的actions為空，則action匹配失敗。
• 調(diào)用方傳入的want參數(shù)的action不為空，待匹配應用組件的skills配置中的actions為空，則action匹配失敗。
• 調(diào)用方傳入的want參數(shù)的action為空，待匹配應用組件的skills配置中的actions不為空，則action匹配成功。
• 調(diào)用方傳入的want參數(shù)的action不為空，待匹配應用組件的skills配置中的actions不為空且包含調(diào)用方傳入的want參數(shù)的action，則action匹配成功。
• 調(diào)用方傳入的want參數(shù)的action不為空，待匹配應用組件的skills配置中的actions不為空且不包含調(diào)用方傳入的want參數(shù)的action，則action匹配失敗。
  圖1 want參數(shù)的action匹配規(guī)則

want參數(shù)的entities匹配規(guī)則

將調(diào)用方傳入的want參數(shù)的entities與待匹配應用組件的skills配置中的entities進行匹配。

• 調(diào)用方傳入的want參數(shù)的entities為空，待匹配應用組件的skills配置中的entities不為空，則entities匹配成功。
• 調(diào)用方傳入的want參數(shù)的entities為空，待匹配應用組件的skills配置中的entities為空，則entities匹配成功。
• 調(diào)用方傳入的want參數(shù)的entities不為空，待匹配應用組件的skills配置中的entities為空，則entities匹配失敗。
• 調(diào)用方傳入的want參數(shù)的entities不為空，待匹配應用組件的skills配置中的entities不為空且包含調(diào)用方傳入的want參數(shù)的entities，則entities匹配成功。
• 調(diào)用方傳入的want參數(shù)的entities不為空，待匹配應用組件的skills配置中的entities不為空且不完全包含調(diào)用方傳入的want參數(shù)的entities，則entities匹配失敗。
  圖2 want參數(shù)的entities匹配規(guī)則

want參數(shù)的uri和type匹配規(guī)則

調(diào)用方傳入的want參數(shù)中設置uri和type參數(shù)發(fā)起啟動應用組件的請求，系統(tǒng)會遍歷當前系統(tǒng)已安裝的組件列表，并逐個匹配待匹配應用組件的skills配置中的uris數(shù)組，如果待匹配應用組件的skills配置中的uris數(shù)組中只要有一個可以匹配調(diào)用方傳入的want參數(shù)中設置的uri和type即為匹配成功。

實際應用中，uri和type共存在四種情況，下面將講解四種情況的具體匹配規(guī)則：

• 調(diào)用方傳入的want參數(shù)的uri和type都為空。
  1. 如果待匹配應用組件的skills配置中的uris數(shù)組為空，匹配成功。
  2. 如果待匹配應用組件的skills配置中的uris數(shù)組中存在uri的scheme和type都為空的元素，匹配成功。
  3. 除以上兩種情況，其他情況均為匹配失敗。
• 調(diào)用方傳入的want參數(shù)的uri不為空，type為空。
  1. 如果待匹配應用組件的skills配置中的uris數(shù)組為空，匹配失敗。
  2. 如果待匹配應用組件的skills配置中的uris數(shù)組存在一條數(shù)據(jù)[uri匹配]成功且type為空，則匹配成功，否則匹配失敗。
  3. 如果前兩條均匹配失敗，并且傳入的uri為文件路徑uri，則根據(jù)文件后綴獲取文件的MIME類型，如果該類型與skills文件中配置的type相匹配，則匹配成功。
• 調(diào)用方傳入的want參數(shù)的uri為空，type不為空。
  1. 如果待匹配應用組件的skills配置中的uris數(shù)組為空，匹配失敗。
  2. 如果待匹配應用組件的skills配置中的uris數(shù)組存在一條數(shù)據(jù)uri的scheme為空且[type匹配]成功，則匹配成功，否則匹配失敗。
• 調(diào)用方傳入的want參數(shù)的uri和type都不為空，如下圖所示。
  1. 如果待匹配應用組件的skills配置中的uris數(shù)組為空，匹配失敗。
  2. 如果待匹配應用組件的skills配置中的uris數(shù)組存在一條數(shù)據(jù)[uri匹配]和[type匹配]需要均匹配成功，則匹配成功，否則匹配失敗。

最左uri匹配：當配置文件待匹配應用組件的skills配置中的uris數(shù)組中只配置scheme；或者只配置scheme和host；或者只配置scheme、host和port時。傳入want參數(shù)的uri的最左邊依次需要和scheme，或者scheme和host，或者scheme、host和port都匹配，才滿足最左uri匹配。

圖3 want參數(shù)中uri和type皆不為空時的匹配規(guī)則

為了簡化描述：

• 稱調(diào)用方傳入的want參數(shù)中的uri參數(shù)為w_uri；待匹配應用組件的skills配置中uri為s_uri，其中每個元素為s_uri。
• 稱調(diào)用方傳入的want參數(shù)的type參數(shù)為w_type，待匹配應用組件的skills數(shù)組中uris的type數(shù)據(jù)為s_type。

圖4 want參數(shù)中uri和type的具體匹配規(guī)則

uri匹配規(guī)則

具體的匹配規(guī)則如下：

• 如果s_uri的scheme為空，當w_uri為空時匹配成功，否則匹配失敗。
• 如果s_uri的host為空，當w_uri和s_uri的scheme相同時匹配成功，否則匹配失敗。
• 如果s_uri的port為空，當w_uri和s_uri中的scheme和host相同時匹配成功，否則匹配失敗。
• 如果s_uri的path、pathStartWith和pathRegex都為空，當w_uri和s_uri中的scheme，host和port相同時匹配成功，否則匹配失敗。
• 如果s_uri的path不為空，當w_uri和s_uri全路徑表達式相同時匹配成功，否則繼續(xù)進行pathStartWith的匹配。
• 如果s_uri的pathStartWith不為空，當w_uri包含s_uri前綴表達式時匹配成功，否則繼續(xù)進行pathRegex的匹配。
• 如果s_uri的pathRegex不為空，當w_uri滿足s_uri正則表達式時匹配成功，否則匹配失敗。

說明：

待匹配應用組件的skills配置的uris中scheme、host、port、path、pathStartWith和pathRegex屬性拼接，如果依次聲明了path、pathStartWith和pathRegex屬性時，uris將分別拼接為如下三種表達式：

• 前綴uri表達式 ：當配置文件只配置scheme，或者只配置scheme和host，或者只配置scheme，host和port時，參數(shù)傳入以配置文件為前綴的Uri
  • scheme://
  • scheme://host
  • scheme://host:port
• 全路徑表達式 ：scheme://host:port/path
• 前綴表達式 ：scheme://host:port/pathStartWith
• 正則表達式 ：scheme://host:port/pathRegex

系統(tǒng)應用預留uri的scheme統(tǒng)一以ohos開頭，例如ohosclock://。三方應用組件配置的uri不能與系統(tǒng)應用重復，否則會導致無法通過該uri拉起三方應用組件。

type匹配規(guī)則

說明：

本章節(jié)所述的type匹配規(guī)則的適用性需建立在want參數(shù)內(nèi)type不為空的基礎上。當want參數(shù)內(nèi)type為空時請參見[want參數(shù)的uri和type匹配規(guī)則]。

具體的匹配規(guī)則如下：

• 如果s_type為空，則匹配失敗。
• 如果s_type或者w_type為通配符*/*，則匹配成功。
• 如果s_type最后一個字符為通配符*，如prefixType/*，則當w_type包含prefixType/時匹配成功，否則匹配失敗。
• 如果w_type最后一個字符為通配符*，如prefixType/*，則當s_type包含prefixType/時匹配成功，否則匹配失敗。

審核編輯 黃宇