[ViewVC] Annotation of: public/ibx/trunk/fbintf/changelog

FBINTF Change Log  version                                               (1.1-1) Sat, 24 Feb 2018 23:12:18 +0000

1. IBUtils.QuoteIdentifierIfNeeded: Add check for space character.

2. IAttachment: add two new methods
     function HasDefaultCharSet: boolean;
     function GetDefaultCharSetID: integer;

   These return, respectively, true if a connection default character set was
   specified and the character set id of the connection default character set.
   The DefaultCharSetID is cached when the connection is opened and hence does not
   require a database lookup.

3. Avoid exception when a text blob is a stored procedure parameter.

4. Update test suite to include a test for a stored proc returning a text blob.

5. IAttachment: add
      function GetRemoteProtocol: AnsiString;
      function GetODSMajorVersion: integer;
      function GetODSMinorVersion: integer;
      function GetAuthenticationMethod: AnsiString;

   These results are cached when the connection is opened and hence do not
   require a database lookup.

6. IAttachment: add "function GetConnectString: AnsiString;" This returns the
   connect string used to create/connect to the database.

7. IAttachment: Create Database using SQL statement. The username and password
   are now extracted and used to populate a DPB made available via IAttachment.getDPB.
   It is now possible to use IAttachment disconnect/connect to reconnect to
   a database for which the initial connection was established by a create
   database sql statement. Available in FPC only.

8. Update Test 1 to test 5, 6 and 7 above.

9. IBUtils code tidy up.

10. Parameter Block interfaces "find" method. As documented, this should have
   returned a nil interface when the item could not be found. Instead, an empty
   interface item was returned. "Find" now works as documented and will return
   a nil interface if the item cannot be found.

11. DBInformation: support added for isc_info_active_tran_count and isc_info_creation_date.

12. DBInformation: New interfaces: IDIRB and IDIRBItem added to support DB Information
    requests with additional parameters. This is to enable support for fb_info_page_contents
    (return of page contents). Response to fb_info_page_contents returned as
    a string with code page CP_NONE.

13. DBInformation: Support for fb_info_pages_used and fb_info_pages_free added, plus
    test suite updated.

14. DBInformation: Support for fb_info_crypt_key (Firebird 3.0.3 onwards) added as
    a string type, and fb_info_conn_flags (Firebird 3.0.3 onwards) added as an integer type.

15. Service Manager: List of protocols supported expanded to include inet, wnet and xnet.
    An overloaded version of IIFirebirdAPI.GetServiceManager also allows a non
    default connection port to be specified.

FBINTF Change Log  version                             (1.1-0) Sun, 07 Jan 2018 15:20:02 +0000

1. Fix issues with setting SQL Param values using SetAsString with Numeric types.
   Scale is no longer ignored.

2. Fix issues with setting SQL Param values using SetAsString with Date values
   not in locale format but which are recognised by Firebird. Date values that
   cannot be converted to a string using Pascal library are now passed through
   to Firebird as Text Strings.

3. Lookup character set name by codepage amended to ensure that CP_UTF8 returns
   UTF8 and not UNICODE_FSS.

4. Charset ID problem. When using Firebird 3, with no default database character set
   and a column has a non-default collation specified, an incorrect character set
   id was being reported that could result in a 'division by zero' error when
   used by IBX. This has now been fixed.

5. Move GetCharsetName, CharSetID2CodePage, CodePage2CharSetID, CharSetName2CharSetID,
   CharSetWidth from IFirebirdAPI to IAttachment. This is a better data model as
   the character sets supported can be updated on a per database basis. That is
   it is possible to add a (Firebird) user defined character set to a database.

6. Add RegisterCharSet to IAttachment. This is used to register a user defined character
   set supported by Firebird with the API.

7. Add missing isc_info_db_read_only to list of decoded Database Information items
   in FBOutputBlock.pas and update test suite to include this item.

8. FB30Client: avoid always using "StartMultiple" when only a single database attachment.

