diff options
author | Stephan Bergmann <sbergman@redhat.com> | 2017-01-19 17:59:45 +0100 |
---|---|---|
committer | Stephan Bergmann <sbergman@redhat.com> | 2017-01-19 18:03:24 +0100 |
commit | 5b2b75ac26961d3cef093ca546a5316be6f2d782 (patch) | |
tree | 281c24ea2f4b0a49630834a3ecc529cdc22e2402 | |
parent | 0d5e1cd497b0de0e62c5911fcd6b473689a1dfe7 (diff) |
New loplugin:dynexcspec: Add @throws documentation, connectivity
Change-Id: Id8711eaeac65efaa228b60d5786169016bfb61a3
71 files changed, 352 insertions, 10 deletions
diff --git a/connectivity/source/commontools/FDatabaseMetaDataResultSet.cxx b/connectivity/source/commontools/FDatabaseMetaDataResultSet.cxx index 3d89a552a2cc..f3192a1e4e4e 100644 --- a/connectivity/source/commontools/FDatabaseMetaDataResultSet.cxx +++ b/connectivity/source/commontools/FDatabaseMetaDataResultSet.cxx @@ -873,6 +873,7 @@ void SAL_CALL ODatabaseMetaDataResultSet::initialize( const Sequence< Any >& _aA namespace connectivity { + /// @throws Exception Reference< XInterface > SAL_CALL ODatabaseMetaDataResultSet_CreateInstance(const Reference< XComponentContext >& ) throw( Exception ) { return *(new ODatabaseMetaDataResultSet()); diff --git a/connectivity/source/cpool/ZConnectionPool.hxx b/connectivity/source/cpool/ZConnectionPool.hxx index c4aa5111f132..e598adbd3b0f 100644 --- a/connectivity/source/cpool/ZConnectionPool.hxx +++ b/connectivity/source/cpool/ZConnectionPool.hxx @@ -137,6 +137,8 @@ namespace connectivity // delete all refs void clear(bool _bDispose); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException css::uno::Reference< css::sdbc::XConnection > SAL_CALL getConnectionWithInfo( const OUString& url, const css::uno::Sequence< css::beans::PropertyValue >& info ) throw(css::sdbc::SQLException, css::uno::RuntimeException); // XEventListener virtual void SAL_CALL disposing( const css::lang::EventObject& Source ) throw (css::uno::RuntimeException, std::exception) override; diff --git a/connectivity/source/cpool/ZPoolCollection.hxx b/connectivity/source/cpool/ZPoolCollection.hxx index 316fb7a227c0..1f64980ae987 100644 --- a/connectivity/source/cpool/ZPoolCollection.hxx +++ b/connectivity/source/cpool/ZPoolCollection.hxx @@ -125,7 +125,9 @@ namespace connectivity // XServiceInfo - static methods static css::uno::Reference< css::uno::XInterface > SAL_CALL CreateInstance(const css::uno::Reference< css::lang::XMultiServiceFactory >&); + /// @throws css::uno::RuntimeException static OUString SAL_CALL getImplementationName_Static( ) throw(css::uno::RuntimeException); + /// @throws css::uno::RuntimeException static css::uno::Sequence< OUString > SAL_CALL getSupportedServiceNames_Static( ) throw(css::uno::RuntimeException); // XEventListener diff --git a/connectivity/source/drivers/evoab2/NConnection.hxx b/connectivity/source/drivers/evoab2/NConnection.hxx index ecc7b76c3229..bc1a39608f23 100644 --- a/connectivity/source/drivers/evoab2/NConnection.hxx +++ b/connectivity/source/drivers/evoab2/NConnection.hxx @@ -65,6 +65,7 @@ namespace connectivity public: explicit OEvoabConnection( OEvoabDriver& _rDriver ); + /// @throws css::sdbc::SQLException virtual void construct(const OUString& _rUrl,const css::uno::Sequence< css::beans::PropertyValue >& _rInfo ) throw( css::sdbc::SQLException); inline OString const & getPassword() { return m_aPassword; } diff --git a/connectivity/source/drivers/evoab2/NDriver.hxx b/connectivity/source/drivers/evoab2/NDriver.hxx index e0dc13dd94a2..952b9a060e5e 100644 --- a/connectivity/source/drivers/evoab2/NDriver.hxx +++ b/connectivity/source/drivers/evoab2/NDriver.hxx @@ -33,7 +33,7 @@ namespace connectivity { namespace evoab { - + /// @throws css::uno::Exception css::uno::Reference< css::uno::XInterface > SAL_CALL OEvoabDriver_CreateInstance(const css::uno::Reference< css::lang::XMultiServiceFactory >& _rxFactory) throw( css::uno::Exception ); @@ -57,7 +57,9 @@ namespace connectivity virtual void SAL_CALL disposing() override; // XInterface + /// @throws css::uno::RuntimeException static OUString getImplementationName_Static( ) throw(css::uno::RuntimeException); + /// @throws css::uno::RuntimeException static css::uno::Sequence< OUString > getSupportedServiceNames_Static( ) throw (css::uno::RuntimeException); // XServiceInfo diff --git a/connectivity/source/drivers/evoab2/NResultSetMetaData.hxx b/connectivity/source/drivers/evoab2/NResultSetMetaData.hxx index 7cae14957bcd..eca3a00bcc2d 100644 --- a/connectivity/source/drivers/evoab2/NResultSetMetaData.hxx +++ b/connectivity/source/drivers/evoab2/NResultSetMetaData.hxx @@ -43,6 +43,7 @@ namespace connectivity virtual ~OEvoabResultSetMetaData() override; public: explicit OEvoabResultSetMetaData(const OUString& _aTableName); + /// @throws css::sdbc::SQLException void setEvoabFields(const ::rtl::Reference<connectivity::OSQLColumns> &xColumns) throw(css::sdbc::SQLException); inline sal_uInt32 fieldAtColumn(sal_Int32 columnIndex) const { return m_aEvoabFields[columnIndex - 1]; } diff --git a/connectivity/source/drivers/firebird/Blob.hxx b/connectivity/source/drivers/firebird/Blob.hxx index 89daeac839ff..c8fd8c79e6f7 100644 --- a/connectivity/source/drivers/firebird/Blob.hxx +++ b/connectivity/source/drivers/firebird/Blob.hxx @@ -45,11 +45,14 @@ namespace connectivity ISC_STATUS_ARRAY m_statusVector; + /// @throws css::sdbc::SQLException void ensureBlobIsOpened() throw(css::sdbc::SQLException); /** * Closes the blob and cleans up resources -- can be used to reset * the blob if we e.g. want to read from the beginning again. + * + * @throws css::sdbc::SQLException */ void closeBlob() throw(css::sdbc::SQLException); diff --git a/connectivity/source/drivers/firebird/Connection.hxx b/connectivity/source/drivers/firebird/Connection.hxx index 420f0d7a283f..9e8d917c4393 100644 --- a/connectivity/source/drivers/firebird/Connection.hxx +++ b/connectivity/source/drivers/firebird/Connection.hxx @@ -156,6 +156,7 @@ namespace connectivity /** Statements owned by this connection. */ OWeakRefArray m_aStatements; + /// @throws css::sdbc::SQLException void buildTypeInfo() throw (css::sdbc::SQLException); @@ -163,6 +164,8 @@ namespace connectivity * Creates a new transaction with the desired parameters, if * necessary discarding an existing transaction. This has to be done * anytime we change the transaction isolation, or autocommiting. + * + * @throws css::sdbc::SQLException */ void setupTransaction() throw(css::sdbc::SQLException); @@ -180,6 +183,8 @@ namespace connectivity explicit Connection(FirebirdDriver* _pDriver); virtual ~Connection() override; + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void construct( const ::rtl::OUString& url, const css::uno::Sequence< css::beans::PropertyValue >& info) throw(css::sdbc::SQLException, @@ -189,6 +194,7 @@ namespace connectivity const OUString& getConnectionURL() const {return m_sConnectionURL;} bool isEmbedded() const {return m_bIsEmbedded;} isc_db_handle& getDBHandle() {return m_aDBHandle;} + /// @throws css::sdbc::SQLException isc_tr_handle& getTransaction() throw(css::sdbc::SQLException); @@ -206,11 +212,16 @@ namespace connectivity * Create a new Blob tied to this connection. Blobs are tied to a * transaction and not to a statement, hence the connection should * deal with their management. + * + * @throws css::sdbc::SQLException + * @throws css::uno::RuntimeException */ css::uno::Reference< css::sdbc::XBlob> createBlob(ISC_QUAD* pBlobID) throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException css::uno::Reference< css::sdbc::XClob> createClob(ISC_QUAD* pBlobID) throw(css::sdbc::SQLException, diff --git a/connectivity/source/drivers/firebird/Driver.hxx b/connectivity/source/drivers/firebird/Driver.hxx index ac017d788018..a48b13e11f53 100644 --- a/connectivity/source/drivers/firebird/Driver.hxx +++ b/connectivity/source/drivers/firebird/Driver.hxx @@ -38,6 +38,7 @@ namespace connectivity // 3: Is IB6 -- minimum required for delimited identifiers. static const int FIREBIRD_SQL_DIALECT = 3; + /// @throws css::uno::Exception css::uno::Reference< css::uno::XInterface > SAL_CALL FirebirdDriver_CreateInstance(const css::uno::Reference< css::lang::XMultiServiceFactory >& _rxFactory) throw( css::uno::Exception, std::exception ); typedef ::cppu::WeakComponentImplHelper< css::sdbc::XDriver, @@ -66,7 +67,9 @@ namespace connectivity // OComponentHelper virtual void SAL_CALL disposing() override; // XInterface + /// @throws css::uno::RuntimeException static ::rtl::OUString getImplementationName_Static( ) throw(css::uno::RuntimeException); + /// @throws css::uno::RuntimeException static css::uno::Sequence< ::rtl::OUString > getSupportedServiceNames_Static( ) throw (css::uno::RuntimeException); // XServiceInfo diff --git a/connectivity/source/drivers/firebird/PreparedStatement.hxx b/connectivity/source/drivers/firebird/PreparedStatement.hxx index 21f1d3b3183a..0062110899dd 100644 --- a/connectivity/source/drivers/firebird/PreparedStatement.hxx +++ b/connectivity/source/drivers/firebird/PreparedStatement.hxx @@ -53,6 +53,8 @@ namespace connectivity XSQLDA* m_pOutSqlda; XSQLDA* m_pInSqlda; + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void checkParameterIndex(sal_Int32 nParameterIndex) throw(css::sdbc::SQLException, css::uno::RuntimeException); @@ -60,12 +62,17 @@ namespace connectivity /** * Set a numeric value in the input SQLDA. If the destination * parameter is not of nType then an Exception will be thrown. + * + * @throws css::sdbc::SQLException + * @throws css::uno::RuntimeException */ template <typename T> void setValue(sal_Int32 nIndex, T& nValue, ISC_SHORT nType) throw(css::sdbc::SQLException, css::uno::RuntimeException); void setParameterNull(sal_Int32 nParameterIndex, bool bSetNull = true); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void ensurePrepared() throw(css::sdbc::SQLException, css::uno::RuntimeException); diff --git a/connectivity/source/drivers/firebird/ResultSet.hxx b/connectivity/source/drivers/firebird/ResultSet.hxx index 834e25e7b886..7d2a7c40bfec 100644 --- a/connectivity/source/drivers/firebird/ResultSet.hxx +++ b/connectivity/source/drivers/firebird/ResultSet.hxx @@ -113,9 +113,13 @@ namespace connectivity virtual ::cppu::IPropertyArrayHelper* createArrayHelper() const override; virtual ::cppu::IPropertyArrayHelper& SAL_CALL getInfoHelper() override; + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void SAL_CALL checkColumnIndex( sal_Int32 index ) throw (css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void SAL_CALL checkRowIndex() throw (css::sdbc::SQLException, css::uno::RuntimeException); diff --git a/connectivity/source/drivers/firebird/ResultSetMetaData.hxx b/connectivity/source/drivers/firebird/ResultSetMetaData.hxx index 17539bdf01bc..a183e97cd70a 100644 --- a/connectivity/source/drivers/firebird/ResultSetMetaData.hxx +++ b/connectivity/source/drivers/firebird/ResultSetMetaData.hxx @@ -43,6 +43,7 @@ namespace connectivity virtual ~OResultSetMetaData() override; + /// @throws css::sdbc::SQLException void verifyValidColumn(sal_Int32 column) throw(css::sdbc::SQLException); public: // a constructor, which is required for returning objects: diff --git a/connectivity/source/drivers/firebird/StatementCommonBase.hxx b/connectivity/source/drivers/firebird/StatementCommonBase.hxx index ea5006f9ce31..11d9c3dab52b 100644 --- a/connectivity/source/drivers/firebird/StatementCommonBase.hxx +++ b/connectivity/source/drivers/firebird/StatementCommonBase.hxx @@ -65,6 +65,7 @@ namespace connectivity protected: virtual void disposeResultSet(); + /// @throws css::sdbc::SQLException void freeStatementHandle() throw (css::sdbc::SQLException); @@ -87,15 +88,19 @@ namespace connectivity sal_Int32 nHandle) const override; virtual ~OStatementCommonBase() override; + /// @throws css::sdbc::SQLException void prepareAndDescribeStatement(const OUString& sqlIn, XSQLDA*& pOutSqlda, XSQLDA* pInSqlda=nullptr) throw (css::sdbc::SQLException); + /// @throws css::sdbc::SQLException short getSqlInfoItem(char aInfoItem) throw (css::sdbc::SQLException); + /// @throws css::sdbc::SQLException bool isDDLStatement() throw (css::sdbc::SQLException); + /// @throws css::sdbc::SQLException sal_Int32 getStatementChangeCount() throw (css::sdbc::SQLException); diff --git a/connectivity/source/drivers/firebird/SubComponent.hxx b/connectivity/source/drivers/firebird/SubComponent.hxx index 609c07a9249c..9a6739e59a45 100644 --- a/connectivity/source/drivers/firebird/SubComponent.hxx +++ b/connectivity/source/drivers/firebird/SubComponent.hxx @@ -55,6 +55,7 @@ namespace connectivity css::uno::Reference< css::uno::XInterface >& _xInterface, css::lang::XComponent* _pObject); + /// @throws css::lang::DisposedException void checkDisposed(bool _bThrow) throw ( css::lang::DisposedException ); diff --git a/connectivity/source/drivers/firebird/Util.hxx b/connectivity/source/drivers/firebird/Util.hxx index 04d96d435414..c66ecd7d1209 100644 --- a/connectivity/source/drivers/firebird/Util.hxx +++ b/connectivity/source/drivers/firebird/Util.hxx @@ -55,6 +55,8 @@ namespace connectivity /** * Evaluate a firebird status vector and throw exceptions as necessary. * The content of the status vector is included in the thrown exception. + * + * @throws css::sdbc::SQLException */ void evaluateStatusVector(const ISC_STATUS_ARRAY& rStatusVector, const ::rtl::OUString& aCause, diff --git a/connectivity/source/drivers/mork/MConnection.hxx b/connectivity/source/drivers/mork/MConnection.hxx index 0e517daafc55..d7364c3e908b 100644 --- a/connectivity/source/drivers/mork/MConnection.hxx +++ b/connectivity/source/drivers/mork/MConnection.hxx @@ -48,6 +48,7 @@ namespace connectivity css::uno::Reference< css::sdbcx::XTablesSupplier> m_xCatalog; public: + /// @throws css::sdbc::SQLException void construct( const OUString& url,const css::uno::Sequence< css::beans::PropertyValue >& info) throw(css::sdbc::SQLException); explicit OConnection(MorkDriver* const driver); virtual ~OConnection() override; diff --git a/connectivity/source/drivers/mork/MDatabaseMetaData.hxx b/connectivity/source/drivers/mork/MDatabaseMetaData.hxx index 2c991d01734c..10fb2c478a0e 100644 --- a/connectivity/source/drivers/mork/MDatabaseMetaData.hxx +++ b/connectivity/source/drivers/mork/MDatabaseMetaData.hxx @@ -27,6 +27,7 @@ namespace connectivity std::unique_ptr<MDatabaseMetaDataHelper> m_pMetaDataHelper; + /// @throws css::sdbc::SQLException ODatabaseMetaDataResultSet::ORows& SAL_CALL getColumnRows( const OUString& tableNamePattern, const OUString& columnNamePattern ) throw( css::sdbc::SQLException ); protected: diff --git a/connectivity/source/drivers/mork/MResultSet.hxx b/connectivity/source/drivers/mork/MResultSet.hxx index cfdf6f4e53f3..a05b1b65dddc 100644 --- a/connectivity/source/drivers/mork/MResultSet.hxx +++ b/connectivity/source/drivers/mork/MResultSet.hxx @@ -238,6 +238,8 @@ protected: ::rtl::Reference<connectivity::OSQLColumns> m_xParamColumns; void parseParameter( const OSQLParseNode* pNode, OUString& rMatchString ); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void fillRowData() throw(css::sdbc::SQLException, css::uno::RuntimeException, std::exception); void analyseWhereClause( const OSQLParseNode* parseTree, MQueryExpression &queryExpression); @@ -252,8 +254,12 @@ protected: sal_uInt32 currentRowCount(); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException bool fetchRow(sal_Int32 rowIndex,bool bForceReload=false) throw( css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException bool fetchCurrentRow() throw( css::sdbc::SQLException, css::uno::RuntimeException); static bool pushCard(sal_uInt32 ) { return true; } @@ -262,16 +268,24 @@ protected: sal_Int32 deletedCount(); bool fillKeySet(sal_Int32 nMaxCardNumber); //When we get new rows, fill the m_pKeySet items for them sal_Int32 getRowForCardNumber(sal_Int32 nCardNum); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException const ORowSetValue& getValue(sal_Int32 rowIndex, sal_Int32 columnIndex) throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void updateValue(sal_Int32 columnIndex,const ORowSetValue& x ) throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException static void checkPendingUpdate() throw(css::sdbc::SQLException, css::uno::RuntimeException); sal_Int32 getCurrentCardNumber(); public: bool determineReadOnly(); // MozAddressbook Specific methods + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void SAL_CALL executeQuery() throw(css::sdbc::SQLException, css::uno::RuntimeException, std::exception); @@ -295,6 +309,7 @@ public: inline sal_Int32 mapColumn(sal_Int32 column); + /// @throws css::sdbc::SQLException void checkIndex(sal_Int32 columnIndex ) throw(css::sdbc::SQLException); static void setBoundedColumns( diff --git a/connectivity/source/drivers/mork/MResultSetMetaData.hxx b/connectivity/source/drivers/mork/MResultSetMetaData.hxx index 2e60a2ed86a4..78db8d3f3bb9 100644 --- a/connectivity/source/drivers/mork/MResultSetMetaData.hxx +++ b/connectivity/source/drivers/mork/MResultSetMetaData.hxx @@ -57,7 +57,8 @@ namespace connectivity ,m_bReadOnly(aReadOnly) {} - + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void checkColumnIndex(sal_Int32 column) throw(css::sdbc::SQLException, css::uno::RuntimeException); virtual sal_Int32 SAL_CALL getColumnCount( ) throw(css::sdbc::SQLException, css::uno::RuntimeException, std::exception) override; virtual sal_Bool SAL_CALL isAutoIncrement( sal_Int32 column ) throw(css::sdbc::SQLException, css::uno::RuntimeException, std::exception) override; diff --git a/connectivity/source/drivers/mork/MStatement.hxx b/connectivity/source/drivers/mork/MStatement.hxx index 883957524230..3127bbb20a4e 100644 --- a/connectivity/source/drivers/mork/MStatement.hxx +++ b/connectivity/source/drivers/mork/MStatement.hxx @@ -104,6 +104,9 @@ namespace connectivity enum StatementType { eSelect, eCreateTable }; /** called to do the parsing of a to-be-executed SQL statement, and set all members as needed + + @throws css::sdbc::SQLException + @throws css::uno::RuntimeException */ virtual StatementType parseSql( const OUString& sql , bool bAdjusted = false) throw ( css::sdbc::SQLException, css::uno::RuntimeException, std::exception ); diff --git a/connectivity/source/drivers/mozab/bootstrap/MNSINIParser.hxx b/connectivity/source/drivers/mozab/bootstrap/MNSINIParser.hxx index 25874dfe5c0b..9b44ffb2091b 100644 --- a/connectivity/source/drivers/mozab/bootstrap/MNSINIParser.hxx +++ b/connectivity/source/drivers/mozab/bootstrap/MNSINIParser.hxx @@ -51,6 +51,7 @@ class IniParser IniSectionMap mAllSection; public: IniSectionMap& getAllSection() { return mAllSection; } + /// @throws css::io::IOException explicit IniParser(OUString const & rIniName) throw(css::io::IOException, std::exception); }; diff --git a/connectivity/source/drivers/mozab/bootstrap/MNSProfileDiscover.hxx b/connectivity/source/drivers/mozab/bootstrap/MNSProfileDiscover.hxx index 40a343c53fa5..8de3f03d8e6b 100644 --- a/connectivity/source/drivers/mozab/bootstrap/MNSProfileDiscover.hxx +++ b/connectivity/source/drivers/mozab/bootstrap/MNSProfileDiscover.hxx @@ -70,11 +70,17 @@ namespace connectivity public: ~ProfileAccess(); ProfileAccess(); + /// @throws css::uno::RuntimeException OUString getProfilePath( css::mozilla::MozillaProductType product, const OUString& profileName ) throw (css::uno::RuntimeException); + /// @throws css::uno::RuntimeException ::sal_Int32 getProfileCount( css::mozilla::MozillaProductType product ) throw (css::uno::RuntimeException); + /// @throws css::uno::RuntimeException ::sal_Int32 getProfileList( css::mozilla::MozillaProductType product, css::uno::Sequence< OUString >& list ) throw (css::uno::RuntimeException); + /// @throws css::uno::RuntimeException OUString getDefaultProfile( css::mozilla::MozillaProductType product ) throw (css::uno::RuntimeException); + /// @throws css::uno::RuntimeException bool SAL_CALL isProfileLocked( css::mozilla::MozillaProductType product, const OUString& profileName ) throw (css::uno::RuntimeException); + /// @throws css::uno::RuntimeException bool SAL_CALL getProfileExists( css::mozilla::MozillaProductType product, const OUString& profileName ) throw (css::uno::RuntimeException); private: ProductStruct m_ProductProfileList[4]; diff --git a/connectivity/source/drivers/odbc/ORealDriver.hxx b/connectivity/source/drivers/odbc/ORealDriver.hxx index 2b9e3d6ed883..d015bb42c0bd 100644 --- a/connectivity/source/drivers/odbc/ORealDriver.hxx +++ b/connectivity/source/drivers/odbc/ORealDriver.hxx @@ -32,6 +32,7 @@ namespace com { namespace sun { namespace star { namespace connectivity { namespace odbc { +/// @throws css::uno::Exception css::uno::Reference< css::uno::XInterface > ODBCDriver_CreateInstance( css::uno::Reference< css::lang::XMultiServiceFactory > const & factory) throw (css::uno::Exception); diff --git a/connectivity/source/drivers/postgresql/pq_baseresultset.hxx b/connectivity/source/drivers/postgresql/pq_baseresultset.hxx index 9f0d3c696ccb..caf3218b548f 100644 --- a/connectivity/source/drivers/postgresql/pq_baseresultset.hxx +++ b/connectivity/source/drivers/postgresql/pq_baseresultset.hxx @@ -80,9 +80,14 @@ protected: protected: /** mutex should be locked before called + + @throws css::sdbc::SQLException + @throws css::uno::RuntimeException */ virtual void checkClosed() throw ( css::sdbc::SQLException, css::uno::RuntimeException ) = 0; + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void checkColumnIndex( sal_Int32 index ) throw ( css::sdbc::SQLException, css::uno::RuntimeException ); void checkRowIndex(); diff --git a/connectivity/source/drivers/postgresql/pq_connection.cxx b/connectivity/source/drivers/postgresql/pq_connection.cxx index 2e3560022ac1..0ae43eee2808 100644 --- a/connectivity/source/drivers/postgresql/pq_connection.cxx +++ b/connectivity/source/drivers/postgresql/pq_connection.cxx @@ -658,7 +658,7 @@ Reference< XNameAccess > Connection::getUsers() return m_settings.users; } - +/// @throws Exception Reference< XInterface > ConnectionCreateInstance( const Reference< XComponentContext > & ctx ) throw (Exception, std::exception) { diff --git a/connectivity/source/drivers/postgresql/pq_connection.hxx b/connectivity/source/drivers/postgresql/pq_connection.hxx index cfb4cccf1b9c..fe5cc2a31996 100644 --- a/connectivity/source/drivers/postgresql/pq_connection.hxx +++ b/connectivity/source/drivers/postgresql/pq_connection.hxx @@ -165,6 +165,8 @@ class Connection : public ConnectionBase WeakHashMap m_myStatements; private: + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void checkClosed() throw ( css::sdbc::SQLException, css::uno::RuntimeException ); diff --git a/connectivity/source/drivers/postgresql/pq_databasemetadata.hxx b/connectivity/source/drivers/postgresql/pq_databasemetadata.hxx index 1b84178fd0b7..7087f20387c4 100644 --- a/connectivity/source/drivers/postgresql/pq_databasemetadata.hxx +++ b/connectivity/source/drivers/postgresql/pq_databasemetadata.hxx @@ -56,9 +56,17 @@ class DatabaseMetaData : css::uno::Reference< css::sdbc::XPreparedStatement > m_getTablePrivs_stmt; css::uno::Reference< css::sdbc::XPreparedStatement > m_getColumnPrivs_stmt; + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException sal_Int32 getIntSetting(const OUString& settingName) throw (css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException sal_Int32 getMaxIndexKeys() throw (css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException sal_Int32 getMaxNameLength() throw (css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException css::uno::Reference< css::sdbc::XResultSet > getImportedExportedKeys( const css::uno::Any& primaryCatalog, const OUString& primarySchema, const OUString& primaryTable, const css::uno::Any& foreignCatalog, const OUString& foreignSchema, const OUString& foreignTable ) diff --git a/connectivity/source/drivers/postgresql/pq_preparedstatement.hxx b/connectivity/source/drivers/postgresql/pq_preparedstatement.hxx index 408d14543011..c3fc3c8d0be2 100644 --- a/connectivity/source/drivers/postgresql/pq_preparedstatement.hxx +++ b/connectivity/source/drivers/postgresql/pq_preparedstatement.hxx @@ -250,7 +250,10 @@ public: // OComponentHelper private: void checkColumnIndex( sal_Int32 parameterIndex ); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void checkClosed() throw (css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException void raiseSQLException( const char * errorMsg ) throw ( css::sdbc::SQLException ); // PGresult *pgExecute( OString *pQuery ); diff --git a/connectivity/source/drivers/postgresql/pq_resultsetmetadata.hxx b/connectivity/source/drivers/postgresql/pq_resultsetmetadata.hxx index 1642fc4029f7..077368751992 100644 --- a/connectivity/source/drivers/postgresql/pq_resultsetmetadata.hxx +++ b/connectivity/source/drivers/postgresql/pq_resultsetmetadata.hxx @@ -78,6 +78,8 @@ class ResultSetMetaData : sal_Int32 m_colCount; + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void checkColumnIndex( sal_Int32 columnIndex ) throw (css::sdbc::SQLException, css::uno::RuntimeException); void checkTable(); diff --git a/connectivity/source/drivers/postgresql/pq_sequenceresultsetmetadata.hxx b/connectivity/source/drivers/postgresql/pq_sequenceresultsetmetadata.hxx index 11066a9b1e30..d115b8f750c5 100644 --- a/connectivity/source/drivers/postgresql/pq_sequenceresultsetmetadata.hxx +++ b/connectivity/source/drivers/postgresql/pq_sequenceresultsetmetadata.hxx @@ -51,6 +51,8 @@ namespace pq_sdbc_driver ColumnMetaDataVector m_columnData; sal_Int32 m_colCount; + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void checkColumnIndex( sal_Int32 columnIndex ) throw (css::sdbc::SQLException, css::uno::RuntimeException); diff --git a/connectivity/source/drivers/postgresql/pq_statement.cxx b/connectivity/source/drivers/postgresql/pq_statement.cxx index 805c7b9f963d..e465fa254ed9 100644 --- a/connectivity/source/drivers/postgresql/pq_statement.cxx +++ b/connectivity/source/drivers/postgresql/pq_statement.cxx @@ -276,7 +276,7 @@ sal_Int32 Statement::executeUpdate( const OUString& sql ) return m_multipleResultUpdateCount; } - +/// @throws SQLException static void raiseSQLException( ConnectionSettings *pSettings, const Reference< XInterface> & owner, diff --git a/connectivity/source/drivers/postgresql/pq_statement.hxx b/connectivity/source/drivers/postgresql/pq_statement.hxx index 981fcafd64fe..437eac12c0e6 100644 --- a/connectivity/source/drivers/postgresql/pq_statement.hxx +++ b/connectivity/source/drivers/postgresql/pq_statement.hxx @@ -175,7 +175,10 @@ public: // XResultSetMetaDataSupplier (is required by framework (see throw (css::sdbc::SQLException, css::uno::RuntimeException, std::exception) override; private: + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void checkClosed() throw (css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException void raiseSQLException( const OUString & sql, const char * errorMsg ) throw ( css::sdbc::SQLException ); }; diff --git a/connectivity/source/drivers/postgresql/pq_tools.hxx b/connectivity/source/drivers/postgresql/pq_tools.hxx index 6ab147c76d39..cce2d5a640f4 100644 --- a/connectivity/source/drivers/postgresql/pq_tools.hxx +++ b/connectivity/source/drivers/postgresql/pq_tools.hxx @@ -103,6 +103,7 @@ OString extractSingleTableFromSelect( const OStringVector &vec ); void tokenizeSQL( const OString & sql, OStringVector &vec ); void splitSQL( const OString & sql, OStringVector &vec ); std::vector< sal_Int32 > parseIntArray( const OUString & str ); +/// @throws css::sdbc::SQLException std::vector< css::uno::Any > parseArray( const OUString & str ) throw( css::sdbc::SQLException ); diff --git a/connectivity/source/drivers/postgresql/pq_updateableresultset.hxx b/connectivity/source/drivers/postgresql/pq_updateableresultset.hxx index 7db28ca314a5..040281dec8fb 100644 --- a/connectivity/source/drivers/postgresql/pq_updateableresultset.hxx +++ b/connectivity/source/drivers/postgresql/pq_updateableresultset.hxx @@ -163,7 +163,7 @@ public: // XRowUpdate virtual void SAL_CALL updateNumericObject( sal_Int32 columnIndex, const css::uno::Any& x, sal_Int32 scale ) throw (css::sdbc::SQLException, css::uno::RuntimeException, std::exception) override; public: - + /// @throws css::uno::RuntimeException static css::uno::Sequence< css::uno::Type > getStaticTypes( bool updateable ) throw( css::uno::RuntimeException ); diff --git a/connectivity/source/drivers/postgresql/pq_xcontainer.hxx b/connectivity/source/drivers/postgresql/pq_xcontainer.hxx index e5589b1478f4..6c7a80c113f9 100644 --- a/connectivity/source/drivers/postgresql/pq_xcontainer.hxx +++ b/connectivity/source/drivers/postgresql/pq_xcontainer.hxx @@ -160,6 +160,7 @@ public: // XAppend css::uno::RuntimeException, std::exception) override; // helper method ! + /// @throws css::container::ElementExistException void append( const OUString & str, const css::uno::Reference< css::beans::XPropertySet >& descriptor ) diff --git a/connectivity/source/inc/FDatabaseMetaDataResultSet.hxx b/connectivity/source/inc/FDatabaseMetaDataResultSet.hxx index ccfdfa1dde95..808380563719 100644 --- a/connectivity/source/inc/FDatabaseMetaDataResultSet.hxx +++ b/connectivity/source/inc/FDatabaseMetaDataResultSet.hxx @@ -122,6 +122,7 @@ namespace connectivity sal_Int32 m_nResultSetConcurrency; void construct(); + /// @throws css::sdbc::SQLException void checkIndex(sal_Int32 columnIndex ) throw(css::sdbc::SQLException); void setType(MetaDataResultSetType _eType); @@ -153,7 +154,9 @@ namespace connectivity // XServiceInfo + /// @throws css::uno::RuntimeException static OUString getImplementationName_Static( ) throw(css::uno::RuntimeException); + /// @throws css::uno::RuntimeException static css::uno::Sequence< OUString > getSupportedServiceNames_Static( ) throw (css::uno::RuntimeException); protected: diff --git a/connectivity/source/inc/ParameterSubstitution.hxx b/connectivity/source/inc/ParameterSubstitution.hxx index df664617750d..fa9d94bc30d2 100644 --- a/connectivity/source/inc/ParameterSubstitution.hxx +++ b/connectivity/source/inc/ParameterSubstitution.hxx @@ -41,8 +41,9 @@ namespace connectivity ParameterSubstitution( const ParameterSubstitution& ) = delete; ParameterSubstitution& operator=( const ParameterSubstitution& ) = delete; public: - + /// @throws css::uno::RuntimeException static OUString getImplementationName_Static( ) throw(css::uno::RuntimeException); + /// @throws css::uno::RuntimeException static css::uno::Sequence< OUString > getSupportedServiceNames_Static( ) throw (css::uno::RuntimeException); static css::uno::Reference< css::uno::XInterface > create( const css::uno::Reference< css::uno::XComponentContext > & xContext); protected: diff --git a/connectivity/source/inc/calc/CDriver.hxx b/connectivity/source/inc/calc/CDriver.hxx index 39867264852e..2a5cb622e18e 100644 --- a/connectivity/source/inc/calc/CDriver.hxx +++ b/connectivity/source/inc/calc/CDriver.hxx @@ -28,6 +28,7 @@ namespace connectivity { namespace calc { + /// @throws css::uno::Exception css::uno::Reference< css::uno::XInterface > SAL_CALL ODriver_CreateInstance(const css::uno::Reference< css::lang::XMultiServiceFactory >& _rxFactory) throw( css::uno::Exception ); @@ -39,6 +40,7 @@ namespace connectivity css::uno::XComponentContext >& _rxContext) : file::OFileDriver(_rxContext) {} + /// @throws css::uno::RuntimeException static OUString getImplementationName_Static( ) throw(css::uno::RuntimeException); OUString SAL_CALL getImplementationName( ) throw(css::uno::RuntimeException, std::exception) override; diff --git a/connectivity/source/inc/dbase/DDriver.hxx b/connectivity/source/inc/dbase/DDriver.hxx index 64b5bdad4c9b..79c7d560c765 100644 --- a/connectivity/source/inc/dbase/DDriver.hxx +++ b/connectivity/source/inc/dbase/DDriver.hxx @@ -28,7 +28,7 @@ namespace connectivity { namespace dbase { - + /// @throws css::uno::Exception css::uno::Reference< css::uno::XInterface > SAL_CALL ODriver_CreateInstance(const css::uno::Reference< css::lang::XMultiServiceFactory >& _rxFactory) throw( css::uno::Exception ); class ODriver : public file::OFileDriver @@ -37,6 +37,7 @@ namespace connectivity ODriver(const css::uno::Reference< css::uno::XComponentContext >& _rxContext) : file::OFileDriver(_rxContext){} // XInterface + /// @throws css::uno::RuntimeException static OUString getImplementationName_Static( ) throw(css::uno::RuntimeException); // static css::uno::Sequence< OUString > getSupportedServiceNames_Static( ) throw (css::uno::RuntimeException); diff --git a/connectivity/source/inc/dbase/DTable.hxx b/connectivity/source/inc/dbase/DTable.hxx index 3711aed8b473..7ea5d8516db9 100644 --- a/connectivity/source/inc/dbase/DTable.hxx +++ b/connectivity/source/inc/dbase/DTable.hxx @@ -114,6 +114,9 @@ namespace connectivity bool AllocBuffer(); void throwInvalidDbaseFormat(); + /// @throws css::sdbc::SQLException + /// @throws css::container::ElementExistException + /// @throws css::uno::RuntimeException void SAL_CALL renameImpl( const OUString& newName ) throw(css::sdbc::SQLException, css::container::ElementExistException, css::uno::RuntimeException, std::exception); void throwInvalidColumnType(const sal_uInt16 _nErrorId,const OUString& _sColumnName); diff --git a/connectivity/source/inc/file/FConnection.hxx b/connectivity/source/inc/file/FConnection.hxx index f25d82f349e7..e9ee85e9e235 100644 --- a/connectivity/source/inc/file/FConnection.hxx +++ b/connectivity/source/inc/file/FConnection.hxx @@ -76,6 +76,9 @@ namespace connectivity OConnection(OFileDriver* _pDriver); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException + /// @throws css::uno::DeploymentException virtual void construct(const OUString& _rUrl, const css::uno::Sequence< css::beans::PropertyValue >& _rInfo ) throw( css::sdbc::SQLException, css::uno::RuntimeException, diff --git a/connectivity/source/inc/file/FDriver.hxx b/connectivity/source/inc/file/FDriver.hxx index 90909d669299..0031644c664a 100644 --- a/connectivity/source/inc/file/FDriver.hxx +++ b/connectivity/source/inc/file/FDriver.hxx @@ -50,7 +50,9 @@ namespace connectivity // OComponentHelper virtual void SAL_CALL disposing() override; // XInterface + /// @throws css::uno::DeploymentException static OUString getImplementationName_Static( ) throw(css::uno::RuntimeException); + /// @throws css::uno::DeploymentException static css::uno::Sequence< OUString > getSupportedServiceNames_Static( ) throw (css::uno::RuntimeException); // XServiceInfo diff --git a/connectivity/source/inc/file/FResultSet.hxx b/connectivity/source/inc/file/FResultSet.hxx index ea0576814682..e6fd70322a90 100644 --- a/connectivity/source/inc/file/FResultSet.hxx +++ b/connectivity/source/inc/file/FResultSet.hxx @@ -136,10 +136,15 @@ namespace connectivity // return true when the select statement is "select count(*) from table" inline bool isCount() const { return m_bIsCount; } + /// @throws css::sdbc::SQLException void checkIndex(sal_Int32 columnIndex ) throw(css::sdbc::SQLException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException const ORowSetValue& getValue(sal_Int32 columnIndex) throw (css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void updateValue(sal_Int32 columnIndex,const ORowSetValue& x ) throw(css::sdbc::SQLException, css::uno::RuntimeException); // clear insert row void clearInsertRow(); diff --git a/connectivity/source/inc/file/FResultSetMetaData.hxx b/connectivity/source/inc/file/FResultSetMetaData.hxx index baadbc9d3629..aa7691edad2d 100644 --- a/connectivity/source/inc/file/FResultSetMetaData.hxx +++ b/connectivity/source/inc/file/FResultSetMetaData.hxx @@ -43,6 +43,8 @@ namespace connectivity ::rtl::Reference<connectivity::OSQLColumns> m_xColumns; OFileTable* m_pTable; + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void checkColumnIndex(sal_Int32 column) throw(css::sdbc::SQLException, css::uno::RuntimeException); protected: virtual ~OResultSetMetaData() override; diff --git a/connectivity/source/inc/file/FStatement.hxx b/connectivity/source/inc/file/FStatement.hxx index 50059b8eb80c..257076f01626 100644 --- a/connectivity/source/inc/file/FStatement.hxx +++ b/connectivity/source/inc/file/FStatement.hxx @@ -107,6 +107,8 @@ namespace connectivity virtual void initializeResultSet(OResultSet* _pResult); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void closeResultSet() throw (css::sdbc::SQLException, css::uno::RuntimeException, std::exception); void disposeResultSet(); @@ -135,6 +137,8 @@ namespace connectivity using OStatement_BASE::operator css::uno::Reference< css::uno::XInterface >; + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException virtual void construct(const OUString& sql) throw(css::sdbc::SQLException, css::uno::RuntimeException, std::exception); // OComponentHelper diff --git a/connectivity/source/inc/file/fcomp.hxx b/connectivity/source/inc/file/fcomp.hxx index 90f99dc86899..3f07487be100 100644 --- a/connectivity/source/inc/file/fcomp.hxx +++ b/connectivity/source/inc/file/fcomp.hxx @@ -68,12 +68,26 @@ namespace connectivity void setOrigColumns(const css::uno::Reference< css::container::XNameAccess>& rCols) { m_orgColumns = rCols; } const css::uno::Reference< css::container::XNameAccess>& getOrigColumns() const { return m_orgColumns; } protected: + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void execute_COMPARE(connectivity::OSQLParseNode* pPredicateNode) throw( css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void execute_LIKE(connectivity::OSQLParseNode* pPredicateNode) throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void execute_BETWEEN(connectivity::OSQLParseNode* pPredicateNode) throw(css::sdbc::SQLException, css::uno::RuntimeException, std::exception); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void execute_ISNULL(connectivity::OSQLParseNode* pPredicateNode) throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException OOperand* execute_Operand(connectivity::OSQLParseNode* pPredicateNode) throw(css::sdbc::SQLException, css::uno::RuntimeException, std::exception); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void execute_Fold(OSQLParseNode* pPredicateNode) throw( css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void executeFunction(OSQLParseNode* pPredicateNode) throw( css::sdbc::SQLException, css::uno::RuntimeException); }; diff --git a/connectivity/source/inc/flat/EDriver.hxx b/connectivity/source/inc/flat/EDriver.hxx index 0d9641cd6c51..ece686c5be74 100644 --- a/connectivity/source/inc/flat/EDriver.hxx +++ b/connectivity/source/inc/flat/EDriver.hxx @@ -28,7 +28,7 @@ namespace connectivity { namespace flat { - + /// @throws css::uno::Exception css::uno::Reference< css::uno::XInterface > SAL_CALL ODriver_CreateInstance(const css::uno::Reference< css::lang::XMultiServiceFactory >& _rxFactory) throw( css::uno::Exception ); class ODriver : public file::OFileDriver @@ -37,6 +37,7 @@ namespace connectivity ODriver(const css::uno::Reference< css::uno::XComponentContext >& _rxContext) : file::OFileDriver(_rxContext){} // XInterface + /// @throws css::uno::RuntimeException static OUString getImplementationName_Static( ) throw(css::uno::RuntimeException); // static css::uno::Sequence< OUString > getSupportedServiceNames_Static( ) throw (css::uno::RuntimeException); diff --git a/connectivity/source/inc/hsqldb/HDriver.hxx b/connectivity/source/inc/hsqldb/HDriver.hxx index dd19db7ebc1d..a63e4734e3a1 100644 --- a/connectivity/source/inc/hsqldb/HDriver.hxx +++ b/connectivity/source/inc/hsqldb/HDriver.hxx @@ -38,6 +38,7 @@ namespace connectivity namespace hsqldb { + /// @throws css::uno::Exception css::uno::Reference< css::uno::XInterface > SAL_CALL ODriverDelegator_CreateInstance(const css::uno::Reference< css::lang::XMultiServiceFactory >& _rxFactory) throw( css::uno::Exception ); typedef ::cppu::WeakComponentImplHelper< css::sdbc::XDriver @@ -87,7 +88,9 @@ namespace connectivity // XServiceInfo DECLARE_SERVICE_INFO(); + /// @throws css::uno::RuntimeException static OUString getImplementationName_Static( ) throw(css::uno::RuntimeException); + /// @throws css::uno::RuntimeException static css::uno::Sequence< OUString > getSupportedServiceNames_Static( ) throw (css::uno::RuntimeException); // XDriver diff --git a/connectivity/source/inc/hsqldb/HUser.hxx b/connectivity/source/inc/hsqldb/HUser.hxx index 051112e78e71..74f94aa44bc9 100644 --- a/connectivity/source/inc/hsqldb/HUser.hxx +++ b/connectivity/source/inc/hsqldb/HUser.hxx @@ -35,6 +35,8 @@ namespace connectivity static OUString getPrivilegeString(sal_Int32 nRights); // return the privileges and additional the grant rights + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void findPrivilegesAndGrantPrivileges(const OUString& objName, sal_Int32 objType,sal_Int32& nRights,sal_Int32& nRightsWithGrant) throw(css::sdbc::SQLException, css::uno::RuntimeException); public: virtual void refreshGroups() override; diff --git a/connectivity/source/inc/java/sql/Driver.hxx b/connectivity/source/inc/java/sql/Driver.hxx index 876f00f1eb20..0eae2ffc06b1 100644 --- a/connectivity/source/inc/java/sql/Driver.hxx +++ b/connectivity/source/inc/java/sql/Driver.hxx @@ -29,6 +29,7 @@ namespace connectivity { + /// @throws css::uno::Exception css::uno::Reference< css::uno::XInterface > SAL_CALL java_sql_Driver_CreateInstance(const css::uno::Reference< css::lang::XMultiServiceFactory >& _rxFactory) throw( css::uno::Exception ); class java_sql_Driver : public ::cppu::WeakImplHelper< css::sdbc::XDriver,css::lang::XServiceInfo> @@ -42,7 +43,9 @@ namespace connectivity public: java_sql_Driver(const css::uno::Reference< css::uno::XComponentContext >& _rxContext); + /// @throws css::uno::RuntimeException static OUString getImplementationName_Static( ) throw(css::uno::RuntimeException); + /// @throws css::uno::RuntimeException static css::uno::Sequence< OUString > getSupportedServiceNames_Static( ) throw (css::uno::RuntimeException); // XServiceInfo diff --git a/connectivity/source/inc/java/sql/JStatement.hxx b/connectivity/source/inc/java/sql/JStatement.hxx index 7c53219b5fea..f8a377a18a54 100644 --- a/connectivity/source/inc/java/sql/JStatement.hxx +++ b/connectivity/source/inc/java/sql/JStatement.hxx @@ -58,23 +58,57 @@ namespace connectivity { + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException sal_Int32 getQueryTimeOut() throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException sal_Int32 getMaxFieldSize() throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException sal_Int32 getMaxRows() throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException sal_Int32 getResultSetConcurrency() throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException sal_Int32 getResultSetType() throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException sal_Int32 getFetchDirection() throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException sal_Int32 getFetchSize() throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException OUString getCursorName() throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void setQueryTimeOut(sal_Int32 _par0) throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void setMaxFieldSize(sal_Int32 _par0) throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void setMaxRows(sal_Int32 _par0) throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void setResultSetConcurrency(sal_Int32 _par0) throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void setResultSetType(sal_Int32 _par0) throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void setFetchDirection(sal_Int32 _par0) throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void setFetchSize(sal_Int32 _par0) throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void setCursorName(const OUString &_par0) throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void setEscapeProcessing(bool _par0) throw(css::sdbc::SQLException, css::uno::RuntimeException); protected: diff --git a/connectivity/source/inc/java/sql/ResultSet.hxx b/connectivity/source/inc/java/sql/ResultSet.hxx index 4ef232421530..22cdb392fdc0 100644 --- a/connectivity/source/inc/java/sql/ResultSet.hxx +++ b/connectivity/source/inc/java/sql/ResultSet.hxx @@ -65,13 +65,27 @@ namespace connectivity java::sql::ConnectionLog m_aLogger; java_sql_Connection* m_pConnection; + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException sal_Int32 getResultSetConcurrency() const throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException sal_Int32 getResultSetType() const throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException sal_Int32 getFetchDirection() const throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException sal_Int32 getFetchSize() const throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException OUString getCursorName() const throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void setFetchDirection(sal_Int32 _par0) throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void setFetchSize(sal_Int32 _par0) throw(css::sdbc::SQLException, css::uno::RuntimeException); protected: // Static data for the class diff --git a/connectivity/source/inc/java/tools.hxx b/connectivity/source/inc/java/tools.hxx index e60446306f2e..9514bce98a4e 100644 --- a/connectivity/source/inc/java/tools.hxx +++ b/connectivity/source/inc/java/tools.hxx @@ -41,6 +41,8 @@ namespace connectivity OUString JavaString2String(JNIEnv *pEnv,jstring Str); class java_util_Properties; + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException java_util_Properties* createStringPropertyArray(const css::uno::Sequence< css::beans::PropertyValue >& info ) throw(css::sdbc::SQLException, css::uno::RuntimeException); jobject convertTypeMapToJavaMap(JNIEnv *pEnv,const css::uno::Reference< css::container::XNameAccess > & _rMap); diff --git a/connectivity/source/inc/mysql/YDriver.hxx b/connectivity/source/inc/mysql/YDriver.hxx index c3d5c92c383e..917e6f07b322 100644 --- a/connectivity/source/inc/mysql/YDriver.hxx +++ b/connectivity/source/inc/mysql/YDriver.hxx @@ -42,6 +42,7 @@ namespace connectivity namespace mysql { + /// @throws css::uno::Exception css::uno::Reference< css::uno::XInterface > SAL_CALL ODriverDelegator_CreateInstance(const css::uno::Reference< css::lang::XMultiServiceFactory >& _rxMSF) throw( css::uno::Exception ); typedef ::cppu::WeakComponentImplHelper< css::sdbc::XDriver @@ -86,7 +87,9 @@ namespace connectivity // XServiceInfo DECLARE_SERVICE_INFO(); + /// @throws css::uno::RuntimeException static OUString getImplementationName_Static( ) throw(css::uno::RuntimeException); + /// @throws css::uno::RuntimeException static css::uno::Sequence< OUString > getSupportedServiceNames_Static( ) throw (css::uno::RuntimeException); // XDriver diff --git a/connectivity/source/inc/mysql/YUser.hxx b/connectivity/source/inc/mysql/YUser.hxx index a527f85bc403..07bdfc88cd37 100644 --- a/connectivity/source/inc/mysql/YUser.hxx +++ b/connectivity/source/inc/mysql/YUser.hxx @@ -35,6 +35,8 @@ namespace connectivity static OUString getPrivilegeString(sal_Int32 nRights); // return the privileges and additional the grant rights + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void findPrivilegesAndGrantPrivileges(const OUString& objName, sal_Int32 objType,sal_Int32& nRights,sal_Int32& nRightsWithGrant) throw(css::sdbc::SQLException, css::uno::RuntimeException); public: virtual void refreshGroups() override; diff --git a/connectivity/source/inc/odbc/OConnection.hxx b/connectivity/source/inc/odbc/OConnection.hxx index a3c0067e4a07..83894821c103 100644 --- a/connectivity/source/inc/odbc/OConnection.hxx +++ b/connectivity/source/inc/odbc/OConnection.hxx @@ -78,6 +78,7 @@ namespace connectivity public: oslGenericFunction getOdbcFunction(ODBC3SQLFunctionId _nIndex) const; + /// @throws css::sdbc::SQLException SQLRETURN Construct( const OUString& url,const css::uno::Sequence< css::beans::PropertyValue >& info) throw(css::sdbc::SQLException, std::exception); OConnection(const SQLHANDLE _pDriverHandle,ODBCDriver* _pDriver); diff --git a/connectivity/source/inc/odbc/ODatabaseMetaDataResultSet.hxx b/connectivity/source/inc/odbc/ODatabaseMetaDataResultSet.hxx index 5ab546e4d888..0040e80fd740 100644 --- a/connectivity/source/inc/odbc/ODatabaseMetaDataResultSet.hxx +++ b/connectivity/source/inc/odbc/ODatabaseMetaDataResultSet.hxx @@ -84,7 +84,11 @@ namespace connectivity // set the columncount of the driver void checkColumnCount(); static sal_Int32 getFetchDirection() { return css::sdbc::FetchDirection::FORWARD; } + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException static sal_Int32 getFetchSize() throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException static OUString getCursorName() throw(css::sdbc::SQLException, css::uno::RuntimeException); SWORD impl_getColumnType_nothrow(sal_Int32 columnIndex); @@ -184,34 +188,70 @@ namespace connectivity // XColumnLocate virtual sal_Int32 SAL_CALL findColumn( const OUString& columnName ) throw(css::sdbc::SQLException, css::uno::RuntimeException, std::exception) override; + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void openTablesTypes( ) throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void openTypeInfo() throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void openCatalogs() throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void openSchemas() throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void openTables(const css::uno::Any& catalog, const OUString& schemaPattern, const OUString& tableNamePattern, const css::uno::Sequence< OUString >& types ) throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void openColumnPrivileges( const css::uno::Any& catalog, const OUString& schema, const OUString& table, const OUString& columnNamePattern )throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void openColumns( const css::uno::Any& catalog, const OUString& schemaPattern, const OUString& tableNamePattern, const OUString& columnNamePattern )throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void openProcedureColumns( const css::uno::Any& catalog, const OUString& schemaPattern, const OUString& procedureNamePattern,const OUString& columnNamePattern )throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void openProcedures( const css::uno::Any& catalog, const OUString& schemaPattern, const OUString& procedureNamePattern)throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void openVersionColumns(const css::uno::Any& catalog, const OUString& schema, const OUString& table)throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void openBestRowIdentifier( const css::uno::Any& catalog, const OUString& schema, const OUString& table,sal_Int32 scope, bool nullable )throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void openForeignKeys( const css::uno::Any& catalog, const OUString* schema,const OUString* table, const css::uno::Any& catalog2, const OUString* schema2,const OUString* table2)throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void openExportedKeys(const css::uno::Any& catalog, const OUString& schema,const OUString& table)throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void openImportedKeys(const css::uno::Any& catalog, const OUString& schema,const OUString& table)throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void openPrimaryKeys(const css::uno::Any& catalog, const OUString& schema,const OUString& table)throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void openTablePrivileges(const css::uno::Any& catalog, const OUString& schemaPattern, const OUString& tableNamePattern)throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void openSpecialColumns(bool _bRowVer,const css::uno::Any& catalog, const OUString& schema, const OUString& table,sal_Int32 scope, bool nullable )throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void openIndexInfo( const css::uno::Any& catalog, const OUString& schema, const OUString& table,bool unique,bool approximate )throw(css::sdbc::SQLException, css::uno::RuntimeException); diff --git a/connectivity/source/inc/odbc/ODriver.hxx b/connectivity/source/inc/odbc/ODriver.hxx index 0c86c0695618..10751f94ac62 100644 --- a/connectivity/source/inc/odbc/ODriver.hxx +++ b/connectivity/source/inc/odbc/ODriver.hxx @@ -59,7 +59,9 @@ namespace connectivity // OComponentHelper virtual void SAL_CALL disposing() override; // XInterface + /// @throws css::uno::RuntimeException static OUString getImplementationName_Static( ) throw(css::uno::RuntimeException); + /// @throws css::uno::RuntimeException static css::uno::Sequence< OUString > getSupportedServiceNames_Static( ) throw (css::uno::RuntimeException); // XServiceInfo diff --git a/connectivity/source/inc/odbc/OPreparedStatement.hxx b/connectivity/source/inc/odbc/OPreparedStatement.hxx index 528289d88bf9..764dccf03062 100644 --- a/connectivity/source/inc/odbc/OPreparedStatement.hxx +++ b/connectivity/source/inc/odbc/OPreparedStatement.hxx @@ -59,12 +59,17 @@ namespace connectivity bool m_bPrepared; void FreeParams(); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void putParamData (sal_Int32 index) throw (css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void setStream (sal_Int32 ParameterIndex,const css::uno::Reference< css::io::XInputStream>& x, SQLLEN length,sal_Int32 SQLtype) throw (css::sdbc::SQLException, css::uno::RuntimeException); SQLLEN* getLengthBuf (sal_Int32 index); void* allocBindBuf ( sal_Int32 index, sal_Int32 bufLen); + /// @throws css::sdbc::SQLException void initBoundParam () throw(css::sdbc::SQLException); void setParameterPre(sal_Int32 parameterIndex); template <typename T> void setScalarParameter(sal_Int32 parameterIndex, sal_Int32 _nType, SQLULEN _nColumnSize, const T i_Value); diff --git a/connectivity/source/inc/odbc/OResultSet.hxx b/connectivity/source/inc/odbc/OResultSet.hxx index 1f4965a56b45..5c157d06006b 100644 --- a/connectivity/source/inc/odbc/OResultSet.hxx +++ b/connectivity/source/inc/odbc/OResultSet.hxx @@ -167,6 +167,8 @@ namespace connectivity void fillColumn(sal_Int32 _nToColumn); void allocBuffer(); void releaseBuffer(); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void updateValue(sal_Int32 columnIndex,SQLSMALLINT _nType,void* _pValue) throw(css::sdbc::SQLException, css::uno::RuntimeException); void fillNeededData(SQLRETURN _nRet); bool moveImpl(IResultSetHelper::Movement _eCursorPosition, sal_Int32 _nOffset); @@ -180,13 +182,29 @@ namespace connectivity // for simple cases template < typename T > T impl_getValue( const sal_Int32 _nColumnIndex, SQLSMALLINT nType ); // these cases need some special treatment + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException bool impl_getBoolean( sal_Int32 columnIndex ) throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException css::uno::Sequence< sal_Int8 > impl_getBytes( sal_Int32 columnIndex ) throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException css::util::Date impl_getDate( sal_Int32 columnIndex ) throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException css::util::Time impl_getTime( sal_Int32 columnIndex ) throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException css::util::DateTime impl_getTimestamp( sal_Int32 columnIndex ) throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException sal_Int64 impl_getLong( sal_Int32 columnIndex ) throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException OUString impl_getString( sal_Int32 columnIndex ) throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException css::uno::Sequence<sal_Int8> impl_getBookmark( ) throw(css::sdbc::SQLException, css::uno::RuntimeException); diff --git a/connectivity/source/inc/odbc/OResultSetMetaData.hxx b/connectivity/source/inc/odbc/OResultSetMetaData.hxx index ed80647e27be..b496b7b63b70 100644 --- a/connectivity/source/inc/odbc/OResultSetMetaData.hxx +++ b/connectivity/source/inc/odbc/OResultSetMetaData.hxx @@ -48,7 +48,11 @@ namespace connectivity sal_Int32 m_nColCount; bool m_bUseODBC2Types; + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException OUString getCharColAttrib(sal_Int32 column,sal_Int32 ident) throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException sal_Int32 getNumColAttrib(sal_Int32 column,sal_Int32 ident) throw(css::sdbc::SQLException, css::uno::RuntimeException); public: // A ctor that is needed for returning the object @@ -68,12 +72,16 @@ namespace connectivity virtual ~OResultSetMetaData() override; + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException static SQLLEN getNumColAttrib(OConnection* _pConnection ,SQLHANDLE _aStatementHandle ,const css::uno::Reference< css::uno::XInterface >& _xInterface ,sal_Int32 _column ,sal_Int32 ident) throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException static SQLSMALLINT getColumnODBCType(OConnection* _pConnection ,SQLHANDLE _aStatementHandle ,const css::uno::Reference< css::uno::XInterface >& _xInterface diff --git a/connectivity/source/inc/odbc/OStatement.hxx b/connectivity/source/inc/odbc/OStatement.hxx index 462007c338ca..917187cc9b67 100644 --- a/connectivity/source/inc/odbc/OStatement.hxx +++ b/connectivity/source/inc/odbc/OStatement.hxx @@ -102,11 +102,21 @@ namespace connectivity void setResultSetType(sal_Int32 _par0) ; void setUsingBookmarks(bool _bUseBookmark) ; + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void reset() throw (css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void clearMyResultSet() throw (css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException void setWarning (const css::sdbc::SQLWarning &ex) throw (css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException bool lockIfNecessary (const OUString& sql) throw (css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException sal_Int32 getColumnCount() throw (css::sdbc::SQLException, css::uno::RuntimeException); @@ -114,6 +124,8 @@ namespace connectivity // getResultSet returns the current result as a ResultSet. It // returns NULL if the current result is not a ResultSet. + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException css::uno::Reference<css::sdbc::XResultSet> getResultSet(bool checkCount) throw (css::sdbc::SQLException, css::uno::RuntimeException, std::exception); /** @@ -121,6 +133,8 @@ namespace connectivity */ virtual OResultSet* createResulSet(); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException SQLLEN getRowCount() throw (css::sdbc::SQLException, css::uno::RuntimeException); diff --git a/connectivity/source/inc/odbc/OTools.hxx b/connectivity/source/inc/odbc/OTools.hxx index d821a772b131..919101e72ba5 100644 --- a/connectivity/source/inc/odbc/OTools.hxx +++ b/connectivity/source/inc/odbc/OTools.hxx @@ -99,6 +99,7 @@ namespace connectivity class OOO_DLLPUBLIC_ODBCBASE OTools { public: + /// @throws css::sdbc::SQLException static void ThrowException( const OConnection* _pConnection, SQLRETURN _rRetCode, SQLHANDLE _pContext, @@ -108,6 +109,8 @@ namespace connectivity rtl_TextEncoding _nTextEncoding = RTL_TEXTENCODING_MS_1252) throw(css::sdbc::SQLException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException static void GetInfo(OConnection* _pConnection, SQLHANDLE _aConnectionHandle, SQLUSMALLINT _nInfo, @@ -116,18 +119,24 @@ namespace connectivity rtl_TextEncoding _nTextEncoding) throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException static void GetInfo(OConnection* _pConnection, SQLHANDLE _aConnectionHandle, SQLUSMALLINT _nInfo, sal_Int32 &_rValue, const css::uno::Reference< css::uno::XInterface >& _xInterface) throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException static void GetInfo(OConnection* _pConnection, SQLHANDLE _aConnectionHandle, SQLUSMALLINT _nInfo, SQLUSMALLINT &_rValue, const css::uno::Reference< css::uno::XInterface >& _xInterface) throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException static void GetInfo(OConnection* _pConnection, SQLHANDLE _aConnectionHandle, SQLUSMALLINT _nInfo, @@ -179,6 +188,8 @@ namespace connectivity SQLSMALLINT& fCType, SQLSMALLINT& fSqlType); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException static OUString getStringValue( OConnection* _pConnection, SQLHANDLE _aStatementHandle, sal_Int32 columnIndex, @@ -187,12 +198,16 @@ namespace connectivity const css::uno::Reference< css::uno::XInterface >& _xInterface, rtl_TextEncoding _nTextEncoding) throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException static css::uno::Sequence<sal_Int8> getBytesValue(const OConnection* _pConnection, SQLHANDLE _aStatementHandle, sal_Int32 columnIndex, SQLSMALLINT _fSqlType, bool &_bWasNull, const css::uno::Reference< css::uno::XInterface >& _xInterface) throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException static void getValue( OConnection* _pConnection, SQLHANDLE _aStatementHandle, sal_Int32 columnIndex, @@ -202,6 +217,8 @@ namespace connectivity void* _pValue, SQLLEN _nSize) throw(css::sdbc::SQLException, css::uno::RuntimeException); + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException static void bindValue( OConnection* _pConnection, SQLHANDLE _aStatementHandle, sal_Int32 columnIndex, @@ -215,6 +232,8 @@ namespace connectivity bool _bUseOldTimeDate) throw(css::sdbc::SQLException, css::uno::RuntimeException); }; + /// @throws css::sdbc::SQLException + /// @throws css::uno::RuntimeException template <class T> void getValue( OConnection* _pConnection, SQLHANDLE _aStatementHandle, sal_Int32 columnIndex, diff --git a/connectivity/source/manager/mdrivermanager.cxx b/connectivity/source/manager/mdrivermanager.cxx index 116412fc551a..3b3754e2c8bd 100644 --- a/connectivity/source/manager/mdrivermanager.cxx +++ b/connectivity/source/manager/mdrivermanager.cxx @@ -49,6 +49,7 @@ using namespace ::osl; #define SERVICE_SDBC_DRIVER "com.sun.star.sdbc.Driver" +/// @throws NoSuchElementException void throwNoSuchElementException() throw(NoSuchElementException) { throw NoSuchElementException(); diff --git a/connectivity/source/manager/mdrivermanager.hxx b/connectivity/source/manager/mdrivermanager.hxx index b1c24120d470..fed7b9a26a75 100644 --- a/connectivity/source/manager/mdrivermanager.hxx +++ b/connectivity/source/manager/mdrivermanager.hxx @@ -105,8 +105,11 @@ namespace drivermanager virtual css::uno::Sequence< OUString > SAL_CALL getSupportedServiceNames( ) throw(css::uno::RuntimeException, std::exception) override; // XServiceInfo - static methods + /// @throws css::uno::RuntimeException static OUString SAL_CALL getImplementationName_static( ) throw(css::uno::RuntimeException); + /// @throws css::uno::RuntimeException static css::uno::Sequence< OUString > SAL_CALL getSupportedServiceNames_static( ) throw(css::uno::RuntimeException); + /// @throws css::uno::RuntimeException static OUString SAL_CALL getSingletonName_static( ) throw(css::uno::RuntimeException); static css::uno::Reference< css::uno::XInterface > SAL_CALL Create( const css::uno::Reference< css::lang::XMultiServiceFactory >& _rxContext ); 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 |