Quelle  VCollection.hxx

/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
/*
 * This file is part of the LibreOffice project.
 *
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/.
 *
 * This file incorporates work covered by the following license notice:
 *
 *   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 .
 */

#ifndef INCLUDED_CONNECTIVITY_SDBCX_VCOLLECTION_HXX
#define INCLUDED_CONNECTIVITY_SDBCX_VCOLLECTION_HXX

#include <cppuhelper/implbase10.hxx>
#include <com/sun/star/container/XNameAccess.hpp>
#include <com/sun/star/container/XIndexAccess.hpp>
#include <com/sun/star/container/XEnumerationAccess.hpp>
#include <com/sun/star/beans/XPropertySet.hpp>
#include <com/sun/star/util/XRefreshable.hpp>
#include <com/sun/star/sdbcx/XDataDescriptorFactory.hpp>
#include <com/sun/star/sdbcx/XAppend.hpp>
#include <com/sun/star/sdbcx/XDrop.hpp>
#include <com/sun/star/sdbc/XColumnLocate.hpp>
#include <comphelper/interfacecontainer3.hxx>
#include <com/sun/star/lang/XServiceInfo.hpp>
#include <connectivity/CommonTools.hxx>
#include <com/sun/star/container/XContainer.hpp>
#include <connectivity/dbtoolsdllapi.hxx>
#include <memory>


namespace connectivity::sdbcx
{

    // the class OCollection is base class for collections :-)
    typedef ::cppu::ImplHelper10< css::container::XNameAccess,
                                     css::container::XIndexAccess,
                                     css::container::XEnumerationAccess,
                                     css::container::XContainer,
                                     css::sdbc::XColumnLocate,
                                     css::util::XRefreshable,
                                     css::sdbcx::XDataDescriptorFactory,
                                     css::sdbcx::XAppend,
                                     css::sdbcx::XDrop,
                                     css::lang::XServiceInfo> OCollectionBase;

    class OOO_DLLPUBLIC_DBTOOLS SAL_NO_VTABLE IObjectCollection
    {
    public:
        virtual ~IObjectCollection();
        virtual bool exists(const OUString& _sName ) = 0;
        virtual bool empty() = 0;
        virtual void swapAll() = 0;
        virtual void swap() = 0;
        virtual void clear() = 0;
        virtual void reFill(const ::std::vector< OUString> &_rVector) = 0;
        virtual void insert(const OUString& _sName, const css::uno::Reference< css::beans::XPropertySet >& _xObject) = 0;
        virtual bool rename(const OUString& _sOldName, const OUString& _sNewName) = 0;
        virtual sal_Int32 size() = 0;
        virtual css::uno::Sequence< OUString > getElementNames() = 0;
        virtual OUString getName(sal_Int32 _nIndex) = 0;
        virtual void disposeAndErase(sal_Int32 _nIndex) = 0;
        virtual void disposeElements() = 0;
        virtual sal_Int32 findColumn( const OUString& columnName ) = 0;
        virtual css::uno::Reference< css::beans::XPropertySet > getObject(sal_Int32 _nIndex) = 0;
        virtual css::uno::Reference< css::beans::XPropertySet > getObject(const OUString& columnName) = 0;
        virtual void setObject(sal_Int32 _nIndex,const css::uno::Reference< css::beans::XPropertySet >& _xObject) = 0;
        virtual bool isCaseSensitive() const = 0;
    };

    //  OCollection

