QNdefFilter Class

Description détaillée

Le filtre QNdefFilter encapsule la structure d'un message NDEF et est utilisé pour faire correspondre les messages qui ont une structure particulière.

Le filtre suivant correspond aux messages NDEF qui contiennent un seul enregistrement d'affiche intelligente :

QNdefFilter filter;
filter.append(QNdefRecord::NfcRtd, "Sp");

Le filtre suivant correspond aux messages NDEF qui contiennent un URI, un texte localisé et une image JPEG facultative. L'ordre des enregistrements doit être conforme à l'ordre spécifié :

QNdefFilter filter;
filter.setOrderMatch(true);
filter.appendRecord(QNdefRecord::NfcRtd, "U");
filter.appendRecord<QNdefNfcTextRecord>();
filter.appendRecord(QNdefRecord::Mime, "image/jpeg", 0, 1);

La méthode match() peut être utilisée pour vérifier si un message correspond au filtre.

Algorithmes de correspondance

Le comportement du filtre dépend de la valeur du paramètre orderMatch().

Correspondance non ordonnée

Si l'ordre des enregistrements n'est pas pris en compte, tous les enregistrements égaux du filtre peuvent être fusionnés. Le filtre résultant ne contiendra que des enregistrements uniques, chacun avec les valeurs minimum et maximum mises à jour.

Prenons l'exemple suivant :

QNdefFilter filter;
filter.appendRecord<QNdefNfcTextRecord>(0, 1);
filter.appendRecord<QNdefNfcTextRecord>(0, 1);
filter.appendRecord(QNdefRecord::Mime, "", 1, 1);
filter.appendRecord<QNdefNfcTextRecord>(1, 1);
filter.setOrderMatch(false);

Avec la correspondance non ordonnée, le filtre sera simplifié comme suit :

QNdefFilter filter;
filter.appendRecord<QNdefNfcTextRecord>(1, 3);
filter.appendRecord(QNdefRecord::Mime, "", 1, 1);
filter.setOrderMatch(false);

Une fois que le filtre ne contient que des enregistrements uniques, l'algorithme de correspondance parcourt le message et calcule la quantité réelle d'enregistrements de chaque type. Si tous les montants réels sont compris dans les fourchettes [minimum, maximum] correspondantes, l'algorithme de mise en correspondance renvoie true.

Correspondance ordonnée

Si l'ordre des enregistrements est important, une approche différente est appliquée. Dans ce cas, les enregistrements égaux ne peuvent pas être simplement réunis. Cependant, les enregistrements égaux consécutifs peuvent toujours être réunis. L'algorithme de mise en correspondance parcourt ensuite le message en tenant compte, cette fois, de la position des enregistrements.

Gestion du type vide dans l'enregistrement filtre

Il est possible d'ajouter un enregistrement filtre avec un type vide type. Dans ce cas, le type vide agira comme un joker pour n'importe quel type.

Par exemple, le filtre peut être défini comme suit :

QNdefFilter filter;
filter.addRecord(QNdefRecord::Mime, "", 1, 1);

Ce filtre spécifie que le message doit contenir exactement un enregistrement NDEF avec Mime typeNameFormat (), et n'importe quel type().

Traitement des enregistrements supplémentaires dans le message

Si le message contient des enregistrements qui ne correspondent à aucun enregistrement du filtre, l'algorithme de correspondance renvoie false.

Exemples de filtres

Dans le tableau ci-dessous, chaque enregistrement du filtre est spécifié par les paramètres suivants (dans l'ordre indiqué) :

• typeNameFormat - contient le typeNameFormat() de l'enregistrement.
• type - contient le type() de l'enregistrement.
• minimum - contient le nombre minimum d'occurrences de l'enregistrement dans le message.
• maximum - contient le nombre maximum d'occurrences de l'enregistrement dans le message.

Le filtre contient plusieurs enregistrements.

Le message se compose de plusieurs QNdefRecords. Dans le tableau ci-dessous, seuls les typeNameFormat() et type() de chaque enregistrement sont affichés, car les autres paramètres n'ont pas d'importance pour le filtrage.