ViewVC Help
View File | Revision Log | Show Annotations | Download File | View Changeset | Root Listing
root/public/ibx/trunk/fbintf/changelog
Revision: 419
Committed: Sat Aug 5 12:42:00 2023 UTC (15 months, 3 weeks ago) by tony
File size: 35211 byte(s)
Log Message:
Fixes Merged

File Contents

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