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