api.keyValue Работа с хранилищем пар "ключ-значение"

  • api.keyValue.put(namespace, key, value)

    Сохранение или изменение значения по ключу в указанном пространстве значений.

    Параметры метода:

    • namespace — пространство значений. String;
    • key — ключ. String;
    • value — значение. String

    Возвращаемое значение:

    • true — успех сохранения /обновления;
    • false — провал сохранения /обновления

  • api.keyValue.get(namespace, key)

    Получение значения по ключу из пространства значений.

    Параметры метода:

    • namespace — пространство значений. String;
    • key — ключ. String

    Возвращаемое значение:

    • строковое значение;
    • null (если по ключу ничего не найдено)

  • api.keyValue.delete(namespace, key)

    Удаление значения по ключу из пространства значений.

    Параметры метода:

    • namespace — пространство значений. String;
    • key — ключ . String

    Возвращаемое значение:

    • true — успех удаления
    • false — провал удаления

  • api.keyValue.find(namespace, keyPart, predicate)

    Поиск всех пар "ключ-значение" в указанном пространстве значений, содержащие keyPart подстрокой ключа. Выборка из хранилища выполняется последовательно по N объектов за один запрос до тех пор, пока есть подходящие значения.

    * Число объектов N настраивается в конфигурационном файле dbaccess.properties, по умолчанию 1000

    Параметры метода:

    • namespace — пространство значений. String;
    • keyPart — ключ. String;
    • predicate — предикат вида (key, value) → boolean, который фильтрует значения

    Возвращаемое значение:

    • ассоциативный список найденных пар значений;
    • пустой список (если ничего не найдено)