Zeos tutorial/ru: what changed

Revision 1 to 2. 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	80		` rename -v 'y/A-Z/a-z/' *`
81	81
82	82		- Затем в Lazarus повторно откройте пакет (.lpk) и исправьте регистры имен файлов, нажав "More..."/"Fix Files Case"(Еще .../Исправить регистр файлов).
83	83		- Теперь пакет должен скомпилироваться.
84	84
85	85		# Немного о компонентах
86	86
87	87		Прим.перев.: позволил себе сделать краткое описание компонентов из набора на основе [официальной документации](https://sourceforge.net/projects/zeoslib/files/documentation/ZeosDocumentationCollection-2017-03-20.pdf/download).
88	88
89	89		## TZConnection
90	90
91	91		Компонент TZConnection представляет собой комбинацию компонента, подобного BDE TDatabase, и компонента, который обрабатывает транзакцию. Транзакция запускается библиотекой ZEOS всякий раз, когда открывается соединение (метод Connect TZConnection) с базой данных. Это приводит к тому, что каждый доступ к базе данных выполняется автоматически в контексте выполняющейся транзакции.
92	92
93	93		### AutoCommit
94	94
95	95		Так называемый режим AutoCommit о умолчанию всегда включен (установлен в «True»). Это также стандартное поведение соответствующего компонента BDE. Если AutoCommit активен, то каждое изменение оператора SQL будет подтверждаться в базе данных с помощью COMMIT после его успешного выполнения.
96	96
97	97		Если вы хотите управлять транзакцией сами при помощи последовательных StartTransaction..Commit/Rollback, то AutoCommit должен быть отключен (установлен в «False»). В рамках этой явной транзакции можно последовательно выполнить несколько операторов SQL, которые вносят изменения в базу данных. При вызове метода Commit все изменения, сделанные в этой явной транзакции, подтверждаются. Вызов метода Rollback сбрасывает эти изменения.
98	98
99	99		### TransactIsolationLevel (TIL)
100	100
101	101		Компонент TZConnection предоставляет четыре полезных и предопределенных уровня изоляции транзакций (TIL):
102	102
103	103		- tiRepeatableRead: он соответствует TIL ”SNAPSHOT”, который является стандартом серверов Firebird. Это комбинация параметров транзакции concurrency и nowait. Создается снимок текущей базы данных. На других пользователей влияют (ограничивают) только в том случае, если две транзакции работают с одной записью одновременно. Если при доступе к данным возникнут конфликты, будет возвращено сообщение об ошибке. Изменения в других транзакциях не будут замечены. Этот TIL широко охватывает требования стандарта SQL (SERIALIZABLE).
104	104
105	105		- TiReadCommitted: соответствует TIL "READ COMMITTED". Это комбинация параметров транзакции "read_committed", "rec_version" и "nowait'. Этот TIL распознает все изменения в других транзакциях, которые были подтверждены COMMIT. Параметр "rec_version" отвечает за поведение, при котором будут учитываться самые последние значения, зафиксированные другими пользователями. Параметр "nowait" отвечает за поведение, при котором нет ожидания освобождения заблокированной записи (т.е. транзакция откатывается, если запись редактируется другим пользователем, а потому является заблокированной). Таким образом, сервер более нагружен, чем в TIL tiRepeatableRead, потому что он должен выполнять все обновления, чтобы получать эти значения снова и снова.
106	106
107	107		- TiSerializable: соответствует TIL "SNAPSHOT TABLE STABILITY'. Она используется для получения монопольного доступа к набору данных. Реализуемый параметром транзакции «согласованность», она предотвращает доступ «внешней» транзакции к записанным данным. Только транзакция, которая записала данные, может получить к ним доступ. Это предотвращает также многопользовательский доступ к записанным данным. Поскольку этот TIL очень ограничивает доступ к записанным данным, его следует применять с большой осторожностью.
108	108
109	109		- TiNone: TIL не используется для изоляции транзакции. TIL tiReadUncommitted не поддерживается Firebird. Если используется этот TIL, будет вызвана ошибка, и транзакция не будет изолирована (как при использовании tiNone).
110	110
111	111		### Protocol
112	112
113	113		Свойство определяет, какой протокол коннекта (напр, ado, firebird, sqlite и т.д.) будет использоваться и, следовательно, к какому серверу SQL будет осуществляться доступ. Благодаря этому, вам не нужно устанавливать специальные компоненты для каждой базы данных, к которой вы хотите получить доступ, как это было в версии 5.x и ранее. Компоненты будут установлены один раз. Вы только выбираете протокол для поддерживаемого SQL-сервера, к которому хотите получить доступ, и все готово.
114	114
115	115		### ReadOnly
116	116
117	117		Соединение с базой данных, поддерживаемое объектом TZConnection, по умолчанию настроено только для чтения (ReadOnly = True). Это означает, что доступ для записи в подключенную базу данных запрещен. Чтобы получить доступ для записи в базу данных, вы должны установить для ReadOnly значение False.
118	118
119	119		### Properties
120	120
121	121		Редактор множества настроек, каждую из которых можно задать либо путем выбора в диалоговом окне
122	122
123		-	~~<img src="zeos_zconnection_properties.png" title="zeos_zconnection_properties.png" width="400" />~~
	123	+	![](/wiki-images/f/fa/Zeos_zconnection_properties.png)
124	124
125	125		либо определением этого параметра в коде, например:
126	126
127	127		``` pascal
128	128		ZConection.Properties.Add ('lc_ctype=ISO8859_1');
129	129		//или
130	130		ZConnection.Properties.Add ('Codepage=ISO8859_1');
131	131		```
132	132
133	133		## TZQuery и TZUpdateSQL
134	134
135	135		Компонент для чтения и изменения набора данных. Для чтения необходимо заполнить свойство SQL, затем открыть набор данных, например:
136	136
137	137		``` pascal
138	138		ZQuery.SQL.Text:= 'select * from MyTable';
139	139		ZQuery.Active:= True;//или if not ZQuery.Active then ZQuery.Open;
140	140		```
141	141
142	142		Для модификации набора данных необходимо использовать TZUpdateSQL, где должны быть заполнены свойства ModifySQL, InsertSQl, DeleteSQL и RefreshSQL для изменения, вставки, удаления и обновления данных соответственно. При этом оба компонента должны быть связаны следующим образом:
143	143
144	144		``` pascal
145	145		ZQuery.UpdateObject:= ZUpdateSQL;
146	146		```
147	147
148	148		а для выполнения модификации данных необходимо вызывать ZQuery.ExecSQL (вместо ZQuery.Open).
149	149
150	150		Генерацию модифицирующих запросов можно выполнять в design-time при помощи встроенного редактора. Для этого необходимо в design-time связать между собой ZConnection, ZTransaction, ZQuery и ZUpdateSQL. Затем выполнить подключение к базе данных, сделать активным ZQuery, выделить ZUpdateSQL, ПКМ вызвать контекстное меню и выбрать пункт "UpdateSQL editor..."
151	151
152	152		![](/wiki-images/7/77/Zeos_zupdatesql_editor1.png)
153	153
154	154		Затем последовательно выделяем первичный ключ в поле "Key Fields" и жмем "Select Primary Keys", потом в поле "Update Fields" выделяем поля, которые мы хотим модифицировать
155	155
156	156		![](/wiki-images/5/50/Zeos_zupdatesql_editor2.png)
157	157
158	158		Нажав кнопку "Generate SQL", получает автоматически сгенерированные запросы
159	159
160	160		![](/wiki-images/2/25/Zeos_zupdatesql_editor3.png)
161	161
162	162		### Transaction и UpdateTransaction
163	163
164	164		Поля, где указываются транзакции для чтения (ZQuery.Open) и записи (ZQuery.ExecSQL) соответственно. Иногда читающей и пишущей транзакцией может быть одна транзакция (зависит от типа сервера).
165	165
166	166		# Делаем свое первое приложение Zeos
167	167
168	168		- Бросьте на форму ZConnection.
169	169		- Задайте свои User, Password, Host, Port и Protocol (и любые другие параметры, если необходимо).
170	170		- Установите Connected в True.
171	171
172	172		- Бросьте на форму ZQuery (не перепутайте с ZReadOnlyQuery).
173	173		- Задайте свойству Connection значение ZConnection.
174	174		- Задайте для свойства Sql что-то вроде *SELECT FROM MyTable**
175	175		- Установите Active в True.
176	176
177	177		- Бросьте на форму DataSource с вкладки \[Data Access\].
178	178		- Задайте свойству DataSet ваш ZQuery.
179	179
180	180		- Бросьте на форму DBGrid с вкладки \[Data Controls\].
181	181		- Задайте свойству Datasource ваш DataSource.
182	182		- Если все в порядке, вы должны увидеть записи из своей таблицы..
183	183
184	184		# Possible Bugs and Issues
185	185
186	186		- I have noticed that sometimes when building Lazarus it cannot find some Zeos files, as a quick workaround try this:
187	187		- Use Components/Package Graph from the main menu.
188	188		- Open the ZComponent package.
189	189		- Right Click on the Files item in the list.
190	190		- Choose \[Recompile all required\].
191	191		- When asked "Re-Compile this and all required packages?" answer \[Yes\].
192	192		- Recompile Lazarus normally (with packages).\
193	193		\
194	194
195	195		# See also
196	196
197	197		- [Forum for ZeosLib](http://zeoslib.sourceforge.net/index.php)
198	198		- [[ZeosDBO]]
199	199		- [Учебник 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	200		- [Документация по работе с компонентами (англ)](https://sourceforge.net/projects/zeoslib/files/documentation/ZeosDocumentationCollection-2017-03-20.pdf/download)
201	201
202	202		---
203	203		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