configuration.hxx

Go to the documentation of this file.

/* -*- 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/.
 */
 
#ifndef INCLUDED_COMPHELPER_CONFIGURATION_HXX
#define INCLUDED_COMPHELPER_CONFIGURATION_HXX
 
#include <sal/config.h>
 
#include <optional>
#include <string_view>
 
#include <com/sun/star/uno/Any.hxx>
#include <com/sun/star/uno/Reference.h>
#include <comphelper/comphelperdllapi.h>
#include <comphelper/processfactory.hxx>
#include <sal/types.h>
#include <memory>
 
namespace com::sun::star {
    namespace configuration { class XReadWriteAccess; }
    namespace container {
        class XHierarchicalNameAccess;
        class XHierarchicalNameReplace;
        class XNameAccess;
        class XNameContainer;
    }
    namespace uno { class XComponentContext; }
}
 
namespace comphelper {
 
namespace detail { class ConfigurationWrapper; }
 
class COMPHELPER_DLLPUBLIC ConfigurationChanges {
public:
    static std::shared_ptr<ConfigurationChanges> create();
 
    ~ConfigurationChanges();
 
    void commit() const;
 
private:
    ConfigurationChanges(const ConfigurationChanges&) = delete;
    ConfigurationChanges& operator=(const ConfigurationChanges&) = delete;
 
    SAL_DLLPRIVATE ConfigurationChanges(
        css::uno::Reference< css::uno::XComponentContext >
            const & context);
 
    SAL_DLLPRIVATE void setPropertyValue(
        OUString const & path, css::uno::Any const & value)
        const;
 
    SAL_DLLPRIVATE css::uno::Reference<
        css::container::XHierarchicalNameReplace >
    getGroup(OUString const & path) const;
 
    SAL_DLLPRIVATE
    css::uno::Reference< css::container::XNameContainer >
    getSet(OUString const & path) const;
 
    css::uno::Reference<
        css::configuration::XReadWriteAccess > access_;
 
    friend class detail::ConfigurationWrapper;
};
 
namespace detail {
 
class COMPHELPER_DLLPUBLIC ConfigurationWrapper {
public:
    static ConfigurationWrapper const & get();
 
    bool isReadOnly(OUString const & path) const;
 
    css::uno::Any getPropertyValue(OUString const & path) const;
 
    static void setPropertyValue(
        std::shared_ptr< ConfigurationChanges > const & batch,
        OUString const & path, css::uno::Any const & value);
 
    css::uno::Any getLocalizedPropertyValue(
        std::u16string_view path) const;
 
    static void setLocalizedPropertyValue(
        std::shared_ptr< ConfigurationChanges > const & batch,
        OUString const & path, css::uno::Any const & value);
 
    css::uno::Reference<
        css::container::XHierarchicalNameAccess >
    getGroupReadOnly(OUString const & path) const;
 
    static css::uno::Reference<
        css::container::XHierarchicalNameReplace >
    getGroupReadWrite(
        std::shared_ptr< ConfigurationChanges > const & batch,
        OUString const & path);
 
    css::uno::Reference< css::container::XNameAccess >
    getSetReadOnly(OUString const & path) const;
 
    static css::uno::Reference< css::container::XNameContainer >
    getSetReadWrite(
        std::shared_ptr< ConfigurationChanges > const & batch,
        OUString const & path);
 
    std::shared_ptr< ConfigurationChanges > createChanges() const;
 
private:
    SAL_DLLPRIVATE explicit ConfigurationWrapper();
 
    SAL_DLLPRIVATE ~ConfigurationWrapper();
 
    ConfigurationWrapper(const ConfigurationWrapper&) = delete;
    ConfigurationWrapper& operator=(const ConfigurationWrapper&) = delete;
 
    css::uno::Reference< css::uno::XComponentContext >          context_;
 
