ViewVC Help
View File | Revision Log | Show Annotations | Download File | View Changeset | Root Listing
root/public/ibx/trunk/fbintf/changelog
Revision: 410
Committed: Thu Jun 22 13:52:39 2023 UTC (17 months ago) by tony
File size: 35009 byte(s)
Log Message:
Release 2.6.0 beta

File Contents

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