ViewVC Help
View File | Revision Log | Show Annotations | Download File | View Changeset | Root Listing
root/public/ibx/branches/udr/changelog
Revision: 377
Committed: Mon Jan 10 09:55:56 2022 UTC (2 years, 10 months ago) by tony
File size: 33299 byte(s)
Log Message:

File Contents

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