office-gobmx/configmgr/source/inc/roottree.hxx
Rüdiger Timm 074fc18f1a INTEGRATION: CWS sb88 (1.14.10); FILE MERGED
2008/06/03 15:29:49 sb 1.14.10.1: #i89553 applied patch by cmc
2008-06-16 12:47:00 +00:00

124 lines
4.7 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: roottree.hxx,v $
* $Revision: 1.15 $
*
* 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_ROOTTREE_HXX_
#define CONFIGMGR_ROOTTREE_HXX_
#include "utility.hxx"
#ifndef INCLUDED_MEMORY
#include <memory>
#define INCLUDED_MEMORY
#endif
namespace configmgr
{
//-----------------------------------------------------------------------------
class SubtreeChange;
struct TreeChangeList;
//-----------------------------------------------------------------------------
namespace data
{
class NodeAccess;
}
//-----------------------------------------------------------------------------
namespace configuration
{
//-----------------------------------------------------------------------------
class Tree; typedef Tree RootTree;
class TreeRef;
class TreeImpl;
class NodeRef;
class NodeChangesInformation;
class AbsolutePath;
class TemplateProvider;
typedef unsigned int NodeOffset;
typedef unsigned int TreeDepth;
//-----------------------------------------------------------------------------
RootTree createReadOnlyTree( AbsolutePath const& aRootPath,
data::NodeAccess const& _aCacheNode,
TreeDepth nDepth,
TemplateProvider const& aTemplateProvider);
RootTree createUpdatableTree( AbsolutePath const& aRootPath,
data::NodeAccess const& _aCacheNode,
TreeDepth nDepth,
TemplateProvider const& aTemplateProvider);
//-----------------------------------------------------------------------------
class CommitHelper : Noncopyable
{
struct Data;
std::auto_ptr<Data> m_pData;
TreeImpl* m_pTree;
public:
CommitHelper(TreeRef const& aTree);
~CommitHelper();
// collect all changes into rChangeList
bool prepareCommit(TreeChangeList& rChangeList);
// finish and clean up the changes in rChangeList after they are integrated
void finishCommit(TreeChangeList& rChangeList);
// throw away and clean up the changes in rChangeList after a commit failed
void failedCommit(TreeChangeList& rChangeList);
};
//-----------------------------------------------------------------------------
/** adjusts <var>aTree</var> tree to the (externally produced) changes under <var>aExternalChanges</var>
and collects the changes this induces locally.
@param rLocalChanges
a collection that will hold the changes induced by <var>aExternalChanges</var>.
@param aExternalChanges
a structured change that has already been applied to the master tree.
@param aBaseTree
the Tree that contains (directly) the affected node of <var>aExternalChanges</var>.
@param aBaseNode
a NodeRef referring to the (directly) affected node of <var>aExternalChanges</var>.
@return
<TRUE/> if any changes occur in this tree (so rLocalChanges is not empty), <FALSE/> otherwise.
*/
bool adjustToChanges( NodeChangesInformation& rLocalChanges,
Tree const& aBaseTree, NodeRef const& aBaseNode,
SubtreeChange const& aExternalChange) ;
//-----------------------------------------------------------------------------
}
}
#endif // CONFIGMGR_ROOTTREE_HXX_