Об использовании класса CursorAdapter в Microsoft Visual FoxPro

данных в CA-классе
Настройка обновляемых данных в CA-классе (Auto-update)
Настройка обновляемых данных в CA-классе (Advanced)
Настройка обновляемых данных в CA-классе (XML)
Примеры фрагментов кода для XML-источников данных
Использование одного соединения и параметров в SQL-запросе для ADO-источника
Назначение свойства __VFPSetup в CA-классе при использовании построителя в vcx/scx
Журнал событий (DatasourceType=ADO,DeteEnvironment.AutoOpenTables=.T.)
Схема обмена данными между клиентом и сервером
Ссылки на ресурсы в Интернет

существовавшую ранее в рамках VFP-баз данных (dbc-фалов) технику работы через редактируемые представления (View) основанную на SQL-запросах к VFP-таблицам (Local View), а также к внешним ODBC-источникам (Remote View)
во-первых, на возможность работы с ADO и XML источниками данных,
во-вторых, на объектный подход, поскольку эта возможность представлена VFP-классом. Обладая большим количеством свойств, событий и методов, этот класс существенно расширяет и обогащает возможности, существовавшие ранее в рамках представлений (View).
Таким образом, этот класс обеспечивает работу VFP-приложений с такими внешними источниками данных, как ODBC, ADO, XML и VFP-таблицами.
С помощью его вы можете абстрагироваться от конкретики внешнего источника и работать с данными независимо от того, какой именно источник данных вами используется, т.е. взаимодействовать с внешними данными исключительно только через методы/свойства CA-класса. Естественно, что значения свойств, также как и код в методах/событиях экземпляра CA-класса, будут зависимы от обслуживаемого внешнего источника данных.
Средствами этого класса внешние данные могут быть как преобразованы во временные VFP-курсоры, так и наоборот, изменённые данные из VFP-курсоров могут быть преобразованы и переданы на соответствующие внешние источники.
В своей работе данный класс может использовать классы-помощники там, где средств самого CA-класса недостаточно. Так, при работе с XML-данными обычно требуется использование VFP-класса XMLAdapter, а при работе с MS ADO (Microsoft® ActiveX® Data Objects) возникает необходимость в использовании объектов, входящих в объектную модель ADODB: ADODB.Connection, ADODB.Recordset, ADODB.Command
Данные в VFP-курсорах, получаемых средствами CA представляют из себя «локальную копию» внешних данных и всегда являются буферизованными. А VFP-функция TABLEUPDATE(), сохраняющая изменения клиента из VFP-курсоров на свои внешние источники, поддерживает работу с CA

данных: ODBC, ADO, XML, VFP-Narive. Какой именно источник данных обслуживается экземпляром класса определяется значением свойства DataSourceType
Метод CursorFill() – выполняет команду (из свойства SelectCmd), чтобы заполнить данными курсор (свойство Alias). Заполнение курсора может выполняться с использование метода AutoOpen(), если класс CA помещён в экземпляр класса DataEnvironment (DE). При выполнение метода CursorFill() также вызываются соответствующие события: BeforeCursorFill(), AfterCursorFill()
Метод AutoOpen() – вызывает метод CursorFill(), по умолчанию без параметров. Если CA-класс принадлежит экземпляру класса DE, то метод DE.OpenTables() вызывает метод AutoOpen() для каждого экземпляра CA. Такой механизм позволяет (при DE.AutoOpenTables=.T.) как открыть данные формы до наступления события Load() формы, так и более точно настроить параметры вызова метода CursorFill() в случае необходимости, например при параметризованных запросах для ADO-источника данных.
Метод CursorRefresh() – обновляет данные в курсоре (свойство Alias) данными с сервера, повторно выполняя команду (из свойства SelectCmd) в соответствии типом источника данных (свойства DataSourceType) При выполнение этого метода также вызываются соответствующие события: BeforeCursorRefresh(), AfterCursorRefresh().
Метод RecordRefresh() – обновляет данные указанной(ых) записи(ей) в курсоре (свойство Alias) данными с сервера. Этот метод интегрирован с функцией REFRESH(). Команда обновления записи может быть уточнена с помощью свойства RefreshCmd При выполнение метода также вызываются соответствующие события: BeforeRecordRefresh(), AfterRecordRefresh().
Методы: CursorAttach(),CursorDetach() – позволяют подсоединиться/отсоединиться к/от заданному курсору, чтобы автоматически заполнить свойства экземпляра CA-класса, взяв их из указанного курсора.
Свойство: CursorSchema – позволяет (пере)определить структуры данных источника. В VFP 8.0 используется для XML-данных, в VFP 9.0 распространяется на все типы данных. В VFP 9.0 значение свойства CA.UseCursorSchema определяет значение по умолчанию для передачи как параметра lUseSchema в метод CursorFill(), если этот параметр не использован при обращении к этому методу
Свойство NoData - в VFP 9.0 определяет значение по умолчанию, передаваемое в качестве lNoData параметра методу CursorFill() в том случае, если этот параметр не использован при обращении к этому методу.
и т.д. См. описания в документации…
CA-класс тесно интегрирован с функциями: CURSORSETPROP(), CURSORGETPROP(), TABLEUPDATE()
См. также ряд статей Юрия ШутенкоСм. также ряд статей Юрия Шутенко на начиная с «Часть I Создание CursorAdapter'а с помощью построителя».

