office-gobmx/configmgr/source/inc/configset.hxx
Rüdiger Timm 45b30c0a75 INTEGRATION: CWS changefileheader (1.16.16); FILE MERGED
2008/04/01 15:06:43 thb 1.16.16.3: #i85898# Stripping all external header guards
2008/04/01 12:27:23 thb 1.16.16.2: #i85898# Stripping all external header guards
2008/03/31 12:22:43 rt 1.16.16.1: #i87441# Change license header to LPGL v3.
2008-04-11 11:46:59 +00:00

252 lines
9.6 KiB
C++

/*************************************************************************
*
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* Copyright 2008 by Sun Microsystems, Inc.
*
* OpenOffice.org - a multi-platform office productivity suite
*
* $RCSfile: configset.hxx,v $
* $Revision: 1.17 $
*
* This file is part of OpenOffice.org.
*
* OpenOffice.org is free software: you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License version 3
* only, as published by the Free Software Foundation.
*
* OpenOffice.org is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License version 3 for more details
* (a copy is included in the LICENSE file that accompanied this code).
*
* You should have received a copy of the GNU Lesser General Public License
* version 3 along with OpenOffice.org. If not, see
* <http://www.openoffice.org/license.html>
* for a copy of the LGPLv3 License.
*
************************************************************************/
#ifndef CONFIGMGR_CONFIGSET_HXX_
#define CONFIGMGR_CONFIGSET_HXX_
#include "configexcept.hxx"
#include "configdefaultprovider.hxx"
#include "template.hxx"
#include "noderef.hxx"
#include <rtl/ref.hxx>
#ifndef INCLUDED_MEMORY
#include <memory>
#define INCLUDED_MEMORY
#endif
namespace com { namespace sun { namespace star {
namespace script { class XTypeConverter; }
} } }
namespace configmgr
{
namespace data { class TreeSegment; }
namespace configuration
{
//-----------------------------------------------------------------------------
class ElementRef;
class ElementTree;
//---------------------------------------------------------------------
class Name;
class AbsolutePath;
namespace Path { class Component; }
//---------------------------------------------------------------------
typedef com::sun::star::uno::Type UnoType;
typedef com::sun::star::uno::Any UnoAny;
typedef com::sun::star::uno::Reference<com::sun::star::script::XTypeConverter> UnoTypeConverter;
//---------------------------------------------------------------------
class ElementTreeImpl;
typedef rtl::Reference<ElementTreeImpl> ElementTreeHolder;
class NodeChange;
class Template;
typedef rtl::Reference<Template> TemplateHolder;
//-----------------------------------------------------------------------------
/// identifies a <type>Node</type> that is a element of a Container ("set").
class ElementRef
{
ElementTreeHolder m_aTreeHolder;
public:
explicit ElementRef(ElementTreeImpl* pTree);
ElementRef(ElementRef const& aOther);
ElementRef& operator=(ElementRef const& aOther);
~ElementRef();
bool isValid() const;
Path::Component getFullName() const;
Name getName() const;
TemplateHolder getTemplate() const;
ElementTree getElementTree() const;
TreeRef getTreeRef() const;
static ElementRef extract(TreeRef const& aTree);
};
//-----------------------------------------------------------------------------
/// provides information about a <type>Node</type> that is a element of a Container ("set").
class ElementTree
{
ElementTreeHolder m_aTreeHolder;
public:
static ElementTree emptyElement() { return ElementTree(); }
ElementTree(ElementTreeImpl* pTree);
ElementTree(ElementTreeHolder const& pTree);
ElementTree(ElementTree const& aOther);
ElementTree& operator=(ElementTree const& aOther);
~ElementTree();
bool isValid() const;
ElementTreeHolder get() const;
ElementTreeImpl* getImpl() const;
TemplateHolder getTemplate() const;
ElementTreeImpl* operator->() const;
ElementTreeImpl& operator*() const;
Tree getTree() const;
static ElementTree extract(Tree const& aTree);
/** if the element tree owns it's node tree, access to the segment is given to the caller.
*/
static data::TreeSegment getOwnedElement(ElementTree const& aElementTree);
private:
ElementTree();
};
//-----------------------------------------------------------------------------
/// provides information about the elements of a <type>Node</type> that is a Container ("set").
class TemplateInfo
{
TemplateHolder m_aTemplate;
public:
explicit TemplateInfo(TemplateHolder const& aTemplate);
TemplateHolder getTemplate() const;
UnoType getType() const;
Name getTemplateName() const;
Name getTemplatePackage() const;
OUString getTemplatePathString() const;
};
//-----------------------------------------------------------------------------
/// provides information about the elements of a <type>Node</type> that is a Container ("set").
class SetElementInfo
{
TemplateInfo m_aTemplateInfo;
public:
SetElementInfo(TemplateHolder const& aTemplate);
TemplateHolder getTemplate() const;
TemplateInfo getTemplateInfo() const;
UnoType getElementType() const { return m_aTemplateInfo.getType(); }
static TemplateHolder extractElementInfo(Tree const& aTree, NodeRef const& aNode);
};
//-----------------------------------------------------------------------------
class SetElementFactory
{
TemplateProvider m_aProvider;
public:
SetElementFactory(TemplateProvider const& aProvider);
SetElementFactory(SetElementFactory const& aOther);
SetElementFactory& operator=(SetElementFactory const& aOther);
~SetElementFactory();
ElementTree instantiateTemplate(TemplateHolder const& aTemplate);
ElementTree instantiateOnDefault(data::TreeSegment const& _aTree, TemplateHolder const& aDummyTemplate);
static TemplateProvider findTemplateProvider(Tree const& aTree, NodeRef const& aNode);
};
//-----------------------------------------------------------------------------
/// allows to insert,remove and replace an element of a <type>Node</type> that is a Container ("set") of full-fledged trees.
class TreeSetUpdater
{
Tree m_aParentTree;
NodeRef m_aSetNode;
TemplateHolder m_aTemplate;
public:
TreeSetUpdater(Tree const& aParentTree, NodeRef const& aSetNode, SetElementInfo const& aInfo);
NodeChange validateInsertElement (Name const& aName, ElementTree const& aNewElement);
NodeChange validateReplaceElement(ElementRef const& aElement, ElementTree const& aNewElement);
NodeChange validateRemoveElement (ElementRef const& aElement);
private:
void implValidateSet();
Path::Component implValidateElement(ElementRef const& aElement, bool bReqRemovable);
void implValidateTree(ElementTree const& aElementTree);
};
//-----------------------------------------------------------------------------
/// allows to insert,remove and replace an element of a <type>Node</type> that is a Container ("set") of simple values.
class ValueSetUpdater
{
Tree m_aParentTree;
NodeRef m_aSetNode;
TemplateHolder m_aTemplate;
UnoTypeConverter m_xTypeConverter;
public:
ValueSetUpdater(Tree const& aParentTree, NodeRef const& aSetNode,
SetElementInfo const& aInfo, UnoTypeConverter const& xConverter);
NodeChange validateInsertElement (Name const& aName, UnoAny const& aNewValue);
NodeChange validateReplaceElement(ElementRef const& aElement, UnoAny const& aNewValue);
NodeChange validateRemoveElement (ElementRef const& aElement);
private:
typedef Tree ElementNodeRef;
void implValidateSet();
Path::Component implValidateElement(ElementRef const& aElement, bool bReqRemovable);
UnoAny implValidateValue(ElementNodeRef const& aElementTree, UnoAny const& aValue);
UnoAny implValidateValue(UnoAny const& aValue);
ElementTreeHolder makeValueElement(Name const& aName, ElementNodeRef const& aElementTree, UnoAny const& aValue, bool bInserting);
ElementTreeHolder makeValueElement(Name const& aName, UnoAny const& aValue, bool bInserting);
ElementNodeRef extractElementNode(ElementRef const& aElement);
};
//-----------------------------------------------------------------------------
/// allows to restore to its default state a <type>Node</type> that is a Container ("set") of full-fledged trees.
class SetDefaulter
{
Tree m_aParentTree;
NodeRef m_aSetNode;
DefaultProvider m_aDefaultProvider;
public:
SetDefaulter(Tree const& aParentTree, NodeRef const& aSetNode, DefaultProvider const& aDefaultProvider);
NodeChange validateSetToDefaultState();
private:
void implValidateSet();
};
//-----------------------------------------------------------------------------
}
}
#endif // CONFIGMGR_CONFIGSET_HXX_