office-gobmx/configmgr/source/broadcaster.hxx
Mike Kaganski 8e9b3abce9 Make sure that root listeners are notified first
The problem appeared when in a configuration listener's changesOccurred,
a configuration value was read using officecfg machinery, which could
return the old value of the configuration, or an updated one, at random.

This was caused by use of a cached value in
comphelper::detail::ConfigurationWrapper::getPropertyValue, which is
cleaned in ConfigurationChangesListener::changesOccurred; but the order
in which the listeners' changesOccurred methods were called depended on
the implementation detail of configmgr::Components::roots_, which was
previously a std::set of pointers, and now is a sorted vector. This
made the pointers sorted in order of the pointers' addresses (basically
random), and when a broadcaster's common list of change listeners was
prepared in Components::initGlobalBroadcaster, ConfigurationWrapper's
listener could arrive last. This meant, that the cache could be cleaned
too late, after its obsolete content was already used in a previous
listener.

The problem could be partially mitigated by clearing the cache in the
comphelper::detail::ConfigurationWrapper::setPropertyValue, but that
would only handle cases of config modifications using comphelper.

Instead, take into account that ConfigurationWrapper listens on the
root of configuration tree; and introduce a separate container in
configmgr::Broadcaster for root listeners. They would be triggered
first, before all other listeners.

Still, this would not guarantee the proper order, if another listener
is registered on root. To handle all cases, a special listener category
could be used, which could be filled using a dedicated internal API, so
comphelper could use it to register its privileged listener close to
the heart of the broadcaster :) This might be implemented later.

Change-Id: I956b7989b3927dca2683f63cf92b0dda04db9bdf
Reviewed-on: https://gerrit.libreoffice.org/c/core/+/154561
Tested-by: Jenkins
Reviewed-by: Mike Kaganski <mike.kaganski@collabora.com>
2023-07-18 06:54:47 +02:00

140 lines
5.4 KiB
C++

/* -*- 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 .
*/
#pragma once
#include <sal/config.h>
#include <vector>
#include <com/sun/star/beans/PropertyChangeEvent.hpp>
#include <com/sun/star/container/ContainerEvent.hpp>
#include <com/sun/star/lang/EventObject.hpp>
#include <com/sun/star/uno/Reference.hxx>
#include <com/sun/star/uno/Sequence.hxx>
#include <com/sun/star/util/ChangesEvent.hpp>
namespace com::sun::star {
namespace beans {
class XPropertiesChangeListener;
class XPropertyChangeListener;
}
namespace container { class XContainerListener; }
namespace lang { class XEventListener; }
namespace util { class XChangesListener; }
}
namespace configmgr {
class Broadcaster {
public:
Broadcaster() {}
void addDisposeNotification(
css::uno::Reference< css::lang::XEventListener > const & listener,
css::lang::EventObject const & event);
void addContainerElementInsertedNotification(
css::uno::Reference< css::container::XContainerListener > const & listener,
css::container::ContainerEvent const & event);
void addContainerElementRemovedNotification(
css::uno::Reference< css::container::XContainerListener > const & listener,
css::container::ContainerEvent const & event);
void addContainerElementReplacedNotification(
css::uno::Reference< css::container::XContainerListener > const & listener,
css::container::ContainerEvent const & event);
void addPropertyChangeNotification(
css::uno::Reference< css::beans::XPropertyChangeListener > const & listener,
css::beans::PropertyChangeEvent const & event);
void addPropertiesChangeNotification(
css::uno::Reference< css::beans::XPropertiesChangeListener > const & listener,
css::uno::Sequence< css::beans::PropertyChangeEvent > const & event);
void addChangesNotification(
css::uno::Reference< css::util::XChangesListener > const & listener,
css::util::ChangesEvent const & event, bool bRootListener);
void send();
private:
Broadcaster(const Broadcaster&) = delete;
Broadcaster& operator=(const Broadcaster&) = delete;
struct DisposeNotification {
css::uno::Reference< css::lang::XEventListener > listener;
css::lang::EventObject event;
DisposeNotification(
css::uno::Reference< css::lang::XEventListener > const & theListener,
css::lang::EventObject theEvent);
};
struct ContainerNotification {
css::uno::Reference< css::container::XContainerListener > listener;
css::container::ContainerEvent event;
ContainerNotification(
css::uno::Reference< css::container::XContainerListener > const & theListener,
css::container::ContainerEvent theEvent);
};
struct PropertyChangeNotification {
css::uno::Reference< css::beans::XPropertyChangeListener > listener;
css::beans::PropertyChangeEvent event;
PropertyChangeNotification(
css::uno::Reference< css::beans::XPropertyChangeListener > const & theListener,
css::beans::PropertyChangeEvent theEvent);
};
struct PropertiesChangeNotification {
css::uno::Reference< css::beans::XPropertiesChangeListener > listener;
css::uno::Sequence< css::beans::PropertyChangeEvent > event;
PropertiesChangeNotification(
css::uno::Reference< css::beans::XPropertiesChangeListener > const & theListener,
css::uno::Sequence< css::beans::PropertyChangeEvent > const & theEvent);
};
struct ChangesNotification {
css::uno::Reference< css::util::XChangesListener > listener;
css::util::ChangesEvent event;
ChangesNotification(
css::uno::Reference< css::util::XChangesListener > const & theListener,
css::util::ChangesEvent theEvent);
};
std::vector< DisposeNotification > disposeNotifications_;
std::vector< ContainerNotification > containerElementInsertedNotifications_;
std::vector< ContainerNotification > containerElementRemovedNotifications_;
std::vector< ContainerNotification > containerElementReplacedNotifications_;
std::vector< PropertyChangeNotification > propertyChangeNotifications_;
std::vector< PropertiesChangeNotification > propertiesChangeNotifications_;
std::vector< ChangesNotification > rootChangesNotifications_;
std::vector< ChangesNotification > changesNotifications_;
};
}
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */