/* -*- 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 .
*/
/*-************************************************************************************************************ @descr These values are used to define necessary keys from our configuration management to support all functionality of these implementation. It's a fast way to make changes if some keys change its name or location!
Property handle are necessary to specify right position in return list of configuration for asked values. We ask it with a list of properties to get its values. The returned list has the same order like our given name list! e.g.: NAMELIST[ PROPERTYHANDLE_xxx ] => VALUELIST[ PROPERTYHANDLE_xxx ]
*/
constexpr OUStringLiteral ROOTNODE_FACTORIES = u"Setup/Office/Factories"; #define PATHSEPARATOR "/"
// Attention: The property "ooSetupFactoryEmptyDocumentURL" is read from configuration but not used! There is // special code that uses hard coded strings to return them. #define PROPERTYNAME_SHORTNAME "ooSetupFactoryShortName" #define PROPERTYNAME_TEMPLATEFILE "ooSetupFactoryTemplateFile" #define PROPERTYNAME_WINDOWATTRIBUTES "ooSetupFactoryWindowAttributes" #define PROPERTYNAME_EMPTYDOCUMENTURL "ooSetupFactoryEmptyDocumentURL" #define PROPERTYNAME_DEFAULTFILTER "ooSetupFactoryDefaultFilter" #define PROPERTYNAME_ICON "ooSetupFactoryIcon"
/*-************************************************************************************************************ @descr This struct hold information about one factory. We declare a complete array which can hold infos for all well known factories. Values of enum "EFactory" (see header!) are directly used as index! So we can support a fast access on this information.
*/ struct FactoryInfo
{ public:
// returns list of properties, which has changed only! // We use given value of sNodeBase to build full qualified paths ... // Last sign of it must be "/". because we use it directly, without any additional things!
css::uno::Sequence< css::beans::PropertyValue > getChangedProperties( std::u16string_view sNodeBase )
{ // a) reserve memory for max. count of changed properties // b) add names and values of changed ones only and count it // c) resize return list by using count
css::uno::Sequence< css::beans::PropertyValue > lProperties ( 4 ); auto plProperties = lProperties.getArray();
sal_Int8 nRealyChanged = 0;
// We must support setting AND marking of changed values. // That's why we can't make our member public. We must use get/set/init methods // to control access on it! bool getInstalled () const { return bInstalled; }; const OUString& getFactory () const { return sFactory; }; const OUString& getTemplateFile () const { return sTemplateFile; }; const OUString& getDefaultFilter () const { return sDefaultFilter; }; bool isDefaultFilterReadonly() const { return bDefaultFilterReadonly; }
sal_Int32 getIcon () const { return nIcon; };
// If you call set-methods - we check for changes of values and mark it. // But if you wish to set it without that... you must initialize it! void initInstalled () { bInstalled = true; } void initFactory ( const OUString& sNewFactory ) { sFactory = sNewFactory; } void initDefaultFilter ( const OUString& sNewDefaultFilter ) { sDefaultFilter = sNewDefaultFilter; } void setDefaultFilterReadonly( constbool bVal){bDefaultFilterReadonly = bVal;} void initIcon ( sal_Int32 nNewIcon ) { nIcon = nNewIcon; }
/*-************************************************************************************************************ @short default ctor @descr We open our configuration here and read all necessary values from it. These values are cached till everyone call Commit(). Then we write changed ones back to cfg.
@seealso baseclass ConfigItem @seealso method impl_Read() @threadsafe no
*/
SvtModuleOptions_Impl::SvtModuleOptions_Impl()
: ::utl::ConfigItem( ROOTNODE_FACTORIES )
, m_bReadOnlyStatesWellKnown( false )
{ // First initialize list of factory infos! Otherwise we couldn't guarantee right working of these class. for( auto & rFactory : m_lFactories )
rFactory.free();
// Get name list of all existing set node names in configuration to read her properties in impl_Read(). // These list is a list of long names of our factories. const css::uno::Sequence< OUString > lFactories = GetNodeNames( OUString() );
impl_Read( lFactories );
// Enable notification for changes by using configuration directly. // So we can update our internal values immediately.
EnableNotification( lFactories );
}
SvtModuleOptions_Impl::~SvtModuleOptions_Impl()
{
assert(!IsModified()); // should have been committed
}
/*-************************************************************************************************************ @short called for notify of configmanager @descr This method is called from the ConfigManager before application ends or from the PropertyChangeListener if the sub tree broadcasts changes. You must update our internal values.
@attention We are registered for pure set node names only. So we can use our internal method "impl_Read()" to update our info list. Because - this method expand given name list to full qualified property list and use it to read the values. These values are filled into our internal member list m_lFactories at right position.
@seealso method impl_Read()
@param "lNames" is the list of set node entries which should be updated. @threadsafe no
*/ void SvtModuleOptions_Impl::Notify( const css::uno::Sequence< OUString >& )
{
OSL_FAIL( "SvtModuleOptions_Impl::Notify() Not implemented yet!" );
}
/*-**************************************************************************************************** @short write changes to configuration @descr This method writes the changed values into the sub tree and should always called in our destructor to guarantee consistency of config data.
@attention We clear complete set in configuration first and write it completely new! So we don't must distinguish between existing, added or removed elements. Our internal cached values are the only and right ones.
@seealso baseclass ConfigItem @threadsafe no
*/ void SvtModuleOptions_Impl::ImplCommit()
{ // Reserve memory for ALL possible factory properties! // Step over all factories and get her really changed values only. // Build list of these ones and use it for commit.
css::uno::Sequence< css::beans::PropertyValue > lCommitProperties( FACTORYCOUNT*PROPERTYCOUNT );
sal_Int32 nRealCount = 0;
OUString sBasePath; for( FactoryInfo & rInfo : m_lFactories )
{ // These path is used to build full qualified property names... // See pInfo->getChangedProperties() for further information
sBasePath = PATHSEPARATOR + rInfo.getFactory() + PATHSEPARATOR;
const css::uno::Sequence< css::beans::PropertyValue > lChangedProperties = rInfo.getChangedProperties ( sBasePath );
std::copy(lChangedProperties.begin(), lChangedProperties.end(), std::next(lCommitProperties.getArray(), nRealCount));
nRealCount += lChangedProperties.getLength();
} // Resize commit list to real size. // If nothing to do - suppress calling of configuration... // It could be too expensive :-) if( nRealCount > 0 )
{
lCommitProperties.realloc( nRealCount );
SetSetProperties( OUString(), lCommitProperties );
}
}
/*-**************************************************************************************************** @short access method to get internal values @descr These methods implement easy access to our internal values. You give us right enum value to specify which module interest you ... we return right information.
@attention Some people use any value as enum ... but we support in header specified values only! We use it directly as index in our internal list. If enum value isn't right - we crash with an "index out of range"!!! Please use me right - otherwise there is no guarantee. @param "eModule" , index in list - specify module @return Queried information.
@onerror We return default values. (mostly "not installed"!) @threadsafe no
*/ bool SvtModuleOptions_Impl::IsModuleInstalled( SvtModuleOptions::EModule eModule ) const
{ switch( eModule )
{ case SvtModuleOptions::EModule::WRITER: return m_lFactories[SvtModuleOptions::EFactory::WRITER].getInstalled(); case SvtModuleOptions::EModule::WEB: return m_lFactories[SvtModuleOptions::EFactory::WRITERWEB].getInstalled(); case SvtModuleOptions::EModule::GLOBAL: return m_lFactories[SvtModuleOptions::EFactory::WRITERGLOBAL].getInstalled(); case SvtModuleOptions::EModule::CALC: return m_lFactories[SvtModuleOptions::EFactory::CALC].getInstalled(); case SvtModuleOptions::EModule::DRAW: return m_lFactories[SvtModuleOptions::EFactory::DRAW].getInstalled(); case SvtModuleOptions::EModule::IMPRESS: return m_lFactories[SvtModuleOptions::EFactory::IMPRESS].getInstalled(); case SvtModuleOptions::EModule::MATH: return m_lFactories[SvtModuleOptions::EFactory::MATH].getInstalled(); case SvtModuleOptions::EModule::CHART: return m_lFactories[SvtModuleOptions::EFactory::CHART].getInstalled(); case SvtModuleOptions::EModule::STARTMODULE: return m_lFactories[SvtModuleOptions::EFactory::STARTMODULE].getInstalled(); case SvtModuleOptions::EModule::BASIC: returntrue; // Couldn't be deselected by setup yet! case SvtModuleOptions::EModule::DATABASE: return m_lFactories[SvtModuleOptions::EFactory::DATABASE].getInstalled();
}
OUString SvtModuleOptions::GetFactoryShortName(SvtModuleOptions::EFactory eFactory)
{ // Attention: Hard configured yet ... because it's not fine to make changes possible by xml file yet. // But it's good to plan further possibilities!
//return m_lFactories[eFactory].sShortName;
OUString sShortName; switch( eFactory )
{ case SvtModuleOptions::EFactory::WRITER : sShortName = "swriter"; break; case SvtModuleOptions::EFactory::WRITERWEB: sShortName = "swriter/web"; break; case SvtModuleOptions::EFactory::WRITERGLOBAL: sShortName = "swriter/GlobalDocument"; break; case SvtModuleOptions::EFactory::CALC : sShortName = "scalc"; break; case SvtModuleOptions::EFactory::DRAW : sShortName = "sdraw"; break; case SvtModuleOptions::EFactory::IMPRESS : sShortName = "simpress"; break; case SvtModuleOptions::EFactory::MATH : sShortName = "smath"; break; case SvtModuleOptions::EFactory::CHART : sShortName = "schart"; break; case SvtModuleOptions::EFactory::BASIC : sShortName = "sbasic"; break; case SvtModuleOptions::EFactory::DATABASE : sShortName = "sdatabase"; break; case SvtModuleOptions::EFactory::STARTMODULE : sShortName = "startmodule"; break; default:
OSL_FAIL( "unknown factory" ); break;
}
OUString SvtModuleOptions_Impl::GetFactoryEmptyDocumentURL( SvtModuleOptions::EFactory eFactory )
{ // Attention: Hard configured yet ... because it's not fine to make changes possible by xml file yet. // But it's good to plan further possibilities!
/*-************************************************************************************************************ @short return list of key names of our configuration management which represent our module tree @descr You give use a list of current existing set node names .. and we expand it for all well known properties which are necessary for this implementation. These full expanded list should be used to get values of this properties.
@seealso ctor @return List of all relative addressed properties of given set entry names.
@onerror List will be empty. @threadsafe no
*/
css::uno::Sequence< OUString > SvtModuleOptions_Impl::impl_ExpandSetNames( const css::uno::Sequence< OUString >& lSetNames )
{
sal_Int32 nCount = lSetNames.getLength();
css::uno::Sequence< OUString > lPropNames ( nCount*PROPERTYCOUNT );
OUString* pPropNames = lPropNames.getArray();
sal_Int32 nPropStart = 0;
/*-************************************************************************************************************ @short helper to classify given factory by name @descr Every factory has its own long and short name. So we can match right enum value for internal using.
@attention We change in/out parameter "eFactory" in every case! But you should use it only, if return value is sal_True! Algorithm: Set out-parameter to probably value ... and check the longname. If it matches with these factory - break operation and return true AND right set parameter. Otherwise try next one and so on. If no factory was found return false. Out parameter eFactory is set to last tried value but shouldn't be used! Because our return value is false! @param "sLongName" , long name of factory, which should be classified @return "eFactory" , right enum value, which match given long name and true for successfully classification, false otherwise
@onerror We return false. @threadsafe no
*/ bool SvtModuleOptions_Impl::ClassifyFactoryByName( std::u16string_view sName, SvtModuleOptions::EFactory& eFactory )
{ bool bState;
/*-************************************************************************************************************ @short read factory configuration @descr Give us a list of pure factory names (long names!) which can be used as direct set node names... and we read her property values and fill internal list. These method can be used by initial reading at ctor and later updating by "Notify()".
@seealso ctor @seealso method Notify()
@param "lFactories" is the list of set node entries which should be read. @onerror We do nothing. @threadsafe no
*/ void SvtModuleOptions_Impl::impl_Read( const css::uno::Sequence< OUString >& lFactories )
{ // Expand every set node name in lFactories to full qualified paths to its properties // and get right values from configuration. const css::uno::Sequence< OUString > lProperties = impl_ExpandSetNames( lFactories ); const css::uno::Sequence< css::uno::Any > lValues = GetProperties( lProperties );
// Safe impossible cases. // We need values from ALL configuration keys. // Follow assignment use order of values in relation to our list of key names!
OSL_ENSURE( !(lProperties.getLength()!=lValues.getLength()), "SvtModuleOptions_Impl::impl_Read()\nI miss some values of configuration keys!" );
// Algorithm: We step over all given factory names and classify it. These enum value can be used as direct index // in our member list m_lFactories! VAriable nPropertyStart marks start position of every factory // and her properties in expanded property/value list. The defines PROPERTHANDLE_xxx are used as offset values // added to nPropertyStart. So we can address every property relative in these lists. // If we found any valid values ... we reset all existing information for corresponding m_lFactories-entry and // use a pointer to these struct in memory directly to set new values. // But we set it only, if bInstalled is true. Otherwise all other values of a factory can be undeclared .. They // shouldn't be used then. // Attention: If a propertyset of a factory will be ignored we must step to next start position of next factory infos! // see "nPropertyStart += PROPERTYCOUNT" ...
/*-************************************************************************************************************ @short standard constructor and destructor @descr This will initialize an instance with default values. We initialize/deinitialize our static data container and create a static mutex, which is used for threadsafe code in further time of this object.
@seealso method impl_GetOwnStaticMutex() @threadsafe yes
*/
SvtModuleOptions::SvtModuleOptions()
{ // no need to take the mutex yet, shared_ptr/weak_ptr are thread-safe
m_pImpl = g_pModuleOptions.lock(); if( m_pImpl ) return;
// take the mutex, so we don't accidentally create more than one
std::unique_lock aGuard( impl_GetOwnStaticMutex() );
m_pImpl = g_pModuleOptions.lock(); if( !m_pImpl )
{
m_pImpl = std::make_shared<SvtModuleOptions_Impl>();
g_pModuleOptions = m_pImpl;
aGuard.unlock(); // because holdConfigItem will call this constructor
ItemHolder1::holdConfigItem(EItem::ModuleOptions);
}
}
/*-************************************************************************************************************ @short access to configuration data @descr This methods allow read/write access to configuration values. They are threadsafe. All calls are forwarded to impl-data-container. See there for further information!
bool SvtModuleOptions::ClassifyFactoryByName( std::u16string_view sName ,
EFactory& eFactory )
{ // We don't need any mutex here ... because we don't use any member here! return SvtModuleOptions_Impl::ClassifyFactoryByName( sName, eFactory );
}
// is there already a filter inside the descriptor?
OUString sFilterName = stlDesc.getUnpackedValueOrDefault(u"FilterName"_ustr, OUString()); if (!sFilterName.isEmpty())
{ try
{
::comphelper::SequenceAsHashMap stlFilterProps (xFilterCfg->getByName(sFilterName));
OUString sDocumentService = stlFilterProps.getUnpackedValueOrDefault(u"DocumentService"_ustr, OUString());
SvtModuleOptions::EFactory eApp = SvtModuleOptions::ClassifyFactoryByServiceName(sDocumentService);
if (eApp != EFactory::UNKNOWN_FACTORY) return eApp;
} catch(const css::uno::RuntimeException&)
{ throw; } catch(const css::uno::Exception&)
{ /* do nothing here ... may the following code can help!*/ }
}
// is there already a type inside the descriptor?
OUString sTypeName = stlDesc.getUnpackedValueOrDefault(u"TypeName"_ustr, OUString()); if (sTypeName.isEmpty())
{ // no :-( // start flat detection of URL
css::uno::Reference< css::document::XTypeDetection > xDetect(xTypeCfg, css::uno::UNO_QUERY);
sTypeName = xDetect->queryTypeByURL(sURL);
}
if (sTypeName.isEmpty()) return EFactory::UNKNOWN_FACTORY;
// yes - there is a type info // Try to find the preferred filter. try
{
::comphelper::SequenceAsHashMap stlTypeProps (xTypeCfg->getByName(sTypeName));
OUString sPreferredFilter = stlTypeProps.getUnpackedValueOrDefault(u"PreferredFilter"_ustr, OUString());
::comphelper::SequenceAsHashMap stlFilterProps (xFilterCfg->getByName(sPreferredFilter));
OUString sDocumentService = stlFilterProps.getUnpackedValueOrDefault(u"DocumentService"_ustr, OUString());
SvtModuleOptions::EFactory eApp = SvtModuleOptions::ClassifyFactoryByServiceName(sDocumentService);
if (eApp != EFactory::UNKNOWN_FACTORY) return eApp;
} catch(const css::uno::RuntimeException&)
{ throw; } catch(const css::uno::Exception&)
{ /* do nothing here ... may the following code can help!*/ }
// no filter/no type/no detection result => no fun :-) return EFactory::UNKNOWN_FACTORY;
}
Die Informationen auf dieser Webseite wurden
nach bestem Wissen sorgfältig zusammengestellt. Es wird jedoch weder Vollständigkeit, noch Richtigkeit,
noch Qualität der bereit gestellten Informationen zugesichert.
Bemerkung:
Die farbliche Syntaxdarstellung ist noch experimentell.
