Что такое генеративный метод?

Question

Я знаком с генераторами Python, однако я просто натолкнулся на термин «генеративный метод», с которым я не знаком и не могу найти удовлетворительное определение.

Выражаясь в контексте, я нашел этот термин в описательной документации SQLAlchemy в:

Полный контроль поведения «автоматической фиксации» доступен при помощи генеративные Connection.execution_options() метод, предусмотренный на подключение, двигателя, Исполняемый файл, используя флаг «autocommit», который включает или выключает автозапуск для выбранной области.

Что такое генеративный метод? Попытка итерации объекта, возвращаемого Connection.execution_options(), не работает, поэтому я полагаю, что это нечто иное, чем стандартный генератор.

Answer 1

Это не кажется, общая концепция базы данных, но SQLAlchemy использует термин порождающая в смысле «сгенерированного вашей программой итеративно во время выполнения». (Таким образом, нет связи с генераторами питона). Пример из the tutorial:

Query объекта полностью генеративные, означает, что большинство вызовов методов возвращают новый объект Query, на которой могут быть добавлены дополнительные критерии. Например, для запроса пользователей под названием «изд» с полным названием «Ed Джонс», вы можете вызвать filter() дважды, который присоединяется к критериям, используя AND:

>>> for user in session.query(User).\ 
... filter(User.name=='ed').\ 
... filter(User.fullname=='Ed Jones'): 
...  print user 

Этот синтаксис вызова чаще известный как «цепочка методов», и дизайн, который позволяет использовать его как "fluent interface".

Таким образом, в случае Connection.execution_options() «генеративный» означает, что он возвращает модифицированный объект соединения, чтобы вы могли связать вызовы, как указано выше.

Answer 2

Вам действительно нужно было бы убедиться в том, что он действительно нуждается в конкретизации конкретной документации или исходного кода этого проекта, но я бы предположил, что он возвращает модифицированную версию некоторого объекта, адаптированную к требованиям/поведению, определенным аргументами.

В documentation состоянии:

Метод возвращает копию этого Connection, который ссылается на один и то же лежащих в основе соединения DBAPI, но и определяет заданные параметры выполнения , которые вступят в силу для вызова execute().

Answer 3

Рассматривая исходный код Connection.execution_options (lib/sqlalchemy/engine/base.py), все, что делает этот метод, это добавить параметры соединения.

Идея состоит в том, что эти варианты влияют на будущее поведение, например. запросы.

В качестве примера:

 result = connection.execution_options(stream_results=True).\ 
          execute(stmt) 

Здесь поведение было изменено в середине соединения для всего этого запроса. В некотором роде он «генерирует» или клонирует себя как объект, который имеет несколько другое поведение.

Здесь вы также можете установить autocommit в True. Пример

# obtain a connection 
connection = ... 
# do some stuff 
# for the next section we want autocommit on 
autocommitting_connection = connection.execution_options(autocommit=True) 
autocommitting_connection.execute(some_insert) 
result = autocommitting_connection.execute(some_query) 
# done with this section. Continue using connection (no autocommit) 

Это то, что имеется в виду в этом разделе документации. «Generative method» относится к методу, который возвращает измененную копию того же экземпляра, с которой вы можете продолжить работу. Это применимо к классам Connection, Engine, Executable.

Answer 4

Как примечания @zzzeek выше, это теперь задокументировано в SQLAlchemy glossary.

generative означает:

Термин, который использует SQLAlchemy для обозначения того, что обычно известно как метод построения цепочки; см. этот термин для деталей.

И method chaining является:

Объектно-ориентированный метод, посредством которого состояние объекта строится путем вызова методов объекта. Объект имеет любое количество методов, каждый из которых возвращает новый объект (или, в некоторых случаях, тот же объект), с добавлением дополнительного состояния к объекту.