include/comphelper/enumhelper.hxx

   1 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
   2 /*
   3  * This file is part of the LibreOffice project.
   4  *
   5  * This Source Code Form is subject to the terms of the Mozilla Public
   6  * License, v. 2.0. If a copy of the MPL was not distributed with this
   7  * file, You can obtain one at http://mozilla.org/MPL/2.0/.
   8  *
   9  * This file incorporates work covered by the following license notice:
  10  *
  11  *   Licensed to the Apache Software Foundation (ASF) under one or more
  12  *   contributor license agreements. See the NOTICE file distributed
  13  *   with this work for additional information regarding copyright
  14  *   ownership. The ASF licenses this file to you under the Apache
  15  *   License, Version 2.0 (the "License"); you may not use this file
  16  *   except in compliance with the License. You may obtain a copy of
  17  *   the License at http://www.apache.org/licenses/LICENSE-2.0 .
  18  */
  19
  20 #ifndef INCLUDED_COMPHELPER_ENUMHELPER_HXX
  21 #define INCLUDED_COMPHELPER_ENUMHELPER_HXX
  22
  23 #include <vector>
  24 #include <com/sun/star/container/XNameAccess.hpp>
  25 #include <com/sun/star/container/XEnumeration.hpp>
  26 #include <com/sun/star/container/XIndexAccess.hpp>
  27 #include <com/sun/star/lang/XEventListener.hpp>
  28 #include <cppuhelper/implbase.hxx>
  29 #include <osl/mutex.hxx>
  30 #include <comphelper/comphelperdllapi.h>
  31
  32 namespace comphelper
  33 {
  34
  35 struct OEnumerationLock
  36 {
  37     public:
  38         ::osl::Mutex m_aLock;
  39 };
  40
  41 /** provides an com.sun.star.container::XEnumeration access based
  42     on an object implementing the com.sun.star.container::XNameAccess interface
  43 */
  44 class COMPHELPER_DLLPUBLIC OEnumerationByName : private OEnumerationLock
  45                          , public ::cppu::WeakImplHelper< css::container::XEnumeration ,
  46                                                           css::lang::XEventListener    >
  47 {
  48     css::uno::Sequence< OUString >                m_aNames;
  49     sal_Int32                                           m_nPos;
  50     css::uno::Reference< css::container::XNameAccess >    m_xAccess;
  51     bool                                            m_bListening;
  52
  53 public:
  54     OEnumerationByName(const css::uno::Reference< css::container::XNameAccess >& _rxAccess);
  55     OEnumerationByName(const css::uno::Reference< css::container::XNameAccess >& _rxAccess,
  56                        const css::uno::Sequence< OUString >&             _aNames  );
  57     virtual ~OEnumerationByName();
  58
  59     virtual sal_Bool SAL_CALL hasMoreElements(  ) throw(css::uno::RuntimeException, std::exception) override;
  60     virtual css::uno::Any SAL_CALL nextElement(  )
  61         throw(css::container::NoSuchElementException, css::lang::WrappedTargetException, css::uno::RuntimeException, std::exception) override;
  62
  63     virtual void SAL_CALL disposing(const css::lang::EventObject& aEvent) throw(css::uno::RuntimeException, std::exception) override;
  64
  65 private:
  66     COMPHELPER_DLLPRIVATE void impl_startDisposeListening();
  67     COMPHELPER_DLLPRIVATE void impl_stopDisposeListening();
  68 };
  69
  70 /** provides an com.sun.star.container::XEnumeration access based
  71     on an object implementing the com.sun.star.container::XNameAccess interface
  72 */
  73 class COMPHELPER_DLLPUBLIC OEnumerationByIndex : private OEnumerationLock
  74                           , public ::cppu::WeakImplHelper< css::container::XEnumeration ,
  75                                                            css::lang::XEventListener    >
  76 {
  77     sal_Int32                                         m_nPos;
  78     css::uno::Reference< css::container::XIndexAccess > m_xAccess;
  79     bool                                          m_bListening;
  80
  81 public:
  82     OEnumerationByIndex(const css::uno::Reference< css::container::XIndexAccess >& _rxAccess);
  83     virtual ~OEnumerationByIndex();
  84
  85     virtual sal_Bool SAL_CALL hasMoreElements(  ) throw(css::uno::RuntimeException, std::exception) override;
  86     virtual css::uno::Any SAL_CALL nextElement(  )
  87         throw(css::container::NoSuchElementException, css::lang::WrappedTargetException, css::uno::RuntimeException, std::exception) override;
  88
  89     virtual void SAL_CALL disposing(const css::lang::EventObject& aEvent) throw(css::uno::RuntimeException, std::exception) override;
  90
  91 private:
  92     COMPHELPER_DLLPRIVATE void impl_startDisposeListening();
  93     COMPHELPER_DLLPRIVATE void impl_stopDisposeListening();
  94 };
  95
  96 // this is the way that works for ENABLE_LTO with MSVC 2013
  97 class SAL_DLLPUBLIC_TEMPLATE OAnyEnumeration_BASE
  98     : public ::cppu::WeakImplHelper<css::container::XEnumeration> {};
  99
 100 /** provides an com.sun.star.container::XEnumeration
 101     for an outside set vector of Any's.
 102
 103 */
 104 class COMPHELPER_DLLPUBLIC OAnyEnumeration : private OEnumerationLock
 105                                            , public OAnyEnumeration_BASE
 106 {
 107     sal_Int32                         m_nPos;
 108     css::uno::Sequence< css::uno::Any > m_lItems;
 109
 110 public:
 111     OAnyEnumeration(const css::uno::Sequence< css::uno::Any >& lItems);
 112     virtual ~OAnyEnumeration();
 113
 114     virtual sal_Bool SAL_CALL hasMoreElements(  ) throw(css::uno::RuntimeException, std::exception) override;
 115     virtual css::uno::Any SAL_CALL nextElement(  )
 116         throw(css::container::NoSuchElementException, css::lang::WrappedTargetException, css::uno::RuntimeException, std::exception) override;
 117
 118 };
 119
 120 }
 121
 122 #endif // INCLUDED_COMPHELPER_ENUMHELPER_HXX
 123
 124 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */