TFBEventMonitor/ru: what changed
Revision 0 to 1. Removed lines have a minus sign; added lines have a plus sign.
Title: TFBEventMonitor/ru
| Old | New | Line | |
|---|---|---|---|
| 1 | + | **TFBEventMonitor**  из модуля FBEventMonitor используется для мониторинга именованных событий, отправленных с сервера базы данных [[Firebird]]. События обычно генерируются триггерами при определенных операциях с базой данных. | |
| 2 | + | ||
| 3 | + | Использование событий означает, что вы можете избежать регулярного опроса базы данных на предмет изменений статуса и могут быть полезны в случаях высокой нагрузки. | |
| 4 | + | ||
| 5 | + | ## Пример | |
| 6 | + | ||
| 7 | + | Обновление memo получаемыми событиями. Мониторинг событий с E1 по E7. | |
| 8 | + | ||
| 9 | + | ``` pascal | |
| 10 | + | procedure TForm1.StartMonitor; | |
| 11 | + | begin | |
| 12 | + | EventsM:=TFBEventMonitor.create(Self); | |
| 13 | + | EventsM.Connection:=IBConnection1; | |
| 14 | + | EventsM.Events.CommaText:='"E1",E2,E3,E4,"E5","E6","E7"'; //кавычки игнорируются | |
| 15 | + | EventsM.OnEventAlert:=OnFBEvent; | |
| 16 | + | EventsM.RegisterEvents; // активирует IBConnection1, если он до сих пор не подсоединен к БД | |
| 17 | + | end; | |
| 18 | + | ||
| 19 | + | procedure TForm1.StopMonitor; | |
| 20 | + | begin | |
| 21 | + | EventsM.UnRegisterEvents; | |
| 22 | + | EventsM.Free; | |
| 23 | + | end; | |
| 24 | + | ||
| 25 | + | procedure TForm1.OnFBEvent(Sender: TObject; EventName: string; | |
| 26 | + | EventCount: longint; var CancelAlerts: boolean); | |
| 27 | + | begin | |
| 28 | + | Memo1.Lines.Add(EventName+' произошло '+IntToStr(EventCount)+' раз.'); | |
| 29 | + | end; | |
| 30 | + | ``` | |
| 31 | + | ||
| 32 | + | Монитор событий прекращает мониторинг, когда связанный TIBConnection отключается от БД, и не перезапускается автоматически. Используйте обработчики событий TIBConnection.AfterConnect и TIBConnection.BeforeDisconnect для автоматического запуска и остановки мониторинга. | |
| 33 | + | ||
| 34 | + | Сервер базы данных отправляет события всем соединениям, зарегистрированным для этих событий, кроме тех, которые созданы самим соединением. События отправляются после завершения транзакции. Откат транзакции отменит все события, созданные в этой транзакции. `fbeventstest.pp` в корневом каталоге fcl packages/fcl-db/examples/ представляет собой тестовую/демонстрационную программу, которая создает хранимую процедуру для отправки события с произвольным именем и использует второе соединение для мониторинга отправленных событий. | |
| 35 | + | ||
| 36 | + | > **Warning:** TFBEventMonitor создает поток для мониторинга входящих событий. На Unix включают cthreads или любой другой менеджер потоков. | |
| 37 | + | ||
| 38 | + | ## См. также | |
| 39 | + | ||
| 40 | + | - [[Firebird|Using Firebird with FPC/Lazarus sqldb.]] | |
| 41 | + | - Firebird documentation/readme files on events | |
| 42 | + | - [Presentation on Firebird events](http://www.firebirdsql.org/file/documentation/papers_presentations/Power_Firebird_events.pdf) | |
| 43 | + | ||
| 44 | + | --- | |
| 45 | + | *From the Free Pascal wiki, page "TFBEventMonitor/ru", as it stood on 2019-10-12 after a change by Zoltanleo, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).* |