426 lines
25 KiB
C++
426 lines
25 KiB
C++
/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
|
|
/*************************************************************************
|
|
*
|
|
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
|
*
|
|
* Copyright 2000, 2010 Oracle and/or its affiliates.
|
|
*
|
|
* OpenOffice.org - a multi-platform office productivity suite
|
|
*
|
|
* This file is part of OpenOffice.org.
|
|
*
|
|
* OpenOffice.org is free software: you can redistribute it and/or modify
|
|
* it under the terms of the GNU Lesser General Public License version 3
|
|
* only, as published by the Free Software Foundation.
|
|
*
|
|
* OpenOffice.org is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU Lesser General Public License version 3 for more details
|
|
* (a copy is included in the LICENSE file that accompanied this code).
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public License
|
|
* version 3 along with OpenOffice.org. If not, see
|
|
* <http://www.openoffice.org/license.html>
|
|
* for a copy of the LGPLv3 License.
|
|
*
|
|
************************************************************************/
|
|
#ifndef DBACCESS_CORE_API_ROWSETBASE_HXX
|
|
#define DBACCESS_CORE_API_ROWSETBASE_HXX
|
|
|
|
#include <cppuhelper/implbase10.hxx>
|
|
#include <com/sun/star/sdbcx/XColumnsSupplier.hpp>
|
|
#include <com/sun/star/sdbc/XRow.hpp>
|
|
#include <com/sun/star/sdbc/XColumnLocate.hpp>
|
|
#include <com/sun/star/sdbc/XCloseable.hpp>
|
|
#include <com/sun/star/sdbcx/XRowLocate.hpp>
|
|
#include <com/sun/star/sdbc/XResultSetMetaDataSupplier.hpp>
|
|
#include <com/sun/star/sdbc/XWarningsSupplier.hpp>
|
|
#include <com/sun/star/lang/XServiceInfo.hpp>
|
|
#include <com/sun/star/lang/XUnoTunnel.hpp>
|
|
#include <cppuhelper/interfacecontainer.h>
|
|
#include <connectivity/sqlerror.hxx>
|
|
#include <connectivity/CommonTools.hxx>
|
|
#include <comphelper/propertystatecontainer.hxx>
|
|
#include <comphelper/proparrhlp.hxx>
|
|
#include <com/sun/star/sdbc/XRowSet.hpp>
|
|
#include <com/sun/star/util/XNumberFormatTypes.hpp>
|
|
#include <com/sun/star/container/XNameAccess.hpp>
|
|
#include "RowSetRow.hxx"
|
|
#include <comphelper/broadcasthelper.hxx>
|
|
#include "RowSetCacheIterator.hxx"
|
|
#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;
|
|
|
|
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;
|
|
// return <TRUE/> if the property change notification should be fired
|
|
// upon property change.
|
|
virtual sal_Bool isPropertyChangeNotificationEnabled() const;
|
|
// 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 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
|
|
|
|
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */
|