9. Loading Windows fbclient.dll: when using the FIREBIRD variable to locate the client
   library or finding it by disk location, the PATH environment variable is now also set to
   include the FIREBIRD directory. This is to ensure that the correct dlls in the
   firebird client library dependencies are loaded.

10. Testsuite: Ensure consistent UTF-8 output on Windows console.

11. Testsuite: Update Windows script to include FPC 3.0.4 in search path.

12. FB30Statement: Protect call to "Move" and avoid calling with a nil pointer

13. FB30Statement: A check has been added to ensure that all SQL Parameters
    have been given a value (including NULL). Previously, failing to set the
    value of an SQL Parameter could give rise to unpredictable results or
    an SQLDA error.

14. FB30Statement/FB25Statement: Set SQLParam "modified" when string value set.

15. FBAttachment: Avoid string reference count error when processing an Ansistring
    parameter in an array of const passed to IAttachment.OpenCursor, etc.

16. FBAttachment: Allow for WideString and UnicodeString parameters in an array
    of const passed to IAttachment.OpenCursor, etc.


FBINTF Change Log  version             (1.0-2) Sat, 04 Mar 2017 14:43:56 +0000

1. Change syntax to Mode Delphi

2. Change all uses of string type to explicit AnsiString in order to ensure
   compatibility between Delphi and FPC. 

3. Various syntax changes to ensure Delphi and FPC compilation including GUIDs
   defined for each interface.

4. Generics syntax variations for Delphi added

5. PChar replaced with PByte expect where an actual string is being referenced,
   where PAnsiChar is used instead.

6. Review of type definitions in IBExternals to ensure Delphi compatibility

7. Testsuite updated for Delphi

FBINTF Change Log  version            (1.0-1) Fri, 24 Feb 2017 12:17:57 +0000

1. Limit maximum Blob segment read/write to MaxuShort. Avoids data loss with
   large blobs and the FB3 API.

2. Update Event Handling algorithm to avoid looping due to recreation of the
   event block.

3. Avoid invalid XSQLDA error when the only parameter is updated to null

4. Array Handling: fix problem with text arrays with character set none. When the
   DB connection has a default character set (e.g. UTF8), an error is raised by
   Firebird if the space allocated is not enough to allow for transliteration, even
   though it is not required for character set none.

5. IBUtils: List of reserved words brought up-to-date

6. Add ISQL style performance statistics collection to IStatement

7. Add IFirebirdAPI.CreateDatabase variant to allow execution of user provided
   CREATE DATABASE statement.

8. Update SQL Statement parsing to allow for Array Dimensions. That is so that the ':' in
   an array dimension is not mistaken for a named parameter prefix.

9. Trim function no longer applied to result of GetAsString for SQL_TEXT
   when Character set is octets. Avoids loss of non printable characters at start of string.

10. Add function GetPerfStatistics to IStatement. This returns ISQL like performance
    statistics for the last action. Requires use of procedure IStatement.EnableStatistics
    to enable stats gathering.

11. API Version information added as constants to IB.pas

12. BlobMetaData character set id should now be the same as that given by IColumnMetaData.GetCharSetID

13. Firebird Character set "NONE" now interpreted as codepage CP_ACP.

FBINTF Change Log  version                                      (1.0-0) Tue, 06 Dec 2016 10:33:47 +0000

1. Initial Release

