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

隱式Want匹配原理詳解

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

• 調(diào)用方傳入的want參數(shù)，表明調(diào)用方需要執(zhí)行的操作，并提供相關(guān)數(shù)據(jù)以及其他應(yīng)用類型限制。

• 待匹配Ability的skills配置，聲明其具備的能力（module.json5配置文件中的skills標(biāo)簽參數(shù)）。

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

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

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

• 調(diào)用方傳入的want參數(shù)的action為空，待匹配Ability的skills配置中的actions為空，則action匹配失敗。

• 調(diào)用方傳入的want參數(shù)的action不為空，待匹配Ability的skills配置中的actions為空，則action匹配失敗。

• 調(diào)用方傳入的want參數(shù)的action為空，待匹配Ability的skills配置中的actions不為空，則action匹配成功。

• 調(diào)用方傳入的want參數(shù)的action不為空，待匹配Ability的skills配置中的actions不為空且包含調(diào)用方傳入的want參數(shù)的action，則action匹配成功。

• 調(diào)用方傳入的want參數(shù)的action不為空，待匹配Ability的skills配置中的actions不為空且不包含調(diào)用方傳入的want參數(shù)的action，則action匹配失敗。

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

  

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

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

• 調(diào)用方傳入的want參數(shù)的entities為空，待匹配Ability的skills配置中的entities不為空，則entities匹配成功。

• 調(diào)用方傳入的want參數(shù)的entities為空，待匹配Ability的skills配置中的entities為空，則entities匹配成功。

• 調(diào)用方傳入的want參數(shù)的entities不為空，待匹配Ability的skills配置中的entities為空，則entities匹配失敗。

• 調(diào)用方傳入的want參數(shù)的entities不為空，待匹配Ability的skills配置中的entities不為空且包含調(diào)用方傳入的want參數(shù)的entities，則entities匹配成功。

• 調(diào)用方傳入的want參數(shù)的entities不為空，待匹配Ability的skills配置中的entities不為空且不完全包含調(diào)用方傳入的want參數(shù)的entities，則entities匹配失敗。

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

  

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

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

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

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

• 調(diào)用方傳入的want參數(shù)的uri和type都為空。

  1. 如果待匹配Ability的skills配置中的uris數(shù)組為空，匹配成功。
  2. 如果待匹配Ability的skills配置中的uris數(shù)組中存在uri的scheme和type都為空的元素，匹配成功。
  3. 除以上兩種情況，其他情況均為匹配失敗。

• 調(diào)用方傳入的want參數(shù)的uri不為空，type為空。

  1. 如果待匹配Ability的skills配置中的uris數(shù)組為空，匹配失敗。
  2. 如果待匹配Ability的skills配置中的uris數(shù)組存在一條數(shù)據(jù)uri匹配成功且type為空，則匹配成功，否則匹配失敗。

• 調(diào)用方傳入的want參數(shù)的uri為空，type不為空。

  1. 如果待匹配Ability的skills配置中的uris數(shù)組為空，匹配失敗。
  2. 如果待匹配Ability的skills配置中的uris數(shù)組存在一條數(shù)據(jù)uri的scheme為空且type匹配成功，則匹配成功，否則匹配失敗。

• 調(diào)用方傳入的want參數(shù)的uri和type都不為空，如圖3所示。

  1. 如果待匹配Ability的skills配置中的uris數(shù)組為空，匹配失敗。
  2. 如果待匹配Ability的skills配置中的uris數(shù)組存在一條數(shù)據(jù)uri匹配和type匹配需要均匹配成功，則匹配成功，否則匹配失敗。

下圖為了簡化描述，稱want中傳入的uri為w_uri，稱want中傳入的type為w_type, 待匹配Ability的skills配置中uris為s_uris，其中每個元素為s_uri；按自上而下順序匹配。

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

uri匹配規(guī)則

這里為了簡化描述，稱want中傳入的uri為w_uri，待匹配Ability的skills配置中uri為s_uri，具體的匹配規(guī)則如下：

• 如果s_uri的scheme為空，當(dāng)w_uri為空時匹配成功，否則匹配失敗；

• 如果s_uri的host為空，當(dāng)w_uri和s_uri的scheme相同時匹配成功，否則匹配失??；

• 如果s_uri的path、pathStartWith和pathRegex都為空，當(dāng)w_uri和s_uri完全相同時匹配成功，否則匹配失??；

• 如果s_uri的path不為空，當(dāng)w_uri和s_uri全路徑表達(dá)式相同時匹配成功，否則繼續(xù)進(jìn)行pathStartWith的匹配；

• 如果s_uri的pathStartWith不為空，當(dāng)w_uri包含s_uri前綴表達(dá)式時匹配成功，否則繼續(xù)進(jìn)行pathRegex的匹配；

• 如果s_uri的pathRegex不為空，當(dāng)w_uri滿足s_uri正則表達(dá)式時匹配成功，否則匹配失敗；

type匹配規(guī)則

這里為了簡化描述，稱want中傳入的uri為w_type，待匹配Ability的skills數(shù)組中uris的type數(shù)據(jù)為s_type，具體的匹配規(guī)則如下：

• 如果s_type為空，則匹配失敗。

• 如果s_type或者w_type為通配符"*/*"，則匹配成功。

• 如果s_type最后一個字符為通配符'*'，如"prefixType/*"，則當(dāng)w_type包含"prefixType/"時匹配成功，否則匹配失敗。

• 如果w_type最后一個字符為通配符'*'，如"prefixType/*"，則當(dāng)s_type包含"prefixType/"時匹配成功，否則匹配失敗。