[qtcontacts-sqlite] Implement contact search filter query. Contribute…

…s to JB#47217

A common use-case is to search all contacts based on a simple search
string, where you want results to be ordered according to some
"likelihood" that the match is what the user is hoping to find.

This commit adds a new type of request, the search filter request,
which is implemented as a compound fetch request, which returns
results in order according to a built-in criteria of likelihood.

That criteria is:
- first name starts with
- last name starts with
- display label group starts with
- phone number starts with
- email or organization starts with
- any of the above details contains

(the substring provided as the search filter value).

src/extensions/QContactSearchFilterRequest

@@ -0,0 +1 @@
+#include "./qcontactsearchfilterrequest.h"

src/extensions/qcontactsearchfilterrequest.h

@@ -0,0 +1,99 @@
+/*
+ * Copyright (c) 2019 Open Mobile Platform LLC.
+ *
+ * You may use this file under the terms of the BSD license as follows:
+ *
+ * "Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are
+ * met:
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *   * Redistributions in binary form must reproduce the above copyright
+ *     notice, this list of conditions and the following disclaimer in
+ *     the documentation and/or other materials provided with the
+ *     distribution.
+ *   * Neither the name of Nemo Mobile nor the names of its contributors
+ *     may be used to endorse or promote products derived from this
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+ * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+ * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+ * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+ * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE."
+ */
+
+#ifndef QCONTACTSEARCHFILTERREQUEST_H
+#define QCONTACTSEARCHFILTERREQUEST_H
+
+#include <qcontactabstractrequest.h>
+#include <qcontactdetail.h>
+#include <qcontactname.h>
+#include <qcontactsortorder.h>
+#include <qcontactfilter.h>
+#include <qcontactfetchhint.h>
+
+QT_BEGIN_NAMESPACE_CONTACTS
+
+class QContactSearchFilterRequestPrivate;
+class QContactSearchFilterRequest : public QObject
+{
+    Q_OBJECT
+    Q_DISABLE_COPY(QContactSearchFilterRequest)
+    Q_DECLARE_PRIVATE(QContactSearchFilterRequest)
+
+public:
+    struct SearchField {
+        QContactDetail::DetailType detailType = QContactName::Type;
+        int field = QContactName::FieldFirstName;
+    };
+
+    struct SearchFilter {
+        QList<SearchField> fields;
+        QContactFilter::MatchFlags matchFlags = QContactFilter::MatchStartsWith;
+    };
+
+    QContactSearchFilterRequest(QObject *parent = nullptr);
+    ~QContactSearchFilterRequest() override;
+
+    QContactManager *manager() const;
+    void setManager(QContactManager *manager);
+
+    QList<SearchFilter> searchFilters() const;
+    void setSearchFilters(const QList<SearchFilter> &filters);
+
+    QString searchFilterValue() const;
+    void setSearchFilterValue(const QString &value);
+
+    QContactFetchHint fetchHint() const;
+    void setFetchHint(const QContactFetchHint &hint);
+
+    QContactAbstractRequest::State state() const;
+    QContactManager::Error error() const;
+
+    QList<QContact> contacts() const;
+
+    static QList<SearchFilter> defaultSearchFilters();
+
+public Q_SLOTS:
+    bool start();
+    bool cancel();
+    bool waitForFinished(int msecs = 0);
+
+Q_SIGNALS:
+    void stateChanged(QContactAbstractRequest::State state);
+    void resultsAvailable();
+
+private:
+    QScopedPointer<QContactSearchFilterRequestPrivate> d_ptr;
+};
+
+QT_END_NAMESPACE_CONTACTS
+
+#endif // QCONTACTSEARCHFILTERREQUEST_H