1# Matching Rules of Explicit Want and Implicit Want 2 3Both explicit Want and implicit Want can be used to match an ability to start based on certain rules. These rules determine how the parameters set in Want match the configuration file declared by the target ability. 4 5## Matching Rules of Explicit Want 6 7| Name| Type| Matching Item| Mandatory| Rule Description| 8| -------- | -------- | -------- | -------- | -------- | 9| deviceId | string | Yes| No| If this field is unspecified, only abilities on the local device are matched.| 10| bundleName | string | Yes| Yes| If **abilityName** is specified but **bundleName** is unspecified, the matching fails.| 11| moduleName | string | Yes| No| If this field is unspecified and multiple modules with the same ability name exist in the application, the first ability is matched by default.| 12| abilityName | string | Yes| Yes| To use explicit Want, this field must be specified.| 13| uri | string | No| No| This field is not used for matching. It is passed to the target ability as a parameter.| 14| type | string | No| No| This field is not used for matching. It is passed to the target ability as a parameter.| 15| action | string | No| No| This field is not used for matching. It is passed to the target ability as a parameter.| 16| entities | Array<string> | No| No| This field is not used for matching. It is passed to the target ability as a parameter.| 17| flags | number | No| No| This field is not used for matching and is directly transferred to the system for processing. It is generally used to set runtime information, such as URI data authorization.| 18| parameters | {[key: string]: any} | No| No| This field is not used for matching. It is passed to the target ability as a parameter.| 19 20## Matching Rules of Implicit Want 21 22| Name | Type | Matching Item| Mandatory| Rule Description | 23| ----------- | ------------------------------ | ------ | ---- | ------------------------------------------------------------ | 24| deviceId | string | Yes | No | Implicit invoking is not supported across devices. | 25| abilityName | string | No | No | To use implicit Want, this field must be left unspecified. | 26| bundleName | string | Yes | No | - When only **bundleName** is specified, matching is limited to that application.<br>- When both **bundleName** and **moduleName** are specified, matching is limited to that module in that application.<br>- When only **moduleName** is specified, the setting is invalid.<br> <br>These fields will be used for implicit matching.| 27| moduleName | string | Yes | No | | 28| uri | string | Yes | No | | 29| type | string | Yes | No | | 30| action | string | Yes | No | | 31| entities | Array<string> | Yes | No | | 32| flags | number | No | No | This field is not used for matching and is directly transferred to the system for processing. It is generally used to set runtime information, such as URI data authorization.| 33| parameters | {[key: string]: any} | No | No | This field is not used for matching. It is passed to the target ability as a parameter. | 34 35 36## Interpretation of Implicit Want Matching Rules 37Get familiar with the following about implicit Want: 38 39- The **want** parameter passed by the caller indicates the operation to be performed by the caller. It also provides data and application type restrictions. 40 41- The **skills** field declares the capabilities of the target ability. For details, see [the skills tag](../quick-start/module-configuration-file.md#skills) in the [module.json5 file](../quick-start/module-configuration-file.md). 42 43 44The system matches the **want** parameter (including the **action**, **entities**, **uri**, and **type** attributes) passed by the caller against the **skills** configuration (including the **actions**, **entities**, **uris**, and **type** attributes) of the abilities one by one. When all the four attributes are matched, a dialog box is displayed for users to select a matched application. 45 46 47### Matching Rules of action in the want Parameter 48 49The system matches the **action** attribute in the **want** parameter passed by the caller against **actions** under **skills** of the abilities. 50 51- If **action** in the passed **want** parameter is specified but **actions** under **skills** of an ability is unspecified, the matching fails. 52 53- If **action** in the passed **want** parameter is unspecified but **actions** under **skills** of an ability is specified, the matching is successful. 54 55- If **action** in the passed **want** parameter is specified, and **actions** under **skills** of an ability is specified and contains **action** in the passed **want** parameter, the matching is successful. 56 57- If **action** in the passed **want** parameter is specified, and **actions** under **skills** of an ability is specified but does not contain **action** in the passed **want** parameter, the matching fails. 58 59 **Figure 1** Matching rules of action in the want parameter 60 61  62 63 64### Matching Rules of entities in the want Parameter 65 66The system matches the **entities** attribute in the **want** parameter passed by the caller against **entities** under **skills** of the abilities. 67 68- If **entities** in the passed **want** parameter is unspecified but **entities** under **skills** of an ability is specified, the matching is successful. 69 70- If **entities** in the passed **want** parameter is unspecified but **entities** under **skills** of an ability is unspecified, the matching is successful. 71 72- If **entities** in the passed **want** parameter is specified but **entities** under **skills** of an ability is unspecified, the matching fails. 73 74- If **entities** in the passed **want** parameter is specified, and **entities** under **skills** of an ability is specified and contains **entities** in the passed **want** parameter, the matching is successful. 75 76- If **entities** in the passed **want** parameter is specified, and **entities** under **skills** of an ability is specified but does not contain **entities** in the passed **want** parameter, the matching fails. 77 78 **Figure 2** Matching rule of entities in the want parameter 79 80  81 82 83### Matching Rules of uri and type in the want Parameter 84 85When the **uri** and **type** parameters are specified in the **want** parameter to initiate a component startup request, the system traverses the list of installed components and matches the **uris** array under **skills** of the abilities one by one. If one of the **uris** arrays under **skills** matches the **uri** and **type** in the passed **want**, the matching is successful. 86 87There are four combinations of **uri** and **type** settings. The matching rules are as follows: 88 89- Neither **uri** or **type** is specified in the **want** parameter. 90 - If the **uris** array under **skills** of an ability is unspecified, the matching is successful. 91 - If the **uris** array under **skills** of an ability contains an URI element whose **scheme** and **type** are unspecified, the matching is successful. 92 - In other cases, the matching fails. 93 94- Only **uri** is specified in the **want** parameter. 95 - If the **uris** array under **skills** of an ability is unspecified, the matching fails. 96 - If the **uris** array under **skills** of an ability contains an element whose [uri is matched](#matching-rules-of-uri) and **type** is unspecified, the matching is successful. Otherwise, the matching fails. 97 98- Only **type** is specified in the **want** parameter. 99 - If the **uris** array under **skills** of an ability is unspecified, the matching fails. 100 - If the **uris** array under **skills** of an ability contains an URI element whose **scheme** is unspecified and [type is matched](#matching-rules-of-type), the matching is successful. Otherwise, the matching fails. 101 102- Both **uri** and **type** are specified in the **want** parameter, as shown in Figure 3. 103 - If the **uris** array under **skills** of an ability is unspecified, the matching fails. 104 - If the **uris** array under **skills** of an ability contains an element whose [uri is matched](#matching-rules-of-uri) and [type is matched](#matching-rules-of-type), the matching is successful. Otherwise, the matching fails. 105 106Leftmost URI matching: When only **scheme**, a combination of **scheme** and **host**, or a combination of **scheme**, **host**, and **port** is configured in the **uris** array under **skills** of the ability, 107the matching is successful only if the leftmost URI in the passed **want** parameter matches **scheme**, the combination of **scheme** and **host**, or the combination of **scheme**, **host**, and **port**. 108 109**Figure 3** Matching rules when uri and type are specified in the want parameter 110 111  112 113 114To simplify the description, **uri** and **type** passed in the **want** parameter are called **w_uri** and **w_type**, respectively; the **uris** array under **skills** of an ability to match is called **s_uris**; each element in the array is called **s_uri**. Matching is performed from top to bottom. 115 116**Figure 4** Matching rules of uri and type in the want parameter 117 118 119 120 121### Matching Rules of uri 122 123To simplify the description, **uri** in the passed **want** parameter is called **w_uri**; **uri** under **skills** of an ability to match is called **s_uri**. The matching rules are as follows: 124 125- If **scheme** of **s_uri** is unspecified and **w_uri** is unspecified, the matching is successful. Otherwise, the matching fails. 126 127- If **host** of **s_uri** is unspecified and **scheme** of **w_uri** and **scheme** of **s_uri** are the same, the matching is successful. Otherwise, the matching fails. 128 129- If **port** of **s_uri** is unspecified and the combination of **scheme** and **host** of **w_uri** is the same as the combination of **scheme** and **host** of **s_uri**, the matching is successful. Otherwise, the matching fails. 130 131- If **path**, **pathStartWith**, and **pathRegex** of **s_uri** are unspecified and the combination of **scheme**, **host**, and **port** of **w_uri** is the same as the combination of **scheme**, **host**, and **port** of **s_uri**, the matching is successful. Otherwise, the matching fails. 132 133- If **path** of **s_uri** is specified and the **full path expressions** of **w_uri** and **s_uri** are the same, the matching is successful. Otherwise, the matching of **pathStartWith** continues. 134 135- If **pathStartWith** of **s_uri** is specified and **w_uri** contains the prefix expression of **s_uri**, the matching is successful. Otherwise, **pathRegex** matching continues. 136 137- If **pathRegex** of **s_uri** is specified and **w_uri** meets the regular expression of **s_uri**, the matching is successful. Otherwise, the matching fails. 138 139> **NOTE** 140> 141> The **scheme**, **host**, **port**, **path**, **pathStartWith**, and **pathRegex** attributes of **uris** under **skills** of an ability are concatenated. If **path**, **pathStartWith**, and **pathRegex** are declared in sequence, **uris** can be concatenated into the following expressions: 142> 143> - **Full path expression**: scheme://host:port/path 144> 145> - **Prefix expression**: scheme://host:port/pathStartWith 146> 147> - **Regular expression**: scheme://host:port/pathRegex 148> 149> - **Prefix URI expression**: When only **scheme**, a combination of **scheme** and **host**, or a combination of **scheme**, **host**, and **port** is configured in the configuration file, the matching is successful if a URI prefixed with the configuration file is passed in. 150> * `scheme://` 151> * `scheme://host` 152> * `scheme://host:port` 153 154 155### Matching Rules of type 156 157> **NOTE** 158> 159> The matching rules of **type** described in this section are based on the fact that **type** in the **want** parameter is specified. If **type** is unspecified, follow the [matching rules of uri and type in the want parameter](#matching-rules-of-uri-and-type-in-the-want-parameter). 160 161To simplify the description, **uri** in the passed **want** parameter is called **w_type**, and **type** of **uris** under **skills** of an ability to match is called **s_type**. The matching rules are as follows: 162 163- If **s_type** is unspecified, the matching fails. 164 165- If **s_type** or **w_type** contains the wildcard `*/*`, the matching is successful. 166 167- If the last character of **s_type** is the wildcard `*`, for example, `prefixType/*`, the matching is successful only when **w_type** contains `prefixType/`. 168 169- If the last character of **w_type** is the wildcard `*`, for example, `prefixType/*`, the matching is successful only when **s_type** contains `prefixType/`. 170