UpdatableFieldList обеспечивают настройку обновления данных (могут быть настроены на закладке [Auto-Update] в CA Builder). Если эти свойства неопределенны, то предполагается указание явного механизма обновления данных, например используя SQL-команды в качестве свойств: UpdateCmd, InsertCmd, DeleteCmd при соответствующих *CmdDataSource и *CmdDataSourceType (по кнопке Advanced… на закладке [Auto-Update] в CA Builder)
Значение свойства DataSourceType определяет тип источника данных. Возможные значения строки: ‘ODBC’, ‘ADO’, ‘XML’, ‘Native’.
Native – означает, что источниками данных являются VFP-таблицы. Единственно что здесь нужно хорошо осознавать, - это то, что мы обращаемся не к VFP-таблицам непосредственно (чрез открытие её по команде USE), а к буферизованным VFP-курсорам, являющимся результатами выполнения SQL-команд к соответствующим VFP-таблицам. Как следствие в частности, имя полученного курсора (CA.Alias) не может совпадать с именем VFP-тблицы (в команде SQL-SELECT … FROM tblName)
ODBC – внешним источник является совместимые с Open Database Connectivity приложения, доступ к данным которых, обеспечивается через соответствующие ODBC driver-ы
Значением свойства CA.DataSource в этом случае, является числовое значение, возвращаемые функцией SQLSTRINGCONNECT() или SQLCONNECT()
Если к примеру, для получение данных с сервера используется хранимая процедура, то значением свойства SelectCmd может быть команда обращения к такой процедуре
ADO – определяет, что внешним источником является Microsoft® ActiveX® Data Objects (ADO). Это может быть совместимое с MS OLE DB Provider приложение, обеспечивающее стандартный интерфейс для работы с данными, например SQL Server (SQLOLEDB), либо приложение совместимое с Microsoft OLE DB Provider for ODBC (MSDASQL).
В этом случае, в качестве значения свойства CA.DataSource принимается объект ADODB.Recordset
Т.к. объект ADODB.Recordset не имеет возможности работать с параметрами, то по умолчанию метод CA.CursorFill() неспособен обрабатывать команды, содержащие параметры. Поэтому, в случае параметризованных запросов к данным, вам следует переопределить метод CA.CursorFill() так, чтобы создать дополнительный объект ADODB.Command и передать его чрез параметр методу CursorFill(), тем самым обеспечить обработку параметров в запросе.
Было обнаружено, что один общий ADODB.Recordset не способен обрабатывать несколько экземпляров CA-классов. Т.е. не следует пытаться одним DataSource, помещённым например в DataEnvironment пытаться обслужить несколько CA-классов.
XML – означает, что внешними источниками являются XML-данные (Extensible Markup Language).
В этом случае свойство CA.SelectCmd должно быть:
либо строкой-результатом работы функции CURSORTOXML(), (т.е. корректной строкой XML-данных для получения VFP-курсора применением функции XMLTOCURSOR())
либо строкой, вычисляемой до объекта XMLTable, например «this.oXmlAdapter.Tables(1)»
Если определены свойства: Tables, KeyFieldList, UpdateNameList, UpdatableFieldList и значения свойств UpdateCmdDataSourceType, InsertCmdDataSourceType, и DeleteCmdDataSourceType установлены в ‘XML’, то свойство CA.UpdateGram на момент сохранения изменений содержит XML-схему изменений в формате, принятом для SQLXML 3.0, а свойства: UpdateCmd, InsertCmd и DeleteCmd могут быть строками, вычисляющимися до методов, к которым следует обратиться при возникновении соответствующих событий.

