ViewVC Help
View File | Revision Log | Show Annotations | Download File | View Changeset | Root Listing
root/public/ibx/branches/udr/changelog
Revision: 387
Committed: Wed Jan 19 13:34:42 2022 UTC (2 years, 10 months ago) by tony
File size: 34529 byte(s)
Log Message:
Transactions started within a UDR are not forcibly closed if still active immediately prior to UDR exit

File Contents

# User Rev Content
1 tony 387 FBINTF Change Log version (1.4-0 Build 13107) Wed, 19 Jan 2022 12:08:21 +0000
2 tony 363
3 tony 381 1. Support package fbudr added for support of User Defined Routines (UDRs), and package
4     fbudrtestbed for client side debugging of UDR libraries.
5    
6     2. Package layout changed with introduction of udr support. IB*.pas files moved from
7     root directory to "client". IBHeader move to "Client".
8    
9     3. Delphi packages: all packages now compile .dcp and .bpi files to either
10     fbintf\Win32\Debug or fbintf\Win64\Debug by default. Please remove any pre-existing
11     fbintf.dcp and fbintf.bpi files from other locations.
12    
13     4. Client side journaling support added. Interface changes
14 tony 363 IAttachment
15     function JournalingActive: boolean;
16     function GetJournalOptions: TJournalOptions;
17     function StartJournaling(aJournalLogFile: AnsiString): integer; overload;
18     function StartJournaling(aJournalLogFile: AnsiString; Options: TJournalOptions): integer; overload;
19 tony 371 function StartJournaling(S: TStream; Options: TJournalOptions): integer; overload;
20 tony 363 procedure StopJournaling(RetainJournal: boolean);
21    
22 tony 381 5. Transactions may now be given a local transaction name:
23 tony 363 IFirebirdAPI
24     function StartTransaction(Attachments: array of IAttachment;
25     TPB: array of byte; DefaultCompletion: TTransactionCompletion=taCommit): ITransaction; overload;
26     TPB: array of byte; DefaultCompletion: TTransactionCompletion=taCommit;
27     aName: AnsiString=''): ITransaction; overload;
28     function StartTransaction(Attachments: array of IAttachment;
29     TPB: ITPB; DefaultCompletion: TTransactionCompletion=taCommit): ITransaction; overload;
30     TPB: ITPB; DefaultCompletion: TTransactionCompletion=taCommit;
31     aName: AnsiString=''): ITransaction; overload;
32    
33     IAttachment
34     function StartTransaction(TPB: array of byte; DefaultCompletion: TTransactionCompletion=taCommit): ITransaction; overload;
35     function StartTransaction(TPB: ITPB; DefaultCompletion: TTransactionCompletion=taCommit): ITransaction; overload;
36     function StartTransaction(TPB: array of byte;
37     DefaultCompletion: TTransactionCompletion=taCommit;
38     aName: AnsiString=''): ITransaction; overload;
39     function StartTransaction(TPB: ITPB;
40     DefaultCompletion: TTransactionCompletion=taCommit;
41     aName: AnsiString=''): ITransaction; overload;
42    
43     ITransaction
44     function GetTransactionName: AnsiString;
45     procedure SetTransactionName(aValue: AnsiString);
46    
47 tony 381 6. Additional Transaction information
48 tony 363 ITPB.function AsText: AnsiString; {Returns TPB as a text string}
49    
50     ITransaction
51     function GetDefaultCompletion: TTransactionCompletion;
52     function GetJournalingActive(attachment: IAttachment): boolean; {attachment must be specified when multi-database transaction}
53    
54 tony 381 7. New IAttachment helper functions
55 tony 363 function HasTable(aTableName: AnsiString): boolean;
56 tony 371 function HasFunction(aFunctionName: AnsiString): boolean;
57     function HasProcedure(aProcName: AnsiString): boolean;
58 tony 363 function GetAttachmentID: integer;
59 tony 371 function GetCharSetID: integer;
60 tony 363
61 tony 381 8. IStatement: if the BatchRowLimit is set to maxint, the maximum possible buffer size
62 tony 371 will be allocted for batch operations.
63    
64 tony 381 9. IStatement, IColumnMetaData and ISQLParam all now consistently provide:
65 tony 371 function GetStatement: IStatement;
66     function GetTransaction: ITransaction;
67     function GetAttachment: IAttachment;
68    
69 tony 381 10. Internal: a more disciplined approach to the handling of Firebird.IReferenceCounted
70     interfaces.
71 tony 371
72 tony 381 11. New interface type: IFBNumeric. IFBNumeric is implemented in the unit FBNumeric
73     and concentrates all handling of Fixed Point numbers. New ISQLItem and ISQLParam
74     functions getAsNumeric and setAsNumeric allow for direct retrival and manipulation
75     of numerics without loss of precision.
76 tony 371
77 tony 381 12. TryStrToNumeric and NumericToDouble moved from IBUtils to FBNumeric.
78 tony 371
79 tony 381 13. ISQLParams new method "Clear"
80 tony 371
81 tony 381 14. Connection Info (e.g. ODS Version, Remote Protocol) now retrieved on first
82 tony 375 request rather than on attachment connect.
83 tony 371
84 tony 385 15. IStatus.IBDataBaseErrorMessages now defaults to [ShowIBMessage]. This reflects the
85     fact that SQLCodes are soon to be deprecated. In the future, the other options
86     will be silently ignored if SQLCode support is not present in the Firebird
87     Client library.
88 tony 375
89 tony 387 16. ITransaction changes Rollback and Commit from procedures to functions:
90     function Commit(Force: boolean=false): TTrCompletionState;
91     function Rollback(Force: boolean=false): TTrCompletionState;
92 tony 385
93 tony 387 Specifically, this is to allow the functions to report back a failed commit or
94     rollback when Force = true. In the case, the transaction handle has been
95     released, while the transaction remains in limbo.
96    
97     17. IAttachment ExecImmediate, ExecuteSQL and OpenCursorAtStart.
98     When the transaction parameters are provided as an array of const and the
99     statement fails, the transaction is rolledback (forced) before the exception
100     is raised.
101    
102    
103    
104 tony 359 FBINTF Change Log version (1.3-3 Build 12935) Mon, 06 Dec 2021 23:17:13 +0000
105    
106     1. Fix compile error with fpc trunk (3.3.1 and later), due to type change to tzname in "unix" unit.
107    
108     2. Remove constraint in IAttachment.HasScollableCursors that returned false when
109     using remote protocol. Scrollable cursors with remote database expected to
110     be support for Firebird 4.0.1 onwards. Note: Firebird 4.0.0 will return
111     a not supported error.
112    
113     3. IStatement: new function;
114     TStatementFlag = (stHasCursor,stRepeatExecute,stScrollable);
115     TStatementFlags = set of TStatementFlag;
116     function GetFlags: TStatementFlags;
117    
118     4. Revised behaviour for IStatement.ExecuteQuery in order to preserve backwards
119     compatibility.
120     In Firebird 5, Update..Returning may returns multiple rows and hence the statemen
121     type changes from ExecProcedure to Select. So that ExecuteQuery can continue
122     to be used with Update...Retruning statements that return a singleton row,
123     instead of raising an exception when ExecuteQuery is used with a (SELECT) statement,
124     it will open the cursor and return the first row only.
125    
126     5. ITransaction: new functions:
127     function GetIsReadOnly: boolean;
128     function GetTransactionID: integer;
129     function GetTrInformation(Requests: array of byte): ITrInformation; overload;
130     function GetTrInformation(Request: byte): ITrInformation; overload;
131    
132     The latter two return the Transaction Information block. The first two extract
133     information the Transaction Information block
134    
135     6. New function TSQLTokeniser.ReadCharacters
136     Used internally.
137    
138     7. IStatement: GetProcessedSQL bug fix. No longer raises and error if SQL contains
139     parameter placeholders instead of named parameters.
140    
141     8. ITransaction (Firebird 3 and later): An exception raised when freeing an underlying
142     transaction handle is now ignored if Rollback/Commit is called with Force=true
143    
144 tony 371 9. Tidy up of exception handling code. Under the legacy API, fb_interpret is now
145     used to get an IBError Message instead of isc_interprete.
146    
147     10. Internal tidyup. Native code now used for decoding integers and the events
148     buffer. Avoids dependencies on fbclient functions isc_portable_integer,
149     isc_event_block and isc_event_counts.
150    
151     11. New IAttachment function
152     function GetAttachmentID: integer;
153    
154     12. Internal changes to TFBClientAPI, TFBAttachment and TFBTransaction and TFB30
155     subclasses to enable UDR support.
156    
157 tony 356 FBINTF Change Log version (1.3-2 Build 12889) Sun, 24 Oct 2021 13:49:28 +0100
158 tony 347
159     1. TFBClientAPI.GetProcAddr. Add check for nil reference.
160    
161     2. IStatement: new methods:
162     procedure SetStaleReferenceChecks(Enable:boolean); {default true}
163     function GetStaleReferenceChecks: boolean;
164    
165     In previous versions, stale reference checks were always enabled. This allows the
166     user to disable them on a per statement basis. Note this can risk out-of-date
167     statement BLR. See User Guide.
168    
169 tony 348 3. IBUtils: TSQLwithNamedParamsTokeniser now recognises a CASE...END block within a
170     stored procedure and hence avoids replacing named parameters within a containing
171     BEGIN..END block.
172    
173 tony 349 4. ISQLParam: using a string value to set an integer field with a scale factor of
174     zero is now treated as a special case to avoid the risk of floating point
175     rounding errors affecting pure integers.
176    
177     5. ISQLParam: Review and tidy-up of SetAsString for numeric types.
178    
179     6. ISQLParam is now subclassed from IParamMetaData, which provides access to the mutable
180     SQL Parameter metadata (methods moved from ISQLParam).
181    
182     7. ISQLParam: new method
183     function getColMetadata: IParamMetaData;
184     This instance of IParamMetaData returns the original column metadata which is unmutable.
185     Note: ISQLParam metadata can change after a parameter value has been set e.g when
186     setting a VARCHAR column to an integer value.
187    
188 tony 350 8. IStatement: can now set cursor name when opening a cursor. New overloaded method:
189     procedure Prepare(CursorName: AnsiString; aTransaction: ITransaction=nil); overload;
190     also IAttachment:
191     function Prepare(transaction: ITransaction; sql: AnsiString; aSQLDialect: integer; CursorName: AnsiString=''): IStatement; overload;
192     function Prepare(transaction: ITransaction; sql: AnsiString; CursorName: AnsiString=''): IStatement; overload;
193     function PrepareWithNamedParameters(transaction: ITransaction; sql: AnsiString;
194     aSQLDialect: integer; GenerateParamNames: boolean=false;
195     CaseSensitiveParams: boolean = false; CursorName: AnsiString=''): IStatement; overload;
196     function PrepareWithNamedParameters(transaction: ITransaction; sql: AnsiString;
197     GenerateParamNames: boolean=false;
198     CaseSensitiveParams: boolean = false; CursorName: AnsiString=''): IStatement; overload;
199 tony 349
200 tony 350 9. Support for scrollable cursors added. New/updated methods:
201     IAttachment:
202 tony 352 function HasScollableCursors: boolean;
203 tony 350 function OpenCursor(transaction: ITransaction; sql: AnsiString; aSQLDialect: integer;
204     Scrollable: boolean=false): IResultSet; overload;
205     function OpenCursor(transaction: ITransaction; sql: AnsiString; Scrollable: boolean=false): IResultSet; overload;
206     function OpenCursor(transaction: ITransaction; sql: AnsiString; aSQLDialect: integer; Scrollable: boolean;
207     params: array of const): IResultSet; overload;
208     function OpenCursor(transaction: ITransaction; sql: AnsiString; Scrollable: boolean=false;
209     params: array of const): IResultSet; overload;
210     function OpenCursorAtStart(transaction: ITransaction; sql: AnsiString; aSQLDialect: integer; Scrollable: boolean;
211     params: array of const): IResultSet; overload;
212     function OpenCursorAtStart(transaction: ITransaction; sql: AnsiString; aSQLDialect: integer;
213     Scrollable: boolean=false): IResultSet; overload;
214     function OpenCursorAtStart(transaction: ITransaction; sql: AnsiString; Scrollable: boolean=false): IResultSet; overload;
215     function OpenCursorAtStart(transaction: ITransaction; sql: AnsiString; Scrollable: boolean;
216     params: array of const): IResultSet; overload;
217     function OpenCursorAtStart(sql: AnsiString; Scrollable: boolean=false): IResultSet; overload;
218     function OpenCursorAtStart(sql: AnsiString; Scrollable: boolean;
219     params: array of const): IResultSet; overload;
220     IStatement:
221     function OpenCursor(Scrollable: boolean; CursorName: AnsiString =''; aTransaction: ITransaction=nil): IResultSet; overload;
222     IResultSet:
223     function FetchPrior: boolean; {fetch previous record}
224     function FetchFirst:boolean; {fetch first record}
225     function FetchLast: boolean; {fetch last record}
226     function FetchAbsolute(position: Integer): boolean; {fetch record by its absolute position in result set}
227     function FetchRelative(offset: Integer): boolean; {fetch record by position relative to current}
228     function IsBof: boolean;
229    
230 tony 353 10. IArray: tidyup of SetAsString method to ensure correct handling of fixed point numbers.
231 tony 350
232 tony 353 11. IBUtils: TSQLTokeniser. CRLF now combined by low level parser into sqltEOL token. This
233     may be noticeable when a line separator occurs inside quoted text. The quoted text
234     output by the tokeniser will now use the platform specific lineEnding regardless
235     of whether the input uses the CRLF or LF as a line separator.
236 tony 350
237 tony 353 12. IStatement, IResultsSet: Support for scrollable cursors added (note: local databases only)
238    
239    
240 tony 345 FBINTF Change Log version (1.3-1 Build 12776) Mon, 23 Aug 2021 11:09:33 +0100
241    
242     1. Integer decodes in information blocks (e.g. IDBInfoItem) widened from 32 bit to 64-bit integers.
243    
244     2. Support for inline blob encoding. Blob values pass using the "SetAsString" method
245     will now be encoded inline (i.e. as part of the parameter buffer) if they are
246     shorter than a pre-set limit. Longer values continue to be saved as blobs as a
247     separate server interaction. This is intended as a performance optimisation.
248    
249     The pre-set limit defaults to 8192 bytes and can be inspected/modified using the new
250     IAttachment interface functions:
251    
252     function GetInlineBlobLimit: integer;
253     procedure SetInlineBlobLimit(limit: integer);
254    
255     3. Support for Firebird 4 IBatch interface added. This is largely transparent to the API
256     user as the functionality is embedded in the implementation of the IStatement
257     interface. Three new functions are defined:
258    
259     procedure AddToBatch;
260     function ExecuteBatch(aTransaction: ITransaction=nil): IBatchCompletion;
261     procedure CancelBatch;
262     function GetBatchCompletion: IBatchCompletion;
263     function GetBatchRowLimit: integer;
264     procedure SetBatchRowLimit(aLimit: integer);
265    
266     Also
267    
268     function IsInBatchMode: boolean; {true after call to execute(eaDefer)}
269     function HasBatchMode: boolean; {true if and only if IBatch Supported}
270    
271     For more information see the User Guide.
272    
273     4. Default error message contents. Now aligned with User Guide section 10.2 i.e. error messages
274     provided with the EIBInterBaseError now include all three parts.
275    
276     5. Firebird.pas and include files updated to Firebird 4.0.0
277    
278     6. New IStatement method: function GetSQLStatementTypeName: AnsiString;
279     Returns SQL Statement type as a text string;
280    
281     7. ISQLData.AsInteger and AsInt64 now use "Round" to convert a float field to
282     an integer instead of "trunc". This is for compatibility with TFloatField.AsInteger.
283    
284 tony 340 FBINTF Change Log version (1.2-1 Build 12552) Wed, 09 Jun 2021 13:05:40 +0100
285 tony 338
286     1. Big fix for Firebird 4.0. A internal change in Firebird 4.0.0 from RC1 flushed out a
287     typo in FB30Statement.pas that caused an unknown parameter error.
288    
289 tony 319 FBINTF Change Log version (1.2-0 Build 12520) Fri, 19 Feb 2021 13:27:23 +0000
290 tony 308
291 tony 315 1. Imported (Firebird) constants updated for Firebird 4.
292    
293     2. Firebird.pas from Firebird 4 integrated into source code tree.
294    
295     3. Added Support for TIMETAMP WITH TIME ZONE and TIME WITH TIME ZONE data types.
296    
297     4. Added Support for SQL_DEC16, SQL_DEC34 and extended NUMERIC precision.
298    
299     5. New unit 'FBClientLib.pas' added and provides new interface IFBIMasterProvider.
300     QueryInterface may be used to coerce this interface from IFirebirdAPI. The
301     interface provides a single method "function GetIMasterIntf: IMaster". This provides
302     type safe access to the Firebird IMaster interface and avoids the need to turn
303     off object checks when coercing "function GetIMaster: TObject" to IMaster.
304    
305     6. New IFirebirdAPI Calls:
306     function HasLocalTZDB: boolean;
307     function HasTimeZoneSupport: boolean;
308     function HasExtendedTZSupport: boolean;
309     procedure SQLDecFloatEncode(aValue: tBCD; SQLType: cardinal; bufptr: PByte);
310     function SQLDecFloatDecode(SQLType: cardinal; scale: integer; bufptr: PByte): tBCD;
311    
312     7. New IAttachment Calls:
313     function HasDecFloatSupport: boolean;
314     function GetTimeZoneServices: ITimeZoneServices;
315     function HasTimeZoneSupport: boolean;
316    
317     8. New Interface ITimeZoneServices.
318    
319     9. New ISQLData API Calls:
320     procedure GetAsDateTime(var aDateTime: TDateTime; var dstOffset: smallint; var aTimezoneID: TFBTimeZoneID); overload;
321     procedure GetAsDateTime(var aDateTime: TDateTime; var dstOffset: smallint; var aTimezone: AnsiString); overload;
322     procedure GetAsTime(var aTime: TDateTime; var dstOffset: smallint; var aTimezoneID: TFBTimeZoneID; OnDate: TDateTime); overload;
323     procedure GetAsTime(var aTime: TDateTime; var dstOffset: smallint; var aTimezone: AnsiString; OnDate: TDateTime); overload;
324     function GetAsUTCDateTime: TDateTime;
325     function GetAsBCD: tBCD;
326    
327     10. New ISQLParam API Calls
328     procedure GetAsDateTime(var aDateTime: TDateTime; var dstOffset: smallint; var aTimezoneID: TFBTimeZoneID); overload;
329     procedure GetAsDateTime(var aDateTime: TDateTime; var dstOffset: smallint; var aTimezone: AnsiString); overload;
330     procedure GetAsTime(var aTime: TDateTime; var dstOffset: smallint; var aTimezoneID: TFBTimeZoneID; OnDate: TDateTime); overload;
331     procedure GetAsTime(var aTime: TDateTime; var dstOffset: smallint; var aTimezone: AnsiString; OnDate: TDateTime); overload;
332     function GetAsUTCDateTime: TDateTime;
333     function GetAsBCD: tBCD;
334     function GetStatement: IStatement;
335     function GetTransaction: ITransaction;
336     procedure SetAsTime(aValue: TDateTime; OnDate: TDateTime; aTimeZoneID: TFBTimeZoneID); overload;
337     procedure SetAsTime(aValue: TDateTime; OnDate: TDateTime; aTimeZone: AnsiString); overload;
338     procedure SetAsDateTime(aValue: TDateTime; aTimeZoneID: TFBTimeZoneID); overload;
339     procedure SetAsDateTime(aValue: TDateTime; aTimeZone: AnsiString); overload;
340     procedure SetAsUTCDateTime(aUTCTime: TDateTime);
341     procedure SetAsBcd(aValue: tBCD);
342    
343     11. New IArray API Calls
344     procedure GetAsDateTime(index: array of integer; var aDateTime: TDateTime; var dstOffset: smallint; var aTimezoneID: TFBTimeZoneID); overload;
345     procedure GetAsDateTime(index: array of integer; var aDateTime: TDateTime; var dstOffset: smallint; var aTimezone: AnsiString); overload;
346     procedure GetAsTime(index: array of integer; var aTime: TDateTime; var dstOffset: smallint; var aTimezoneID: TFBTimeZoneID; OnDate: TDateTime); overload;
347     procedure GetAsTime(index: array of integer; var aTime: TDateTime; var dstOffset: smallint; var aTimezone: AnsiString; OnDate: TDateTime); overload;
348     function GetAsUTCDateTime(index: array of integer): TDateTime;
349     procedure SetAsDateTime(index: array of integer; aValue: TDateTime; aTimeZoneID: TFBTimeZoneID); overload;
350     procedure SetAsDateTime(index: array of integer; aValue: TDateTime; aTimeZone: AnsiString); overload;
351     procedure SetAsTime(index: array of integer; aValue: TDateTime; OnDate: TDateTime; aTimeZoneID: TFBTimeZoneID); overload;
352     procedure SetAsTime(index: array of integer; aValue: TDateTime; OnDate: TDateTime; aTimeZone: AnsiString); overload;
353    
354     12. Utility functions in IBUtils
355     function ParseDateTimeTZString(aDateTimeStr: Ansistring; var aDateTime: TDateTime;
356     var aTimezone: AnsiString; aFormatSettings: TFormatSettings; TimeOnly: boolean=false): boolean;
357     procedure FBDecodeTime(aTime: TDateTime; var Hour, Minute, Second: word; var DeciMillisecond: cardinal);
358     function FBEncodeTime(Hour, Minute, Second, DeciMillisecond: cardinal): TDateTime;
359     function FBFormatDateTime(fmt: AnsiString; aDateTime: TDateTime): AnsiString;
360     function FormatTimeZoneOffset(EffectiveTimeOffsetMins: integer): AnsiString;
361     function DecodeTimeZoneOffset(TZOffset: AnsiString; var dstOffset: integer): boolean;
362    
363     13. IDPB, ITPB and ISPB: new interface method
364     function AddByTypeName(ParamTypeName: AnsiString): IDPBItem/ITPBItem/ISPBItem;
365     This is used to add a parameter block item by the string equivalent of its
366     symbolic type name. e.g. DPB.AddByTypeName('isc_dpb_user_name').AsString := '...'
367    
368     14. IDPBItem/ITPBItem/ISPBItem: new interface method:
369     function getParamTypeName: AnsiString;
370    
371     15. fb_shutdown now called before unloading Firebird library. This can avoid a
372     SIGEVENT error when a programme using the embeded server is unloaded.
373    
374     FBINTF Change Log version (1.1-6 Build 12237) Tue, 21 Jul 2020 08:54:21 +0100
375    
376 tony 308 1. GetImplementationVersion now correctly returns '3.0' for Firebird 3 API
377     with a Firebrid 3 client library.
378    
379     2. Linux Only: FIREBIRD environment variable is now checked when loading the client library.
380     If a client library path is not explicitly provided and the FIREBIRD environment
381     variable is set then the directory given by this variable and any 'lib' subdirectory
382     are searched for the Firebird client library. Only if none is found, is the default
383     client library used.
384    
385     3. IUtil.FormatStatus now used to format error messages when using new API
386    
387     4. Fixed Array SDL: array_desc_scale now correctly encoded as a signed integer.
388    
389     5. SQL_TEXT handling changed. When the value of an SQL_TEXT (i.e. fixed width string) column is
390     returned using GetAsString and the string codepage is UTF8, the string is truncated so
391     that the byte length corresponds to the number of characters specified for the column.
392     SQL_TEXT strings are no longer automatically trimmed to remove all trailing white space. This is
393     correct behaviour but may affect some implementations that relied upon automatic
394     trimming of trailing white space.
395    
396     6. New IFirebirdAPI Calls:
397     function GetClientMajor: integer;
398     function GetClientMinor: integer;
399    
400 tony 309 7. IColumnMetaData and IArrayMetaData: new method
401     function GetCharSetWidth: integer;
402 tony 308
403 tony 315 FBINTF Change Log version (1.1-5 Build 12022) Fri, 17 Apr 2020 10:35:55 +0100
404 tony 309
405 tony 287 1. ISQLParams.GetHasCaseSensitiveParams added. Returns true if param names are
406     case sensitive
407    
408     2. Single line SQL comments starting with '--' are now recognised by SQL Parser.
409    
410 tony 291 3. New API Calls:
411     IColumnMetaData.GetStatement
412     IColumnMetaData.GetTransaction
413 tony 315 ISQLData.GetStrDataLength
414 tony 291 IResults.GetStatement
415     IAttachment.OpenBlob (using Blob metadata)
416     IAttachment.OpenArray (using array metadata)
417    
418     4. FBMessages: removal of unused messages
419    
420     5. TFBArray.Create (2nd case): ensure that FFirebirdClientAPI is correctly set.
421    
422     6. TIBSQLStatementType: SQLSavePoint added to end of enumeration.
423    
424 tony 280 FBINTF Change Log version (1.1-4 Build 11515) Fri, 28 Dec 2018 10:04:19 +0000
425 tony 265
426     1. Fix a problem with the SQL parameter parser that failed to recognise parameters
427     where the second character of the parameter name is a numeric.
428    
429 tony 266 2. New method for IAttachment: procedure getFBVersion(version: TStrings);
430     This returns the isc_version connection information as one or more lines.
431     This is the same information as returned by isql with the -z option.
432 tony 265
433 tony 270 3. If -dFIREBIRD3APIONLY is used as a compiler option then the legacy Firebird API
434     is no longer compiled in. Likewise, if -dLEGACYFIREBIRDAPIONLY is used as a
435     compiler option then the Firebird 3 API is no longer compiled in.
436 tony 266
437 tony 270 4. IColumnMetaData: new method.
438    
439     TIBDateTimeFormats = (dfTimestamp, {SQL TIMESTAMP}
440     dfDateTime, {SQL DATETIME}
441     dfTime);
442    
443     function GetDateTimeStrLength(DateTimeFormat: TIBDateTimeFormats): integer;
444    
445     This returns the max. number of characters returned by the "AsString" method
446     when the SQL type of the column is respectively TIMESTAMP, DATETIME or TIME.
447    
448     5. Additional argument for IAttachment.PrepareWithNamedParameters -
449     CaseSensitiveParams: boolean = false
450    
451     If this argument is set to true then SQL parameter names are assumed to be case
452     sensitive and must be referenced (using ISQLParams.ByName) using the case
453     sensitive name.
454    
455     6. Bug fix: when setting a query parameter, it is now possible, when the parameter
456     is of type VarChar or Char to set the parameter to a numeric value (e.g. using
457     .AsCurrency) and then subsequently to update the value to a non-numeric string
458     using .AsString.
459    
460    
461    
462 tony 263 FBINTF Change Log version (1.1-3) Wed, 05 Dec 2018 14:28:10 +0000
463 tony 238
464     1. DARWIN only syntax error: fix missing semi-colon in TFBClientAPI.LoadIBLibrary
465    
466 tony 263 2. Restrict IsMultiThread check to Unix only for compatibility with
467     https://bugs.freepascal.org/view.php?id=30535
468    
469     3. New SQL Tokeniser added to IBUtils. This is used to pre-process SQL with
470     named parameters and is intended to avoid problems with (e.g.) Execute Block
471     and processing internal parameters as statement parameters.
472    
473     4. New interface IFirebirdLibrary provides access to the underlying firebird DLL
474     or shared object. Available via a new member (GetFBLibrary) of IFirebirdAPI.
475    
476     5. New function added to IB.pas
477    
478     function LoadFBLibrary(aLibPathName: string): IFirebirdLibrary
479    
480     This allows a Firebird Library to be loaded from an explicit path. use the
481     IFirebirdLibrary.GetFirebirdAPI member function to get the Firebird API using
482     the library. It is possible to load Firebird libraries from different locations
483     simultaneously, each with a distinct IFirebirdAPI.
484    
485 tony 233 FBINTF Change Log version (1.1-2) Mon, 16 Apr 2018 09:30:32 +0100
486 tony 59
487 tony 209 1. Firebird.pas: {$OBJECTCHECKS OFF} added to file to avoid runtime error when
488     program compiled with -CR command line switch.
489    
490     2. IServiceManager additions (informational):
491     function getProtocol: TProtocol;
492     function getPortNo: AnsiString;
493    
494     3. IServiceManager improved error handling. Interfaces changed:
495     function Start(Request: ISRB; RaiseExceptionOnError: boolean=true): boolean;
496     function Query(SQPB: ISQPB; Request: ISRB; RaiseExceptionOnError: boolean=true) :IServiceQueryResults; overload;
497     function Query(Request: ISRB; RaiseExceptionOnError: boolean=true) :IServiceQueryResults; overload;
498    
499     4. IAttachment addition (informational)
500     function GetSecurityDatabase: AnsiString;
501    
502     5. IStatement: performance counters now updated after each Fetch. GetPerfStatistics
503     thus now returns accumulated stats for a select statement from opening a cursor
504     up to the last fetch.
505    
506     6. DARWIN: uloadlibrary.inc bug fix. Many thanks to Luigi Naimi for correcting
507     the problem.
508    
509     7. Type change: "TPerfCounters = array[TPerfStats] of Int64". Note "Int64"
510     replaces deprecated "comp" type.
511    
512 tony 217 10. Testsuite Test10 updated to include thread synchronisation for event reporting.
513 tony 209
514 tony 231 11. URL Connection Strings: inet4 and inet6 now recognised.
515 tony 217
516 tony 231 12. IBUtils: Parse and Make Connect String now recognise URL style loopback syntax.
517    
518 tony 233 13. IAttachment.CharSetName2CharSetID is now performed case insensitive.
519 tony 231
520 tony 233
521 tony 209 FBINTF Change Log version (1.1-1) Tue, 27 Feb 2018 16:51:16 +0000
522    
523 tony 107 1. IBUtils.QuoteIdentifierIfNeeded: Add check for space character.
524    
525 tony 109 2. IAttachment: add two new methods
526     function HasDefaultCharSet: boolean;
527     function GetDefaultCharSetID: integer;
528    
529     These return, respectively, true if a connection default character set was
530 tony 117 specified and the character set id of the connection default character set.
531     The DefaultCharSetID is cached when the connection is opened and hence does not
532     require a database lookup.
533 tony 109
534 tony 110 3. Avoid exception when a text blob is a stored procedure parameter.
535 tony 109
536 tony 111 4. Update test suite to include a test for a stored proc returning a text blob.
537    
538 tony 117 5. IAttachment: add
539     function GetRemoteProtocol: AnsiString;
540     function GetODSMajorVersion: integer;
541     function GetODSMinorVersion: integer;
542 tony 143 function GetAuthenticationMethod: AnsiString;
543 tony 117
544     These results are cached when the connection is opened and hence do not
545     require a database lookup.
546    
547     6. IAttachment: add "function GetConnectString: AnsiString;" This returns the
548     connect string used to create/connect to the database.
549    
550     7. IAttachment: Create Database using SQL statement. The username and password
551     are now extracted and used to populate a DPB made available via IAttachment.getDPB.
552     It is now possible to use IAttachment disconnect/connect to reconnect to
553     a database for which the initial connection was established by a create
554 tony 120 database sql statement. Available in FPC only.
555 tony 117
556     8. Update Test 1 to test 5, 6 and 7 above.
557    
558     9. IBUtils code tidy up.
559    
560 tony 143 10. Parameter Block interfaces "find" method. As documented, this should have
561     returned a nil interface when the item could not be found. Instead, an empty
562     interface item was returned. "Find" now works as documented and will return
563     a nil interface if the item cannot be found.
564    
565     11. DBInformation: support added for isc_info_active_tran_count and isc_info_creation_date.
566    
567     12. DBInformation: New interfaces: IDIRB and IDIRBItem added to support DB Information
568     requests with additional parameters. This is to enable support for fb_info_page_contents
569     (return of page contents). Response to fb_info_page_contents returned as
570     a string with code page CP_NONE.
571    
572     13. DBInformation: Support for fb_info_pages_used and fb_info_pages_free added, plus
573     test suite updated.
574    
575     14. DBInformation: Support for fb_info_crypt_key (Firebird 3.0.3 onwards) added as
576     a string type, and fb_info_conn_flags (Firebird 3.0.3 onwards) added as an integer type.
577    
578     15. Service Manager: List of protocols supported expanded to include inet, wnet and xnet.
579     An overloaded version of IIFirebirdAPI.GetServiceManager also allows a non
580     default connection port to be specified.
581    
582 tony 107 FBINTF Change Log version (1.1-0) Sun, 07 Jan 2018 15:20:02 +0000
583    
584 tony 59 1. Fix issues with setting SQL Param values using SetAsString with Numeric types.
585     Scale is no longer ignored.
586    
587     2. Fix issues with setting SQL Param values using SetAsString with Date values
588     not in locale format but which are recognised by Firebird. Date values that
589     cannot be converted to a string using Pascal library are now passed through
590     to Firebird as Text Strings.
591    
592 tony 60 3. Lookup character set name by codepage amended to ensure that CP_UTF8 returns
593     UTF8 and not UNICODE_FSS.
594    
595     4. Charset ID problem. When using Firebird 3, with no default database character set
596     and a column has a non-default collation specified, an incorrect character set
597     id was being reported that could result in a 'division by zero' error when
598     used by IBX. This has now been fixed.
599    
600     5. Move GetCharsetName, CharSetID2CodePage, CodePage2CharSetID, CharSetName2CharSetID,
601     CharSetWidth from IFirebirdAPI to IAttachment. This is a better data model as
602     the character sets supported can be updated on a per database basis. That is
603     it is possible to add a (Firebird) user defined character set to a database.
604    
605     6. Add RegisterCharSet to IAttachment. This is used to register a user defined character
606     set supported by Firebird with the API.
607    
608 tony 61 7. Add missing isc_info_db_read_only to list of decoded Database Information items
609     in FBOutputBlock.pas and update test suite to include this item.
610 tony 60
611 tony 63 8. FB30Client: avoid always using "StartMultiple" when only a single database attachment.
612 tony 61
613 tony 68 9. Loading Windows fbclient.dll: when using the FIREBIRD variable to locate the client
614     library or finding it by disk location, the PATH environment variable is now also set to
615     include the FIREBIRD directory. This is to ensure that the correct dlls in the
616     firebird client library dependencies are loaded.
617 tony 63
618 tony 68 10. Testsuite: Ensure consistent UTF-8 output on Windows console.
619    
620     11. Testsuite: Update Windows script to include FPC 3.0.4 in search path.
621    
622     12. FB30Statement: Protect call to "Move" and avoid calling with a nil pointer
623    
624     13. FB30Statement: A check has been added to ensure that all SQL Parameters
625     have been given a value (including NULL). Previously, failing to set the
626     value of an SQL Parameter could give rise to unpredictable results or
627     an SQLDA error.
628    
629     14. FB30Statement/FB25Statement: Set SQLParam "modified" when string value set.
630    
631 tony 70 15. FBAttachment: Avoid string reference count error when processing an Ansistring
632     parameter in an array of const passed to IAttachment.OpenCursor, etc.
633 tony 68
634 tony 70 16. FBAttachment: Allow for WideString and UnicodeString parameters in an array
635     of const passed to IAttachment.OpenCursor, etc.
636    
637    
638 tony 56 FBINTF Change Log version (1.0-2) Sat, 04 Mar 2017 14:43:56 +0000
639 tony 47
640 tony 56 1. Change syntax to Mode Delphi
641    
642     2. Change all uses of string type to explicit AnsiString in order to ensure
643     compatibility between Delphi and FPC.
644    
645     3. Various syntax changes to ensure Delphi and FPC compilation including GUIDs
646     defined for each interface.
647    
648     4. Generics syntax variations for Delphi added
649    
650     5. PChar replaced with PByte expect where an actual string is being referenced,
651     where PAnsiChar is used instead.
652    
653     6. Review of type definitions in IBExternals to ensure Delphi compatibility
654    
655     7. Testsuite updated for Delphi
656    
657     FBINTF Change Log version (1.0-1) Fri, 24 Feb 2017 12:17:57 +0000
658    
659 tony 47 1. Limit maximum Blob segment read/write to MaxuShort. Avoids data loss with
660     large blobs and the FB3 API.
661    
662     2. Update Event Handling algorithm to avoid looping due to recreation of the
663     event block.
664    
665     3. Avoid invalid XSQLDA error when the only parameter is updated to null
666    
667     4. Array Handling: fix problem with text arrays with character set none. When the
668     DB connection has a default character set (e.g. UTF8), an error is raised by
669     Firebird if the space allocated is not enough to allow for transliteration, even
670     though it is not required for character set none.
671    
672     5. IBUtils: List of reserved words brought up-to-date
673    
674     6. Add ISQL style performance statistics collection to IStatement
675    
676     7. Add IFirebirdAPI.CreateDatabase variant to allow execution of user provided
677     CREATE DATABASE statement.
678    
679     8. Update SQL Statement parsing to allow for Array Dimensions. That is so that the ':' in
680     an array dimension is not mistaken for a named parameter prefix.
681    
682     9. Trim function no longer applied to result of GetAsString for SQL_TEXT
683     when Character set is octets. Avoids loss of non printable characters at start of string.
684    
685     10. Add function GetPerfStatistics to IStatement. This returns ISQL like performance
686     statistics for the last action. Requires use of procedure IStatement.EnableStatistics
687     to enable stats gathering.
688    
689     11. API Version information added as constants to IB.pas
690    
691     12. BlobMetaData character set id should now be the same as that given by IColumnMetaData.GetCharSetID
692    
693     13. Firebird Character set "NONE" now interpreted as codepage CP_ACP.
694    
695 tony 45 FBINTF Change Log version (1.0-0) Tue, 06 Dec 2016 10:33:47 +0000
696    
697     1. Initial Release
698    

Properties

Name Value
svn:eol-style native