QNdefFilter Class

Detaillierte Beschreibung

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

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

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

Der folgende Filter passt zu NDEF-Nachrichten, die einen URI, einen lokalisierten Text und ein optionales JPEG-Bild enthalten. Die Reihenfolge der Datensätze muss mit der angegebenen Reihenfolge übereinstimmen:

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

Die Methode match() kann verwendet werden, um zu prüfen, ob eine Nachricht dem Filter entspricht.

Übereinstimmende Algorithmen

Das Verhalten des Filters hängt von dem Wert des Parameters orderMatch() ab.

Ungeordnetes Matching

Wenn die Reihenfolge der Datensätze nicht berücksichtigt wird, können alle gleichen Datensätze im Filter verbunden werden. Der resultierende Filter enthält dann nur eindeutige Datensätze, jeweils mit dem aktualisierten Wert 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);

Mit dem ungeordneten Abgleich wird der Filter zu folgendem vereinfacht:

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

Sobald der Filter nur noch eindeutige Datensätze enthält, iteriert der Abgleichsalgorithmus durch die Nachricht und berechnet die tatsächliche Anzahl der Datensätze jedes Typs. Wenn alle tatsächlichen Beträge in die entsprechenden [Minimum, Maximum]-Bereiche passen, gibt der Abgleichsalgorithmus true zurück.

Geordneter Abgleich

Wenn die Reihenfolge der Datensätze wichtig ist, wird ein anderer Ansatz angewandt. In diesem Fall können die gleichen Datensätze nicht einfach zusammengefügt werden. Die aufeinanderfolgenden gleichen Datensätze können jedoch trotzdem verbunden werden. Dann durchläuft der Abgleichsalgorithmus die Nachricht, wobei diesmal auch die Positionen der Datensätze berücksichtigt werden.

Behandlung des leeren Typs im Filtersatz

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

Der Filter kann zum Beispiel wie folgt definiert werden:

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

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

Behandlung zusätzlicher Datensätze in der Nachricht

Wenn die Nachricht einige Datensätze enthält, die mit keinem Datensatz des Filters übereinstimmen, gibt der Abgleichsalgorithmus false zurück.

Filter-Beispiele

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

• typeNameFormat - enthält den typeNameFormat() des Datensatzes.
• type - enthält die type() des Datensatzes.
• minimum - enthält die minimale Anzahl 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 nachstehenden Tabelle werden nur die typeNameFormat() und type() jedes Datensatzes angezeigt, da die anderen Parameter für die Filterung keine Rolle spielen.