ViewVC Help
View File | Revision Log | Show Annotations | Download File | View Changeset | Root Listing
root/public/ibx/trunk/fbintf/client/FBAttachment.pas
Revision: 70
Committed: Thu Oct 26 12:59:51 2017 UTC (6 years, 5 months ago) by tony
Content type: text/x-pascal
File size: 25830 byte(s)
Log Message:
FBAttachment: Avoid string reference count error when processing an Ansistring
    parameter in an array of const passed to IAttachment.OpenCursor, etc.

FBAttachment: Allow for WideString and UnicodeString parameters in an array
    of const passed to IAttachment.OpenCursor, etc.

File Contents

# Content
1 (*
2 * Firebird Interface (fbintf). The fbintf components provide a set of
3 * Pascal language bindings for the Firebird API.
4 *
5 * The contents of this file are subject to the Initial Developer's
6 * Public License Version 1.0 (the "License"); you may not use this
7 * file except in compliance with the License. You may obtain a copy
8 * of the License here:
9 *
10 * http://www.firebirdsql.org/index.php?op=doc&id=idpl
11 *
12 * Software distributed under the License is distributed on an "AS
13 * IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or
14 * implied. See the License for the specific language governing rights
15 * and limitations under the License.
16 *
17 * The Initial Developer of the Original Code is Tony Whyman.
18 *
19 * The Original Code is (C) 2016 Tony Whyman, MWA Software
20 * (http://www.mwasoftware.co.uk).
21 *
22 * All Rights Reserved.
23 *
24 * Contributor(s): ______________________________________.
25 *
26 *)
27 unit FBAttachment;
28 {$IFDEF MSWINDOWS}
29 {$DEFINE WINDOWS}
30 {$ENDIF}
31
32 {$IFDEF FPC}
33 {$mode delphi}
34 {$interfaces COM}
35 {$ENDIF}
36
37 interface
38
39 uses
40 Classes, SysUtils, {$IFDEF WINDOWS} windows, {$ENDIF} IB, FBParamBlock, FBActivityMonitor;
41
42 type
43 TCharsetMap = record
44 CharsetID: integer;
45 CharSetName: AnsiString;
46 CharSetWidth: integer;
47 CodePage: TSystemCodePage;
48 AllowReverseLookup: boolean; {used to ensure that lookup of CP_UTF* does not return UNICODE_FSS}
49 end;
50
51 { TFBAttachment }
52
53 TFBAttachment = class(TActivityHandler)
54 private
55 FDPB: IDPB;
56 FFirebirdAPI: IFirebirdAPI;
57 FUserCharSetMap: array of TCharSetMap;
58 protected
59 FDatabaseName: AnsiString;
60 FRaiseExceptionOnConnectError: boolean;
61 FSQLDialect: integer;
62 FHasDefaultCharSet: boolean;
63 FCharSetID: integer;
64 FCodePage: TSystemCodePage;
65 constructor Create(DatabaseName: AnsiString; DPB: IDPB;
66 RaiseExceptionOnConnectError: boolean);
67 procedure CheckHandle; virtual; abstract;
68 function GenerateCreateDatabaseSQL(DatabaseName: AnsiString; aDPB: IDPB): AnsiString;
69 procedure EndAllTransactions;
70 procedure SetParameters(SQLParams: ISQLParams; params: array of const);
71 public
72 destructor Destroy; override;
73 function getDPB: IDPB;
74 function AllocateBPB: IBPB;
75 function StartTransaction(TPB: array of byte; DefaultCompletion: TTransactionCompletion): ITransaction; overload; virtual; abstract;
76 function StartTransaction(TPB: ITPB; DefaultCompletion: TTransactionCompletion): ITransaction; overload; virtual; abstract;
77 procedure Disconnect(Force: boolean=false); virtual; abstract;
78 procedure ExecImmediate(transaction: ITransaction; sql: AnsiString; aSQLDialect: integer); overload; virtual; abstract;
79 procedure ExecImmediate(TPB: array of byte; sql: AnsiString; aSQLDialect: integer); overload;
80 procedure ExecImmediate(transaction: ITransaction; sql: AnsiString); overload;
81 procedure ExecImmediate(TPB: array of byte; sql: AnsiString); overload;
82 function ExecuteSQL(TPB: array of byte; sql: AnsiString; SQLDialect: integer; params: array of const): IResults; overload;
83 function ExecuteSQL(transaction: ITransaction; sql: AnsiString; SQLDialect: integer; params: array of const): IResults; overload;
84 function ExecuteSQL(TPB: array of byte; sql: AnsiString; params: array of const): IResults; overload;
85 function ExecuteSQL(transaction: ITransaction; sql: AnsiString; params: array of const): IResults; overload;
86 function OpenCursor(transaction: ITransaction; sql: AnsiString; aSQLDialect: integer): IResultSet; overload;
87 function OpenCursor(transaction: ITransaction; sql: AnsiString; aSQLDialect: integer;
88 params: array of const): IResultSet; overload;
89 function OpenCursor(transaction: ITransaction; sql: AnsiString): IResultSet; overload;
90 function OpenCursor(transaction: ITransaction; sql: AnsiString;
91 params: array of const): IResultSet; overload;
92 function OpenCursorAtStart(transaction: ITransaction; sql: AnsiString; aSQLDialect: integer): IResultSet; overload;
93 function OpenCursorAtStart(transaction: ITransaction; sql: AnsiString; aSQLDialect: integer;
94 params: array of const): IResultSet; overload;
95 function OpenCursorAtStart(transaction: ITransaction; sql: AnsiString): IResultSet; overload;
96 function OpenCursorAtStart(transaction: ITransaction; sql: AnsiString;
97 params: array of const): IResultSet; overload;
98 function OpenCursorAtStart(sql: AnsiString): IResultSet; overload;
99 function OpenCursorAtStart(sql: AnsiString;
100 params: array of const): IResultSet; overload;
101 function Prepare(transaction: ITransaction; sql: AnsiString; aSQLDialect: integer): IStatement; overload; virtual; abstract;
102 function Prepare(transaction: ITransaction; sql: AnsiString): IStatement; overload;
103 function PrepareWithNamedParameters(transaction: ITransaction; sql: AnsiString;
104 aSQLDialect: integer; GenerateParamNames: boolean=false): IStatement; overload; virtual; abstract;
105 function PrepareWithNamedParameters(transaction: ITransaction; sql: AnsiString;
106 GenerateParamNames: boolean=false): IStatement; overload;
107 function GetEventHandler(Events: TStrings): IEvents; overload; virtual; abstract;
108 function GetEventHandler(Event: AnsiString): IEvents; overload;
109
110 function GetSQLDialect: integer;
111 function OpenBlob(transaction: ITransaction; BlobMetaData: IBlobMetaData; BlobID: TISC_QUAD; BPB: IBPB=nil): IBlob; overload; virtual; abstract;
112 function OpenBlob(transaction: ITransaction; Field: ISQLData; BPB: IBPB=nil): IBlob; overload;
113 property SQLDialect: integer read FSQLDialect;
114 property DPB: IDPB read FDPB;
115 public
116 {Character Sets}
117 function GetCharsetName(CharSetID: integer): AnsiString;
118 function CharSetID2CodePage(CharSetID: integer; var CodePage: TSystemCodePage): boolean;
119 function CodePage2CharSetID(CodePage: TSystemCodePage; var CharSetID: integer): boolean;
120 function CharSetName2CharSetID(CharSetName: AnsiString; var CharSetID: integer): boolean;
121 function CharSetWidth(CharSetID: integer; var Width: integer): boolean;
122 procedure RegisterCharSet(CharSetName: AnsiString; CodePage: TSystemCodePage;
123 AllowReverseLookup:boolean; out CharSetID: integer);
124 property HasDefaultCharSet: boolean read FHasDefaultCharSet;
125 property CharSetID: integer read FCharSetID;
126 property CodePage: TSystemCodePage read FCodePage;
127 end;
128
129 implementation
130
131 uses FBMessages, FBTransaction;
132
133 const
134 CharSetMap: array [0..69] of TCharsetMap = (
135 (CharsetID: 0; CharSetName: 'NONE'; CharSetWidth: 1; CodePage: CP_ACP; AllowReverseLookup: true),
136 (CharsetID: 1; CharSetName: 'OCTETS'; CharSetWidth: 1; CodePage: CP_NONE; AllowReverseLookup: true),
137 (CharsetID: 2; CharSetName: 'ASCII'; CharSetWidth: 1; CodePage: CP_ASCII; AllowReverseLookup: true),
138 (CharsetID: 3; CharSetName: 'UNICODE_FSS'; CharSetWidth: 3; CodePage: CP_UTF8; AllowReverseLookup: false),
139 (CharsetID: 4; CharSetName: 'UTF8'; CharSetWidth: 4; CodePage: CP_UTF8; AllowReverseLookup: true),
140 (CharsetID: 5; CharSetName: 'SJIS_0208'; CharSetWidth: 2; CodePage: 20932; AllowReverseLookup: true),
141 (CharsetID: 6; CharSetName: 'EUCJ_0208'; CharSetWidth: 2; CodePage: 20932; AllowReverseLookup: true),
142 (CharsetID: 7; CharSetName: 'Unknown'; CharSetWidth: 0; CodePage: CP_NONE; AllowReverseLookup: true),
143 (CharsetID: 8; CharSetName: 'Unknown'; CharSetWidth: 0; CodePage: CP_NONE; AllowReverseLookup: true),
144 (CharsetID: 9; CharSetName: 'DOS737'; CharSetWidth: 1; CodePage: 737; AllowReverseLookup: true),
145 (CharsetID: 10; CharSetName: 'DOS437'; CharSetWidth: 1; CodePage: 437; AllowReverseLookup: true),
146 (CharsetID: 11; CharSetName: 'DOS850'; CharSetWidth: 1; CodePage: 850; AllowReverseLookup: true),
147 (CharsetID: 12; CharSetName: 'DOS865'; CharSetWidth: 1; CodePage: 865; AllowReverseLookup: true),
148 (CharsetID: 13; CharSetName: 'DOS860'; CharSetWidth: 1; CodePage: 860; AllowReverseLookup: true),
149 (CharsetID: 14; CharSetName: 'DOS863'; CharSetWidth: 1; CodePage: 863; AllowReverseLookup: true),
150 (CharsetID: 15; CharSetName: 'DOS775'; CharSetWidth: 1; CodePage: 775; AllowReverseLookup: true),
151 (CharsetID: 16; CharSetName: 'DOS858'; CharSetWidth: 1; CodePage: 858; AllowReverseLookup: true),
152 (CharsetID: 17; CharSetName: 'DOS862'; CharSetWidth: 1; CodePage: 862; AllowReverseLookup: true),
153 (CharsetID: 18; CharSetName: 'DOS864'; CharSetWidth: 1; CodePage: 864; AllowReverseLookup: true),
154 (CharsetID: 19; CharSetName: 'NEXT'; CharSetWidth: 1; CodePage: CP_NONE; AllowReverseLookup: true),
155 (CharsetID: 20; CharSetName: 'Unknown'; CharSetWidth: 0; CodePage: CP_NONE; AllowReverseLookup: true),
156 (CharsetID: 21; CharSetName: 'ISO8859_1'; CharSetWidth: 1; CodePage: 28591; AllowReverseLookup: true),
157 (CharsetID: 22; CharSetName: 'ISO8859_2'; CharSetWidth: 1; CodePage: 28592; AllowReverseLookup: true),
158 (CharsetID: 23; CharSetName: 'ISO8859_3'; CharSetWidth: 1; CodePage: 28593; AllowReverseLookup: true),
159 (CharsetID: 24; CharSetName: 'Unknown'; CharSetWidth: 0; CodePage: CP_NONE; AllowReverseLookup: false),
160 (CharsetID: 25; CharSetName: 'Unknown'; CharSetWidth: 0; CodePage: CP_NONE; AllowReverseLookup: false),
161 (CharsetID: 26; CharSetName: 'Unknown'; CharSetWidth: 0; CodePage: CP_NONE; AllowReverseLookup: false),
162 (CharsetID: 27; CharSetName: 'Unknown'; CharSetWidth: 0; CodePage: CP_NONE; AllowReverseLookup: false),
163 (CharsetID: 28; CharSetName: 'Unknown'; CharSetWidth: 0; CodePage: CP_NONE; AllowReverseLookup: false),
164 (CharsetID: 29; CharSetName: 'Unknown'; CharSetWidth: 0; CodePage: CP_NONE; AllowReverseLookup: false),
165 (CharsetID: 30; CharSetName: 'Unknown'; CharSetWidth: 0; CodePage: CP_NONE; AllowReverseLookup: false),
166 (CharsetID: 31; CharSetName: 'Unknown'; CharSetWidth: 0; CodePage: CP_NONE; AllowReverseLookup: false),
167 (CharsetID: 32; CharSetName: 'Unknown'; CharSetWidth: 0; CodePage: CP_NONE; AllowReverseLookup: false),
168 (CharsetID: 33; CharSetName: 'Unknown'; CharSetWidth: 0; CodePage: CP_NONE; AllowReverseLookup: false),
169 (CharsetID: 34; CharSetName: 'ISO8859_4'; CharSetWidth: 1; CodePage: 28594; AllowReverseLookup: true),
170 (CharsetID: 35; CharSetName: 'ISO8859_5'; CharSetWidth: 1; CodePage: 28595; AllowReverseLookup: true),
171 (CharsetID: 36; CharSetName: 'ISO8859_6'; CharSetWidth: 1; CodePage: 28596; AllowReverseLookup: true),
172 (CharsetID: 37; CharSetName: 'ISO8859_7'; CharSetWidth: 1; CodePage: 28597; AllowReverseLookup: true),
173 (CharsetID: 38; CharSetName: 'ISO8859_8'; CharSetWidth: 1; CodePage: 28598; AllowReverseLookup: true),
174 (CharsetID: 39; CharSetName: 'ISO8859_9'; CharSetWidth: 1; CodePage: 28599; AllowReverseLookup: true),
175 (CharsetID: 40; CharSetName: 'ISO8859_13'; CharSetWidth: 1; CodePage: 28603; AllowReverseLookup: true),
176 (CharsetID: 41; CharSetName: 'Unknown'; CharSetWidth: 0; CodePage: CP_NONE; AllowReverseLookup: false),
177 (CharsetID: 42; CharSetName: 'Unknown'; CharSetWidth: 0; CodePage: CP_NONE; AllowReverseLookup: false),
178 (CharsetID: 43; CharSetName: 'Unknown'; CharSetWidth: 0; CodePage: CP_NONE; AllowReverseLookup: false),
179 (CharsetID: 44; CharSetName: 'KSC_5601'; CharSetWidth: 2; CodePage: 949; AllowReverseLookup: true),
180 (CharsetID: 45; CharSetName: 'DOS852'; CharSetWidth: 1; CodePage: 852; AllowReverseLookup: true),
181 (CharsetID: 46; CharSetName: 'DOS857'; CharSetWidth: 1; CodePage: 857; AllowReverseLookup: true),
182 (CharsetID: 47; CharSetName: 'DOS861'; CharSetWidth: 1; CodePage: 861; AllowReverseLookup: true),
183 (CharsetID: 48; CharSetName: 'DOS866'; CharSetWidth: 1; CodePage: 866; AllowReverseLookup: true),
184 (CharsetID: 49; CharSetName: 'DOS869'; CharSetWidth: 1; CodePage: 869; AllowReverseLookup: true),
185 (CharsetID: 50; CharSetName: 'CYRL'; CharSetWidth: 1; CodePage: 1251; AllowReverseLookup: true),
186 (CharsetID: 51; CharSetName: 'WIN1250'; CharSetWidth: 1; CodePage: 1250; AllowReverseLookup: true),
187 (CharsetID: 52; CharSetName: 'WIN1251'; CharSetWidth: 1; CodePage: 1251; AllowReverseLookup: true),
188 (CharsetID: 53; CharSetName: 'WIN1252'; CharSetWidth: 1; CodePage: 1252; AllowReverseLookup: true),
189 (CharsetID: 54; CharSetName: 'WIN1253'; CharSetWidth: 1; CodePage: 1253; AllowReverseLookup: true),
190 (CharsetID: 55; CharSetName: 'WIN1254'; CharSetWidth: 1; CodePage: 1254; AllowReverseLookup: true),
191 (CharsetID: 56; CharSetName: 'BIG_5'; CharSetWidth: 2; CodePage: 950; AllowReverseLookup: true),
192 (CharsetID: 57; CharSetName: 'GB_2312'; CharSetWidth: 2; CodePage: 936; AllowReverseLookup: true),
193 (CharsetID: 58; CharSetName: 'WIN1255'; CharSetWidth: 1; CodePage: 1255; AllowReverseLookup: true),
194 (CharsetID: 59; CharSetName: 'WIN1256'; CharSetWidth: 1; CodePage: 1256; AllowReverseLookup: true),
195 (CharsetID: 60; CharSetName: 'WIN1257'; CharSetWidth: 1; CodePage: 1257; AllowReverseLookup: true),
196 (CharsetID: 61; CharSetName: 'Unknown'; CharSetWidth: 0; CodePage: CP_NONE; AllowReverseLookup: false),
197 (CharsetID: 62; CharSetName: 'Unknown'; CharSetWidth: 0; CodePage: CP_NONE; AllowReverseLookup: false),
198 (CharsetID: 63; CharSetName: 'KOI8R'; CharSetWidth: 1; CodePage: 20866; AllowReverseLookup: true),
199 (CharsetID: 64; CharSetName: 'KOI8U'; CharSetWidth: 1; CodePage: 21866; AllowReverseLookup: true),
200 (CharsetID: 65; CharSetName: 'WIN1258'; CharSetWidth: 1; CodePage: 1258; AllowReverseLookup: true),
201 (CharsetID: 66; CharSetName: 'TIS620'; CharSetWidth: 1; CodePage: 874; AllowReverseLookup: true),
202 (CharsetID: 67; CharSetName: 'GBK'; CharSetWidth: 2; CodePage: 936; AllowReverseLookup: true),
203 (CharsetID: 68; CharSetName: 'CP943C'; CharSetWidth: 2; CodePage: 943; AllowReverseLookup: true),
204 (CharsetID: 69; CharSetName: 'GB18030'; CharSetWidth: 4; CodePage: 54936; AllowReverseLookup: true)
205 );
206
207
208
209
210 { TFBAttachment }
211
212 constructor TFBAttachment.Create(DatabaseName: AnsiString; DPB: IDPB;
213 RaiseExceptionOnConnectError: boolean);
214 begin
215 inherited Create;
216 FFirebirdAPI := FirebirdAPI; {Keep reference to interface}
217 FSQLDialect := 3;
218 FDatabaseName := DatabaseName;
219 FDPB := DPB;
220 SetLength(FUserCharSetMap,0);
221 FRaiseExceptionOnConnectError := RaiseExceptionOnConnectError;
222 end;
223
224 function TFBAttachment.GenerateCreateDatabaseSQL(DatabaseName: AnsiString; aDPB: IDPB): AnsiString;
225 var CreateParams: AnsiString;
226 DPBItem: IDPBItem;
227 begin
228 CreateParams := '';
229
230 if aDPB <> nil then
231 begin
232 DPBItem := aDPB.Find(isc_dpb_user_name);
233 if DPBItem <> nil then
234 CreateParams := CreateParams + ' USER ''' + DPBItem.AsString + '''';
235
236 DPBItem := aDPB.Find(isc_dpb_password);
237 if DPBItem <> nil then
238 CreateParams := CreateParams + ' Password ''' + DPBItem.AsString + '''';
239
240 DPBItem := aDPB.Find(isc_dpb_page_size);
241 if DPBItem <> nil then
242 CreateParams := CreateParams + ' PAGE_SIZE ' + DPBItem.AsString;
243
244 DPBItem := aDPB.Find(isc_dpb_lc_ctype);
245 if DPBItem <> nil then
246 CreateParams := CreateParams + ' DEFAULT CHARACTER SET ' + DPBItem.AsString;
247
248 DPBItem := aDPB.Find(isc_dpb_sql_dialect);
249 if DPBItem <> nil then
250 FSQLDialect := DPBItem.AsInteger;
251 end;
252
253 Result := 'CREATE DATABASE ''' + DatabaseName + ''' ' + CreateParams; {do not localize}
254 end;
255
256 procedure TFBAttachment.EndAllTransactions;
257 var i: integer;
258 intf: TInterfacedObject;
259 begin
260 for i := 0 to InterfaceCount - 1 do
261 begin
262 intf := GetInterface(i);
263 if (intf <> nil) and (intf is TFBTransaction) then
264 TFBTransaction(intf).DoDefaultTransactionEnd(true);
265 end;
266 end;
267
268 procedure TFBAttachment.SetParameters(SQLParams: ISQLParams;
269 params: array of const);
270 var i: integer;
271 begin
272 if SQLParams.Count <> Length(params) then
273 IBError(ibxeInvalidParamCount,[SQLParams.Count,Length(params)]);
274
275 for i := 0 to High(params) do
276 begin
277 case params[i].vtype of
278 vtinteger :
279 SQLParams[i].AsInteger := params[i].vinteger;
280 vtInt64:
281 SQLParams[i].AsInt64 := params[i].VInt64^;
282 {$IF declared (vtQWord)}
283 vtQWord:
284 SQLParams[i].AsInt64 := params[i].VQWord^;
285 {$IFEND}
286 vtboolean :
287 SQLParams[i].AsBoolean := params[i].vboolean;
288 vtchar :
289 SQLParams[i].AsString := params[i].vchar;
290 vtextended :
291 SQLParams[i].AsDouble := params[i].VExtended^;
292 vtCurrency:
293 SQLParams[i].AsDouble := params[i].VCurrency^;
294 vtString :
295 SQLParams[i].AsString := strpas(PChar(params[i].VString));
296 vtPChar :
297 SQLParams[i].AsString := strpas(params[i].VPChar);
298 vtAnsiString :
299 SQLParams[i].AsString := strpas(PAnsiChar(params[i].VAnsiString));
300 vtVariant:
301 SQLParams[i].AsVariant := params[i].VVariant^;
302 vtWideChar:
303 SQLParams[i].AsString := UTF8Encode(WideCharLenToString(@params[i].VWideChar,1));
304 vtPWideChar:
305 SQLParams[i].AsString := UTF8Encode(strpas(PWideChar(params[i].VPWideChar)));
306 vtWideString:
307 SQLParams[i].AsString := UTF8Encode(strpas(PWideChar(params[i].VWideString)));
308 vtUnicodeString:
309 SQLParams[i].AsString := UTF8Encode(strpas(PWideChar(params[i].VUnicodeString)));
310 else
311 IBError(ibxeInvalidVariantType,[nil]);
312 end;
313 end;
314 end;
315
316 destructor TFBAttachment.Destroy;
317 begin
318 Disconnect(true);
319 inherited Destroy;
320 end;
321
322 function TFBAttachment.getDPB: IDPB;
323 begin
324 Result := FDPB;
325 end;
326
327 function TFBAttachment.AllocateBPB: IBPB;
328 begin
329 Result := TBPB.Create;
330 end;
331
332 procedure TFBAttachment.ExecImmediate(TPB: array of byte; sql: AnsiString;
333 aSQLDialect: integer);
334 begin
335 ExecImmediate(StartTransaction(TPB,taCommit),sql,aSQLDialect);
336 end;
337
338 procedure TFBAttachment.ExecImmediate(transaction: ITransaction; sql: AnsiString);
339 begin
340 ExecImmediate(transaction,sql,FSQLDialect);
341 end;
342
343 procedure TFBAttachment.ExecImmediate(TPB: array of byte; sql: AnsiString);
344 begin
345 ExecImmediate(StartTransaction(TPB,taCommit),sql,FSQLDialect);
346 end;
347
348 function TFBAttachment.ExecuteSQL(TPB: array of byte; sql: AnsiString;
349 SQLDialect: integer; params: array of const): IResults;
350 begin
351 Result := ExecuteSQL(StartTransaction(TPB,taCommit),sql,FSQLDialect,params);
352 end;
353
354 function TFBAttachment.ExecuteSQL(transaction: ITransaction; sql: AnsiString;
355 SQLDialect: integer; params: array of const): IResults;
356 begin
357 with Prepare(transaction,sql,SQLDialect) do
358 begin
359 SetParameters(SQLParams,params);
360 Result := Execute;
361 end;
362 end;
363
364 function TFBAttachment.ExecuteSQL(TPB: array of byte; sql: AnsiString;
365 params: array of const): IResults;
366 begin
367 Result := ExecuteSQL(StartTransaction(TPB,taCommit),sql,params);
368 end;
369
370 function TFBAttachment.ExecuteSQL(transaction: ITransaction; sql: AnsiString;
371 params: array of const): IResults;
372 begin
373 with Prepare(transaction,sql,FSQLDialect) do
374 begin
375 SetParameters(SQLParams,params);
376 Result := Execute;
377 end;
378 end;
379
380 function TFBAttachment.OpenCursor(transaction: ITransaction; sql: AnsiString;
381 aSQLDialect: integer): IResultSet;
382 begin
383 Result := OpenCursor(transaction,sql,aSQLDialect,[]);
384 end;
385
386 function TFBAttachment.OpenCursor(transaction: ITransaction; sql: AnsiString;
387 aSQLDialect: integer; params: array of const): IResultSet;
388 var Statement: IStatement;
389 begin
390 CheckHandle;
391 Statement := Prepare(transaction,sql,aSQLDialect);
392 SetParameters(Statement.SQLParams,params);
393 Result := Statement.OpenCursor;
394 end;
395
396 function TFBAttachment.OpenCursor(transaction: ITransaction; sql: AnsiString
397 ): IResultSet;
398 begin
399 Result := OpenCursor(transaction,sql,FSQLDialect,[]);
400 end;
401
402 function TFBAttachment.OpenCursor(transaction: ITransaction; sql: AnsiString;
403 params: array of const): IResultSet;
404 begin
405 Result := OpenCursor(transaction,sql,FSQLDialect,params);
406 end;
407
408 function TFBAttachment.OpenCursorAtStart(transaction: ITransaction;
409 sql: AnsiString; aSQLDialect: integer): IResultSet;
410 begin
411 Result := OpenCursor(transaction,sql,aSQLDialect,[]);
412 Result.FetchNext;
413 end;
414
415 function TFBAttachment.OpenCursorAtStart(transaction: ITransaction;
416 sql: AnsiString; aSQLDialect: integer; params: array of const): IResultSet;
417 begin
418 Result := OpenCursor(transaction,sql,aSQLDialect,params);
419 Result.FetchNext;
420 end;
421
422 function TFBAttachment.OpenCursorAtStart(transaction: ITransaction; sql: AnsiString
423 ): IResultSet;
424 begin
425 Result := OpenCursorAtStart(transaction,sql,FSQLDialect,[]);
426 end;
427
428 function TFBAttachment.OpenCursorAtStart(transaction: ITransaction;
429 sql: AnsiString; params: array of const): IResultSet;
430 begin
431 Result := OpenCursorAtStart(transaction,sql,FSQLDialect,params);
432 end;
433
434 function TFBAttachment.OpenCursorAtStart(sql: AnsiString): IResultSet;
435 begin
436 Result := OpenCursorAtStart(sql,[]);
437 end;
438
439 function TFBAttachment.OpenCursorAtStart(sql: AnsiString;
440 params: array of const): IResultSet;
441 begin
442 Result := OpenCursorAtStart(StartTransaction([isc_tpb_read,isc_tpb_wait,isc_tpb_concurrency],taCommit),sql,FSQLDialect,params);
443 end;
444
445 function TFBAttachment.Prepare(transaction: ITransaction; sql: AnsiString
446 ): IStatement;
447 begin
448 Result := Prepare(transaction,sql,FSQLDialect);
449 end;
450
451 function TFBAttachment.PrepareWithNamedParameters(transaction: ITransaction;
452 sql: AnsiString; GenerateParamNames: boolean): IStatement;
453 begin
454 Result := PrepareWithNamedParameters(transaction,sql,FSQLDialect,GenerateParamNames);
455 end;
456
457 function TFBAttachment.GetEventHandler(Event: AnsiString): IEvents;
458 var S: TStringList;
459 begin
460 S := TStringList.Create;
461 try
462 S.Add(Event);
463 Result := GetEventHandler(S);
464 finally
465 S.Free;
466 end;
467 end;
468
469 function TFBAttachment.GetSQLDialect: integer;
470 begin
471 Result := FSQLDialect;
472 end;
473
474 function TFBAttachment.OpenBlob(transaction: ITransaction; Field: ISQLData;
475 BPB: IBPB): IBlob;
476 begin
477 Result := OpenBlob(Transaction,Field.GetBlobMetadata, Field.AsQuad,BPB);
478 end;
479
480 function TFBAttachment.GetCharsetName(CharSetID: integer): AnsiString;
481 var i: integer;
482 begin
483 Result := '';
484 if (CharSetID >= Low(CharSetMap)) and (CharSetID <= High(CharSetMap)) and
485 (CharSetMap[CharSetID].CharSetID = CharSetID) then
486 begin
487 Result := CharSetMap[CharSetID].CharSetName;
488 Exit;
489 end;
490
491 for i := 0 to Length(FUserCharSetMap) - 1 do
492 if FUserCharSetMap[i].CharSetID = CharSetID then
493 begin
494 Result := FUserCharSetMap[i].CharSetName;
495 Exit;
496 end;
497 end;
498
499 function TFBAttachment.CharSetID2CodePage(CharSetID: integer;
500 var CodePage: TSystemCodePage): boolean;
501 var i: integer;
502 begin
503 Result := (CharSetID >= Low(CharSetMap)) and (CharSetID <= High(CharSetMap))
504 and (CharSetMap[CharSetID].CharSetID = CharSetID);
505 if Result then
506 begin
507 CodePage := CharSetMap[CharSetID].CodePage;
508 Result := true;
509 Exit;
510 end;
511
512 for i := 0 to Length(FUserCharSetMap) - 1 do
513 if FUserCharSetMap[i].CharSetID = CharSetID then
514 begin
515 CodePage := FUserCharSetMap[i].CodePage;
516 Result := true;
517 Exit;
518 end;
519 end;
520
521 function TFBAttachment.CodePage2CharSetID(CodePage: TSystemCodePage;
522 var CharSetID: integer): boolean;
523 var i: integer;
524 begin
525 Result := false;
526 for i := Low(CharSetMap) to High(CharSetMap) do
527 if (CharSetMap[i].AllowReverseLookup) and (CharSetMap[i].CodePage = CodePage) then
528 begin
529 CharSetID := CharSetMap[i].CharSetID;
530 Result := true;
531 Exit;
532 end;
533
534 for i := 0 to Length(FUserCharSetMap) - 1 do
535 if (FUserCharSetMap[i].AllowReverseLookup) and (FUserCharSetMap[i].CodePage = CodePage) then
536 begin
537 CharSetID := FUserCharSetMap[i].CharSetID;
538 Result := true;
539 Exit;
540 end;
541 end;
542
543 function TFBAttachment.CharSetName2CharSetID(CharSetName: AnsiString;
544 var CharSetID: integer): boolean;
545 var i: integer;
546 begin
547 Result := false;
548 for i := Low(CharSetMap) to High(CharSetMap) do
549 if AnsiCompareStr(CharSetMap[i].CharSetName, CharSetName) = 0 then
550 begin
551 CharSetID := CharSetMap[i].CharSetID;
552 Result := true;
553 Exit;
554 end;
555
556 for i := 0 to Length(FUserCharSetMap) - 1 do
557 if AnsiCompareStr(FUserCharSetMap[i].CharSetName, CharSetName) = 0 then
558 begin
559 CharSetID := FUserCharSetMap[i].CharSetID;
560 Result := true;
561 Exit;
562 end;
563 end;
564
565 function TFBAttachment.CharSetWidth(CharSetID: integer; var Width: integer
566 ): boolean;
567 var i: integer;
568 begin
569 Result := (CharSetID >= Low(CharSetMap)) and (CharSetID <= High(CharSetMap))
570 and (CharSetMap[CharSetID].CharSetID = CharSetID);
571 if Result then
572 begin
573 Width := CharSetMap[CharSetID].CharSetWidth;
574 Result := true;
575 Exit;
576 end;
577
578 for i := 0 to Length(FUserCharSetMap) - 1 do
579 if FUserCharSetMap[i].CharSetID = CharSetID then
580 begin
581 Width := FUserCharSetMap[i].CharSetWidth;
582 Result := true;
583 Exit;
584 end;
585 end;
586
587 const
588 sqlLookupCharSet = 'Select RDB$CHARACTER_SET_ID, RDB$BYTES_PER_CHARACTER From RDB$CHARACTER_SETS '+
589 'Where RDB$SYSTEM_FLAG = 0 and RDB$CHARACTER_SET_NAME = UPPER(?)';
590
591 procedure TFBAttachment.RegisterCharSet(CharSetName: AnsiString;
592 CodePage: TSystemCodePage; AllowReverseLookup: boolean; out CharSetID: integer
593 );
594 var CharSets: IResultSet;
595 idx: integer;
596 begin
597 if CharSetName2CharSetID(CharSetName,CharSetID) then
598 IBError(ibxeCharacterSetExists,[CharSetName]);
599
600 CharSets := OpenCursorAtStart(sqlLookupCharSet,[CharSetName]);
601 if CharSets.IsEof then
602 IBError(ibxeUnknownUserCharSet,[CharSetName]);
603
604 idx := Length(FUserCharSetMap);
605 SetLength(FUserCharSetMap,idx+1);
606 FUserCharSetMap[idx].AllowReverseLookup := AllowReverseLookup;
607 FUserCharSetMap[idx].CharSetID := CharSets[0].AsInteger;
608 FUserCharSetMap[idx].CharSetName := AnsiUpperCase(CharSetName);
609 FUserCharSetMap[idx].CharSetWidth := CharSets[1].AsInteger;
610 FUserCharSetMap[idx].CodePage := CodePage;
611 CharSetID := CharSets[0].AsInteger;
612 end;
613
614 end.
615