QNdefFilter Class

Description détaillée

Le QNdefFilter encapsule la structure d'un message NDEF et sert à faire correspondre les messages présentant une structure particulière.

Le filtre suivant correspond aux messages NDEF contenant un seul enregistrement « smart poster » :

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

Le filtre suivant correspond aux messages NDEF contenant une URI, un texte localisé et une image JPEG facultative. L’ordre des enregistrements doit respecter 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() permet de 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 identiques du filtre peuvent être fusionnés. Le filtre résultant ne contiendra que des enregistrements uniques, chacun avec les valeurs mises à jour de minimum et maximum.

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 mise en 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 plus que les enregistrements uniques, l’algorithme de mise en correspondance parcourt le message et calcule le nombre réel d’enregistrements de chaque type. Si tous ces nombres réels s’inscrivent dans les plages [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 identiques ne peuvent pas être simplement regroupés. Cependant, les enregistrements identiques consécutifs peuvent toujours être regroupés. L’algorithme de mise en correspondance parcourt alors le message, en tenant cette fois-ci également compte des positions des enregistrements.

Gestion d’un type vide dans un enregistrement de filtre

Il est possible d’ajouter un enregistrement de filtrage avec un « type » vide. Dans ce cas, le type vide fera office de caractère générique 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 l’ Mime typeNameFormat (), et n’importe quel type().

Gestion des enregistrements supplémentaires dans le message

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

Exemples de filtres

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

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

Le filtre contient plusieurs enregistrements.

Le message est composé de plusieurs QNdefRecords. Dans le tableau ci-dessous, seules les valeurs « typeNameFormat » () et « type » () de chaque enregistrement seront affichées, car les autres paramètres n’ont pas d’importance pour le filtrage.