ViewVC Help
View File | Revision Log | Show Annotations | Download File | View Changeset | Root Listing
root/public/ibx/trunk/fbintf/changelog
Revision: 280
Committed: Tue Feb 5 09:46:35 2019 UTC (5 years, 1 month ago) by tony
File size: 12112 byte(s)
Log Message:
Fixes merged

File Contents

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