azchatlanin / firebase

FireBase Qt library

FireBase (Qt)

FireBase is the mobile platform which allows to develop high-quality applications quickly. It is necessary to have the account FireBase for use of library. Version Qt 5.7.1

Facility

  Send single data
  Send data objects
  Edit data
  Delete data
  Rewrite data
  Obtain data
  Obtain the sorted data

Data access makes only in one parameter. It is technical aspect of FireBase. At the time of writing this library their answer about of a possibility of data access according to some data was the following:

Thank you for your patience. Like you, there are other developers requesting for these features. In fact, there's already an existing internal request to address this functionality. But as of the moment, no public release dates or details we can share.

Installation

Installation of library is standard installation of third-party libraries in Qt. It is necessary to download sources and to bring together library under your own system. Then following documentation of Qt you connect it to your own project.

Example of a code:

    QString http = "https://test.firebaseio.com/";
    QString token = "SECRET KEY";
    FireBase firebase(http, token);

Data record

This method will write down data with own key from FireBase.

    QString str = "Money";
    QJsonObject object;
    object["value"] = 25345685;
    object["story"] = "many";
    firebase.child(str)->value(object)->push();

This method will write down data using YOUR key.

    QString str = "MY_KEY/Money";
    QJsonObject object;
    object["value"] = 25345685;
    object["story"] = "many";
    firebase.child(str)->value(object)->set();

Data editing

    QString str = "Money";
    QJsonObject object;
    object["value"] = 25;    
    firebase.child(str)->value(object)->update();

Data deletion

    QString str = "Money";
    firebase.child(str)->remove();

Getting data

    QString str = "Money";
    QString data = firebase.child(str)->get();

Sorting

For sorting of data it is necessary to create rules on the party of FireBase.

• orderBy - the parameter by which we sort
• startAt - for example, from 100 and above
• limitToFirst - for example, the first 20 sorted
• endAt - for example to 100 and below
• limitToLast - the last 20 sorted

Example of a code when it is necessary to receive the first 100 records on the “value” parameter a meaning of which not less than 10 000

    QString str = "Money";
    QString orderBy = "value";
    QString data = firebase.child(str)->orderBy(orderBy)->startAt(10000)->limitToFirst(100)->get();

Example of a code when it is necessary to receive the last 100 records on the “value” parameter a meaning of which less than 10 000

    QString str = "Money";
    QString orderBy = "value";
    QString data = firebase.child(str)->orderBy(orderBy)->endAt(10000)->limitToLast(100)->get();

LECENSE

See LICENSE.txt for details.

RU

Firebase представляет собой мобильную платформу, которая позволяет быстро разрабатывать высококачественные приложения. Для использования библиотеки необходимо иметь аккаунт Firebase. Версия Qt 5.7.1

Возможности

  Отправлятть единичные данные
  Отправлять объекты данных
  Редактировать данные
  Удалять данные
  Перезаписывать данные
  Получать данные
  Получать отсортированные данные

Выборка данных происходит только по одному параметру. Это техническая сторона FireBase. На момент написания данной библиотеки их ответ по вопросу о возможности выборки по нескольим данным был следующим:

Thank you for your patience. Like you, there are other developers requesting for these features. In fact, there's already an existing internal request to address this functionality. But as of the moment, no public release dates or details we can share.

Установка

Установка библиотеки является стандартной установкой сторонних библиотек в Qt. Необходимо скачать исодники и собрать библиотеку под свою систему. Далее следуя док-ции Qt подключить её к своему проекту.

Пример кода:

    QString http = "https://test.firebaseio.com/";
    QString token = "SECRET KEY";
    FireBase firebase(http, token);

Запись данных

Данный метод запишит данные с собственным ключом от FireBase.

    QString str = "Money";
    QJsonObject object;
    object["value"] = 25345685;
    object["story"] = "many";
    firebase.child(str)->value(object)->push();

Данный метод запишит данные используя ваш ключ.

    QString str = "MY_KEY/Money";
    QJsonObject object;
    object["value"] = 25345685;
    object["story"] = "many";
    firebase.child(str)->value(object)->set();

Редактирование данных

    QString str = "Money";
    QJsonObject object;
    object["value"] = 25;    
    firebase.child(str)->value(object)->update();

Удаление данных

    QString str = "Money";
    firebase.child(str)->remove();

Получение данных

    QString str = "Money";
    QString data = firebase.child(str)->get();

Сортировка

Для сортировки данных необходимо на стороне FIreBase создать правила.

• orderBy - параметр по которому сортируем
• startAt - например, от 100 и выше
• limitToFirst - например, первые 20 отсортированных
• endAt - например до 100 и ниже
• limitToLast - последние 20 отсортированных

Пример кода когда нужно получить первые 100 записей по параметру "value" зачение которого не менее 10 000

    QString str = "Money";
    QString orderBy = "value";
    QString data = firebase.child(str)->orderBy(orderBy)->startAt(10000)->limitToFirst(100)->get();

Пример кода когда нужно получить последние 100 записей по параметру "value" зачение которого менее 10 000

    QString str = "Money";
    QString orderBy = "value";
    QString data = firebase.child(str)->orderBy(orderBy)->endAt(10000)->limitToLast(100)->get();

LECENSE

See LICENSE.txt for details.