QNdefFilter Class

Descripción detallada

QNdefFilter encapsula la estructura de un mensaje NDEF y se utiliza para buscar mensajes que tengan una estructura determinada.

El siguiente filtro coincide con los mensajes NDEF que contienen un único registro de cartel inteligente:

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

El siguiente filtro coincide con mensajes NDEF que contienen un URI, un texto localizado y una imagen JPEG opcional. El orden de los registros debe ser el especificado:

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

El método match() puede utilizarse para comprobar si un mensaje coincide con el filtro.

Algoritmos de concordancia

El comportamiento del filtro depende del valor del parámetro orderMatch().

Coincidencia desordenada

Si no se tiene en cuenta el orden de los registros, se pueden unir todos los registros iguales del filtro. El filtro resultante contendrá sólo registros únicos, cada uno con el valor minimum y maximum actualizado.

Considere el siguiente ejemplo:

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

Con la concordancia desordenada, el filtro se simplificará a lo siguiente:

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

Una vez que el filtro contiene sólo los registros únicos, el algoritmo de correspondencia itera a través del mensaje y calcula la cantidad real de registros de cada tipo. Si todas las cantidades reales encajan en los rangos [mínimo, máximo] correspondientes, el algoritmo de correspondencia devuelve true.

Correspondencia ordenada

Si el orden de los registros es importante, se aplica un enfoque diferente. En este caso, los registros iguales no pueden unirse sin más. Sin embargo, los registros iguales consecutivos sí pueden unirse. A continuación, el algoritmo de correspondencia itera a través del mensaje, esta vez también teniendo en cuenta las posiciones de los registros.

Tratamiento de un tipo vacío en un registro de filtro

Es posible añadir un registro de filtro con un type vacío. En este caso, el tipo vacío actuará como comodín para cualquier tipo.

Por ejemplo, el filtro puede definirse de la siguiente manera:

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

Este filtro especifica que el mensaje debe contener exactamente un registro NDEF con Mime typeNameFormat (), y cualquier type().

Tratamiento de registros adicionales en el mensaje

Si el mensaje contiene algunos registros que no coinciden con ningún registro del filtro, el algoritmo de coincidencia devolverá false.

Ejemplos de filtros

En la tabla siguiente, cada registro del filtro se especifica mediante los siguientes parámetros (en el orden indicado):

• typeNameFormat - contiene el typeNameFormat() del registro.
• type - contiene el type() del registro.
• minimum - contiene el número mínimo de apariciones del registro en el mensaje.
• maximum - contiene el número máximo de apariciones del registro en el mensaje.

El filtro contiene varios registros.

El mensaje consta de varios QNdefRecords. En la tabla siguiente, sólo se mostrarán los typeNameFormat() y type() de cada registro, porque los demás parámetros no importan para el filtrado.