    class OOO_DLLPUBLIC_DBTOOLS SAL_NO_VTABLE OCollection :
        public OCollectionBase
    {
    protected:
        ::std::unique_ptr<IObjectCollection>    m_pElements;

        ::comphelper::OInterfaceContainerHelper3<css::container::XContainerListener> m_aContainerListeners;
        ::comphelper::OInterfaceContainerHelper3<css::util::XRefreshListener> m_aRefreshListeners;

    protected:
        ::cppu::OWeakObject&                    m_rParent;          // parent of the collection
        ::osl::Mutex&                           m_rMutex;           // mutex of the parent
        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() = 0;

        // will be called when an object was requested by one of the accessing methods like getByIndex
        virtual css::uno::Reference< css::beans::XPropertySet > createObject(const OUString& ;_rName) = 0;

        // will be called when a new object should be generated by a call of createDataDescriptor
        // the returned object is empty will be filled outside and added to the collection
        virtual css::uno::Reference< css::beans::XPropertySet > createDescriptor();

        /** appends an object described by a descriptor, under a given name
            @param _rForName
                is the name under which the object should be appended. Guaranteed to not be empty.
                This is passed for convenience only, since it's the result of a call of
                getNameForObject for the given descriptor
            @param descriptor
                describes the object to append
            @return
                the new object which is to be inserted into the collection. This might be the result
                of a call of <code>createObject( _rForName )</code>, or a clone of the descriptor.
        */
        virtual css::uno::Reference< css::beans::XPropertySet > appendObject( const OUString& ;_rForName, const css::uno::Reference< css::beans::XPropertySet >& descriptor );

        // called when XDrop was called
        virtual void dropObject(sal_Int32 _nPos, const OUString& _sElementName);

        /** returns the name for the object. The default implementation ask for the property NAME. If this doesn't satisfy, it has to be overridden.
            @param  _xObject    The object where the name should be extracted.
            @return The name of the object.
        */
        virtual OUString getNameForObject(const css::uno::Reference< css::beans::XPropertySet >&&nbsp;_xObject);

        /** clones the given descriptor

            The method calls createDescriptor to create a new, empty descriptor, and then copies all properties from
            _descriptor to the new object, which is returned.

            This method might come handy in derived classes for implementing appendObject, when the object
            is not actually appended to any backend (e.g. for the columns collection of a descriptor object itself,
            where there is not yet a database backend to append the column to).
        */
        css::uno::Reference< css::beans::XPropertySet > cloneDescriptor( const css::uno::Reference< css::beans::XPropertySet >& _descriptor );

        OCollection(::cppu::OWeakObject& _rParent,
                    bool _bCase,
                    ::osl::Mutex& _rMutex,
                    const ::std::vector< OUString> &_rVector,
                    bool _bUseIndexOnly = false,
                    bool _bUseHardRef = true);

        /** clear the name map
            <p>Does <em>not</em> dispose the objects hold by the collection.</p>
        */
        void clear_NoDispose();

        /**  insert a new element into the collection
        */
        void insertElement(const OUString& _sElementName,const css::uno::Reference< css::beans::XPropertySet >& _xElement);

        /** return the object, if not existent it creates it.
            @param  _nIndex
                The index of the object to create.
            @return ObjectType
        */
        css::uno::Reference< css::beans::XPropertySet > getObject(sal_Int32 _nIndex);

    public:
        virtual ~OCollection();
        DECLARE_SERVICE_INFO();

        void reFill(const ::std::vector< OUString> &_rVector);
        bool isCaseSensitive() const { return m_pElements->isCaseSensitive(); }
        void renameObject(const OUString& _sOldName, const OUString& _sNewName);

        // only the name is identical to ::cppu::OComponentHelper
        virtual void disposing();
        // dispatch the refcounting to the parent
        virtual void SAL_CALL acquire() noexcept override;
        virtual void SAL_CALL release() noexcept override;

        // XInterface
        virtual css::uno::Any SAL_CALL queryInterface( const css::uno::Type & rType ) override;
        virtual css::uno::Sequence< css::uno::Type > SAL_CALL getTypes() override;

        // css::container::XElementAccess
        virtual css::uno::Type SAL_CALL getElementType(  ) override;
        virtual sal_Bool SAL_CALL hasElements(  ) override;
        // css::container::XIndexAccess
        virtual sal_Int32 SAL_CALL getCount(  ) override;
        virtual css::uno::Any SAL_CALL getByIndex( sal_Int32 Index ) override;

            // css::container::XNameAccess
        virtual css::uno::Any SAL_CALL getByName( const OUString& aName ) override;
        virtual css::uno::Sequence< OUString > SAL_CALL getElementNames(  ) override;
        virtual sal_Bool SAL_CALL hasByName( const OUString& aName ) override;
        // XEnumerationAccess
        virtual css::uno::Reference< css::container::XEnumeration > SAL_CALL createEnumeration(  ) override;
                    // css::util::XRefreshable
        virtual void SAL_CALL refresh(  ) override;
        virtual void SAL_CALL addRefreshListener( const css::uno::Reference< css::util::XRefreshListener >& l ) override;
        virtual void SAL_CALL removeRefreshListener( const css::uno::Reference< css::util::XRefreshListener >& l ) override;
        // XDataDescriptorFactory
        virtual css::uno::Reference< css::beans::XPropertySet > SAL_CALL createDataDescriptor(  ) override;
        // XAppend
        virtual void SAL_CALL appendByDescriptor( const css::uno::Reference< css::beans::XPropertySet >& descriptor ) override;
        // XDrop
        virtual void SAL_CALL dropByName( const OUString& elementName ) override;
        virtual void SAL_CALL dropByIndex( sal_Int32 index ) override;
        // XColumnLocate
        virtual sal_Int32 SAL_CALL findColumn( const OUString& columnName ) override;
        // css::container::XContainer
        virtual void SAL_CALL addContainerListener( const css::uno::Reference< css::container::XContainerListener >& xListener ) override;
        virtual void SAL_CALL removeContainerListener( const css::uno::Reference< css::container::XContainerListener >& xListener ) override;
    private:
        void notifyElementRemoved(const OUString& _sName);
        void disposeElements();
        void dropImpl(sal_Int32 _nIndex, bool _bReallyDrop = true);
    };

}
#endif // INCLUDED_CONNECTIVITY_SDBCX_VCOLLECTION_HXX


/* vim:set shiftwidth=4 softtabstop=4 expandtab: */