    css::uno::Reference< css::configuration::XReadWriteAccess > access_;
        // should really be a css.configuration.ReadOnlyAccess (with added
        // css.beans.XHierarchicalPropertySetInfo), but then
        // configmgr::Access::asProperty() would report all properties as
        // READONLY, so isReadOnly() would not work
};
 
template< typename T > struct Convert {
    static css::uno::Any toAny(T const & value)
    { return css::uno::Any(value); }
 
    static T fromAny(css::uno::Any const & value)
    { return value.get< T >(); }
 
private:
    Convert(const Convert&) = delete;
    Convert& operator=(const Convert&) = delete;
 
    Convert() = delete;
    ~Convert() = delete;
};
 
template< typename T > struct Convert< std::optional< T > >
{
    static css::uno::Any toAny(std::optional< T > const & value) {
        return value
            ? css::uno::Any(*value)
            : css::uno::Any();
    }
 
    static std::optional< T > fromAny(css::uno::Any const & value)
    {
        return value.hasValue()
            ? std::optional< T >(value.get< T >()) : std::optional< T >();
    }
 
private:
    Convert(const Convert&) = delete;
    Convert& operator=(const Convert&) = delete;
 
    Convert() = delete;
    ~Convert() = delete;
};
 
}
 
template< typename T, typename U > struct ConfigurationProperty
{
    static bool isReadOnly()
    {
        return detail::ConfigurationWrapper::get().isReadOnly(T::path());
    }
 
    static U get()
    {
        // Folding this into one statement causes a bogus error at least with
        // Red Hat GCC 4.6.2-1:
        css::uno::Any a(
            detail::ConfigurationWrapper::get().getPropertyValue(
                T::path()));
        return detail::Convert< U >::fromAny(a);
    }
 
    static void set(
        U const & value,
        std::shared_ptr< ConfigurationChanges > const & batch)
    {
        comphelper::detail::ConfigurationWrapper::setPropertyValue(
            batch, T::path(), detail::Convert< U >::toAny(value));
    }
 
private:
    ConfigurationProperty(const ConfigurationProperty&) = delete;
    ConfigurationProperty& operator=(const ConfigurationProperty&) = delete;
 
    ConfigurationProperty() = delete;
    ~ConfigurationProperty() = delete;
};
 
template< typename T, typename U > struct ConfigurationLocalizedProperty
{
    static U get()
    {
        // Folding this into one statement causes a bogus error at least with
        // Red Hat GCC 4.6.2-1:
        css::uno::Any a(
            detail::ConfigurationWrapper::get().
            getLocalizedPropertyValue(T::path()));
        return detail::Convert< U >::fromAny(a);
    }
 
    static void set(
        U const & value,
        std::shared_ptr< ConfigurationChanges > const & batch)
    {
        comphelper::detail::ConfigurationWrapper::setLocalizedPropertyValue(
            batch, T::path(), detail::Convert< U >::toAny(value));
    }
 
private:
    ConfigurationLocalizedProperty(const ConfigurationLocalizedProperty&) = delete;
    ConfigurationLocalizedProperty& operator=(const ConfigurationLocalizedProperty&) = delete;
 
    ConfigurationLocalizedProperty() = delete;
    ~ConfigurationLocalizedProperty() = delete;
};
 
template< typename T > struct ConfigurationGroup {
    static css::uno::Reference<
        css::container::XHierarchicalNameAccess >
    get()
    {
        return detail::ConfigurationWrapper::get().getGroupReadOnly(
            T::path());
    }
 
    static css::uno::Reference<
        css::container::XHierarchicalNameReplace >
    get(std::shared_ptr< ConfigurationChanges > const & batch)
    {
        return comphelper::detail::ConfigurationWrapper::getGroupReadWrite(
            batch, T::path());
    }
 
private:
    ConfigurationGroup(const ConfigurationGroup&) = delete;
    ConfigurationGroup& operator=(const ConfigurationGroup&) = delete;
 
    ConfigurationGroup() = delete;
    ~ConfigurationGroup() = delete;
};
 
template< typename T > struct ConfigurationSet {
    static
    css::uno::Reference< css::container::XNameAccess >
    get()
    {
        return detail::ConfigurationWrapper::get().getSetReadOnly(
            T::path());
    }
 
    static
    css::uno::Reference< css::container::XNameContainer >
    get(std::shared_ptr< ConfigurationChanges > const & batch)
    {
        return comphelper::detail::ConfigurationWrapper::getSetReadWrite(
            batch, T::path());
    }
 
private:
    ConfigurationSet(const ConfigurationSet&) = delete;
    ConfigurationSet& operator=(const ConfigurationSet&) = delete;
 
    ConfigurationSet() = delete;
    ~ConfigurationSet() = delete;
};
 
}
 
#endif
 
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */