<uri-relative-filter-group>

<uri-relative-filter-group android:allow=["true" | "false"]>
  <data ... />
  ...
</uri-relative-filter-group>

So khớp

Để so khớp một URI, mỗi phần của nhóm bộ lọc tương đối URI phải khớp với một phần của URI. Có thể có các phần của URI không được chỉ định trong nhóm bộ lọc tương đối URI. Ví dụ:

<intent-filter...>
  <data android:scheme="https" android:host="project.example.com" />
  <uri-relative-filter-group android:allow="true">
    <data android:query="param1=value1" />
    <data android:query="param2=value2" />
  </uri-relative-filter-group>
  ...
</intent-filter>

Bộ lọc khớp với https://project.example.com/any/path/here?param1=value1&param2=value2&param3=value3 vì mọi thứ do nhóm bộ lọc tương đối URI chỉ định đều có mặt. Bộ lọc cũng khớp với https://project.example.com/any/path/here?param2=value2&param1=value1 vì thứ tự của các tham số truy vấn không quan trọng. Tuy nhiên, bộ lọc không khớp với https://project.example.com/any/path/here?param1=value1, vì https://project.example.com/any/path/here?param1=value1 thiếu param2=value2.

HOẶC và VÀ

Thẻ <data> bên ngoài <uri-relative-filter-group> được nối bằng toán tử OR, còn thẻ <data> bên trong <uri-relative-filter-group> được nối bằng toán tử AND.

Hãy xem ví dụ sau đây:

<intent-filter...>
  <data android:scheme="https" android:host="project.example.com" />
  <data android:pathPrefix="/prefix" />
  <data android:pathSuffix="suffix" />
  ...
</intent-filter>

Bộ lọc này khớp với các đường dẫn bắt đầu bằng /prefix HOẶC kết thúc bằng suffix.

Ngược lại, ví dụ tiếp theo sẽ so khớp các đường dẫn bắt đầu bằng /prefix VÀ kết thúc bằng suffix:

<intent-filter...>
  <data android:scheme="https" android:host="project.example.com" />
  <uri-relative-filter-group>
    <data android:pathPrefix="/prefix" />
    <data android:pathSuffix="suffix" />
  </uri-relative-filter-group>
  ...
</intent-filter>

Do đó, nhiều thuộc tính path trong cùng một <uri-relative-filter-group> sẽ không khớp với bất kỳ thuộc tính nào:

<intent-filter...>
  <data android:scheme="https" android:host="project.example.com" />
  <uri-relative-filter-group>
    <data android:path="/path1" />
    <data android:path="/path2" />
  </uri-relative-filter-group>
  ...
</intent-filter>

Thứ tự khai báo

Hãy xem ví dụ sau đây:

<intent-filter...>
  <data android:scheme="https" android:host="project.example.com" />
  <uri-relative-filter-group>
    <data android:fragment="fragment" />
  </uri-relative-filter-group>
  <uri-relative-filter-group android:allow="false">
    <data android:fragmentPrefix="fragment" />
  </uri-relative-filter-group>
  ...
</intent-filter>

Bộ lọc khớp với mảnh #fragment vì tìm thấy một kết quả khớp trước khi đánh giá quy tắc loại trừ, nhưng các mảnh như #fragment123 thì không khớp.

Thẻ đồng cấp

Thẻ <uri-relative-filter-group> hoạt động cùng với các thẻ <data> đồng cấp (tức là các thẻ <data> nằm bên ngoài <uri-relative-filter-group> nhưng bên trong cùng một <intent-filter>). Thẻ <uri-relative-filter-group> phải có thẻ <data> đồng cấp để hoạt động đúng cách vì các thuộc tính URI phụ thuộc lẫn nhau ở cấp <intent-filter>:

• Nếu không chỉ định scheme cho bộ lọc ý định thì mọi thuộc tính URI khác sẽ bị bỏ qua.
• Nếu không chỉ định host cho bộ lọc, thì thuộc tính port và mọi thuộc tính path* sẽ bị bỏ qua.

Các <data> con của <intent-filter> được đánh giá trước mọi thẻ <uri-relative-filter-group>. Sau đó, các thẻ <uri-relative-filter-group> được đánh giá theo thứ tự, ví dụ:

