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

Properties

Name Value
svn:eol-style native