QNdefFilter Class

Ausführliche Beschreibung

Der QNdefFilter kapselt die Struktur einer NDEF-Nachricht und dient zum Abgleich von Nachrichten, die eine bestimmte Struktur aufweisen.

Der folgende Filter findet NDEF-Nachrichten, die einen einzelnen Smart-Poster-Datensatz enthalten:

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

Der folgende Filter findet NDEF-Nachrichten, die eine URI, einen lokalisierten Textabschnitt und ein optionales JPEG-Bild enthalten. Die Reihenfolge der Datensätze muss der angegebenen Reihenfolge entsprechen:

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

Mit der Methode ` match()` kann überprüft werden, ob eine Nachricht dem Filter entspricht.

Abgleichalgorithmen

Das Verhalten des Filters hängt vom Wert des Parameters ` orderMatch()` ab.

Unsortiertes Abgleichen

Wird die Reihenfolge der Datensätze nicht berücksichtigt, können alle identischen Datensätze im Filter zusammengeführt werden. Der resultierende Filter enthält dann nur noch eindeutige Datensätze, jeweils mit den aktualisierten Werten für „ minimum “ und „ maximum “.

Betrachten Sie das folgende Beispiel:

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);

Bei der ungeordneten Zuordnung wird der Filter wie folgt vereinfacht:

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

Sobald der Filter nur noch die eindeutigen Datensätze enthält, durchläuft der Abgleichalgorithmus die Nachricht und berechnet die tatsächliche Anzahl der Datensätze jedes Typs. Wenn alle tatsächlichen Anzahlen in die entsprechenden [Minimum, Maximum]-Bereiche passen, gibt der Abgleichalgorithmus „ true “ zurück.

Geordnete Zuordnung

Wenn die Reihenfolge der Datensätze wichtig ist, wird ein anderer Ansatz angewendet. In diesem Fall können die identischen Datensätze nicht einfach zusammengefügt werden. Aufeinanderfolgende identische Datensätze können jedoch weiterhin zusammengefügt werden. Anschließend durchläuft der Abgleichalgorithmus die Nachricht und berücksichtigt dabei auch die Positionen der Datensätze.

Behandlung eines leeren Typs im Filterdatensatz

Es ist möglich, einen Filterdatensatz mit einem leeren „ type “ hinzuzufügen. In diesem Fall fungiert der leere Typ als Platzhalter für jeden beliebigen Typ.

Beispielsweise kann der Filter wie folgt definiert werden:

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

Dieser Filter legt fest, dass die Nachricht genau einen NDEF-Datensatz mit dem Typ „ Mime “ typeNameFormat() und einen beliebigen Typ „ type “ () enthalten muss.

Behandlung zusätzlicher Datensätze in der Nachricht

Enthält die Nachricht Datensätze, die keinem Datensatz im Filter entsprechen, gibt der Abgleichalgorithmus „ false “ zurück.

Filterbeispiele

In der folgenden Tabelle wird jeder Filterdatensatz durch die folgenden Parameter (in der angegebenen Reihenfolge) spezifiziert:

• typeNameFormat - enthält den Wert „ typeNameFormat()“ des Datensatzes.
• type - enthält den Wert „ type “ () des Datensatzes.
• minimum - enthält die Mindestanzahl der Vorkommen des Datensatzes in der Nachricht.
• maximum - enthält die maximale Anzahl der Vorkommen des Datensatzes in der Nachricht.

Der Filter enthält mehrere Datensätze.

Die Nachricht besteht aus mehreren „ QNdefRecords“. In der folgenden Tabelle werden nur die „ typeNameFormat “ () und die „ type “ () jedes Datensatzes angezeigt, da die anderen Parameter für die Filterung keine Rolle spielen.