<intent-filter...>
  <data android:scheme="https" android:host="project.example.com" />
  <uri-relative-filter-group android:allow="false">
    <data android:path="/path" />
    <data android:query="query" />
  </uri-relative-filter-group>
  <data android:path="/path" />
  ...
</intent-filter>

Bộ lọc chấp nhận https://project.example.com/path?query vì bộ lọc này khớp với <data android:path="/path" /> nằm ngoài quy tắc loại trừ <uri-relative-filter-group>.

Trường hợp sử dụng phổ biến

Hãy tưởng tượng bạn có URI https://project.example.com/path mà bạn muốn so khớp với Intent tuỳ thuộc vào sự hiện diện hoặc giá trị của tham số truy vấn. Để tạo một bộ lọc ý định khớp với https://project.example.com/path và chặn https://project.example.com/path?query, bạn có thể thử như sau:

<intent-filter...>
  <data android:scheme="https" android:host="project.example.com" />
  <uri-relative-filter-group android:allow="true">
    <data android:path="/path" />
  </uri-relative-filter-group>
  ...
</intent-filter>

Trên thực tế, cách này không hiệu quả. URI https://project.example.com/path?query khớp với đường dẫn /path và thẻ <uri-relative-filter-group> cho phép các phần bổ sung khi khớp.

Sửa đổi bộ lọc ý định như sau:

<intent-filter...>
  <data android:scheme="https" android:host="project.example.com" />
  <uri-relative-filter-group android:allow="false">
    <data android:path="/path" />
    <data android:queryAdvancedPattern=".+" />
  </uri-relative-filter-group>
  <uri-relative-filter-group android:allow="true">
    <data android:path="/path" />
  </uri-relative-filter-group>
  ...
</intent-filter>

Bộ lọc này hoạt động vì các quy tắc chặn cấm tham số truy vấn không trống được đánh giá trước tiên.

Để đơn giản hoá mã, hãy đảo ngược hành vi để cho phép các tham số truy vấn và chặn các URI không có tham số truy vấn:

<intent-filter...>
  <data android:scheme="https" android:host="project.example.com" />
  <uri-relative-filter-group android:allow="true">
    <data android:path="/path" />
    <data android:queryAdvancedPattern=".+" />
  </uri-relative-filter-group>
  ...
</intent-filter>

Ký tự được mã hoá URI

Để so khớp các URI chứa ký tự được mã hoá URI, hãy viết các ký tự thô, chưa mã hoá vào bộ lọc, ví dụ:

<intent-filter...>
  <data android:scheme="https" android:host="project.example.com" />
  <uri-relative-filter-group android:allow="true">
    <data android:query="param=value!" />
  </uri-relative-filter-group>
  ...
</intent-filter>

Bộ lọc này khớp với ?param=value! và ?param=value%21.

Tuy nhiên, nếu bạn viết các ký tự đã mã hoá trong bộ lọc như sau:

<intent-filter...>
  <data android:scheme="https" android:host="project.example.com" />
  <uri-relative-filter-group android:allow="true">
    <data android:query="param=value%21" />
  </uri-relative-filter-group>
  ...
</intent-filter>

Bộ lọc không khớp với ?param=value! hoặc ?param=value%21.

Số phần tử

Bạn có thể đặt số lượng phần tử <uri-relative-filter-group> bất kỳ vào bên trong <intent-filter>.

Tài nguyên khác

Để biết thông tin về cách hoạt động của bộ lọc ý định, bao gồm cả quy tắc về cách so khớp đối tượng ý định với bộ lọc, hãy xem bài viết Ý định và bộ lọc ý định cũng như phần Bộ lọc ý định.

Để biết thông tin về <uri-relative-filter-group>, hãy xem UriRelativeFilterGroup và UriRelativeFilter.

android:allow

Nhóm bộ lọc tương đối URI này có phải là quy tắc đưa vào (cho phép) thay vì quy tắc loại trừ (chặn) hay không. Giá trị mặc định là "true".

Giá trị	Mô tả
"true" (mặc định)	Nếu nhóm bộ lọc tương đối URI khớp, thì bộ lọc ý định sẽ khớp
"false"	Nếu nhóm bộ lọc tương đối URI khớp, thì bộ lọc ý định sẽ không khớp