summaryrefslogtreecommitdiff
path: root/offapi/com/sun
diff options
context:
space:
mode:
authorAndrzej J.R. Hunt <andrzej@ahunt.org>2013-09-12 09:05:50 +0100
committerFridrich Strba <fridrich@documentfoundation.org>2013-09-12 17:25:55 +0000
commita042cdd7eff15ed5f6cbd613588b3fca9509a85e (patch)
treea7083720a33a5f693bb98ae5058e3891b7903845 /offapi/com/sun
parent08e4d51f04734b952f42e3c334920dfd859bba02 (diff)
Update XColumnLocate to specify SQLException for invalid column.
This is to reflect the JDBC specification where invalid column names result in an SQLException. (The drivers within LibreOffice are being updated to reflect this new specification.) Change-Id: I76cdf9d5d15d55b534b28219b541ff9190365f9d Reviewed-on: https://gerrit.libreoffice.org/5921 Reviewed-by: Fridrich Strba <fridrich@documentfoundation.org> Tested-by: Fridrich Strba <fridrich@documentfoundation.org>
Diffstat (limited to 'offapi/com/sun')
-rw-r--r--offapi/com/sun/star/sdbc/XColumnLocate.idl12
1 files changed, 11 insertions, 1 deletions
diff --git a/offapi/com/sun/star/sdbc/XColumnLocate.idl b/offapi/com/sun/star/sdbc/XColumnLocate.idl
index 094389895c99..a7c8d525d89f 100644
--- a/offapi/com/sun/star/sdbc/XColumnLocate.idl
+++ b/offapi/com/sun/star/sdbc/XColumnLocate.idl
@@ -45,12 +45,22 @@ published interface XColumnLocate: com::sun::star::uno::XInterface
{
/** maps the given ResultSet column name to its ResultSet column index.
+
+ <p>
+ The specification before LibreOffice 4.2 left unspecified what should
+ happen for an invalid column name. As a result some drivers written
+ against the older speification may return a special invalid value, such
+ as a negative number, zero, or a number greater than the number of
+ columns.
+ </p>
+
@param columnName
the name of the column
@returns
the position of the column
@throws SQLException
- if a database access error occurs.
+ if the column named <code>columnName</code> does not exist,
+ or a database access error occurs.
*/
long findColumn([in]string columnName) raises (SQLException);
};