| /************************************************************** |
| * |
| * Licensed to the Apache Software Foundation (ASF) under one |
| * or more contributor license agreements. See the NOTICE file |
| * distributed with this work for additional information |
| * regarding copyright ownership. The ASF licenses this file |
| * to you under the Apache License, Version 2.0 (the |
| * "License"); you may not use this file except in compliance |
| * with the License. You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, |
| * software distributed under the License is distributed on an |
| * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY |
| * KIND, either express or implied. See the License for the |
| * specific language governing permissions and limitations |
| * under the License. |
| * |
| *************************************************************/ |
| |
| |
| #ifndef DBACCESS_CORE_API_ROWSETBASE_HXX |
| #define DBACCESS_CORE_API_ROWSETBASE_HXX |
| |
| #ifndef _CPPUHELPER_IMPLBASE10_HXX_ |
| #include <cppuhelper/implbase10.hxx> |
| #endif |
| #ifndef _COM_SUN_STAR_SDBCX_XCOLUMNSSUPPLIER_HPP_ |
| #include <com/sun/star/sdbcx/XColumnsSupplier.hpp> |
| #endif |
| #ifndef _COM_SUN_STAR_SDBC_XROW_HPP_ |
| #include <com/sun/star/sdbc/XRow.hpp> |
| #endif |
| #ifndef _COM_SUN_STAR_SDBC_XCOLUMNLOCATE_HPP_ |
| #include <com/sun/star/sdbc/XColumnLocate.hpp> |
| #endif |
| #ifndef _COM_SUN_STAR_SDBC_XCLOSEABLE_HPP_ |
| #include <com/sun/star/sdbc/XCloseable.hpp> |
| #endif |
| #ifndef _COM_SUN_STAR_SDBCX_XROWLOCATE_HPP_ |
| #include <com/sun/star/sdbcx/XRowLocate.hpp> |
| #endif |
| #ifndef _COM_SUN_STAR_SDBC_XRESULTSETMETADATASUPPLIER_HPP_ |
| #include <com/sun/star/sdbc/XResultSetMetaDataSupplier.hpp> |
| #endif |
| #ifndef _COM_SUN_STAR_SDBC_XWARNINGSSUPPLIER_HPP_ |
| #include <com/sun/star/sdbc/XWarningsSupplier.hpp> |
| #endif |
| #ifndef _COM_SUN_STAR_LANG_XSERVICEINFO_HPP_ |
| #include <com/sun/star/lang/XServiceInfo.hpp> |
| #endif |
| #ifndef _COM_SUN_STAR_LANG_XUNOTUNNEL_HPP_ |
| #include <com/sun/star/lang/XUnoTunnel.hpp> |
| #endif |
| #ifndef _CPPUHELPER_INTERFACECONTAINER_H_ |
| #include <cppuhelper/interfacecontainer.h> |
| #endif |
| #ifndef CONNECTIVITY_SQLERROR_HXX |
| #include <connectivity/sqlerror.hxx> |
| #endif |
| #ifndef _CONNECTIVITY_COMMONTOOLS_HXX_ |
| #include <connectivity/CommonTools.hxx> |
| #endif |
| #ifndef COMPHELPER_PROPERTYSTATECONTAINER_HXX |
| #include <comphelper/propertystatecontainer.hxx> |
| #endif |
| #ifndef _COMPHELPER_PROPERTY_ARRAY_HELPER_HXX_ |
| #include <comphelper/proparrhlp.hxx> |
| #endif |
| #ifndef _COM_SUN_STAR_SDBC_XROWSET_HPP_ |
| #include <com/sun/star/sdbc/XRowSet.hpp> |
| #endif |
| #ifndef _COM_SUN_STAR_UTIL_XNUMBERFORMATTYPES_HPP_ |
| #include <com/sun/star/util/XNumberFormatTypes.hpp> |
| #endif |
| #ifndef _COM_SUN_STAR_CONTAINER_XNAMEACCESS_HPP_ |
| #include <com/sun/star/container/XNameAccess.hpp> |
| #endif |
| #ifndef DBACCESS_CORE_API_ROWSETROW_HXX |
| #include "RowSetRow.hxx" |
| #endif |
| #ifndef _COMPHELPER_BROADCASTHELPER_HXX_ |
| #include <comphelper/broadcasthelper.hxx> |
| #endif |
| #ifndef DBACCESS_ROWSETCACHEITERATOR_HXX |
| #include "RowSetCacheIterator.hxx" |
| #endif |
| #include "core_resource.hxx" |
| #include <comphelper/componentcontext.hxx> |
| |
| #include <functional> |
| |
| |
| namespace com { namespace sun { namespace star { |
| namespace sdb { struct RowChangeEvent; } |
| namespace lang { struct Locale; } |
| } } } |
| |
| namespace dbaccess |
| { |
| class OEmptyCollection; |
| |
| typedef ::cppu::ImplHelper10< ::com::sun::star::sdbcx::XRowLocate, |
| ::com::sun::star::sdbc::XRow, |
| ::com::sun::star::sdbc::XResultSetMetaDataSupplier, |
| ::com::sun::star::sdbc::XWarningsSupplier, |
| ::com::sun::star::sdbc::XColumnLocate, |
| ::com::sun::star::sdbcx::XColumnsSupplier, |
| ::com::sun::star::lang::XServiceInfo, |
| ::com::sun::star::sdbc::XRowSet, |
| ::com::sun::star::sdbc::XCloseable, |
| ::com::sun::star::lang::XUnoTunnel> ORowSetBase_BASE; |
| |
| class ORowSetCache; |
| class ORowSetDataColumns; |
| class ORowSetCacheIterator; |
| class ORowSetDataColumn; |
| class ORowSetBase : public ORowSetBase_BASE, |
| public ::comphelper::OPropertyStateContainer, |
| public ::comphelper::OPropertyArrayUsageHelper<ORowSetBase> // this class hold the static property info |
| { |
| OModuleClient m_aModuleClient; |
| protected: |
| typedef ::std::vector<ORowSetDataColumn*> TDataColumns; |
| ::osl::Mutex* m_pMutex; // this the mutex form the rowset itself |
| ::osl::Mutex m_aRowCountMutex, // mutex for rowcount changes |
| // we need a extra mutex for columns to prevend deadlock when setting new values |
| // for a row |
| m_aColumnsMutex; |
| |
| ::com::sun::star::uno::Any m_aBookmark; |
| ORowSetCacheIterator m_aCurrentRow; // contains the actual fetched row |
| TORowSetOldRowHelperRef m_aOldRow; |
| TDataColumns m_aDataColumns; // holds the columns as m_pColumns but know the implementation class |
| connectivity::ORowSetValue m_aEmptyValue; // only for error case |
| |
| ::cppu::OWeakObject* m_pMySelf; // set by derived classes |
| ORowSetCache* m_pCache; // the cache is used by the rowset and his clone (shared) |
| ORowSetDataColumns* m_pColumns; // represent the select columns |
| ::cppu::OBroadcastHelper& m_rBHelper; // must be set from the derived classes |
| // is used when the formatkey for database types is set |
| ::com::sun::star::uno::Reference< ::com::sun::star::util::XNumberFormatTypes> m_xNumberFormatTypes; |
| OEmptyCollection* m_pEmptyCollection; |
| |
| ::comphelper::ComponentContext m_aContext; |
| ::connectivity::SQLError m_aErrors; |
| |
| sal_Int32 m_nLastColumnIndex; // the last column ask for, used for wasNull() |
| sal_Int32 m_nDeletedPosition; // is set only when a row was deleted |
| sal_Int32 m_nResultSetType; // fetch property |
| sal_Int32 m_nResultSetConcurrency; |
| sal_Bool m_bClone; // I'm clone or not |
| sal_Bool m_bIgnoreResult ; |
| sal_Bool m_bBeforeFirst : 1; |
| sal_Bool m_bAfterLast : 1; |
| sal_Bool m_bIsInsertRow : 1; |
| |
| protected: |
| ORowSetBase( |
| const ::comphelper::ComponentContext& _rContext, |
| ::cppu::OBroadcastHelper& _rBHelper, |
| ::osl::Mutex* _pMutex |
| ); |
| |
| // fire a notification for all that are listening on column::VALUE property |
| void firePropertyChange(const ORowSetRow& _rOldRow); |
| // fire a change for one column |
| // _nPos starts at zero |
| void firePropertyChange(sal_Int32 _nPos,const ::connectivity::ORowSetValue& _rNewValue); |
| |
| // fire if rowcount changed |
| virtual void fireRowcount(); |
| // notify row changed |
| virtual sal_Bool notifyAllListenersCursorBeforeMove(::osl::ResettableMutexGuard& _rGuard); |
| // notify cursor moved |
| virtual void notifyAllListenersCursorMoved(::osl::ResettableMutexGuard& _rGuard); |
| // notify all that rowset changed |
| virtual void notifyAllListeners(::osl::ResettableMutexGuard& _rGuard); |
| |
| // cancel the insertion, if necessary (means if we're on the insert row) |
| virtual void doCancelModification( ) = 0; |
| // return <TRUE/> if and only if we're using the insert row (means: we're updating _or_ inserting) |
| virtual sal_Bool isModification( ) = 0; |
| // return <TRUE/> if and only if the current row is modified |
| // TODO: isn't this the same as isModification? |
| virtual sal_Bool isModified( ) = 0; |
| // return <TRUE/> if and only if the current row is the insert row |
| virtual sal_Bool isNew( ) = 0; |
| // notify the change of a boolean property |
| void fireProperty( sal_Int32 _nProperty, sal_Bool _bNew, sal_Bool _bOld ); |
| |
| // OPropertyStateContainer |
| virtual void getPropertyDefaultByHandle( sal_Int32 _nHandle, ::com::sun::star::uno::Any& _rDefault ) const; |
| virtual void SAL_CALL getFastPropertyValue(::com::sun::star::uno::Any& rValue,sal_Int32 nHandle) const; |
| |
| enum CursorMoveDirection |
| { |
| /// denotes a cursor move forward |
| MOVE_FORWARD, |
| /// denotes a cursor move backwards |
| MOVE_BACKWARD, |
| /// denotes no cursor move at all, used when the current row is to be refreshed only |
| MOVE_NONE_REFRESH_ONLY |
| }; |
| /** positions the cache in preparation of a cursor move |
| |
| Normally, the cache is simply moved to our bookmark (m_aBookmark). If however the current |
| row is deleted, then the cache is properly positioned for a following cursor movement in the |
| given direction. |
| |
| @param _ePrepareForDirection |
| the direction into which the cursor should be moved after the call. If we're currently not on |
| a deleted row, this parameter is ignored, since in this case the cache is simply moved to |
| m_aBookmark.</br> |
| If, however, we're currently on a deleted row, this is used to properly position the cache |
| using <member>m_nDeletedPosition</member>.<br/> |
| In this case, MOVE_NONE_REFRESH_ONLY is not supported. This is because the deleted row |
| (to which the RowSet currently points to) is not present in the cache. So, you cannot move the |
| cache to this row. |
| */ |
| void positionCache( CursorMoveDirection _ePrepareForDirection ); |
| |
| // returns a value of a column of the current row |
| const connectivity::ORowSetValue& getValue(sal_Int32 columnIndex); |
| // the cache has to be checked before calling this method |
| const connectivity::ORowSetValue& impl_getValue(sal_Int32 columnIndex); |
| // sets the current and the bookmark |
| void setCurrentRow( sal_Bool _bMoved, sal_Bool _bDoNotify, const ORowSetRow& _rOldValues, ::osl::ResettableMutexGuard& _rGuard); |
| void checkPositioningAllowed() throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| // checks if the cache is null |
| void checkCache(); |
| // sets the bookmark to Any() |
| // m_aCurrentRow to end of matrix |
| // m_aOldRow to NULL |
| void movementFailed(); |
| |
| ORowSetRow getOldRow(sal_Bool _bWasNew); |
| /** move the cache the postion defined by the member functor |
| @param _aCheckFunctor |
| Return <TRUE/> when we already stand on the row we want to. |
| @param _aMovementFunctor |
| The mehtod used to move. |
| @return |
| <TRUE/> if movement was successful. |
| */ |
| sal_Bool SAL_CALL move( ::std::mem_fun_t<sal_Bool,ORowSetBase>& _aCheckFunctor, |
| ::std::mem_fun_t<sal_Bool,ORowSetCache>& _aMovementFunctor); |
| |
| /** same meaning as isFirst. Only need by mem_fun |
| @return |
| <TRUE/> if so. |
| */ |
| sal_Bool isOnFirst(); |
| /** same meaning as isLast. Only need by mem_fun |
| @return |
| <TRUE/> if so. |
| */ |
| sal_Bool isOnLast(); |
| |
| /** returns the current row count |
| |
| This function takes into account that we might actually be positioned on a |
| deleted row, so that m_pCache->m_nRowCount does not really reflect the actual |
| count. |
| |
| @precond |
| Our mutext is locked. |
| */ |
| sal_Int32 impl_getRowCount() const; |
| |
| // the checkCache has to be called before calling this methods |
| sal_Bool impl_wasNull(); |
| sal_Int32 impl_getRow(); |
| sal_Bool impl_rowDeleted(); |
| |
| public: |
| virtual ~ORowSetBase(); |
| |
| // OComponentHelper |
| virtual void SAL_CALL disposing(void); |
| |
| // com::sun::star::beans::XPropertySet |
| virtual ::com::sun::star::uno::Reference< ::com::sun::star::beans::XPropertySetInfo > SAL_CALL getPropertySetInfo( ) throw(::com::sun::star::uno::RuntimeException) |
| { |
| return ::cppu::OPropertySetHelper::createPropertySetInfo(getInfoHelper()); |
| } |
| |
| // comphelper::OPropertyArrayUsageHelper |
| virtual ::cppu::IPropertyArrayHelper* createArrayHelper( ) const; |
| |
| // cppu::OPropertySetHelper |
| virtual ::cppu::IPropertyArrayHelper& SAL_CALL getInfoHelper(); |
| |
| // com::sun::star::lang::XTypeProvider |
| virtual ::com::sun::star::uno::Sequence< ::com::sun::star::uno::Type > SAL_CALL getTypes() throw (::com::sun::star::uno::RuntimeException); |
| |
| // com::sun::star::uno::XInterface |
| virtual ::com::sun::star::uno::Any SAL_CALL queryInterface( const ::com::sun::star::uno::Type & rType ) throw (::com::sun::star::uno::RuntimeException); |
| |
| // ::com::sun::star::sdbc::XWarningsSupplier |
| virtual ::com::sun::star::uno::Any SAL_CALL getWarnings( ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| virtual void SAL_CALL clearWarnings( ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| |
| // ::com::sun::star::sdbc::XResultSetMetaDataSupplier |
| virtual ::com::sun::star::uno::Reference< ::com::sun::star::sdbc::XResultSetMetaData > SAL_CALL getMetaData( ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| |
| // ::com::sun::star::sdbc::XColumnLocate |
| virtual sal_Int32 SAL_CALL findColumn( const ::rtl::OUString& columnName ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| |
| // ::com::sun::star::sdbcx::XColumnsSupplier |
| virtual ::com::sun::star::uno::Reference< ::com::sun::star::container::XNameAccess > SAL_CALL getColumns( ) throw(::com::sun::star::uno::RuntimeException); |
| |
| // ::com::sun::star::sdbc::XRow |
| virtual sal_Bool SAL_CALL wasNull( ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| virtual ::rtl::OUString SAL_CALL getString( sal_Int32 columnIndex ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| virtual sal_Bool SAL_CALL getBoolean( sal_Int32 columnIndex ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| virtual sal_Int8 SAL_CALL getByte( sal_Int32 columnIndex ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| virtual sal_Int16 SAL_CALL getShort( sal_Int32 columnIndex ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| virtual sal_Int32 SAL_CALL getInt( sal_Int32 columnIndex ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| virtual sal_Int64 SAL_CALL getLong( sal_Int32 columnIndex ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| virtual float SAL_CALL getFloat( sal_Int32 columnIndex ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| virtual double SAL_CALL getDouble( sal_Int32 columnIndex ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| virtual ::com::sun::star::uno::Sequence< sal_Int8 > SAL_CALL getBytes( sal_Int32 columnIndex ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| virtual ::com::sun::star::util::Date SAL_CALL getDate( sal_Int32 columnIndex ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| virtual ::com::sun::star::util::Time SAL_CALL getTime( sal_Int32 columnIndex ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| virtual ::com::sun::star::util::DateTime SAL_CALL getTimestamp( sal_Int32 columnIndex ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| virtual ::com::sun::star::uno::Reference< ::com::sun::star::io::XInputStream > SAL_CALL getBinaryStream( sal_Int32 columnIndex ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| virtual ::com::sun::star::uno::Reference< ::com::sun::star::io::XInputStream > SAL_CALL getCharacterStream( sal_Int32 columnIndex ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| virtual ::com::sun::star::uno::Any SAL_CALL getObject( sal_Int32 columnIndex, const ::com::sun::star::uno::Reference< ::com::sun::star::container::XNameAccess >& typeMap ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| virtual ::com::sun::star::uno::Reference< ::com::sun::star::sdbc::XRef > SAL_CALL getRef( sal_Int32 columnIndex ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| virtual ::com::sun::star::uno::Reference< ::com::sun::star::sdbc::XBlob > SAL_CALL getBlob( sal_Int32 columnIndex ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| virtual ::com::sun::star::uno::Reference< ::com::sun::star::sdbc::XClob > SAL_CALL getClob( sal_Int32 columnIndex ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| virtual ::com::sun::star::uno::Reference< ::com::sun::star::sdbc::XArray > SAL_CALL getArray( sal_Int32 columnIndex ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| |
| // ::com::sun::star::sdbcx::XRowLocate |
| virtual ::com::sun::star::uno::Any SAL_CALL getBookmark( ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| virtual sal_Bool SAL_CALL moveToBookmark( const ::com::sun::star::uno::Any& bookmark ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| virtual sal_Bool SAL_CALL moveRelativeToBookmark( const ::com::sun::star::uno::Any& bookmark, sal_Int32 rows ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| virtual sal_Int32 SAL_CALL compareBookmarks( const ::com::sun::star::uno::Any& first, const ::com::sun::star::uno::Any& second ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| virtual sal_Bool SAL_CALL hasOrderedBookmarks( ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| virtual sal_Int32 SAL_CALL hashBookmark( const ::com::sun::star::uno::Any& bookmark ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| |
| // ::com::sun::star::sdbc::XResultSet |
| virtual sal_Bool SAL_CALL next( ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| virtual sal_Bool SAL_CALL isBeforeFirst( ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| virtual sal_Bool SAL_CALL isAfterLast( ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| virtual sal_Bool SAL_CALL isFirst( ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| virtual sal_Bool SAL_CALL isLast( ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| virtual void SAL_CALL beforeFirst( ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| virtual void SAL_CALL afterLast( ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| virtual sal_Bool SAL_CALL first( ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| virtual sal_Bool SAL_CALL last( ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| virtual sal_Int32 SAL_CALL getRow( ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| virtual sal_Bool SAL_CALL absolute( sal_Int32 row ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| virtual sal_Bool SAL_CALL relative( sal_Int32 rows ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| virtual sal_Bool SAL_CALL previous( ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| virtual void SAL_CALL refreshRow( ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| virtual sal_Bool SAL_CALL rowUpdated( ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| virtual sal_Bool SAL_CALL rowInserted( ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| virtual sal_Bool SAL_CALL rowDeleted( ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| virtual ::com::sun::star::uno::Reference< ::com::sun::star::uno::XInterface > SAL_CALL getStatement( ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException); |
| |
| // ::com::sun::star::sdbc::XRowSet |
| virtual void SAL_CALL execute( ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException) = 0; |
| virtual void SAL_CALL addRowSetListener( const ::com::sun::star::uno::Reference< ::com::sun::star::sdbc::XRowSetListener >& listener ) throw(::com::sun::star::uno::RuntimeException) = 0; |
| virtual void SAL_CALL removeRowSetListener( const ::com::sun::star::uno::Reference< ::com::sun::star::sdbc::XRowSetListener >& listener ) throw(::com::sun::star::uno::RuntimeException) = 0; |
| |
| // is called when the rowset is going to delete this bookmark _rBookmark |
| void onDeleteRow( const ::com::sun::star::uno::Any& _rBookmark ); |
| // is called when the rowset has deleted this bookmark _rBookmark |
| void onDeletedRow( const ::com::sun::star::uno::Any& _rBookmark, sal_Int32 _nPos ); |
| |
| // ========================================================== |
| // granular access control |
| struct GrantNotifierAccess { friend class ORowSetNotifier; private: GrantNotifierAccess () { } }; |
| |
| // cancel the insertion, if necessary (means if we're on the insert row) |
| inline void doCancelModification( const GrantNotifierAccess& ) { doCancelModification(); } |
| inline sal_Bool isModification( const GrantNotifierAccess& ) { return isModification(); } |
| inline sal_Bool isModified( const GrantNotifierAccess& ) { return isModified(); } |
| inline sal_Bool isNew( const GrantNotifierAccess& ) { return isNew(); } |
| inline sal_Bool isInsertRow() { return m_bIsInsertRow; } // isNew() || isModified(); } |
| inline void fireProperty( sal_Int32 _nProperty, sal_Bool _bNew, sal_Bool _bOld, const GrantNotifierAccess& ) |
| { |
| fireProperty( _nProperty, _bNew, _bOld ); |
| } |
| inline void firePropertyChange(sal_Int32 _nPos,const ::connectivity::ORowSetValue& _rNewValue, const GrantNotifierAccess& ) |
| { |
| firePropertyChange(_nPos,_rNewValue); |
| } |
| using ::comphelper::OPropertyStateContainer::getFastPropertyValue; |
| |
| ::osl::Mutex* getMutex() const { return m_pMutex; } |
| }; |
| |
| // ======================================================================== |
| /** eases the handling of the doCancelModification and notifyCancelInsert methods |
| |
| <p>The class can only be used on the stack, within a method of ORowSetBase (or derivees)</p> |
| */ |
| struct ORowSetNotifierImpl; |
| class ORowSetNotifier |
| { |
| private: |
| ::std::auto_ptr<ORowSetNotifierImpl> m_pImpl; |
| ORowSetBase* m_pRowSet; |
| // not aquired! This is not necessary because this class here is to be used on the stack within |
| // a method of ORowSetBase (or derivees) |
| sal_Bool m_bWasNew; |
| sal_Bool m_bWasModified; |
| |
| #ifdef DBG_UTIL |
| sal_Bool m_bNotifyCalled; |
| #endif |
| |
| public: |
| /** constructs the object, and cancels the insertion |
| |
| @see ORowSetBase::doCancelModification |
| */ |
| ORowSetNotifier( ORowSetBase* m_pRowSet ); |
| |
| /** use this one to consturct an vector for change value notification |
| */ |
| ORowSetNotifier( ORowSetBase* m_pRowSet,const ORowSetValueVector::Vector& i_aRow ); |
| |
| // destructs the object. <member>fire</member> has to be called before. |
| ~ORowSetNotifier( ); |
| |
| /** notifies the insertion |
| |
| <p>This has <em>not</em> been put into the destructor by intention!<br/> |
| |
| The destructor is called during stack unwinding in case of an exception, so if we would do |
| listener notification there, this would have the potential of another exception during stack |
| unwinding, which would terminate the application.</p> |
| |
| @see ORowSetBase::notifyCancelInsert |
| */ |
| void fire(); |
| |
| /** notifies value change events and notifies IsModified |
| @param i_aChangedColumns the index of the changed value columns |
| @param i_aRow the old values |
| @see ORowSetBase::notifyCancelInsert |
| */ |
| void firePropertyChange(); |
| |
| /** use this one to store the inde of the changed column values |
| */ |
| ::std::vector<sal_Int32>& getChangedColumns() const; |
| ::std::vector<com::sun::star::uno::Any>& getChangedBookmarks() const; |
| |
| }; |
| |
| } // end of namespace |
| |
| #endif // DBACCESS_CORE_API_ROWSETBASE_HXX |
| |
