Zeos tutorial/ru: what changed

Revision 2 to 3. Removed lines have a minus sign; added lines have a plus sign.

Old	New		Line
1	1		# Обзор
2	2
3	3		Это руководство посвящено получению, установке и использованию [Zeoslib](https://www.firmos.at/zeos) с [[Glossary\|Lazarus]] и [[Glossary\|FPC]].
4	4
5	5		# Получение Zeos
6	6
7	7		Zeos недавно был перенесен на [[Glossary\|Lazarus]], и пока нет выпусков, которые официально поддерживают его, но вы можете легко получить его из SVN, если выполните следующие действия:
8	8
9	9		## SVN
10	10
11	11		### Windows
12	12
13	13		- скачайте клиент SVN [TortoiseSVN](http://tortoisesvn.tigris.org) и установите
14	14		- см. [Начало работы с TortoiseSVN](http://tortoisesvn.net/docs/release/TortoiseSVN_en/help-onepage.html#tsvn-dug-general)
15	15		- сделайте Checkout из проводника Windows: <http://svn.code.sf.net/p/zeoslib/code-0/trunk>
16	16
17	17		### Linux/BSD
18	18
19	19		- [[Portal:FreeBSD\|FreeBSD]] поставляется с предустановленным svnlite (клиент svn)
20	20		- получите клиент SVN (esvn, kdesvn и т.д.)
21	21		- создайте каталог zeosdbo, перейдите в этот каталог и выполните
22	22		- svn checkout <http://svn.code.sf.net/p/zeoslib/code-0/trunk>
23	23
24	24		## ZIP
25	25
26	26		Вы можете скачать последнюю версию в виде ZIP-файла с sourceforge.net:
27	27
28	28		- [<http://sourceforge.net/projects/zeoslib/>](http://sourceforge.net/projects/zeoslib/)
29	29
30	30		# Установка компонентов
31	31
32	32		Это сложная часть, поэтому вам следует проявить немного терпения и внимательно прочитать эту часть.
33	33
34	34		- Убедитесь, что у вас последний [снапшот Lazarus](http://www.de.freepascal.org/lazarus/) и версия FPC 2.0.3 не ранее 6 марта 2006г.
35	35		- Запустите один экземпляр Lazarus.
36	36
37	37		1. Используйте Components/Open Package File(.lpk) из главного меню.
38	38		2. Перейдите в zeosdbo_rework\packages\lazarus\ и откройте zcomponent.lpk
39	39		3. Нажмите только \[Compile\] в том случае, если вы не хотите устанавливать компоненты в IDE
40	40		4. Нажмите \[Install\]
41	41		5. Вас спросят, хотите ли вы перекомпилировать Lazarus.
42	42
43	43		- Ответьте \[Yes\] на этот раз.
44	44		- Дождитесь завершения компиляции, после этого Lazarus должен перезапуститься.
45	45		- Если все в порядке, теперь вы должны увидеть вкладку \[Zeos Access\] на палитре компонентов.
46	46
47	47		------------------------------------------------------------------------
48	48
49	49		Прим.перев: на момент перевода статьи (май 2021г) установка немного изменилась:
50	50
51	51		- качаете исходный код отсюда <https://svn.code.sf.net/p/zeoslib/code-0/trunk>
52	52		- открываете файл zeos\packages\lazarus\zcomponentdesign.lpk
53	53		- жмете последовательно \[Compile\] и \[Install\]
54	54		- пересобираете Лазарус
55	55
56	56		------------------------------------------------------------------------
57	57
58	58		![](/wiki-images/2/25/Zeos_Components.png)
59	59
60	60		Если вы получаете сообщение об ошибке "Cannot find unit ZClasses"(Не удается найти модуль ZClasses) или что-то подобное, вам необходимо внимательно проверить регистр имен файлов в исходном дистрибутиве Zeos.
61	61
62	62		- Даже если случаи полностью совпадают, автоматически сгенерированный исходный файл пакета может сгенерировать неправильное имя случая в разделе uses (Lazarus 0.9.18), то есть:
63	63
64	64		``` pascal
65	65		{ This file was automatically created by Lazarus. Do not edit!
66	66		This source is only used to compile and install the package.
67	67		}
68	68		unit Zcore;
69	69		interface
70	70		uses
71	71		Zclasses, Zcollections, Zcompatibility, Zexprparser, Zexprtoken, Zexpression,
72	72		Zfunctions, Zmatchpattern, Zmessages, Zsysutils, Ztokenizer, Zvariables,
73	73		Zvariant;
74	74		implementation
75	75		end.
76	76		```
77	77
78	78		- Обратите внимание, что Lazarus переименовал модуль ZClasses на Zclasses, что привело к конфликту имен. Предположительно это ошибка в Lazarus, а не в пакетах Zeos. Один из способов обойти это - переименовать все исходные файлы zeos в нижний регистр. Просмотрите каждый подкаталог в src/ и выполните эту команду в окне bash:
79	79
80		-	~~` rename -v 'y/A-Z/a-z/' *`~~
	80	+	```text
	81	+	rename -v 'y/A-Z/a-z/' *
	82	+	```
81	83
82	84		- Затем в Lazarus повторно откройте пакет (.lpk) и исправьте регистры имен файлов, нажав "More..."/"Fix Files Case"(Еще .../Исправить регистр файлов).
83	85		- Теперь пакет должен скомпилироваться.
84	86
85	87		# Немного о компонентах
86	88
87	89		Прим.перев.: позволил себе сделать краткое описание компонентов из набора на основе [официальной документации](https://sourceforge.net/projects/zeoslib/files/documentation/ZeosDocumentationCollection-2017-03-20.pdf/download).
88	90
89	91		## TZConnection
90	92
91	93		Компонент TZConnection представляет собой комбинацию компонента, подобного BDE TDatabase, и компонента, который обрабатывает транзакцию. Транзакция запускается библиотекой ZEOS всякий раз, когда открывается соединение (метод Connect TZConnection) с базой данных. Это приводит к тому, что каждый доступ к базе данных выполняется автоматически в контексте выполняющейся транзакции.
92	94
93	95		### AutoCommit
94	96
95	97		Так называемый режим AutoCommit о умолчанию всегда включен (установлен в «True»). Это также стандартное поведение соответствующего компонента BDE. Если AutoCommit активен, то каждое изменение оператора SQL будет подтверждаться в базе данных с помощью COMMIT после его успешного выполнения.
96	98
97	99		Если вы хотите управлять транзакцией сами при помощи последовательных StartTransaction..Commit/Rollback, то AutoCommit должен быть отключен (установлен в «False»). В рамках этой явной транзакции можно последовательно выполнить несколько операторов SQL, которые вносят изменения в базу данных. При вызове метода Commit все изменения, сделанные в этой явной транзакции, подтверждаются. Вызов метода Rollback сбрасывает эти изменения.
98	100
99	101		### TransactIsolationLevel (TIL)
100	102
101	103		Компонент TZConnection предоставляет четыре полезных и предопределенных уровня изоляции транзакций (TIL):
102	104
103	105		- tiRepeatableRead: он соответствует TIL ”SNAPSHOT”, который является стандартом серверов Firebird. Это комбинация параметров транзакции concurrency и nowait. Создается снимок текущей базы данных. На других пользователей влияют (ограничивают) только в том случае, если две транзакции работают с одной записью одновременно. Если при доступе к данным возникнут конфликты, будет возвращено сообщение об ошибке. Изменения в других транзакциях не будут замечены. Этот TIL широко охватывает требования стандарта SQL (SERIALIZABLE).
104	106
105	107		- TiReadCommitted: соответствует TIL "READ COMMITTED". Это комбинация параметров транзакции "read_committed", "rec_version" и "nowait'. Этот TIL распознает все изменения в других транзакциях, которые были подтверждены COMMIT. Параметр "rec_version" отвечает за поведение, при котором будут учитываться самые последние значения, зафиксированные другими пользователями. Параметр "nowait" отвечает за поведение, при котором нет ожидания освобождения заблокированной записи (т.е. транзакция откатывается, если запись редактируется другим пользователем, а потому является заблокированной). Таким образом, сервер более нагружен, чем в TIL tiRepeatableRead, потому что он должен выполнять все обновления, чтобы получать эти значения снова и снова.
106	108
107	109		- TiSerializable: соответствует TIL "SNAPSHOT TABLE STABILITY'. Она используется для получения монопольного доступа к набору данных. Реализуемый параметром транзакции «согласованность», она предотвращает доступ «внешней» транзакции к записанным данным. Только транзакция, которая записала данные, может получить к ним доступ. Это предотвращает также многопользовательский доступ к записанным данным. Поскольку этот TIL очень ограничивает доступ к записанным данным, его следует применять с большой осторожностью.
108	110
109	111		- TiNone: TIL не используется для изоляции транзакции. TIL tiReadUncommitted не поддерживается Firebird. Если используется этот TIL, будет вызвана ошибка, и транзакция не будет изолирована (как при использовании tiNone).
110	112
111	113		### Protocol
112	114
113	115		Свойство определяет, какой протокол коннекта (напр, ado, firebird, sqlite и т.д.) будет использоваться и, следовательно, к какому серверу SQL будет осуществляться доступ. Благодаря этому, вам не нужно устанавливать специальные компоненты для каждой базы данных, к которой вы хотите получить доступ, как это было в версии 5.x и ранее. Компоненты будут установлены один раз. Вы только выбираете протокол для поддерживаемого SQL-сервера, к которому хотите получить доступ, и все готово.
114	116
115	117		### ReadOnly
116	118
117	119		Соединение с базой данных, поддерживаемое объектом TZConnection, по умолчанию настроено только для чтения (ReadOnly = True). Это означает, что доступ для записи в подключенную базу данных запрещен. Чтобы получить доступ для записи в базу данных, вы должны установить для ReadOnly значение False.
118	120
119	121		### Properties
120	122
121	123		Редактор множества настроек, каждую из которых можно задать либо путем выбора в диалоговом окне
122	124
123	125		![](/wiki-images/f/fa/Zeos_zconnection_properties.png)
124	126
125	127		либо определением этого параметра в коде, например:
126	128
127	129		``` pascal
128	130		ZConection.Properties.Add ('lc_ctype=ISO8859_1');
129	131		//или
130	132		ZConnection.Properties.Add ('Codepage=ISO8859_1');
131	133		```
132	134
133	135		## TZQuery и TZUpdateSQL
134	136
135	137		Компонент для чтения и изменения набора данных. Для чтения необходимо заполнить свойство SQL, затем открыть набор данных, например:
136	138
137	139		``` pascal
138	140		ZQuery.SQL.Text:= 'select * from MyTable';
139	141		ZQuery.Active:= True;//или if not ZQuery.Active then ZQuery.Open;
140	142		```
141	143
142	144		Для модификации набора данных необходимо использовать TZUpdateSQL, где должны быть заполнены свойства ModifySQL, InsertSQl, DeleteSQL и RefreshSQL для изменения, вставки, удаления и обновления данных соответственно. При этом оба компонента должны быть связаны следующим образом:
143	145
144	146		``` pascal
145	147		ZQuery.UpdateObject:= ZUpdateSQL;
146	148		```
147	149
148	150		а для выполнения модификации данных необходимо вызывать ZQuery.ExecSQL (вместо ZQuery.Open).
149	151
150	152		Генерацию модифицирующих запросов можно выполнять в design-time при помощи встроенного редактора. Для этого необходимо в design-time связать между собой ZConnection, ZTransaction, ZQuery и ZUpdateSQL. Затем выполнить подключение к базе данных, сделать активным ZQuery, выделить ZUpdateSQL, ПКМ вызвать контекстное меню и выбрать пункт "UpdateSQL editor..."
151	153
152	154		![](/wiki-images/7/77/Zeos_zupdatesql_editor1.png)
153	155
154	156		Затем последовательно выделяем первичный ключ в поле "Key Fields" и жмем "Select Primary Keys", потом в поле "Update Fields" выделяем поля, которые мы хотим модифицировать
155	157
156	158		![](/wiki-images/5/50/Zeos_zupdatesql_editor2.png)
157	159
158	160		Нажав кнопку "Generate SQL", получает автоматически сгенерированные запросы
159	161
160	162		![](/wiki-images/2/25/Zeos_zupdatesql_editor3.png)
161	163
162	164		### Transaction и UpdateTransaction
163	165
164	166		Поля, где указываются транзакции для чтения (ZQuery.Open) и записи (ZQuery.ExecSQL) соответственно. Иногда читающей и пишущей транзакцией может быть одна транзакция (зависит от типа сервера).
165	167
166	168		# Делаем свое первое приложение Zeos
167	169
168	170		- Бросьте на форму ZConnection.
169	171		- Задайте свои User, Password, Host, Port и Protocol (и любые другие параметры, если необходимо).
170	172		- Установите Connected в True.
171	173
172	174		- Бросьте на форму ZQuery (не перепутайте с ZReadOnlyQuery).
173	175		- Задайте свойству Connection значение ZConnection.
174	176		- Задайте для свойства Sql что-то вроде *SELECT FROM MyTable**
175	177		- Установите Active в True.
176	178
177	179		- Бросьте на форму DataSource с вкладки \[Data Access\].
178	180		- Задайте свойству DataSet ваш ZQuery.
179	181
180	182		- Бросьте на форму DBGrid с вкладки \[Data Controls\].
181	183		- Задайте свойству Datasource ваш DataSource.
182	184		- Если все в порядке, вы должны увидеть записи из своей таблицы..
183	185
184	186		# Possible Bugs and Issues
185	187
186	188		- I have noticed that sometimes when building Lazarus it cannot find some Zeos files, as a quick workaround try this:
187	189		- Use Components/Package Graph from the main menu.
188	190		- Open the ZComponent package.
189	191		- Right Click on the Files item in the list.
190	192		- Choose \[Recompile all required\].
191	193		- When asked "Re-Compile this and all required packages?" answer \[Yes\].
192	194		- Recompile Lazarus normally (with packages).\
193	195		\
194	196
195	197		# See also
196	198
197	199		- [Forum for ZeosLib](http://zeoslib.sourceforge.net/index.php)
198	200		- [[ZeosDBO]]
199	201		- [Учебник Lazarus/Zeos/Firebird (Windows)](https://lazarus.intern.es/tutorial_firebird_lazarus_zeos_2.html) Немец./частично на Англ [download site](https://lazarus.intern.es/download_tutorials_lazarus_zeos_firebird.html)
200	202		- [Документация по работе с компонентами (англ)](https://sourceforge.net/projects/zeoslib/files/documentation/ZeosDocumentationCollection-2017-03-20.pdf/download)
201	203
202	204		---
203	205		From the Free Pascal wiki, page "Zeos tutorial/ru", as it stood on 2021-05-20 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).

Back to history