ViewVC Help
View File | Revision Log | Show Annotations | Download File | View Changeset | Root Listing
root/public/ibx/trunk/changelog
Revision: 303
Committed: Fri Jul 17 22:29:57 2020 UTC (3 years, 9 months ago) by tony
File size: 14145 byte(s)
Log Message:
Fixes Merged

File Contents

# User Rev Content
1 tony 303 FBINTF Change Log version (1.1-6 Build 12214) Fri, 17 Jul 2020 23:10:11 +0100
2 tony 287
3 tony 303 1. GetImplementationVersion now correctly returns '3.0' for Firebird 3 API
4     with a Firebrid 3 client library.
5 tony 287
6 tony 303 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 tony 287
12 tony 303 3. IUtil.FormatStatus now used to format error messages when using new API
13 tony 291
14 tony 303 4. Fixed Array SDL: array_desc_scale now correctly encoded as a signed integer.
15 tony 291
16 tony 303 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 tony 291
23 tony 303 6. New IFirebirdAPI Calls:
24     function GetClientMajor: integer;
25     function GetClientMinor: integer;
26 tony 291
27    
28 tony 303 FBINTF Change Log version (1.1-5 Build 12044) Fri, 17 Apr 2020 12:30:01 +0100
29 tony 266
30 tony 303 1. ISQLParams.GetHasCaseSensitiveParams added. Returns true if param names are
31     case sensitive
32 tony 272
33 tony 303 2. Single line SQL comments starting with '--' are now recognised by SQL Parser.
34 tony 266
35 tony 303 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 tony 266
43 tony 303 4. FBMessages: removal of unused messages
44 tony 263
45 tony 303 5. TFBArray.Create (2nd case): ensure that FFirebirdClientAPI is correctly set.
46 tony 267
47 tony 303 6. TIBSQLStatementType: SQLSavePoint added to end of enumeration.
48 tony 270
49 tony 303 FBINTF Change Log version (1.1-4 Build 11515) Fri, 28 Dec 2018 10:04:19 +0000
50 tony 270
51 tony 303 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 tony 270
54 tony 303 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 tony 270
58 tony 303 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 tony 270
62 tony 303 4. IColumnMetaData: new method.
63 tony 270
64 tony 303 TIBDateTimeFormats = (dfTimestamp, {SQL TIMESTAMP}
65     dfDateTime, {SQL DATETIME}
66     dfTime);
67 tony 270
68 tony 303 function GetDateTimeStrLength(DateTimeFormat: TIBDateTimeFormats): integer;
69 tony 270
70 tony 303 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 tony 270
73 tony 303 5. Additional argument for IAttachment.PrepareWithNamedParameters -
74     CaseSensitiveParams: boolean = false
75 tony 270
76 tony 303 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 tony 270
80 tony 303 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 tony 270
85    
86    
87 tony 303 FBINTF Change Log version (1.1-3) Wed, 05 Dec 2018 14:28:10 +0000
88 tony 271
89 tony 303 1. DARWIN only syntax error: fix missing semi-colon in TFBClientAPI.LoadIBLibrary
90 tony 272
91 tony 303 2. Restrict IsMultiThread check to Unix only for compatibility with
92     https://bugs.freepascal.org/view.php?id=30535
93 tony 272
94 tony 303 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 tony 272
98 tony 303 4. New interface IFirebirdLibrary provides access to the underlying firebird DLL
99     or shared object. Available via a new member (GetFBLibrary) of IFirebirdAPI.
100 tony 272
101 tony 303 5. New function added to IB.pas
102 tony 272
103 tony 303 function LoadFBLibrary(aLibPathName: string): IFirebirdLibrary
104 tony 272
105 tony 303 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 tony 272
110 tony 303 FBINTF Change Log version (1.1-2) Mon, 16 Apr 2018 09:30:32 +0100
111 tony 272
112 tony 303 1. Firebird.pas: {$OBJECTCHECKS OFF} added to file to avoid runtime error when
113     program compiled with -CR command line switch.
114 tony 272
115 tony 303 2. IServiceManager additions (informational):
116     function getProtocol: TProtocol;
117     function getPortNo: AnsiString;
118 tony 272
119 tony 303 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 tony 272
124 tony 303 4. IAttachment addition (informational)
125     function GetSecurityDatabase: AnsiString;
126 tony 267
127 tony 303 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 tony 263
131 tony 303 6. DARWIN: uloadlibrary.inc bug fix. Many thanks to Luigi Naimi for correcting
132     the problem.
133 tony 263
134 tony 303 7. Type change: "TPerfCounters = array[TPerfStats] of Int64". Note "Int64"
135     replaces deprecated "comp" type.
136 tony 263
137 tony 303 10. Testsuite Test10 updated to include thread synchronisation for event reporting.
138 tony 263
139 tony 303 11. URL Connection Strings: inet4 and inet6 now recognised.
140 tony 263
141 tony 303 12. IBUtils: Parse and Make Connect String now recognise URL style loopback syntax.
142 tony 263
143 tony 303 13. IAttachment.CharSetName2CharSetID is now performed case insensitive.
144 tony 263
145    
146 tony 303 FBINTF Change Log version (1.1-1) Tue, 27 Feb 2018 16:51:16 +0000
147 tony 263
148 tony 303 1. IBUtils.QuoteIdentifierIfNeeded: Add check for space character.
149 tony 263
150 tony 303 2. IAttachment: add two new methods
151     function HasDefaultCharSet: boolean;
152     function GetDefaultCharSetID: integer;
153 tony 263
154 tony 303 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 tony 263
159 tony 303 3. Avoid exception when a text blob is a stored procedure parameter.
160 tony 241
161 tony 303 4. Update test suite to include a test for a stored proc returning a text blob.
162 tony 241
163 tony 303 5. IAttachment: add
164     function GetRemoteProtocol: AnsiString;
165     function GetODSMajorVersion: integer;
166     function GetODSMinorVersion: integer;
167     function GetAuthenticationMethod: AnsiString;
168 tony 101
169 tony 303 These results are cached when the connection is opened and hence do not
170     require a database lookup.
171 tony 209
172 tony 303 6. IAttachment: add "function GetConnectString: AnsiString;" This returns the
173     connect string used to create/connect to the database.
174 tony 209
175 tony 303 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 tony 209
181 tony 303 8. Update Test 1 to test 5, 6 and 7 above.
182 tony 209
183 tony 303 9. IBUtils code tidy up.
184 tony 209
185 tony 303 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 tony 209
190 tony 303 11. DBInformation: support added for isc_info_active_tran_count and isc_info_creation_date.
191 tony 209
192 tony 303 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 tony 209
197 tony 303 13. DBInformation: Support for fb_info_pages_used and fb_info_pages_free added, plus
198     test suite updated.
199 tony 209
200 tony 303 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 tony 209
203 tony 303 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 tony 209
207 tony 303 FBINTF Change Log version (1.1-0) Sun, 07 Jan 2018 15:20:02 +0000
208 tony 209
209 tony 303 1. Fix issues with setting SQL Param values using SetAsString with Numeric types.
210     Scale is no longer ignored.
211 tony 209
212 tony 303 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 tony 209
217 tony 303 3. Lookup character set name by codepage amended to ensure that CP_UTF8 returns
218     UTF8 and not UNICODE_FSS.
219 tony 209
220 tony 303 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 tony 209
225 tony 303 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 tony 209
230 tony 303 6. Add RegisterCharSet to IAttachment. This is used to register a user defined character
231     set supported by Firebird with the API.
232 tony 209
233 tony 303 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 tony 209
236 tony 303 8. FB30Client: avoid always using "StartMultiple" when only a single database attachment.
237 tony 209
238 tony 303 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 tony 209
243 tony 303 10. Testsuite: Ensure consistent UTF-8 output on Windows console.
244 tony 209
245 tony 303 11. Testsuite: Update Windows script to include FPC 3.0.4 in search path.
246 tony 209
247 tony 303 12. FB30Statement: Protect call to "Move" and avoid calling with a nil pointer
248 tony 209
249 tony 303 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 tony 221
254 tony 303 14. FB30Statement/FB25Statement: Set SQLParam "modified" when string value set.
255 tony 221
256 tony 303 15. FBAttachment: Avoid string reference count error when processing an Ansistring
257     parameter in an array of const passed to IAttachment.OpenCursor, etc.
258 tony 221
259 tony 303 16. FBAttachment: Allow for WideString and UnicodeString parameters in an array
260     of const passed to IAttachment.OpenCursor, etc.
261 tony 225
262    
263 tony 303 FBINTF Change Log version (1.0-2) Sat, 04 Mar 2017 14:43:56 +0000
264 tony 225
265 tony 303 1. Change syntax to Mode Delphi
266 tony 225
267 tony 303 2. Change all uses of string type to explicit AnsiString in order to ensure
268     compatibility between Delphi and FPC.
269 tony 226
270 tony 303 3. Various syntax changes to ensure Delphi and FPC compilation including GUIDs
271     defined for each interface.
272 tony 227
273 tony 303 4. Generics syntax variations for Delphi added
274 tony 229
275 tony 303 5. PChar replaced with PByte expect where an actual string is being referenced,
276     where PAnsiChar is used instead.
277 tony 229
278 tony 303 6. Review of type definitions in IBExternals to ensure Delphi compatibility
279 tony 229
280 tony 303 7. Testsuite updated for Delphi
281 tony 229
282 tony 303 FBINTF Change Log version (1.0-1) Fri, 24 Feb 2017 12:17:57 +0000
283 tony 229
284 tony 303 1. Limit maximum Blob segment read/write to MaxuShort. Avoids data loss with
285     large blobs and the FB3 API.
286 tony 229
287 tony 303 2. Update Event Handling algorithm to avoid looping due to recreation of the
288     event block.
289 tony 231
290 tony 303 3. Avoid invalid XSQLDA error when the only parameter is updated to null
291 tony 209
292 tony 303 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 tony 151
297 tony 303 5. IBUtils: List of reserved words brought up-to-date
298 tony 151
299 tony 303 6. Add ISQL style performance statistics collection to IStatement
300 tony 101
301 tony 303 7. Add IFirebirdAPI.CreateDatabase variant to allow execution of user provided
302     CREATE DATABASE statement.
303 tony 101
304 tony 303 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 tony 107
307 tony 303 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 tony 107
310 tony 303 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 tony 118
314 tony 303 11. API Version information added as constants to IB.pas
315 tony 107
316 tony 303 12. BlobMetaData character set id should now be the same as that given by IColumnMetaData.GetCharSetID
317 tony 107
318 tony 303 13. Firebird Character set "NONE" now interpreted as codepage CP_ACP.
319 tony 101
320 tony 303 FBINTF Change Log version (1.0-0) Tue, 06 Dec 2016 10:33:47 +0000
321 tony 104
322 tony 303 1. Initial Release
323 tony 104