New loplugin:dynexcspec: Add @throws documentation, connectivity

Change-Id: Id8711eaeac65efaa228b60d5786169016bfb61a3

6 files changed, 27 insertions, 2 deletions

diff --git a/include/connectivity/CommonTools.hxx b/include/connectivity/CommonTools.hxx
index 16f7e070d627..ef69b80e420b 100644
--- a/include/connectivity/CommonTools.hxx
+++ b/include/connectivity/CommonTools.hxx
@@ -132,6 +132,7 @@ namespace connectivity
                                         const OUString& _rVal,
                                         const ::comphelper::UStringMixEqual& _rCase);
 
+    /// @throws css::lang::DisposedException
     OOO_DLLPUBLIC_DBTOOLS void checkDisposed(bool _bThrow) throw ( css::lang::DisposedException );
 
 #if HAVE_FEATURE_JAVA
diff --git a/include/connectivity/dbconversion.hxx b/include/connectivity/dbconversion.hxx
index 0c604025a653..3223a7671f6e 100644
--- a/include/connectivity/dbconversion.hxx
+++ b/include/connectivity/dbconversion.hxx
@@ -68,6 +68,7 @@ namespace dbtools
     namespace DBTypeConversion
     {
         OOO_DLLPUBLIC_DBTOOLS css::util::Date const & getStandardDate();
+        /// @throws css::lang::IllegalArgumentException
         OOO_DLLPUBLIC_DBTOOLS void setValue(const css::uno::Reference< css::sdb::XColumnUpdate>& xVariant,
                                     const css::uno::Reference< css::util::XNumberFormatter>& xFormatter,
                                     const css::util::Date& rNullDate,
@@ -76,6 +77,7 @@ namespace dbtools
                                     sal_Int16 nFieldType,
                                     sal_Int16 nKeyType) throw(css::lang::IllegalArgumentException);
 
+        /// @throws css::lang::IllegalArgumentException
         OOO_DLLPUBLIC_DBTOOLS void setValue(const css::uno::Reference< css::sdb::XColumnUpdate>& xVariant,
                              const css::util::Date& rNullDate,
                              const double& rValue,
diff --git a/include/connectivity/dbexception.hxx b/include/connectivity/dbexception.hxx
index 6141ea1decd1..4554c2d9e524 100644
--- a/include/connectivity/dbexception.hxx
+++ b/include/connectivity/dbexception.hxx
@@ -210,6 +210,8 @@ OOO_DLLPUBLIC_DBTOOLS OUString getStandardSQLState( StandardSQLState _eState );
 
 
 /** throws an exception with SQL state IM001, saying that a certain function is not supported
+
+    @throws css::sdbc::SQLException
 */
 OOO_DLLPUBLIC_DBTOOLS void throwFunctionNotSupportedSQLException(
         const OUString& _rFunctionName,
@@ -217,6 +219,7 @@ OOO_DLLPUBLIC_DBTOOLS void throwFunctionNotSupportedSQLException(
     )
     throw ( css::sdbc::SQLException );
 
+/// @throws css::uno::RuntimeException
 OOO_DLLPUBLIC_DBTOOLS void throwFunctionNotSupportedRuntimeException(
         const OUString& _rFunctionName,
         const css::uno::Reference< css::uno::XInterface >& _rxContext
@@ -224,6 +227,8 @@ OOO_DLLPUBLIC_DBTOOLS void throwFunctionNotSupportedRuntimeException(
     throw (css::uno::RuntimeException );
 
 /** throws a function sequence (HY010) exception
+
+    @throws css::sdbc::SQLException
 */
 OOO_DLLPUBLIC_DBTOOLS void throwFunctionSequenceException(
         const css::uno::Reference< css::uno::XInterface >& Context,
@@ -233,6 +238,8 @@ OOO_DLLPUBLIC_DBTOOLS void throwFunctionSequenceException(
 
 
 /** throw a invalid index sqlexception
+
+    @throws css::sdbc::SQLException
 */
 OOO_DLLPUBLIC_DBTOOLS void throwInvalidIndexException(
         const css::uno::Reference< css::uno::XInterface >& Context,
@@ -242,6 +249,8 @@ OOO_DLLPUBLIC_DBTOOLS void throwInvalidIndexException(
 
 
 /** throw a generic SQLException, i.e. one with an SQLState of HY000, an ErrorCode of 0 and no NextException
+
+    @throws css::sdbc::SQLException
 */
 OOO_DLLPUBLIC_DBTOOLS void throwGenericSQLException(
         const OUString& _rMsg,
@@ -251,6 +260,8 @@ OOO_DLLPUBLIC_DBTOOLS void throwGenericSQLException(
 
 
 /** throw a generic SQLException, i.e. one with an SQLState of HY000, an ErrorCode of 0 and no NextException
+
+    @throws css::sdbc::SQLException
 */
 OOO_DLLPUBLIC_DBTOOLS void throwGenericSQLException(
         const OUString& _rMsg,
@@ -266,6 +277,7 @@ OOO_DLLPUBLIC_DBTOOLS void throwGenericSQLException(
         name is built from the name of the interface plus its method, for instance "XParameters::updateBinaryStream"
     @param _rxContext
         the context of the exception
+    @throws css::sdbc::SQLException
 */
 OOO_DLLPUBLIC_DBTOOLS void throwFeatureNotImplementedSQLException(
         const OUString& _rFeatureName,
@@ -279,6 +291,7 @@ OOO_DLLPUBLIC_DBTOOLS void throwFeatureNotImplementedSQLException(
         name is built from the name of the interface plus its method, for instance "XParameters::updateBinaryStream"
     @param _rxContext
         the context of the exception
+    @throws css::uno::RuntimeException
 */
 OOO_DLLPUBLIC_DBTOOLS void throwFeatureNotImplementedRuntimeException(
         const OUString& _rFeatureName,
@@ -291,6 +304,7 @@ OOO_DLLPUBLIC_DBTOOLS void throwFeatureNotImplementedRuntimeException(
         The column that couldn't be found.
     @param _rxContext
         the context of the exception
+    @throws css::sdbc::SQLException
 */
 OOO_DLLPUBLIC_DBTOOLS void throwInvalidColumnException(
         const OUString& _rColumnName,
@@ -299,7 +313,7 @@ OOO_DLLPUBLIC_DBTOOLS void throwInvalidColumnException(
     throw (css::sdbc::SQLException);
 
 
-/** throws an SQLException
+/** @throws css::sdbc::SQLException
 */
 OOO_DLLPUBLIC_DBTOOLS void throwSQLException(
         const OUString& _rMessage,
@@ -311,7 +325,7 @@ OOO_DLLPUBLIC_DBTOOLS void throwSQLException(
     throw (css::sdbc::SQLException);
 
 
-/** throws an SQLException
+/** @throws css::sdbc::SQLException
 */
 OOO_DLLPUBLIC_DBTOOLS void throwSQLException(
         const OUString& _rMessage,
diff --git a/include/connectivity/dbtools.hxx b/include/connectivity/dbtools.hxx
index 5c791b6816e1..9cce10d6c49c 100644
--- a/include/connectivity/dbtools.hxx
+++ b/include/connectivity/dbtools.hxx
@@ -179,6 +179,8 @@ namespace dbtools
     );
 
     /** returns the connection the RowSet is currently working with (which is the ActiveConnection property)
+
+        @throws css::uno::RuntimeException
     */
     OOO_DLLPUBLIC_DBTOOLS css::uno::Reference< css::sdbc::XConnection> getConnection(const css::uno::Reference< css::sdbc::XRowSet>& _rxRowSet) throw (css::uno::RuntimeException);
     OOO_DLLPUBLIC_DBTOOLS css::uno::Reference< css::sdbc::XConnection> getConnection_withFeedback(
@@ -570,6 +572,8 @@ namespace dbtools
         @param  x               the value to set
         @param  sqlType         the corresponding sql type @see css::sdbc::DataType
         @param  scale           the scale of the sql type can be 0
+        @throws css::sdbc::SQLException
+        @throws css::uno::RuntimeException
     */
     OOO_DLLPUBLIC_DBTOOLS
     void setObjectWithInfo( const css::uno::Reference< css::sdbc::XParameters>& _xParameters,
@@ -584,6 +588,8 @@ namespace dbtools
         @param  x               the value to set
         @param  sqlType         the corresponding sql type @see css::sdbc::DataType
         @param  scale           the scale of the sql type can be 0
+        @throws css::sdbc::SQLException
+        @throws css::uno::RuntimeException
     */
     OOO_DLLPUBLIC_DBTOOLS
     void setObjectWithInfo( const css::uno::Reference< css::sdbc::XParameters>& _xParameters,
diff --git a/include/connectivity/sdbcx/VCollection.hxx b/include/connectivity/sdbcx/VCollection.hxx
index 998cf7805bf6..8c5821901124 100644
--- a/include/connectivity/sdbcx/VCollection.hxx
+++ b/include/connectivity/sdbcx/VCollection.hxx
@@ -101,6 +101,7 @@ namespace connectivity
             bool                                    m_bUseIndexOnly;    // is only TRUE when only an indexaccess is needed
 
             // the implementing class should refresh their elements
+            /// @throws css::uno::RuntimeException
             virtual void impl_refresh() throw(css::uno::RuntimeException) = 0;
 
             // will be called when a object was requested by one of the accessing methods like getByIndex
diff --git a/include/connectivity/sdbcx/VDescriptor.hxx b/include/connectivity/sdbcx/VDescriptor.hxx
index d2470578121e..7d89ad30e811 100644
--- a/include/connectivity/sdbcx/VDescriptor.hxx
+++ b/include/connectivity/sdbcx/VDescriptor.hxx
@@ -70,6 +70,7 @@ namespace connectivity
 
             // XInterface
             virtual css::uno::Any SAL_CALL queryInterface( const css::uno::Type & rType ) throw(css::uno::RuntimeException, std::exception) override;
+            /// @throws css::uno::RuntimeException
             virtual css::uno::Sequence< css::uno::Type > SAL_CALL getTypes(  ) throw(css::uno::RuntimeException, std::exception);
 
             // css::lang::XUnoTunnel