1 |
(* |
2 |
* Firebird Interface (fbintf). The fbintf components provide a set of |
3 |
* Pascal language bindings for the Firebird API. Although predominantly |
4 |
* a new development they include source code taken from IBX and may be |
5 |
* considered a derived product. This software thus also includes the copyright |
6 |
* notice and license conditions from IBX. |
7 |
* |
8 |
* Except for those parts dervied from IBX, contents of this file are subject |
9 |
* to the Initial Developer's Public License Version 1.0 (the "License"); you |
10 |
* may not use this file except in compliance with the License. You may obtain a |
11 |
* copy of the License here: |
12 |
* |
13 |
* http://www.firebirdsql.org/index.php?op=doc&id=idpl |
14 |
* |
15 |
* Software distributed under the License is distributed on an "AS |
16 |
* IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or |
17 |
* implied. See the License for the specific language governing rights |
18 |
* and limitations under the License. |
19 |
* |
20 |
* The Initial Developer of the Original Code is Tony Whyman. |
21 |
* |
22 |
* The Original Code is (C) 2016 Tony Whyman, MWA Software |
23 |
* (http://www.mwasoftware.co.uk). |
24 |
* |
25 |
* All Rights Reserved. |
26 |
* |
27 |
* Contributor(s): ______________________________________. |
28 |
* |
29 |
*) |
30 |
{************************************************************************} |
31 |
{ } |
32 |
{ Borland Delphi Visual Component Library } |
33 |
{ InterBase Express core components } |
34 |
{ } |
35 |
{ Copyright (c) 1998-2000 Inprise Corporation } |
36 |
{ } |
37 |
{ InterBase Express is based in part on the product } |
38 |
{ Free IB Components, written by Gregory H. Deatz for } |
39 |
{ Hoagland, Longo, Moran, Dunst & Doukas Company. } |
40 |
{ Free IB Components is used under license. } |
41 |
{ } |
42 |
{ The contents of this file are subject to the InterBase } |
43 |
{ Public License Version 1.0 (the "License"); you may not } |
44 |
{ use this file except in compliance with the License. You } |
45 |
{ may obtain a copy of the License at http://www.Inprise.com/IPL.html } |
46 |
{ Software distributed under the License is distributed on } |
47 |
{ an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, either } |
48 |
{ express or implied. See the License for the specific language } |
49 |
{ governing rights and limitations under the License. } |
50 |
{ The Original Code was created by InterBase Software Corporation } |
51 |
{ and its successors. } |
52 |
{ Portions created by Inprise Corporation are Copyright (C) Inprise } |
53 |
{ Corporation. All Rights Reserved. } |
54 |
{ Contributor(s): Jeff Overcash } |
55 |
{ } |
56 |
{ IBX For Lazarus (Firebird Express) } |
57 |
{ Contributor: Tony Whyman, MWA Software http://www.mwasoftware.co.uk } |
58 |
{ Portions created by MWA Software are copyright McCallum Whyman } |
59 |
{ Associates Ltd 2011 - 2015 } |
60 |
{ } |
61 |
{************************************************************************} |
62 |
unit FB25ClientAPI; |
63 |
{$IFDEF MSWINDOWS} |
64 |
{$DEFINE WINDOWS} |
65 |
{$ENDIF} |
66 |
|
67 |
{$IFDEF FPC} |
68 |
{$mode delphi} |
69 |
{$interfaces COM} |
70 |
{$ENDIF} |
71 |
|
72 |
interface |
73 |
|
74 |
uses |
75 |
Classes, SysUtils, FBClientAPI, IBHeader, IBExternals, IB; |
76 |
|
77 |
const |
78 |
FBClientInterfaceVersion = '2.5'; |
79 |
|
80 |
type |
81 |
|
82 |
{ TFB25Status } |
83 |
|
84 |
TFB25Status = class(TFBStatus,IStatus) |
85 |
public |
86 |
function StatusVector: PStatusVector; override; |
87 |
end; |
88 |
|
89 |
{ TFB25ClientAPI } |
90 |
|
91 |
TFB25ClientAPI = class(TFBClientAPI,IFirebirdAPI) |
92 |
private |
93 |
FIBServiceAPIPresent: boolean; |
94 |
FStatus: TFB25Status; |
95 |
FStatusIntf: IStatus; {Keep a reference to the interface - automatic destroy |
96 |
when this class is freed and last reference to IStatus |
97 |
goes out of scope.} |
98 |
public |
99 |
constructor Create(aFBLibrary: TFBLibrary); |
100 |
destructor Destroy; override; |
101 |
function StatusVector: PISC_STATUS; |
102 |
function LoadInterface: boolean; override; |
103 |
function GetAPI: IFirebirdAPI; override; |
104 |
{$IFDEF UNIX} |
105 |
function GetFirebirdLibList: string; override; |
106 |
{$ENDIF} |
107 |
property IBServiceAPIPresent: boolean read FIBServiceAPIPresent; |
108 |
property Status: TFB25Status read FStatus; |
109 |
|
110 |
public |
111 |
|
112 |
{fbclient API} |
113 |
BLOB_get: TBLOB_get; |
114 |
BLOB_put: TBLOB_put; |
115 |
isc_wait_for_event: Tisc_wait_for_event; |
116 |
isc_vax_integer: Tisc_vax_integer; |
117 |
isc_portable_integer: Tisc_portable_integer; |
118 |
isc_blob_info: Tisc_blob_info; |
119 |
isc_blob_lookup_desc: Tisc_blob_lookup_desc; |
120 |
isc_open_blob2: Tisc_open_blob2; |
121 |
isc_close_blob: Tisc_close_blob; |
122 |
isc_get_segment: Tisc_get_segment; |
123 |
isc_put_segment: Tisc_put_segment; |
124 |
isc_create_blob2: Tisc_create_blob2; |
125 |
isc_cancel_blob: Tisc_cancel_blob; |
126 |
isc_service_attach: Tisc_service_attach; |
127 |
isc_service_detach: Tisc_service_detach; |
128 |
isc_service_query: Tisc_service_query; |
129 |
isc_service_start: Tisc_service_start; |
130 |
isc_decode_date: Tisc_decode_date; |
131 |
isc_decode_sql_date: Tisc_decode_sql_date; |
132 |
isc_decode_sql_time: Tisc_decode_sql_time; |
133 |
isc_decode_timestamp: Tisc_decode_timestamp; |
134 |
isc_encode_date: Tisc_encode_date; |
135 |
isc_encode_sql_date: Tisc_encode_sql_date; |
136 |
isc_encode_sql_time: Tisc_encode_sql_time; |
137 |
isc_encode_timestamp: Tisc_encode_timestamp; |
138 |
isc_dsql_free_statement: Tisc_dsql_free_statement; |
139 |
isc_dsql_execute2: Tisc_dsql_execute2; |
140 |
isc_dsql_execute: Tisc_dsql_execute; |
141 |
isc_dsql_set_cursor_name: Tisc_dsql_set_cursor_name; |
142 |
isc_dsql_fetch: Tisc_dsql_fetch; |
143 |
isc_dsql_sql_info: Tisc_dsql_sql_info; |
144 |
isc_dsql_alloc_statement2: Tisc_dsql_alloc_statement2; |
145 |
isc_dsql_prepare: Tisc_dsql_prepare; |
146 |
isc_dsql_describe_bind: Tisc_dsql_describe_bind; |
147 |
isc_dsql_describe: Tisc_dsql_describe; |
148 |
isc_dsql_execute_immediate: Tisc_dsql_execute_immediate; |
149 |
isc_drop_database: Tisc_drop_database; |
150 |
isc_detach_database: Tisc_detach_database; |
151 |
isc_attach_database: Tisc_attach_database; |
152 |
isc_database_info: Tisc_database_info; |
153 |
isc_start_transaction: Tisc_start_transaction; |
154 |
isc_start_multiple: Tisc_start_multiple; |
155 |
isc_commit_transaction: Tisc_commit_transaction; |
156 |
isc_commit_retaining: Tisc_commit_retaining; |
157 |
isc_rollback_transaction: Tisc_rollback_transaction; |
158 |
isc_rollback_retaining: Tisc_rollback_retaining; |
159 |
isc_cancel_events: Tisc_cancel_events; |
160 |
isc_que_events: Tisc_que_events; |
161 |
isc_add_user : Tisc_add_user; |
162 |
isc_delete_user: Tisc_delete_user; |
163 |
isc_modify_user: Tisc_modify_user; |
164 |
isc_array_lookup_bounds: Tisc_array_lookup_bounds; |
165 |
isc_array_get_slice: Tisc_array_get_slice; |
166 |
isc_array_put_slice: Tisc_array_put_slice; |
167 |
isc_prepare_transaction: Tisc_prepare_transaction; |
168 |
|
169 |
public |
170 |
{Helper Functions} |
171 |
function DecodeInteger(bufptr: PByte; len: short): integer; override; |
172 |
procedure SQLEncodeDate(aDate: TDateTime; bufptr: PByte); override; |
173 |
function SQLDecodeDate(bufptr: PByte): TDateTime; override; |
174 |
procedure SQLEncodeTime(aTime: TDateTime; bufptr: PByte); override; |
175 |
function SQLDecodeTime(bufptr: PByte): TDateTime; override; |
176 |
procedure SQLEncodeDateTime(aDateTime: TDateTime; bufptr: PByte); override; |
177 |
function SQLDecodeDateTime(bufptr: PByte): TDateTime; override; |
178 |
|
179 |
public |
180 |
{IFirebirdAPI} |
181 |
|
182 |
{Database connections} |
183 |
function AllocateDPB: IDPB; |
184 |
function OpenDatabase(DatabaseName: AnsiString; DPB: IDPB; RaiseExceptionOnConnectError: boolean=true): IAttachment; |
185 |
function CreateDatabase(DatabaseName: AnsiString; DPB: IDPB; RaiseExceptionOnError: boolean=true): IAttachment; overload; |
186 |
function CreateDatabase(sql: AnsiString; aSQLDialect: integer; RaiseExceptionOnError: boolean=true): IAttachment; overload; |
187 |
|
188 |
{Start Transaction against multiple databases} |
189 |
function AllocateTPB: ITPB; |
190 |
function StartTransaction(Attachments: array of IAttachment; |
191 |
TPB: array of byte; DefaultCompletion: TTransactionCompletion): ITransaction; overload; |
192 |
function StartTransaction(Attachments: array of IAttachment; |
193 |
TPB: ITPB; DefaultCompletion: TTransactionCompletion): ITransaction; overload; |
194 |
|
195 |
{Service Manager} |
196 |
function AllocateSPB: ISPB; |
197 |
function HasServiceAPI: boolean; |
198 |
function GetServiceManager(ServerName: AnsiString; Protocol: TProtocol; SPB: ISPB): IServiceManager; overload; |
199 |
function GetServiceManager(ServerName: AnsiString; Port: AnsiString; Protocol: TProtocol; SPB: ISPB): IServiceManager; overload; |
200 |
|
201 |
{Information} |
202 |
function GetStatus: IStatus; override; |
203 |
function HasRollbackRetaining: boolean; |
204 |
function IsEmbeddedServer: boolean; override; |
205 |
function GetImplementationVersion: AnsiString; |
206 |
|
207 |
{Firebird 3 API} |
208 |
function HasMasterIntf: boolean; |
209 |
function GetIMaster: TObject; |
210 |
|
211 |
end; |
212 |
|
213 |
implementation |
214 |
|
215 |
uses FBMessages, |
216 |
{$IFDEF WINDOWS}Windows, {$ENDIF} |
217 |
{$IFDEF FPC} Dynlibs, {$ENDIF} |
218 |
FB25Attachment, FB25Transaction, FB25Services, FBParamBlock, |
219 |
IBUtils; |
220 |
|
221 |
{ Stubs for 6.0 only functions } |
222 |
function isc_rollback_retaining_stub(status_vector : PISC_STATUS; |
223 |
tran_handle : PISC_TR_HANDLE): |
224 |
ISC_STATUS; {$IFDEF WINDOWS} stdcall; {$ELSE} cdecl; {$ENDIF} |
225 |
begin |
226 |
Result := 0; |
227 |
IBError(ibxeIB60feature, ['isc_rollback_retaining']); {do not localize} |
228 |
end; |
229 |
|
230 |
function isc_service_attach_stub(status_vector : PISC_STATUS; |
231 |
isc_arg2 : UShort; |
232 |
isc_arg3 : PAnsiChar; |
233 |
service_handle : PISC_SVC_HANDLE; |
234 |
isc_arg5 : UShort; |
235 |
isc_arg6 : PAnsiChar): |
236 |
ISC_STATUS; {$IFDEF WINDOWS} stdcall; {$ELSE} cdecl; {$ENDIF} |
237 |
begin |
238 |
Result := 0; |
239 |
IBError(ibxeIB60feature, ['isc_service_attach']); {do not localize} |
240 |
end; |
241 |
|
242 |
function isc_service_detach_stub(status_vector : PISC_STATUS; |
243 |
service_handle : PISC_SVC_HANDLE): |
244 |
ISC_STATUS; {$IFDEF WINDOWS} stdcall; {$ELSE} cdecl; {$ENDIF} |
245 |
begin |
246 |
Result := 0; |
247 |
IBError(ibxeIB60feature, ['isc_service_detach']); {do not localize} |
248 |
end; |
249 |
|
250 |
function isc_service_query_stub(status_vector : PISC_STATUS; |
251 |
service_handle : PISC_SVC_HANDLE; |
252 |
recv_handle : PISC_SVC_HANDLE; |
253 |
isc_arg4 : UShort; |
254 |
isc_arg5 : PAnsiChar; |
255 |
isc_arg6 : UShort; |
256 |
isc_arg7 : PAnsiChar; |
257 |
isc_arg8 : UShort; |
258 |
isc_arg9 : PAnsiChar): |
259 |
ISC_STATUS; {$IFDEF WINDOWS} stdcall; {$ELSE} cdecl; {$ENDIF} |
260 |
begin |
261 |
Result := 0; |
262 |
IBError(ibxeIB60feature, ['isc_service_query']); {do not localize} |
263 |
end; |
264 |
|
265 |
function isc_service_start_stub(status_vector : PISC_STATUS; |
266 |
service_handle : PISC_SVC_HANDLE; |
267 |
recv_handle : PISC_SVC_HANDLE; |
268 |
isc_arg4 : UShort; |
269 |
isc_arg5 : PAnsiChar): |
270 |
ISC_STATUS; {$IFDEF WINDOWS} stdcall; {$ELSE} cdecl; {$ENDIF} |
271 |
begin |
272 |
Result := 0; |
273 |
IBError(ibxeIB60feature, ['isc_service_start']); {do not localize} |
274 |
end; |
275 |
|
276 |
procedure isc_encode_sql_date_stub(tm_date : PCTimeStructure; |
277 |
ib_date : PISC_DATE); |
278 |
{$IFDEF WINDOWS} stdcall; {$ELSE} cdecl; {$ENDIF} |
279 |
begin |
280 |
IBError(ibxeIB60feature, ['isc_encode_sql_date']); {do not localize} |
281 |
end; |
282 |
|
283 |
procedure isc_encode_sql_time_stub(tm_date : PCTimeStructure; |
284 |
ib_time : PISC_TIME); |
285 |
{$IFDEF WINDOWS} stdcall; {$ELSE} cdecl; {$ENDIF} |
286 |
begin |
287 |
IBError(ibxeIB60feature, ['isc_encode_sql_time']); {do not localize} |
288 |
end; |
289 |
|
290 |
procedure isc_encode_timestamp_stub(tm_date : PCTimeStructure; |
291 |
ib_timestamp : PISC_TIMESTAMP); |
292 |
{$IFDEF WINDOWS} stdcall; {$ELSE} cdecl; {$ENDIF} |
293 |
begin |
294 |
IBError(ibxeIB60feature, ['isc_encode_sql_timestamp']); {do not localize} |
295 |
end; |
296 |
|
297 |
procedure isc_decode_sql_date_stub(ib_date : PISC_DATE; |
298 |
tm_date : PCTimeStructure); |
299 |
{$IFDEF WINDOWS} stdcall; {$ELSE} cdecl; {$ENDIF} |
300 |
begin |
301 |
IBError(ibxeIB60feature, ['isc_decode_sql_date']); {do not localize} |
302 |
end; |
303 |
|
304 |
procedure isc_decode_sql_time_stub(ib_time : PISC_TIME; |
305 |
tm_date : PCTimeStructure); |
306 |
{$IFDEF WINDOWS} stdcall; {$ELSE} cdecl; {$ENDIF} |
307 |
begin |
308 |
IBError(ibxeIB60feature, ['isc_decode_sql_time']); {do not localize} |
309 |
end; |
310 |
|
311 |
procedure isc_decode_timestamp_stub(ib_timestamp : PISC_TIMESTAMP; |
312 |
tm_date : PCTimeStructure); |
313 |
{$IFDEF WINDOWS} stdcall; {$ELSE} cdecl; {$ENDIF} |
314 |
begin |
315 |
IBError(ibxeIB60feature, ['isc_decode_timestamp']); {do not localize} |
316 |
end; |
317 |
|
318 |
{ TFB25Status } |
319 |
|
320 |
threadvar |
321 |
FStatusVector: TStatusVector; |
322 |
|
323 |
{ TFB25ActivityReporter } |
324 |
|
325 |
function TFB25Status.StatusVector: PStatusVector; |
326 |
begin |
327 |
Result := @FStatusVector; |
328 |
end; |
329 |
|
330 |
|
331 |
{ TFB25ClientAPI } |
332 |
|
333 |
{$IFDEF UNIX} |
334 |
function TFB25ClientAPI.GetFirebirdLibList: string; |
335 |
begin |
336 |
Result := 'libfbembed.so:libfbembed.so.2.5:libfbembed.so.2.1:libfbclient.so:libfbclient.so.2'; |
337 |
end; |
338 |
{$ENDIF} |
339 |
|
340 |
function TFB25ClientAPI.LoadInterface: boolean; |
341 |
begin |
342 |
Result := inherited LoadInterface; |
343 |
BLOB_get := GetProcAddr('BLOB_get'); {do not localize} |
344 |
BLOB_put := GetProcAddr('BLOB_put'); {do not localize} |
345 |
isc_wait_for_event := GetProcAddr('isc_wait_for_event'); {do not localize} |
346 |
isc_vax_integer := GetProcAddr('isc_vax_integer'); {do not localize} |
347 |
isc_portable_integer := GetProcAddr('isc_portable_integer'); {do not localize} |
348 |
isc_blob_info := GetProcAddr('isc_blob_info'); {do not localize} |
349 |
isc_blob_lookup_desc := GetProcAddr('isc_blob_lookup_desc'); {do not localize} |
350 |
isc_open_blob2 := GetProcAddr('isc_open_blob2'); {do not localize} |
351 |
isc_close_blob := GetProcAddr('isc_close_blob'); {do not localize} |
352 |
isc_get_segment := GetProcAddr('isc_get_segment'); {do not localize} |
353 |
isc_put_segment := GetProcAddr('isc_put_segment'); {do not localize} |
354 |
isc_create_blob2 := GetProcAddr('isc_create_blob2'); {do not localize} |
355 |
isc_cancel_blob := GetProcAddr('isc_cancel_blob'); {do not localize} |
356 |
isc_decode_date := GetProcAddr('isc_decode_date'); {do not localize} |
357 |
isc_encode_date := GetProcAddr('isc_encode_date'); {do not localize} |
358 |
isc_dsql_free_statement := GetProcAddr('isc_dsql_free_statement'); {do not localize} |
359 |
isc_dsql_execute2 := GetProcAddr('isc_dsql_execute2'); {do not localize} |
360 |
isc_dsql_execute := GetProcAddr('isc_dsql_execute'); {do not localize} |
361 |
isc_dsql_set_cursor_name := GetProcAddr('isc_dsql_set_cursor_name'); {do not localize} |
362 |
isc_dsql_fetch := GetProcAddr('isc_dsql_fetch'); {do not localize} |
363 |
isc_dsql_sql_info := GetProcAddr('isc_dsql_sql_info'); {do not localize} |
364 |
isc_dsql_alloc_statement2 := GetProcAddr('isc_dsql_alloc_statement2'); {do not localize} |
365 |
isc_dsql_prepare := GetProcAddr('isc_dsql_prepare'); {do not localize} |
366 |
isc_dsql_describe_bind := GetProcAddr('isc_dsql_describe_bind'); {do not localize} |
367 |
isc_dsql_describe := GetProcAddr('isc_dsql_describe'); {do not localize} |
368 |
isc_dsql_execute_immediate := GetProcAddr('isc_dsql_execute_immediate'); {do not localize} |
369 |
isc_drop_database := GetProcAddr('isc_drop_database'); {do not localize} |
370 |
isc_detach_database := GetProcAddr('isc_detach_database'); {do not localize} |
371 |
isc_attach_database := GetProcAddr('isc_attach_database'); {do not localize} |
372 |
isc_database_info := GetProcAddr('isc_database_info'); {do not localize} |
373 |
isc_start_transaction := GetProcAddr('isc_start_transaction'); {do not localize} |
374 |
isc_start_multiple := GetProcAddr('isc_start_multiple'); {do not localize} |
375 |
isc_commit_transaction := GetProcAddr('isc_commit_transaction'); {do not localize} |
376 |
isc_commit_retaining := GetProcAddr('isc_commit_retaining'); {do not localize} |
377 |
isc_rollback_transaction := GetProcAddr('isc_rollback_transaction'); {do not localize} |
378 |
isc_cancel_events := GetProcAddr('isc_cancel_events'); {do not localize} |
379 |
isc_que_events := GetProcAddr('isc_que_events'); {do not localize} |
380 |
isc_add_user := GetProcAddr('isc_add_user'); {do not localize} |
381 |
isc_delete_user := GetProcAddr('isc_delete_user'); {do not localize} |
382 |
isc_modify_user := GetProcAddr('isc_modify_user'); {do not localize} |
383 |
isc_array_lookup_bounds := GetProcAddr('isc_array_lookup_bounds'); {do not localize} |
384 |
isc_array_get_slice := GetProcAddr('isc_array_get_slice'); {do not localize} |
385 |
isc_array_put_slice := GetProcAddr('isc_array_put_slice'); {do not localize} |
386 |
isc_prepare_transaction := GetProcAddr('isc_prepare_transaction'); {do not localize} |
387 |
|
388 |
FIBServiceAPIPresent := true; |
389 |
isc_rollback_retaining := GetProcAddress(FFBLibrary.IBLibrary, 'isc_rollback_retaining'); {do not localize} |
390 |
if Assigned(isc_rollback_retaining) then |
391 |
begin |
392 |
isc_service_attach := GetProcAddr('isc_service_attach'); {do not localize} |
393 |
isc_service_detach := GetProcAddr('isc_service_detach'); {do not localize} |
394 |
isc_service_query := GetProcAddr('isc_service_query'); {do not localize} |
395 |
isc_service_start := GetProcAddr('isc_service_start'); {do not localize} |
396 |
isc_decode_sql_date := GetProcAddr('isc_decode_sql_date'); {do not localize} |
397 |
isc_decode_sql_time := GetProcAddr('isc_decode_sql_time'); {do not localize} |
398 |
isc_decode_timestamp := GetProcAddr('isc_decode_timestamp'); {do not localize} |
399 |
isc_encode_sql_date := GetProcAddr('isc_encode_sql_date'); {do not localize} |
400 |
isc_encode_sql_time := GetProcAddr('isc_encode_sql_time'); {do not localize} |
401 |
isc_encode_timestamp := GetProcAddr('isc_encode_timestamp'); {do not localize} |
402 |
end else |
403 |
begin |
404 |
FIBServiceAPIPresent := false; |
405 |
isc_rollback_retaining := @isc_rollback_retaining_stub; |
406 |
isc_service_attach := @isc_service_attach_stub; |
407 |
isc_service_detach := @isc_service_detach_stub; |
408 |
isc_service_query := @isc_service_query_stub; |
409 |
isc_service_start := @isc_service_start_stub; |
410 |
isc_decode_sql_date := @isc_decode_sql_date_stub; |
411 |
isc_decode_sql_time := @isc_decode_sql_time_stub; |
412 |
isc_decode_timestamp := @isc_decode_timestamp_stub; |
413 |
isc_encode_sql_date := @isc_encode_sql_date_stub; |
414 |
isc_encode_sql_time := @isc_encode_sql_time_stub; |
415 |
isc_encode_timestamp := @isc_encode_timestamp_stub; |
416 |
end; |
417 |
Result := Result and assigned(isc_attach_database); |
418 |
end; |
419 |
|
420 |
function TFB25ClientAPI.GetAPI: IFirebirdAPI; |
421 |
begin |
422 |
Result := self; |
423 |
end; |
424 |
|
425 |
constructor TFB25ClientAPI.Create(aFBLibrary: TFBLibrary); |
426 |
begin |
427 |
inherited Create(aFBLibrary); |
428 |
FStatus := TFB25Status.Create(self); |
429 |
FStatusIntf := FStatus; |
430 |
end; |
431 |
|
432 |
destructor TFB25ClientAPI.Destroy; |
433 |
begin |
434 |
FStatusIntf := nil; |
435 |
inherited Destroy; |
436 |
end; |
437 |
|
438 |
|
439 |
function TFB25ClientAPI.StatusVector: PISC_STATUS; |
440 |
begin |
441 |
Result := PISC_STATUS(FStatus.StatusVector); |
442 |
end; |
443 |
|
444 |
function TFB25ClientAPI.GetStatus: IStatus; |
445 |
begin |
446 |
Result := FStatus; |
447 |
end; |
448 |
|
449 |
function TFB25ClientAPI.AllocateDPB: IDPB; |
450 |
begin |
451 |
Result := TDPB.Create(self); |
452 |
end; |
453 |
|
454 |
function TFB25ClientAPI.OpenDatabase(DatabaseName: AnsiString; DPB: IDPB; |
455 |
RaiseExceptionOnConnectError: boolean): IAttachment; |
456 |
begin |
457 |
Result := TFB25Attachment.Create(self,DatabaseName,DPB,RaiseExceptionOnConnectError); |
458 |
if not Result.IsConnected then |
459 |
Result := nil; |
460 |
end; |
461 |
|
462 |
function TFB25ClientAPI.CreateDatabase(DatabaseName: AnsiString; DPB: IDPB; |
463 |
RaiseExceptionOnError: boolean): IAttachment; |
464 |
begin |
465 |
Result := TFB25Attachment.CreateDatabase(self,DatabaseName, DPB, RaiseExceptionOnError ); |
466 |
if (Result <> nil) and not Result.IsConnected then |
467 |
Result := nil; |
468 |
end; |
469 |
|
470 |
function TFB25ClientAPI.CreateDatabase(sql: AnsiString; aSQLDialect: integer; |
471 |
RaiseExceptionOnError: boolean): IAttachment; |
472 |
begin |
473 |
Result := TFB25Attachment.CreateDatabase(self,sql,aSQLDialect, RaiseExceptionOnError ); |
474 |
if (Result <> nil) and not Result.IsConnected then |
475 |
Result := nil; |
476 |
end; |
477 |
|
478 |
function TFB25ClientAPI.AllocateSPB: ISPB; |
479 |
begin |
480 |
Result := TSPB.Create(self); |
481 |
end; |
482 |
|
483 |
function TFB25ClientAPI.AllocateTPB: ITPB; |
484 |
begin |
485 |
Result := TTPB.Create(self); |
486 |
end; |
487 |
|
488 |
function TFB25ClientAPI.GetServiceManager(ServerName: AnsiString; |
489 |
Protocol: TProtocol; SPB: ISPB): IServiceManager; |
490 |
begin |
491 |
if HasServiceAPI then |
492 |
Result := TFB25ServiceManager.Create(self,ServerName,Protocol,SPB) |
493 |
else |
494 |
Result := nil; |
495 |
end; |
496 |
|
497 |
function TFB25ClientAPI.GetServiceManager(ServerName: AnsiString; |
498 |
Port: AnsiString; Protocol: TProtocol; SPB: ISPB): IServiceManager; |
499 |
begin |
500 |
if HasServiceAPI then |
501 |
Result := TFB25ServiceManager.Create(self,ServerName,Protocol,SPB,Port) |
502 |
else |
503 |
Result := nil; |
504 |
end; |
505 |
|
506 |
function TFB25ClientAPI.StartTransaction(Attachments: array of IAttachment; |
507 |
TPB: array of byte; DefaultCompletion: TTransactionCompletion): ITransaction; |
508 |
begin |
509 |
Result := TFB25Transaction.Create(self,Attachments,TPB,DefaultCompletion); |
510 |
end; |
511 |
|
512 |
function TFB25ClientAPI.StartTransaction(Attachments: array of IAttachment; |
513 |
TPB: ITPB; DefaultCompletion: TTransactionCompletion): ITransaction; |
514 |
begin |
515 |
Result := TFB25Transaction.Create(self,Attachments,TPB,DefaultCompletion); |
516 |
end; |
517 |
|
518 |
function TFB25ClientAPI.HasServiceAPI: boolean; |
519 |
begin |
520 |
Result := IBServiceAPIPresent; |
521 |
end; |
522 |
|
523 |
function TFB25ClientAPI.HasRollbackRetaining: boolean; |
524 |
begin |
525 |
Result := assigned(isc_rollback_retaining); |
526 |
end; |
527 |
|
528 |
function TFB25ClientAPI.IsEmbeddedServer: boolean; |
529 |
begin |
530 |
Result := false; |
531 |
{$IFDEF UNIX} |
532 |
Result := Pos('libfbembed',FFBLibrary.GetLibraryName) = 1; |
533 |
{$ENDIF} |
534 |
{$IFDEF WINDOWS} |
535 |
Result := CompareText(FFBLibrary.GetLibraryName,FIREBIRD_EMBEDDED) = 0; |
536 |
{$ENDIF} |
537 |
end; |
538 |
|
539 |
function TFB25ClientAPI.HasMasterIntf: boolean; |
540 |
begin |
541 |
Result := false; |
542 |
end; |
543 |
|
544 |
function TFB25ClientAPI.GetIMaster: TObject; |
545 |
begin |
546 |
Result := nil; |
547 |
end; |
548 |
|
549 |
function TFB25ClientAPI.GetImplementationVersion: AnsiString; |
550 |
begin |
551 |
Result := FBClientInterfaceVersion; |
552 |
end; |
553 |
|
554 |
function TFB25ClientAPI.DecodeInteger(bufptr: PByte; len: short): integer; |
555 |
begin |
556 |
Result := isc_portable_integer(bufptr,len); |
557 |
end; |
558 |
|
559 |
procedure TFB25ClientAPI.SQLEncodeDate(aDate: TDateTime; bufptr: PByte); |
560 |
var |
561 |
tm_date: TCTimeStructure; |
562 |
Yr, Mn, Dy: Word; |
563 |
begin |
564 |
DecodeDate(aDate, Yr, Mn, Dy); |
565 |
with tm_date do begin |
566 |
tm_sec := 0; |
567 |
tm_min := 0; |
568 |
tm_hour := 0; |
569 |
tm_mday := Dy; |
570 |
tm_mon := Mn - 1; |
571 |
tm_year := Yr - 1900; |
572 |
end; |
573 |
isc_encode_sql_date(@tm_date, PISC_DATE(bufptr)); |
574 |
end; |
575 |
|
576 |
function TFB25ClientAPI.SQLDecodeDate(bufptr: PByte): TDateTime; |
577 |
var |
578 |
tm_date: TCTimeStructure; |
579 |
begin |
580 |
isc_decode_sql_date(PISC_DATE(bufptr), @tm_date); |
581 |
try |
582 |
result := EncodeDate(Word(tm_date.tm_year + 1900), Word(tm_date.tm_mon + 1), |
583 |
Word(tm_date.tm_mday)); |
584 |
except |
585 |
on E: EConvertError do begin |
586 |
IBError(ibxeInvalidDataConversion, [nil]); |
587 |
end; |
588 |
end; |
589 |
end; |
590 |
|
591 |
procedure TFB25ClientAPI.SQLEncodeTime(aTime: TDateTime; bufptr: PByte); |
592 |
var |
593 |
tm_date: TCTimeStructure; |
594 |
Hr, Mt, S, Ms: Word; |
595 |
begin |
596 |
DecodeTime(aTime, Hr, Mt, S, Ms); |
597 |
with tm_date do begin |
598 |
tm_sec := S; |
599 |
tm_min := Mt; |
600 |
tm_hour := Hr; |
601 |
tm_mday := 0; |
602 |
tm_mon := 0; |
603 |
tm_year := 0; |
604 |
end; |
605 |
isc_encode_sql_time(@tm_date, PISC_TIME(bufptr)); |
606 |
if Ms > 0 then |
607 |
Inc(PISC_TIME(bufptr)^,Ms*10); |
608 |
end; |
609 |
|
610 |
function TFB25ClientAPI.SQLDecodeTime(bufptr: PByte): TDateTime; |
611 |
var |
612 |
tm_date: TCTimeStructure; |
613 |
msecs: Word; |
614 |
begin |
615 |
isc_decode_sql_time(PISC_TIME(bufptr), @tm_date); |
616 |
try |
617 |
msecs := (PISC_TIME(bufptr)^ mod 10000) div 10; |
618 |
result := EncodeTime(Word(tm_date.tm_hour), Word(tm_date.tm_min), |
619 |
Word(tm_date.tm_sec), msecs) |
620 |
except |
621 |
on E: EConvertError do begin |
622 |
IBError(ibxeInvalidDataConversion, [nil]); |
623 |
end; |
624 |
end; |
625 |
end; |
626 |
|
627 |
procedure TFB25ClientAPI.SQLEncodeDateTime(aDateTime: TDateTime; bufptr: PByte); |
628 |
var |
629 |
tm_date: TCTimeStructure; |
630 |
Yr, Mn, Dy, Hr, Mt, S, Ms: Word; |
631 |
begin |
632 |
DecodeDate(aDateTime, Yr, Mn, Dy); |
633 |
DecodeTime(aDateTime, Hr, Mt, S, Ms); |
634 |
with tm_date do begin |
635 |
tm_sec := S; |
636 |
tm_min := Mt; |
637 |
tm_hour := Hr; |
638 |
tm_mday := Dy; |
639 |
tm_mon := Mn - 1; |
640 |
tm_year := Yr - 1900; |
641 |
end; |
642 |
isc_encode_date(@tm_date, PISC_QUAD(bufptr)); |
643 |
if Ms > 0 then |
644 |
Inc(PISC_TIMESTAMP(bufptr)^.timestamp_time,Ms*10); |
645 |
end; |
646 |
|
647 |
function TFB25ClientAPI.SQLDecodeDateTime(bufptr: PByte): TDateTime; |
648 |
var |
649 |
tm_date: TCTimeStructure; |
650 |
msecs: Word; |
651 |
begin |
652 |
isc_decode_date(PISC_QUAD(bufptr), @tm_date); |
653 |
try |
654 |
result := EncodeDate(Word(tm_date.tm_year + 1900), Word(tm_date.tm_mon + 1), |
655 |
Word(tm_date.tm_mday)); |
656 |
msecs := (PISC_TIMESTAMP(bufptr)^.timestamp_time mod 10000) div 10; |
657 |
if result >= 0 then |
658 |
result := result + EncodeTime(Word(tm_date.tm_hour), Word(tm_date.tm_min), |
659 |
Word(tm_date.tm_sec), msecs) |
660 |
else |
661 |
result := result - EncodeTime(Word(tm_date.tm_hour), Word(tm_date.tm_min), |
662 |
Word(tm_date.tm_sec), msecs) |
663 |
except |
664 |
on E: EConvertError do begin |
665 |
IBError(ibxeInvalidDataConversion, [nil]); |
666 |
end; |
667 |
end; |
668 |
end; |
669 |
|
670 |
end. |
671 |
|
672 |
|