Revision:	147
Committed:	Mon Feb 26 11:14:30 2018 UTC (6 years, 8 months ago) by tony
File size:	7928 byte(s)
Log Message:	Fixes merged
#	User	Rev	Content
1	tony	147	FBINTF Change Log version (1.1-1) Sat, 24 Feb 2018 23:12:18 +0000
2	tony	59
3	tony	107	1. IBUtils.QuoteIdentifierIfNeeded: Add check for space character.
4
5	tony	109	2. IAttachment: add two new methods
6			function HasDefaultCharSet: boolean;
7			function GetDefaultCharSetID: integer;
8
9			These return, respectively, true if a connection default character set was
10	tony	117	specified and the character set id of the connection default character set.
11			The DefaultCharSetID is cached when the connection is opened and hence does not
12			require a database lookup.
13	tony	109
14	tony	110	3. Avoid exception when a text blob is a stored procedure parameter.
15	tony	109
16	tony	111	4. Update test suite to include a test for a stored proc returning a text blob.
17
18	tony	117	5. IAttachment: add
19			function GetRemoteProtocol: AnsiString;
20			function GetODSMajorVersion: integer;
21			function GetODSMinorVersion: integer;
22	tony	143	function GetAuthenticationMethod: AnsiString;
23	tony	117
24			These results are cached when the connection is opened and hence do not
25			require a database lookup.
26
27			6. IAttachment: add "function GetConnectString: AnsiString;" This returns the
28			connect string used to create/connect to the database.
29
30			7. IAttachment: Create Database using SQL statement. The username and password
31			are now extracted and used to populate a DPB made available via IAttachment.getDPB.
32			It is now possible to use IAttachment disconnect/connect to reconnect to
33			a database for which the initial connection was established by a create
34	tony	120	database sql statement. Available in FPC only.
35	tony	117
36			8. Update Test 1 to test 5, 6 and 7 above.
37
38			9. IBUtils code tidy up.
39
40	tony	143	10. Parameter Block interfaces "find" method. As documented, this should have
41			returned a nil interface when the item could not be found. Instead, an empty
42			interface item was returned. "Find" now works as documented and will return
43			a nil interface if the item cannot be found.
44
45			11. DBInformation: support added for isc_info_active_tran_count and isc_info_creation_date.
46
47			12. DBInformation: New interfaces: IDIRB and IDIRBItem added to support DB Information
48			requests with additional parameters. This is to enable support for fb_info_page_contents
49			(return of page contents). Response to fb_info_page_contents returned as
50			a string with code page CP_NONE.
51
52			13. DBInformation: Support for fb_info_pages_used and fb_info_pages_free added, plus
53			test suite updated.
54
55			14. DBInformation: Support for fb_info_crypt_key (Firebird 3.0.3 onwards) added as
56			a string type, and fb_info_conn_flags (Firebird 3.0.3 onwards) added as an integer type.
57
58			15. Service Manager: List of protocols supported expanded to include inet, wnet and xnet.
59			An overloaded version of IIFirebirdAPI.GetServiceManager also allows a non
60			default connection port to be specified.
61
62	tony	107	FBINTF Change Log version (1.1-0) Sun, 07 Jan 2018 15:20:02 +0000
63
64	tony	59	1. Fix issues with setting SQL Param values using SetAsString with Numeric types.
65			Scale is no longer ignored.
66
67			2. Fix issues with setting SQL Param values using SetAsString with Date values
68			not in locale format but which are recognised by Firebird. Date values that
69			cannot be converted to a string using Pascal library are now passed through
70			to Firebird as Text Strings.
71
72	tony	60	3. Lookup character set name by codepage amended to ensure that CP_UTF8 returns
73			UTF8 and not UNICODE_FSS.
74
75			4. Charset ID problem. When using Firebird 3, with no default database character set
76			and a column has a non-default collation specified, an incorrect character set
77			id was being reported that could result in a 'division by zero' error when
78			used by IBX. This has now been fixed.
79
80			5. Move GetCharsetName, CharSetID2CodePage, CodePage2CharSetID, CharSetName2CharSetID,
81			CharSetWidth from IFirebirdAPI to IAttachment. This is a better data model as
82			the character sets supported can be updated on a per database basis. That is
83			it is possible to add a (Firebird) user defined character set to a database.
84
85			6. Add RegisterCharSet to IAttachment. This is used to register a user defined character
86			set supported by Firebird with the API.
87
88	tony	61	7. Add missing isc_info_db_read_only to list of decoded Database Information items
89			in FBOutputBlock.pas and update test suite to include this item.
90	tony	60
91	tony	63	8. FB30Client: avoid always using "StartMultiple" when only a single database attachment.
92	tony	61
93	tony	68	9. Loading Windows fbclient.dll: when using the FIREBIRD variable to locate the client
94			library or finding it by disk location, the PATH environment variable is now also set to
95			include the FIREBIRD directory. This is to ensure that the correct dlls in the
96			firebird client library dependencies are loaded.
97	tony	63
98	tony	68	10. Testsuite: Ensure consistent UTF-8 output on Windows console.
99
100			11. Testsuite: Update Windows script to include FPC 3.0.4 in search path.
101
102			12. FB30Statement: Protect call to "Move" and avoid calling with a nil pointer
103
104			13. FB30Statement: A check has been added to ensure that all SQL Parameters
105			have been given a value (including NULL). Previously, failing to set the
106			value of an SQL Parameter could give rise to unpredictable results or
107			an SQLDA error.
108
109			14. FB30Statement/FB25Statement: Set SQLParam "modified" when string value set.
110
111	tony	70	15. FBAttachment: Avoid string reference count error when processing an Ansistring
112			parameter in an array of const passed to IAttachment.OpenCursor, etc.
113	tony	68
114	tony	70	16. FBAttachment: Allow for WideString and UnicodeString parameters in an array
115			of const passed to IAttachment.OpenCursor, etc.
116
117
118	tony	56	FBINTF Change Log version (1.0-2) Sat, 04 Mar 2017 14:43:56 +0000
119	tony	47
120	tony	56	1. Change syntax to Mode Delphi
121
122			2. Change all uses of string type to explicit AnsiString in order to ensure
123			compatibility between Delphi and FPC.
124
125			3. Various syntax changes to ensure Delphi and FPC compilation including GUIDs
126			defined for each interface.
127
128			4. Generics syntax variations for Delphi added
129
130			5. PChar replaced with PByte expect where an actual string is being referenced,
131			where PAnsiChar is used instead.
132
133			6. Review of type definitions in IBExternals to ensure Delphi compatibility
134
135			7. Testsuite updated for Delphi
136
137			FBINTF Change Log version (1.0-1) Fri, 24 Feb 2017 12:17:57 +0000
138
139	tony	47	1. Limit maximum Blob segment read/write to MaxuShort. Avoids data loss with
140			large blobs and the FB3 API.
141
142			2. Update Event Handling algorithm to avoid looping due to recreation of the
143			event block.
144
145			3. Avoid invalid XSQLDA error when the only parameter is updated to null
146
147			4. Array Handling: fix problem with text arrays with character set none. When the
148			DB connection has a default character set (e.g. UTF8), an error is raised by
149			Firebird if the space allocated is not enough to allow for transliteration, even
150			though it is not required for character set none.
151
152			5. IBUtils: List of reserved words brought up-to-date
153
154			6. Add ISQL style performance statistics collection to IStatement
155
156			7. Add IFirebirdAPI.CreateDatabase variant to allow execution of user provided
157			CREATE DATABASE statement.
158
159			8. Update SQL Statement parsing to allow for Array Dimensions. That is so that the ':' in
160			an array dimension is not mistaken for a named parameter prefix.
161
162			9. Trim function no longer applied to result of GetAsString for SQL_TEXT
163			when Character set is octets. Avoids loss of non printable characters at start of string.
164
165			10. Add function GetPerfStatistics to IStatement. This returns ISQL like performance
166			statistics for the last action. Requires use of procedure IStatement.EnableStatistics
167			to enable stats gathering.
168
169			11. API Version information added as constants to IB.pas
170
171			12. BlobMetaData character set id should now be the same as that given by IColumnMetaData.GetCharSetID
172
173			13. Firebird Character set "NONE" now interpreted as codepage CP_ACP.
174
175	tony	45	FBINTF Change Log version (1.0-0) Tue, 06 Dec 2016 10:33:47 +0000
176
177			1. Initial Release
178