ViewVC Help
View File | Revision Log | Show Annotations | Download File | View Changeset | Root Listing
root/public/ibx/trunk/fbintf/changelog
Revision: 308
Committed: Sat Jul 18 10:26:30 2020 UTC (3 years, 8 months ago) by tony
File size: 14145 byte(s)
Log Message:
Fixes Merged

File Contents

# Content
1 FBINTF Change Log version (1.1-6 Build 12214) Fri, 17 Jul 2020 23:10:11 +0100
2
3 1. GetImplementationVersion now correctly returns '3.0' for Firebird 3 API
4 with a Firebrid 3 client library.
5
6 2. Linux Only: FIREBIRD environment variable is now checked when loading the client library.
7 If a client library path is not explicitly provided and the FIREBIRD environment
8 variable is set then the directory given by this variable and any 'lib' subdirectory
9 are searched for the Firebird client library. Only if none is found, is the default
10 client library used.
11
12 3. IUtil.FormatStatus now used to format error messages when using new API
13
14 4. Fixed Array SDL: array_desc_scale now correctly encoded as a signed integer.
15
16 5. SQL_TEXT handling changed. When the value of an SQL_TEXT (i.e. fixed width string) column is
17 returned using GetAsString and the string codepage is UTF8, the string is truncated so
18 that the byte length corresponds to the number of characters specified for the column.
19 SQL_TEXT strings are no longer automatically trimmed to remove all trailing white space. This is
20 correct behaviour but may affect some implementations that relied upon automatic
21 trimming of trailing white space.
22
23 6. New IFirebirdAPI Calls:
24 function GetClientMajor: integer;
25 function GetClientMinor: integer;
26
27
28 FBINTF Change Log version (1.1-5 Build 12044) Fri, 17 Apr 2020 12:30:01 +0100
29
30 1. ISQLParams.GetHasCaseSensitiveParams added. Returns true if param names are
31 case sensitive
32
33 2. Single line SQL comments starting with '--' are now recognised by SQL Parser.
34
35 3. New API Calls:
36 IColumnMetaData.GetStatement
37 IColumnMetaData.GetTransaction
38 ISQLData.GetStrLength
39 IResults.GetStatement
40 IAttachment.OpenBlob (using Blob metadata)
41 IAttachment.OpenArray (using array metadata)
42
43 4. FBMessages: removal of unused messages
44
45 5. TFBArray.Create (2nd case): ensure that FFirebirdClientAPI is correctly set.
46
47 6. TIBSQLStatementType: SQLSavePoint added to end of enumeration.
48
49 FBINTF Change Log version (1.1-4 Build 11515) Fri, 28 Dec 2018 10:04:19 +0000
50
51 1. Fix a problem with the SQL parameter parser that failed to recognise parameters
52 where the second character of the parameter name is a numeric.
53
54 2. New method for IAttachment: procedure getFBVersion(version: TStrings);
55 This returns the isc_version connection information as one or more lines.
56 This is the same information as returned by isql with the -z option.
57
58 3. If -dFIREBIRD3APIONLY is used as a compiler option then the legacy Firebird API
59 is no longer compiled in. Likewise, if -dLEGACYFIREBIRDAPIONLY is used as a
60 compiler option then the Firebird 3 API is no longer compiled in.
61
62 4. IColumnMetaData: new method.
63
64 TIBDateTimeFormats = (dfTimestamp, {SQL TIMESTAMP}
65 dfDateTime, {SQL DATETIME}
66 dfTime);
67
68 function GetDateTimeStrLength(DateTimeFormat: TIBDateTimeFormats): integer;
69
70 This returns the max. number of characters returned by the "AsString" method
71 when the SQL type of the column is respectively TIMESTAMP, DATETIME or TIME.
72
73 5. Additional argument for IAttachment.PrepareWithNamedParameters -
74 CaseSensitiveParams: boolean = false
75
76 If this argument is set to true then SQL parameter names are assumed to be case
77 sensitive and must be referenced (using ISQLParams.ByName) using the case
78 sensitive name.
79
80 6. Bug fix: when setting a query parameter, it is now possible, when the parameter
81 is of type VarChar or Char to set the parameter to a numeric value (e.g. using
82 .AsCurrency) and then subsequently to update the value to a non-numeric string
83 using .AsString.
84
85
86
87 FBINTF Change Log version (1.1-3) Wed, 05 Dec 2018 14:28:10 +0000
88
89 1. DARWIN only syntax error: fix missing semi-colon in TFBClientAPI.LoadIBLibrary
90
91 2. Restrict IsMultiThread check to Unix only for compatibility with
92 https://bugs.freepascal.org/view.php?id=30535
93
94 3. New SQL Tokeniser added to IBUtils. This is used to pre-process SQL with
95 named parameters and is intended to avoid problems with (e.g.) Execute Block
96 and processing internal parameters as statement parameters.
97
98 4. New interface IFirebirdLibrary provides access to the underlying firebird DLL
99 or shared object. Available via a new member (GetFBLibrary) of IFirebirdAPI.
100
101 5. New function added to IB.pas
102
103 function LoadFBLibrary(aLibPathName: string): IFirebirdLibrary
104
105 This allows a Firebird Library to be loaded from an explicit path. use the
106 IFirebirdLibrary.GetFirebirdAPI member function to get the Firebird API using
107 the library. It is possible to load Firebird libraries from different locations
108 simultaneously, each with a distinct IFirebirdAPI.
109
110 FBINTF Change Log version (1.1-2) Mon, 16 Apr 2018 09:30:32 +0100
111
112 1. Firebird.pas: {$OBJECTCHECKS OFF} added to file to avoid runtime error when
113 program compiled with -CR command line switch.
114
115 2. IServiceManager additions (informational):
116 function getProtocol: TProtocol;
117 function getPortNo: AnsiString;
118
119 3. IServiceManager improved error handling. Interfaces changed:
120 function Start(Request: ISRB; RaiseExceptionOnError: boolean=true): boolean;
121 function Query(SQPB: ISQPB; Request: ISRB; RaiseExceptionOnError: boolean=true) :IServiceQueryResults; overload;
122 function Query(Request: ISRB; RaiseExceptionOnError: boolean=true) :IServiceQueryResults; overload;
123
124 4. IAttachment addition (informational)
125 function GetSecurityDatabase: AnsiString;
126
127 5. IStatement: performance counters now updated after each Fetch. GetPerfStatistics
128 thus now returns accumulated stats for a select statement from opening a cursor
129 up to the last fetch.
130
131 6. DARWIN: uloadlibrary.inc bug fix. Many thanks to Luigi Naimi for correcting
132 the problem.
133
134 7. Type change: "TPerfCounters = array[TPerfStats] of Int64". Note "Int64"
135 replaces deprecated "comp" type.
136
137 10. Testsuite Test10 updated to include thread synchronisation for event reporting.
138
139 11. URL Connection Strings: inet4 and inet6 now recognised.
140
141 12. IBUtils: Parse and Make Connect String now recognise URL style loopback syntax.
142
143 13. IAttachment.CharSetName2CharSetID is now performed case insensitive.
144
145
146 FBINTF Change Log version (1.1-1) Tue, 27 Feb 2018 16:51:16 +0000
147
148 1. IBUtils.QuoteIdentifierIfNeeded: Add check for space character.
149
150 2. IAttachment: add two new methods
151 function HasDefaultCharSet: boolean;
152 function GetDefaultCharSetID: integer;
153
154 These return, respectively, true if a connection default character set was
155 specified and the character set id of the connection default character set.
156 The DefaultCharSetID is cached when the connection is opened and hence does not
157 require a database lookup.
158
159 3. Avoid exception when a text blob is a stored procedure parameter.
160
161 4. Update test suite to include a test for a stored proc returning a text blob.
162
163 5. IAttachment: add
164 function GetRemoteProtocol: AnsiString;
165 function GetODSMajorVersion: integer;
166 function GetODSMinorVersion: integer;
167 function GetAuthenticationMethod: AnsiString;
168
169 These results are cached when the connection is opened and hence do not
170 require a database lookup.
171
172 6. IAttachment: add "function GetConnectString: AnsiString;" This returns the
173 connect string used to create/connect to the database.
174
175 7. IAttachment: Create Database using SQL statement. The username and password
176 are now extracted and used to populate a DPB made available via IAttachment.getDPB.
177 It is now possible to use IAttachment disconnect/connect to reconnect to
178 a database for which the initial connection was established by a create
179 database sql statement. Available in FPC only.
180
181 8. Update Test 1 to test 5, 6 and 7 above.
182
183 9. IBUtils code tidy up.
184
185 10. Parameter Block interfaces "find" method. As documented, this should have
186 returned a nil interface when the item could not be found. Instead, an empty
187 interface item was returned. "Find" now works as documented and will return
188 a nil interface if the item cannot be found.
189
190 11. DBInformation: support added for isc_info_active_tran_count and isc_info_creation_date.
191
192 12. DBInformation: New interfaces: IDIRB and IDIRBItem added to support DB Information
193 requests with additional parameters. This is to enable support for fb_info_page_contents
194 (return of page contents). Response to fb_info_page_contents returned as
195 a string with code page CP_NONE.
196
197 13. DBInformation: Support for fb_info_pages_used and fb_info_pages_free added, plus
198 test suite updated.
199
200 14. DBInformation: Support for fb_info_crypt_key (Firebird 3.0.3 onwards) added as
201 a string type, and fb_info_conn_flags (Firebird 3.0.3 onwards) added as an integer type.
202
203 15. Service Manager: List of protocols supported expanded to include inet, wnet and xnet.
204 An overloaded version of IIFirebirdAPI.GetServiceManager also allows a non
205 default connection port to be specified.
206
207 FBINTF Change Log version (1.1-0) Sun, 07 Jan 2018 15:20:02 +0000
208
209 1. Fix issues with setting SQL Param values using SetAsString with Numeric types.
210 Scale is no longer ignored.
211
212 2. Fix issues with setting SQL Param values using SetAsString with Date values
213 not in locale format but which are recognised by Firebird. Date values that
214 cannot be converted to a string using Pascal library are now passed through
215 to Firebird as Text Strings.
216
217 3. Lookup character set name by codepage amended to ensure that CP_UTF8 returns
218 UTF8 and not UNICODE_FSS.
219
220 4. Charset ID problem. When using Firebird 3, with no default database character set
221 and a column has a non-default collation specified, an incorrect character set
222 id was being reported that could result in a 'division by zero' error when
223 used by IBX. This has now been fixed.
224
225 5. Move GetCharsetName, CharSetID2CodePage, CodePage2CharSetID, CharSetName2CharSetID,
226 CharSetWidth from IFirebirdAPI to IAttachment. This is a better data model as
227 the character sets supported can be updated on a per database basis. That is
228 it is possible to add a (Firebird) user defined character set to a database.
229
230 6. Add RegisterCharSet to IAttachment. This is used to register a user defined character
231 set supported by Firebird with the API.
232
233 7. Add missing isc_info_db_read_only to list of decoded Database Information items
234 in FBOutputBlock.pas and update test suite to include this item.
235
236 8. FB30Client: avoid always using "StartMultiple" when only a single database attachment.
237
238 9. Loading Windows fbclient.dll: when using the FIREBIRD variable to locate the client
239 library or finding it by disk location, the PATH environment variable is now also set to
240 include the FIREBIRD directory. This is to ensure that the correct dlls in the
241 firebird client library dependencies are loaded.
242
243 10. Testsuite: Ensure consistent UTF-8 output on Windows console.
244
245 11. Testsuite: Update Windows script to include FPC 3.0.4 in search path.
246
247 12. FB30Statement: Protect call to "Move" and avoid calling with a nil pointer
248
249 13. FB30Statement: A check has been added to ensure that all SQL Parameters
250 have been given a value (including NULL). Previously, failing to set the
251 value of an SQL Parameter could give rise to unpredictable results or
252 an SQLDA error.
253
254 14. FB30Statement/FB25Statement: Set SQLParam "modified" when string value set.
255
256 15. FBAttachment: Avoid string reference count error when processing an Ansistring
257 parameter in an array of const passed to IAttachment.OpenCursor, etc.
258
259 16. FBAttachment: Allow for WideString and UnicodeString parameters in an array
260 of const passed to IAttachment.OpenCursor, etc.
261
262
263 FBINTF Change Log version (1.0-2) Sat, 04 Mar 2017 14:43:56 +0000
264
265 1. Change syntax to Mode Delphi
266
267 2. Change all uses of string type to explicit AnsiString in order to ensure
268 compatibility between Delphi and FPC.
269
270 3. Various syntax changes to ensure Delphi and FPC compilation including GUIDs
271 defined for each interface.
272
273 4. Generics syntax variations for Delphi added
274
275 5. PChar replaced with PByte expect where an actual string is being referenced,
276 where PAnsiChar is used instead.
277
278 6. Review of type definitions in IBExternals to ensure Delphi compatibility
279
280 7. Testsuite updated for Delphi
281
282 FBINTF Change Log version (1.0-1) Fri, 24 Feb 2017 12:17:57 +0000
283
284 1. Limit maximum Blob segment read/write to MaxuShort. Avoids data loss with
285 large blobs and the FB3 API.
286
287 2. Update Event Handling algorithm to avoid looping due to recreation of the
288 event block.
289
290 3. Avoid invalid XSQLDA error when the only parameter is updated to null
291
292 4. Array Handling: fix problem with text arrays with character set none. When the
293 DB connection has a default character set (e.g. UTF8), an error is raised by
294 Firebird if the space allocated is not enough to allow for transliteration, even
295 though it is not required for character set none.
296
297 5. IBUtils: List of reserved words brought up-to-date
298
299 6. Add ISQL style performance statistics collection to IStatement
300
301 7. Add IFirebirdAPI.CreateDatabase variant to allow execution of user provided
302 CREATE DATABASE statement.
303
304 8. Update SQL Statement parsing to allow for Array Dimensions. That is so that the ':' in
305 an array dimension is not mistaken for a named parameter prefix.
306
307 9. Trim function no longer applied to result of GetAsString for SQL_TEXT
308 when Character set is octets. Avoids loss of non printable characters at start of string.
309
310 10. Add function GetPerfStatistics to IStatement. This returns ISQL like performance
311 statistics for the last action. Requires use of procedure IStatement.EnableStatistics
312 to enable stats gathering.
313
314 11. API Version information added as constants to IB.pas
315
316 12. BlobMetaData character set id should now be the same as that given by IColumnMetaData.GetCharSetID
317
318 13. Firebird Character set "NONE" now interpreted as codepage CP_ACP.
319
320 FBINTF Change Log version (1.0-0) Tue, 06 Dec 2016 10:33:47 +0000
321
322 1. Initial Release
323