через Local/Remote View могли быть сохранены в данных первоисточника, следует
- либо во View Designer на закладке [Update criteria] установить ключевые/редактируемые поля таблиц и отметить флажок SendUpdate
- либо используя функцию CURSORSETPROP() установить свойства: Tables, KeyFieldList, UpdateNameList, UpdatableFieldList, SendUpdates соотвествующим образом (см. статью в MDSN KB: “Q138094 How to Create Updatable Views by Using SQL Passthrough”)
В CA-классе имеется ряд аналогичных свойств: Tables, KeyFieldList, UpdateNameList, UpdatableFieldList, - обеспечивающих настройку изменяемых данных.
Изменённые данные из буферизованных Local/Remote View и из курсоров, полученных с помощью CA-классов, могут быть сохранены, используя функцию TableUpdate()

таблицы

Загружаем XML-таблицу в XMLAdapter

Выполняем заполнение локального курсора

ADODB.Connection

В CA.Init() создаём/настраиваем ADODB.Recordset

В CA.AoutoOpen() создаём/используем ADODB.Command, при явном вызове CursorFill()

при создании класса CA вы воспользовались построителем (Builder), то наверняка обратили внимание на код, помещаемый построителем в метод AutoOpen() и событие Init(), где динамически создаётся свойство __VFPSetup. Это делается по следующим причинам:
При использовании CA-класса в классе DataEnvironment(DE) все источники данных должны быть открыты во время выполнения метода DE.OpenTables().
Если при этом DE-класс принадлежит форме и если у него DE.AutoOpenTables=.T. (т.е. значение, принятое по умолчанию), то метод DE.OpenTables() вызывается ещё до наступления события Form.Load(). Это делается для того, чтобы открыть все используемые в форме данные ещё до создание контролов формы, но это и нарушает общепринятую очерёдность создания объектов и событий для классов-контейнеров, т.к. к этому моменты экземпляр класса DE принадлежащий классу формы ещё не создан.
В этом случае, и метод CA.AutoOpen(), вызываемый из DE.OpenTables(), также нарушает общепринятую очерёдность событий, т.к. к моменту его выполнения экземпляр класса CA, принадлежащий классу DE, ещё не создан.
Наконец, событие Init() любого класса-контейнера должно происходить «лишь однажды» и «в самую последнюю очередь», т.е. тогда, когда все объекты, принадлежащие этому классу-контейнеру, уже существуют (т.е. успешно отработали их события Init()), но «перед выполнением каких-либо событий/методов объекта». Кодом в событии Init() обычно пользуются, чтобы выполнить окончательную настройку класса перед началом его работы (в определённом смысле «конструктор» объекта).
Добавленный построителем «условный код», включая и динамически создаваемое дополнительное свойство _VFPSetup, в начало метода CA.AutoOpen() и в событие CA.Init(), является попыткой решить перечисленные проблемы, т.е. обеспечивает вызов события CA.Init() лишь однажды в т.ч. и до начала выполнения «прикладного кода» в CA.AutoOpen()

HTTP, TCP/IP

XML Diffgram

DCOM, TCP/IP

ODBC, ADO, File

CursorAdapter

Буфер данных

Данные

Изменения в данных

MS IIS

ASP, ASP.NET

DCOM, TCP/IP

ODBC, ADO, File

XML DataSet

XML Diffgram

XML DataSet

XMLAdapter

CursorAdapter

VFP-COM компонента

Совместная работа классов CursorAdapter и XMLAdapter

Сервер

Клиент