Переменные в запросах HyperGraphDB

Вступление

Функция, которая запрашивалась несколько раз, — это возможность параметризовать запросы HyperGraphDB с переменными, что-то вроде того, что позволяет JDBC PreparedStatement . Эта функция теперь реализована с введением именованных переменных. Именованные переменные могут использоваться вместо обычных параметров условия и могут содержать произвольные значения, независимо от того, что ожидает условие. Преимущества имеют два аспекта: повышают производительность, избегая перекомпиляции запросов, в которых изменяется только несколько параметров условий, и более чистого кода с меньшим дублированием запросов. Повышение производительности предварительно скомпилированных запросов вполне ощутимо, и им нельзя пренебрегать. Почти все предопределенные условия запроса поддерживают переменные, кроме TypePlusConditionкоторый раскрывается в дизъюнкцию типа во время компиляции запроса и поэтому не может быть легко предварительно скомпилирован в параметризованную форму. Также следует отметить, что некоторые оптимизации, сделанные на этапе компиляции, в частности связанные с использованием индекса, не могут быть выполнены при параметризации условия. Простым примером этого ограничения является параметризованное  TypeCondition — индексы определяются для каждого типа, поэтому, если тип не известен во время анализа запроса, индекс не будет использоваться.

API

API разработан для соответствия существующим выражениям условий запроса. Переменная создается путем вызова
 метода hg.var, и результат этого метода передается как параметр условия. Например:

HGQuery<HGHandle> q = hg.make(HGHandle.class, graph).compile(
    hg.and(hg.type(typeHandle),hg.incident(hg.var("targetOfInterest"))));

Это создаст запрос, который ищет ссылки определенного типа и которые указывают на данный атом, параметризованный переменной «targetOfInterest». Перед запуском запроса необходимо установить значение переменной:

q.var("targetOfInterest", targetHandle);
q.execute();

Также возможно указать начальное значение переменной как второе в
методе hg.var :

q = hg.make(HGHandle.class, graph).compile(
    hg.and(hg.type(typeHandle),hg.incident(hg.var("targetOfInterest", initialTarget))));
q.execute();

Обратите внимание на новый  статический метод hg
.make : он принимает тип результата и экземпляр графа и возвращает объект запроса, к которому еще не присоединено условие. Чтобы прикрепить условие, необходимо вызвать
метод HGQuery.compile сразу после make. Эта версия make устанавливает переменный контекст, присоединенный к вновь созданному запросу. Все условия запроса, созданные после вызова make и до вызова
compile, будут неявно предполагать, что переменные принадлежат этому контексту. Поэтому, чтобы избежать неожиданностей, вы должны вызывать
compile сразу после
make .

После того, как запрос таким образом создан, можно выполнить его много раз, присваивая новые значения переменным через
hg.var.метод, как показано выше.

Реализация