ViewVC Help
View File | Revision Log | Show Annotations | Download File | View Changeset | Root Listing
root/public/ibx/branches/journaling/fbintf/client/2.5/FB25ClientAPI.pas
Revision: 308
Committed: Sat Jul 18 10:26:30 2020 UTC (3 years, 9 months ago) by tony
Content type: text/x-pascal
Original Path: ibx/trunk/fbintf/client/2.5/FB25ClientAPI.pas
File size: 26762 byte(s)
Log Message:
Fixes Merged

File Contents

# User Rev Content
1 tony 45 (*
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 tony 56 {$IFDEF MSWINDOWS}
64     {$DEFINE WINDOWS}
65     {$ENDIF}
66 tony 45
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 tony 263 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 tony 45 {$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 tony 266 isc_version: Tisc_Version;
169 tony 308 isc_interprete: Tisc_interprete;
170 tony 45
171     public
172     {Helper Functions}
173 tony 56 function DecodeInteger(bufptr: PByte; len: short): integer; override;
174     procedure SQLEncodeDate(aDate: TDateTime; bufptr: PByte); override;
175     function SQLDecodeDate(bufptr: PByte): TDateTime; override;
176     procedure SQLEncodeTime(aTime: TDateTime; bufptr: PByte); override;
177     function SQLDecodeTime(bufptr: PByte): TDateTime; override;
178     procedure SQLEncodeDateTime(aDateTime: TDateTime; bufptr: PByte); override;
179     function SQLDecodeDateTime(bufptr: PByte): TDateTime; override;
180 tony 308 function FormatStatus(Status: TFBStatus): AnsiString; override;
181 tony 45 public
182     {IFirebirdAPI}
183    
184     {Database connections}
185     function AllocateDPB: IDPB;
186 tony 56 function OpenDatabase(DatabaseName: AnsiString; DPB: IDPB; RaiseExceptionOnConnectError: boolean=true): IAttachment;
187     function CreateDatabase(DatabaseName: AnsiString; DPB: IDPB; RaiseExceptionOnError: boolean=true): IAttachment; overload;
188     function CreateDatabase(sql: AnsiString; aSQLDialect: integer; RaiseExceptionOnError: boolean=true): IAttachment; overload;
189 tony 45
190     {Start Transaction against multiple databases}
191     function AllocateTPB: ITPB;
192     function StartTransaction(Attachments: array of IAttachment;
193     TPB: array of byte; DefaultCompletion: TTransactionCompletion): ITransaction; overload;
194     function StartTransaction(Attachments: array of IAttachment;
195     TPB: ITPB; DefaultCompletion: TTransactionCompletion): ITransaction; overload;
196    
197     {Service Manager}
198     function AllocateSPB: ISPB;
199     function HasServiceAPI: boolean;
200 tony 143 function GetServiceManager(ServerName: AnsiString; Protocol: TProtocol; SPB: ISPB): IServiceManager; overload;
201     function GetServiceManager(ServerName: AnsiString; Port: AnsiString; Protocol: TProtocol; SPB: ISPB): IServiceManager; overload;
202 tony 45
203     {Information}
204     function GetStatus: IStatus; override;
205     function HasRollbackRetaining: boolean;
206     function IsEmbeddedServer: boolean; override;
207 tony 308 function GetClientMajor: integer; override;
208     function GetClientMinor: integer; override;
209 tony 45
210     {Firebird 3 API}
211     function HasMasterIntf: boolean;
212     function GetIMaster: TObject;
213    
214     end;
215    
216     implementation
217    
218 tony 56 uses FBMessages,
219     {$IFDEF WINDOWS}Windows, {$ENDIF}
220     {$IFDEF FPC} Dynlibs, {$ENDIF}
221     FB25Attachment, FB25Transaction, FB25Services, FBParamBlock,
222 tony 45 IBUtils;
223    
224     { Stubs for 6.0 only functions }
225     function isc_rollback_retaining_stub(status_vector : PISC_STATUS;
226     tran_handle : PISC_TR_HANDLE):
227     ISC_STATUS; {$IFDEF WINDOWS} stdcall; {$ELSE} cdecl; {$ENDIF}
228     begin
229     Result := 0;
230     IBError(ibxeIB60feature, ['isc_rollback_retaining']); {do not localize}
231     end;
232    
233     function isc_service_attach_stub(status_vector : PISC_STATUS;
234     isc_arg2 : UShort;
235 tony 56 isc_arg3 : PAnsiChar;
236 tony 45 service_handle : PISC_SVC_HANDLE;
237     isc_arg5 : UShort;
238 tony 56 isc_arg6 : PAnsiChar):
239 tony 45 ISC_STATUS; {$IFDEF WINDOWS} stdcall; {$ELSE} cdecl; {$ENDIF}
240     begin
241     Result := 0;
242     IBError(ibxeIB60feature, ['isc_service_attach']); {do not localize}
243     end;
244    
245     function isc_service_detach_stub(status_vector : PISC_STATUS;
246     service_handle : PISC_SVC_HANDLE):
247     ISC_STATUS; {$IFDEF WINDOWS} stdcall; {$ELSE} cdecl; {$ENDIF}
248     begin
249     Result := 0;
250     IBError(ibxeIB60feature, ['isc_service_detach']); {do not localize}
251     end;
252    
253     function isc_service_query_stub(status_vector : PISC_STATUS;
254     service_handle : PISC_SVC_HANDLE;
255     recv_handle : PISC_SVC_HANDLE;
256     isc_arg4 : UShort;
257 tony 56 isc_arg5 : PAnsiChar;
258 tony 45 isc_arg6 : UShort;
259 tony 56 isc_arg7 : PAnsiChar;
260 tony 45 isc_arg8 : UShort;
261 tony 56 isc_arg9 : PAnsiChar):
262 tony 45 ISC_STATUS; {$IFDEF WINDOWS} stdcall; {$ELSE} cdecl; {$ENDIF}
263     begin
264     Result := 0;
265     IBError(ibxeIB60feature, ['isc_service_query']); {do not localize}
266     end;
267    
268     function isc_service_start_stub(status_vector : PISC_STATUS;
269     service_handle : PISC_SVC_HANDLE;
270     recv_handle : PISC_SVC_HANDLE;
271     isc_arg4 : UShort;
272 tony 56 isc_arg5 : PAnsiChar):
273 tony 45 ISC_STATUS; {$IFDEF WINDOWS} stdcall; {$ELSE} cdecl; {$ENDIF}
274     begin
275     Result := 0;
276     IBError(ibxeIB60feature, ['isc_service_start']); {do not localize}
277     end;
278    
279     procedure isc_encode_sql_date_stub(tm_date : PCTimeStructure;
280     ib_date : PISC_DATE);
281     {$IFDEF WINDOWS} stdcall; {$ELSE} cdecl; {$ENDIF}
282     begin
283     IBError(ibxeIB60feature, ['isc_encode_sql_date']); {do not localize}
284     end;
285    
286     procedure isc_encode_sql_time_stub(tm_date : PCTimeStructure;
287     ib_time : PISC_TIME);
288     {$IFDEF WINDOWS} stdcall; {$ELSE} cdecl; {$ENDIF}
289     begin
290     IBError(ibxeIB60feature, ['isc_encode_sql_time']); {do not localize}
291     end;
292    
293     procedure isc_encode_timestamp_stub(tm_date : PCTimeStructure;
294     ib_timestamp : PISC_TIMESTAMP);
295     {$IFDEF WINDOWS} stdcall; {$ELSE} cdecl; {$ENDIF}
296     begin
297     IBError(ibxeIB60feature, ['isc_encode_sql_timestamp']); {do not localize}
298     end;
299    
300     procedure isc_decode_sql_date_stub(ib_date : PISC_DATE;
301     tm_date : PCTimeStructure);
302     {$IFDEF WINDOWS} stdcall; {$ELSE} cdecl; {$ENDIF}
303     begin
304     IBError(ibxeIB60feature, ['isc_decode_sql_date']); {do not localize}
305     end;
306    
307     procedure isc_decode_sql_time_stub(ib_time : PISC_TIME;
308     tm_date : PCTimeStructure);
309     {$IFDEF WINDOWS} stdcall; {$ELSE} cdecl; {$ENDIF}
310     begin
311     IBError(ibxeIB60feature, ['isc_decode_sql_time']); {do not localize}
312     end;
313    
314     procedure isc_decode_timestamp_stub(ib_timestamp : PISC_TIMESTAMP;
315     tm_date : PCTimeStructure);
316     {$IFDEF WINDOWS} stdcall; {$ELSE} cdecl; {$ENDIF}
317     begin
318     IBError(ibxeIB60feature, ['isc_decode_timestamp']); {do not localize}
319     end;
320    
321     { TFB25Status }
322    
323     threadvar
324     FStatusVector: TStatusVector;
325    
326 tony 263 { TFB25ActivityReporter }
327    
328 tony 45 function TFB25Status.StatusVector: PStatusVector;
329     begin
330     Result := @FStatusVector;
331     end;
332    
333    
334     { TFB25ClientAPI }
335    
336     {$IFDEF UNIX}
337     function TFB25ClientAPI.GetFirebirdLibList: string;
338     begin
339     Result := 'libfbembed.so:libfbembed.so.2.5:libfbembed.so.2.1:libfbclient.so:libfbclient.so.2';
340     end;
341     {$ENDIF}
342    
343 tony 263 function TFB25ClientAPI.LoadInterface: boolean;
344 tony 45 begin
345 tony 263 Result := inherited LoadInterface;
346 tony 45 BLOB_get := GetProcAddr('BLOB_get'); {do not localize}
347     BLOB_put := GetProcAddr('BLOB_put'); {do not localize}
348     isc_wait_for_event := GetProcAddr('isc_wait_for_event'); {do not localize}
349     isc_vax_integer := GetProcAddr('isc_vax_integer'); {do not localize}
350     isc_portable_integer := GetProcAddr('isc_portable_integer'); {do not localize}
351     isc_blob_info := GetProcAddr('isc_blob_info'); {do not localize}
352     isc_blob_lookup_desc := GetProcAddr('isc_blob_lookup_desc'); {do not localize}
353     isc_open_blob2 := GetProcAddr('isc_open_blob2'); {do not localize}
354     isc_close_blob := GetProcAddr('isc_close_blob'); {do not localize}
355     isc_get_segment := GetProcAddr('isc_get_segment'); {do not localize}
356     isc_put_segment := GetProcAddr('isc_put_segment'); {do not localize}
357     isc_create_blob2 := GetProcAddr('isc_create_blob2'); {do not localize}
358     isc_cancel_blob := GetProcAddr('isc_cancel_blob'); {do not localize}
359     isc_decode_date := GetProcAddr('isc_decode_date'); {do not localize}
360     isc_encode_date := GetProcAddr('isc_encode_date'); {do not localize}
361     isc_dsql_free_statement := GetProcAddr('isc_dsql_free_statement'); {do not localize}
362     isc_dsql_execute2 := GetProcAddr('isc_dsql_execute2'); {do not localize}
363     isc_dsql_execute := GetProcAddr('isc_dsql_execute'); {do not localize}
364     isc_dsql_set_cursor_name := GetProcAddr('isc_dsql_set_cursor_name'); {do not localize}
365     isc_dsql_fetch := GetProcAddr('isc_dsql_fetch'); {do not localize}
366     isc_dsql_sql_info := GetProcAddr('isc_dsql_sql_info'); {do not localize}
367     isc_dsql_alloc_statement2 := GetProcAddr('isc_dsql_alloc_statement2'); {do not localize}
368     isc_dsql_prepare := GetProcAddr('isc_dsql_prepare'); {do not localize}
369     isc_dsql_describe_bind := GetProcAddr('isc_dsql_describe_bind'); {do not localize}
370     isc_dsql_describe := GetProcAddr('isc_dsql_describe'); {do not localize}
371     isc_dsql_execute_immediate := GetProcAddr('isc_dsql_execute_immediate'); {do not localize}
372     isc_drop_database := GetProcAddr('isc_drop_database'); {do not localize}
373     isc_detach_database := GetProcAddr('isc_detach_database'); {do not localize}
374     isc_attach_database := GetProcAddr('isc_attach_database'); {do not localize}
375     isc_database_info := GetProcAddr('isc_database_info'); {do not localize}
376     isc_start_transaction := GetProcAddr('isc_start_transaction'); {do not localize}
377     isc_start_multiple := GetProcAddr('isc_start_multiple'); {do not localize}
378     isc_commit_transaction := GetProcAddr('isc_commit_transaction'); {do not localize}
379     isc_commit_retaining := GetProcAddr('isc_commit_retaining'); {do not localize}
380     isc_rollback_transaction := GetProcAddr('isc_rollback_transaction'); {do not localize}
381     isc_cancel_events := GetProcAddr('isc_cancel_events'); {do not localize}
382     isc_que_events := GetProcAddr('isc_que_events'); {do not localize}
383     isc_add_user := GetProcAddr('isc_add_user'); {do not localize}
384     isc_delete_user := GetProcAddr('isc_delete_user'); {do not localize}
385     isc_modify_user := GetProcAddr('isc_modify_user'); {do not localize}
386     isc_array_lookup_bounds := GetProcAddr('isc_array_lookup_bounds'); {do not localize}
387     isc_array_get_slice := GetProcAddr('isc_array_get_slice'); {do not localize}
388     isc_array_put_slice := GetProcAddr('isc_array_put_slice'); {do not localize}
389     isc_prepare_transaction := GetProcAddr('isc_prepare_transaction'); {do not localize}
390 tony 266 isc_version := GetProcAddr('isc_version'); {do not localize}
391 tony 308 isc_interprete := GetProcAddr('isc_interprete'); {do not localize}
392 tony 45
393     FIBServiceAPIPresent := true;
394 tony 263 isc_rollback_retaining := GetProcAddress(FFBLibrary.IBLibrary, 'isc_rollback_retaining'); {do not localize}
395 tony 45 if Assigned(isc_rollback_retaining) then
396     begin
397     isc_service_attach := GetProcAddr('isc_service_attach'); {do not localize}
398     isc_service_detach := GetProcAddr('isc_service_detach'); {do not localize}
399     isc_service_query := GetProcAddr('isc_service_query'); {do not localize}
400     isc_service_start := GetProcAddr('isc_service_start'); {do not localize}
401     isc_decode_sql_date := GetProcAddr('isc_decode_sql_date'); {do not localize}
402     isc_decode_sql_time := GetProcAddr('isc_decode_sql_time'); {do not localize}
403     isc_decode_timestamp := GetProcAddr('isc_decode_timestamp'); {do not localize}
404     isc_encode_sql_date := GetProcAddr('isc_encode_sql_date'); {do not localize}
405     isc_encode_sql_time := GetProcAddr('isc_encode_sql_time'); {do not localize}
406     isc_encode_timestamp := GetProcAddr('isc_encode_timestamp'); {do not localize}
407     end else
408     begin
409     FIBServiceAPIPresent := false;
410     isc_rollback_retaining := @isc_rollback_retaining_stub;
411     isc_service_attach := @isc_service_attach_stub;
412     isc_service_detach := @isc_service_detach_stub;
413     isc_service_query := @isc_service_query_stub;
414     isc_service_start := @isc_service_start_stub;
415     isc_decode_sql_date := @isc_decode_sql_date_stub;
416     isc_decode_sql_time := @isc_decode_sql_time_stub;
417     isc_decode_timestamp := @isc_decode_timestamp_stub;
418     isc_encode_sql_date := @isc_encode_sql_date_stub;
419     isc_encode_sql_time := @isc_encode_sql_time_stub;
420     isc_encode_timestamp := @isc_encode_timestamp_stub;
421     end;
422 tony 263 Result := Result and assigned(isc_attach_database);
423 tony 45 end;
424    
425 tony 263 function TFB25ClientAPI.GetAPI: IFirebirdAPI;
426 tony 45 begin
427 tony 263 Result := self;
428     end;
429    
430     constructor TFB25ClientAPI.Create(aFBLibrary: TFBLibrary);
431     begin
432     inherited Create(aFBLibrary);
433 tony 45 FStatus := TFB25Status.Create(self);
434     FStatusIntf := FStatus;
435     end;
436    
437     destructor TFB25ClientAPI.Destroy;
438     begin
439     FStatusIntf := nil;
440     inherited Destroy;
441     end;
442    
443    
444     function TFB25ClientAPI.StatusVector: PISC_STATUS;
445     begin
446     Result := PISC_STATUS(FStatus.StatusVector);
447     end;
448    
449     function TFB25ClientAPI.GetStatus: IStatus;
450     begin
451     Result := FStatus;
452     end;
453    
454     function TFB25ClientAPI.AllocateDPB: IDPB;
455     begin
456 tony 263 Result := TDPB.Create(self);
457 tony 45 end;
458    
459 tony 56 function TFB25ClientAPI.OpenDatabase(DatabaseName: AnsiString; DPB: IDPB;
460 tony 45 RaiseExceptionOnConnectError: boolean): IAttachment;
461     begin
462 tony 263 Result := TFB25Attachment.Create(self,DatabaseName,DPB,RaiseExceptionOnConnectError);
463 tony 45 if not Result.IsConnected then
464     Result := nil;
465     end;
466    
467 tony 56 function TFB25ClientAPI.CreateDatabase(DatabaseName: AnsiString; DPB: IDPB;
468 tony 45 RaiseExceptionOnError: boolean): IAttachment;
469     begin
470 tony 263 Result := TFB25Attachment.CreateDatabase(self,DatabaseName, DPB, RaiseExceptionOnError );
471 tony 45 if (Result <> nil) and not Result.IsConnected then
472     Result := nil;
473     end;
474    
475 tony 56 function TFB25ClientAPI.CreateDatabase(sql: AnsiString; aSQLDialect: integer;
476 tony 47 RaiseExceptionOnError: boolean): IAttachment;
477     begin
478 tony 263 Result := TFB25Attachment.CreateDatabase(self,sql,aSQLDialect, RaiseExceptionOnError );
479 tony 47 if (Result <> nil) and not Result.IsConnected then
480     Result := nil;
481     end;
482    
483 tony 45 function TFB25ClientAPI.AllocateSPB: ISPB;
484     begin
485 tony 263 Result := TSPB.Create(self);
486 tony 45 end;
487    
488     function TFB25ClientAPI.AllocateTPB: ITPB;
489     begin
490 tony 263 Result := TTPB.Create(self);
491 tony 45 end;
492    
493 tony 56 function TFB25ClientAPI.GetServiceManager(ServerName: AnsiString;
494 tony 45 Protocol: TProtocol; SPB: ISPB): IServiceManager;
495     begin
496     if HasServiceAPI then
497 tony 263 Result := TFB25ServiceManager.Create(self,ServerName,Protocol,SPB)
498 tony 45 else
499     Result := nil;
500     end;
501    
502 tony 143 function TFB25ClientAPI.GetServiceManager(ServerName: AnsiString;
503     Port: AnsiString; Protocol: TProtocol; SPB: ISPB): IServiceManager;
504     begin
505     if HasServiceAPI then
506 tony 263 Result := TFB25ServiceManager.Create(self,ServerName,Protocol,SPB,Port)
507 tony 143 else
508     Result := nil;
509     end;
510    
511 tony 45 function TFB25ClientAPI.StartTransaction(Attachments: array of IAttachment;
512     TPB: array of byte; DefaultCompletion: TTransactionCompletion): ITransaction;
513     begin
514 tony 263 Result := TFB25Transaction.Create(self,Attachments,TPB,DefaultCompletion);
515 tony 45 end;
516    
517     function TFB25ClientAPI.StartTransaction(Attachments: array of IAttachment;
518     TPB: ITPB; DefaultCompletion: TTransactionCompletion): ITransaction;
519     begin
520 tony 263 Result := TFB25Transaction.Create(self,Attachments,TPB,DefaultCompletion);
521 tony 45 end;
522    
523     function TFB25ClientAPI.HasServiceAPI: boolean;
524     begin
525     Result := IBServiceAPIPresent;
526     end;
527    
528     function TFB25ClientAPI.HasRollbackRetaining: boolean;
529     begin
530     Result := assigned(isc_rollback_retaining);
531     end;
532    
533     function TFB25ClientAPI.IsEmbeddedServer: boolean;
534     begin
535     Result := false;
536     {$IFDEF UNIX}
537 tony 263 Result := Pos('libfbembed',FFBLibrary.GetLibraryName) = 1;
538 tony 45 {$ENDIF}
539     {$IFDEF WINDOWS}
540 tony 263 Result := CompareText(FFBLibrary.GetLibraryName,FIREBIRD_EMBEDDED) = 0;
541 tony 45 {$ENDIF}
542     end;
543    
544 tony 308 function TFB25ClientAPI.GetClientMajor: integer;
545     begin
546     Result := 2;
547     end;
548    
549     function TFB25ClientAPI.GetClientMinor: integer;
550     begin
551     Result := 5;
552     end;
553    
554 tony 45 function TFB25ClientAPI.HasMasterIntf: boolean;
555     begin
556     Result := false;
557     end;
558    
559     function TFB25ClientAPI.GetIMaster: TObject;
560     begin
561     Result := nil;
562     end;
563    
564 tony 56 function TFB25ClientAPI.DecodeInteger(bufptr: PByte; len: short): integer;
565 tony 45 begin
566     Result := isc_portable_integer(bufptr,len);
567     end;
568    
569 tony 56 procedure TFB25ClientAPI.SQLEncodeDate(aDate: TDateTime; bufptr: PByte);
570 tony 45 var
571     tm_date: TCTimeStructure;
572     Yr, Mn, Dy: Word;
573     begin
574     DecodeDate(aDate, Yr, Mn, Dy);
575     with tm_date do begin
576     tm_sec := 0;
577     tm_min := 0;
578     tm_hour := 0;
579     tm_mday := Dy;
580     tm_mon := Mn - 1;
581     tm_year := Yr - 1900;
582     end;
583     isc_encode_sql_date(@tm_date, PISC_DATE(bufptr));
584     end;
585    
586 tony 56 function TFB25ClientAPI.SQLDecodeDate(bufptr: PByte): TDateTime;
587 tony 45 var
588     tm_date: TCTimeStructure;
589     begin
590     isc_decode_sql_date(PISC_DATE(bufptr), @tm_date);
591     try
592     result := EncodeDate(Word(tm_date.tm_year + 1900), Word(tm_date.tm_mon + 1),
593     Word(tm_date.tm_mday));
594     except
595     on E: EConvertError do begin
596     IBError(ibxeInvalidDataConversion, [nil]);
597     end;
598     end;
599     end;
600    
601 tony 56 procedure TFB25ClientAPI.SQLEncodeTime(aTime: TDateTime; bufptr: PByte);
602 tony 45 var
603     tm_date: TCTimeStructure;
604     Hr, Mt, S, Ms: Word;
605     begin
606     DecodeTime(aTime, Hr, Mt, S, Ms);
607     with tm_date do begin
608     tm_sec := S;
609     tm_min := Mt;
610     tm_hour := Hr;
611     tm_mday := 0;
612     tm_mon := 0;
613     tm_year := 0;
614     end;
615 tony 263 isc_encode_sql_time(@tm_date, PISC_TIME(bufptr));
616 tony 45 if Ms > 0 then
617     Inc(PISC_TIME(bufptr)^,Ms*10);
618     end;
619    
620 tony 56 function TFB25ClientAPI.SQLDecodeTime(bufptr: PByte): TDateTime;
621 tony 45 var
622     tm_date: TCTimeStructure;
623     msecs: Word;
624     begin
625     isc_decode_sql_time(PISC_TIME(bufptr), @tm_date);
626     try
627     msecs := (PISC_TIME(bufptr)^ mod 10000) div 10;
628     result := EncodeTime(Word(tm_date.tm_hour), Word(tm_date.tm_min),
629     Word(tm_date.tm_sec), msecs)
630     except
631     on E: EConvertError do begin
632     IBError(ibxeInvalidDataConversion, [nil]);
633     end;
634     end;
635     end;
636    
637 tony 56 procedure TFB25ClientAPI.SQLEncodeDateTime(aDateTime: TDateTime; bufptr: PByte);
638 tony 45 var
639     tm_date: TCTimeStructure;
640     Yr, Mn, Dy, Hr, Mt, S, Ms: Word;
641     begin
642     DecodeDate(aDateTime, Yr, Mn, Dy);
643     DecodeTime(aDateTime, Hr, Mt, S, Ms);
644     with tm_date do begin
645     tm_sec := S;
646     tm_min := Mt;
647     tm_hour := Hr;
648     tm_mday := Dy;
649     tm_mon := Mn - 1;
650     tm_year := Yr - 1900;
651     end;
652     isc_encode_date(@tm_date, PISC_QUAD(bufptr));
653     if Ms > 0 then
654     Inc(PISC_TIMESTAMP(bufptr)^.timestamp_time,Ms*10);
655     end;
656    
657 tony 56 function TFB25ClientAPI.SQLDecodeDateTime(bufptr: PByte): TDateTime;
658 tony 45 var
659     tm_date: TCTimeStructure;
660     msecs: Word;
661     begin
662     isc_decode_date(PISC_QUAD(bufptr), @tm_date);
663     try
664     result := EncodeDate(Word(tm_date.tm_year + 1900), Word(tm_date.tm_mon + 1),
665     Word(tm_date.tm_mday));
666     msecs := (PISC_TIMESTAMP(bufptr)^.timestamp_time mod 10000) div 10;
667     if result >= 0 then
668     result := result + EncodeTime(Word(tm_date.tm_hour), Word(tm_date.tm_min),
669     Word(tm_date.tm_sec), msecs)
670     else
671     result := result - EncodeTime(Word(tm_date.tm_hour), Word(tm_date.tm_min),
672     Word(tm_date.tm_sec), msecs)
673     except
674     on E: EConvertError do begin
675     IBError(ibxeInvalidDataConversion, [nil]);
676     end;
677     end;
678     end;
679    
680 tony 308 function TFB25ClientAPI.FormatStatus(Status: TFBStatus): AnsiString;
681     var psb: PStatusVector;
682     local_buffer: array[0..IBHugeLocalBufferLength - 1] of AnsiChar;
683     begin
684     psb := Status.StatusVector;
685     Result := '';
686     while isc_interprete(@local_buffer,@psb) > 0 do
687     begin
688     if (Result <> '') and (Result[Length(Result)] <> LF) then
689     Result := Result + LineEnding + '-';
690     Result := Result + strpas(local_buffer);
691     end;
692     end;
693    
694 tony 45 end.
695    
696 tony 56