office-gobmx/configmgr/source/api2/apifactory.cxx
Rüdiger Timm 3b53a957ee INTEGRATION: CWS changefileheader (1.12.16); FILE MERGED
2008/03/31 12:22:35 rt 1.12.16.1: #i87441# Change license header to LPGL v3.
2008-04-11 10:46:46 +00:00

392 lines
14 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: apifactory.cxx,v $
* $Revision: 1.13 $
*
* 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.
*
************************************************************************/
// MARKER(update_precomp.py): autogen include statement, do not remove
#include "precompiled_configmgr.hxx"
#include "apifactory.hxx"
#include "objectregistry.hxx"
#include "apitreeaccess.hxx"
#include "apitreeimplobj.hxx"
#include <com/sun/star/uno/Reference.hxx>
#include <com/sun/star/lang/XUnoTunnel.hpp>
#include "noderef.hxx"
#include "anynoderef.hxx"
#include "configexcept.hxx"
#include "configset.hxx"
namespace configmgr
{
//-----------------------------------------------------------------------------
namespace css = ::com::sun::star;
namespace uno = css::uno;
namespace lang = css::lang;
//-----------------------------------------------------------------------------
namespace configapi
{
//-----------------------------------------------------------------------------
typedef uno::XInterface UnoInterface;
typedef uno::Reference< uno::XInterface > UnoInterfaceRef;
typedef uno::Any UnoAny;
using uno::Reference;
using lang::XUnoTunnel;
using configuration::Tree;
using configuration::ElementTree;
using configuration::TemplateHolder;
using configuration::NodeRef;
using configuration::NodeID;
//-----------------------------------------------------------------------------
ObjectRegistry::~ObjectRegistry()
{
OSL_ENSURE(m_aMap.empty(),"WARNING: Configuration Object Map: Some Objects were not revoked correctly");
}
//-----------------------------------------------------------------------------
Factory::Factory(ObjectRegistryHolder pRegistry)
: m_pRegistry(pRegistry)
, m_aTunnelID()
{
OSL_ENSURE(pRegistry.is(), "ERROR: Factory requires a Object Registry");
}
//-----------------------------------------------------------------------------
Factory::~Factory()
{
}
//-----------------------------------------------------------------------------
inline
NodeElement* Factory::implFind(configuration::NodeID const& aNode)
{
return m_pRegistry->findElement(aNode);
}
//-----------------------------------------------------------------------------
inline
void Factory::doRegisterElement(configuration::NodeID const& aNode, NodeElement* pElement)
{
m_pRegistry->registerElement(aNode,pElement);
}
//-----------------------------------------------------------------------------
inline
void Factory::doRevokeElement(configuration::NodeID const& aNode, NodeElement* pElement)
{
m_pRegistry->revokeElement(aNode,pElement);
}
//-----------------------------------------------------------------------------
ApiTreeImpl& Factory::getImplementation(NodeElement& rElement)
{
return rElement.getApiTree();
}
//-----------------------------------------------------------------------------
inline
TemplateHolder Factory::implGetSetElementTemplate(Tree const& aTree, NodeRef const& aNode)
{
TemplateHolder aRet;
if (configuration::isSetNode(aTree,aNode))
{
aRet = configuration::SetElementInfo::extractElementInfo(aTree,aNode);
}
else if (!configuration::isGroupNode(aTree,aNode))
{
OSL_ENSURE( !configuration::isStructuralNode(aTree,aNode), "ERROR: Configuration: unknown kind of object");
throw configuration::Exception("INTERNAL ERROR: Cannot create template - Unexpected node type");
}
return aRet;
}
//-----------------------------------------------------------------------------
inline
UnoInterfaceRef Factory::implToUno(NodeElement* pElement)
{
if ( pElement )
return UnoInterfaceRef(pElement->getUnoInstance(), uno::UNO_REF_NO_ACQUIRE);
else
return UnoInterfaceRef();
}
//-----------------------------------------------------------------------------
inline
void Factory::implHaveNewElement(NodeID aNodeID, NodeElement* pElement)
{
OSL_ENSURE(pElement ,"WARNING: New API object could not be created");
if (pElement)
{
doRegisterElement(aNodeID,pElement);
OSL_ENSURE(implFind(aNodeID) == pElement,"WARNING: New API object could not be registered with its factory");
}
}
//-----------------------------------------------------------------------------
UnoInterfaceRef Factory::makeUnoElement(Tree const& aTree, NodeRef const& aNode)
{
return implToUno(makeElement(aTree,aNode));
}
//-----------------------------------------------------------------------------
NodeElement* Factory::makeElement(Tree const& aTree, NodeRef const& aNode)
{
OSL_PRECOND( !aTree.isEmpty() == aNode.isValid(), "ERROR: Configuration: Making element from tree requires valid node");
if (aTree.isEmpty())
return 0;
OSL_PRECOND( aTree.isValidNode(aNode), "ERROR: Configuration: NodeRef does not match Tree");
OSL_PRECOND( configuration::isStructuralNode(aTree,aNode), "ERROR: Configuration: Cannot make object for value node");
NodeID aNodeID(aTree,aNode);
NodeElement* pRet = findElement(aNodeID);
if (pRet == 0)
{
TemplateHolder aTemplate = implGetSetElementTemplate(aTree,aNode);
if (!aTree.isRootNode(aNode))
{
pRet = doCreateGroupMember(aTree,aNode,aTemplate.get());
}
else
{
ElementTree aElementTree = ElementTree::extract(aTree);
if (aElementTree.isValid())
{
pRet = doCreateSetElement(aElementTree,aTemplate.get());
}
else
{
OSL_ENSURE(aTree.getContextTree().isEmpty(),"INTERNAL ERROR: Found tree (not a set element) with a parent tree.");
pRet = doCreateAccessRoot(aTree,aTemplate.get(), vos::ORef< OOptions >());
}
}
implHaveNewElement(aNodeID,pRet);
}
return pRet;
}
//-----------------------------------------------------------------------------
UnoInterfaceRef Factory::findUnoElement(NodeID const& aNodeID)
{
return implToUno(findElement(aNodeID));
}
//-----------------------------------------------------------------------------
NodeElement* Factory::findElement(NodeID const& aNodeID)
{
NodeElement* pReturn = implFind(aNodeID);
if (pReturn) pReturn->getUnoInstance()->acquire();
return pReturn;
}
//-----------------------------------------------------------------------------
void Factory::revokeElement(NodeID const& aNodeID)
{
if (NodeElement* pElement = implFind(aNodeID))
doRevokeElement(aNodeID, pElement);
}
//-----------------------------------------------------------------------------
void Factory::revokeElement(NodeID const& aNodeID, NodeElement& rElement)
{
if (implFind(aNodeID) == &rElement)
doRevokeElement(aNodeID, &rElement);
}
//-----------------------------------------------------------------------------
TreeElement* Factory::makeAccessRoot(Tree const& aTree, RequestOptions const& _aOptions)
{
OSL_PRECOND( !aTree.isEmpty() , "ERROR: Configuration: Making element from tree requires valid tree");
if (aTree.isEmpty()) return 0;
OSL_ENSURE(aTree.getContextTree().isEmpty(),"INTERNAL ERROR: Tree with parent tree should not be used for an access root");
OSL_ENSURE(!ElementTree::extract(aTree).isValid(),"INTERNAL ERROR: Element Tree should not be used for an access root");
NodeRef aRoot = aTree.getRootNode();
OSL_ENSURE(aRoot.isValid(),"INTERNAL ERROR: Tree has no root node");
OSL_PRECOND( configuration::isStructuralNode(aTree,aRoot), "ERROR: Configuration: Cannot make object for value node");
NodeID aNodeID(aTree,aRoot);
// must be a tree element if it is a tree root
TreeElement* pRet = static_cast<TreeElement*>(findElement(aNodeID));
if (0 == pRet)
{
TemplateHolder aTemplate = implGetSetElementTemplate(aTree,aRoot);
vos::ORef<OOptions> xOptions = new OOptions(_aOptions);
pRet = doCreateAccessRoot(aTree,aTemplate.get(), xOptions);
implHaveNewElement (aNodeID,pRet);
}
return pRet;
}
//-----------------------------------------------------------------------------
UnoInterfaceRef Factory::makeUnoGroupMember(Tree const& aTree, NodeRef const& aNode)
{
return implToUno(makeGroupMember(aTree,aNode));
}
//-----------------------------------------------------------------------------
NodeElement* Factory::makeGroupMember(Tree const& aTree, NodeRef const& aNode)
{
OSL_PRECOND( !aTree.isEmpty() , "ERROR: Configuration: Creating an object requires a valid tree");
if (aTree.isEmpty()) return 0;
OSL_PRECOND( aNode.isValid() , "ERROR: Configuration: Creating an object requires a valid node");
OSL_PRECOND( aTree.isValidNode(aNode), "ERROR: Configuration: NodeRef does not match Tree");
if (!aTree.isValidNode(aNode)) return 0;
OSL_PRECOND( configuration::isStructuralNode(aTree,aNode), "ERROR: Configuration: Cannot make object for value node");
OSL_ENSURE(!aTree.isRootNode(aNode),"INTERNAL ERROR: Root of Tree should not be used for a group member object");
NodeID aNodeID(aTree,aNode);
NodeElement* pRet = findElement(aNodeID);
if (0 == pRet)
{
TemplateHolder aTemplate = implGetSetElementTemplate(aTree,aNode);
pRet = doCreateGroupMember(aTree,aNode,aTemplate.get());
OSL_ENSURE( pRet,"WARNING: New API object could not be created");
implHaveNewElement(aNodeID,pRet);
}
return pRet;
}
//-----------------------------------------------------------------------------
UnoInterfaceRef Factory::makeUnoSetElement(ElementTree const& aElementTree)
{
UnoInterfaceRef aRet = implToUno(makeSetElement(aElementTree));
OSL_ENSURE( uno::Reference<XUnoTunnel>::query(aRet).is(),"ERROR: API set element has no UnoTunnel");
OSL_ENSURE( uno::Reference<XUnoTunnel>::query(aRet).is() &&
0 != uno::Reference<XUnoTunnel>::query(aRet)->getSomething(doGetElementTunnelID()),
"ERROR: API set element does not support the right tunnel ID");
return aRet;
}
//-----------------------------------------------------------------------------
SetElement* Factory::makeSetElement(ElementTree const& aElementTree)
{
OSL_PRECOND( aElementTree.isValid() , "ERROR: Configuration: Making element from tree requires valid tree");
if (!aElementTree.isValid()) return 0;
Tree aTree = aElementTree.getTree();
OSL_ENSURE(!aTree.isEmpty(),"INTERNAL ERROR: Element Tree has no Tree");
NodeRef aRoot = aTree.getRootNode();
OSL_ENSURE(aRoot.isValid(),"INTERNAL ERROR: Tree has no root node");
OSL_ENSURE( configuration::isStructuralNode(aTree,aRoot), "ERROR: Configuration: Cannot make object for value node");
NodeID aNodeID(aTree,aRoot);
// must be a set element if it wraps a ElementTree
SetElement* pRet = static_cast<SetElement*>( findElement(aNodeID) );
if (0 == pRet)
{
TemplateHolder aTemplate = implGetSetElementTemplate(aTree,aRoot);
pRet = doCreateSetElement(aElementTree,aTemplate.get());
implHaveNewElement(aNodeID,pRet);
}
return pRet;
}
//-----------------------------------------------------------------------------
SetElement* Factory::findSetElement(configuration::ElementRef const& aElement)
{
OSL_PRECOND( aElement.isValid() , "ERROR: Configuration: Making element from tree requires valid tree");
if (!aElement.isValid()) return 0;
configuration::TreeRef aTree = aElement.getTreeRef();
OSL_ENSURE(!aTree.isEmpty(),"INTERNAL ERROR: Element Tree has no Tree");
NodeRef aRoot = aTree.getRootNode();
OSL_ENSURE(aRoot.isValid(),"INTERNAL ERROR: Tree has no root node");
NodeID aNodeID(aTree,aRoot);
// must be a set element if it wraps a ElementTree
SetElement* pRet = static_cast<SetElement*>( findElement(aNodeID) );
return pRet;
}
//-----------------------------------------------------------------------------
SetElement* Factory::extractSetElement(UnoAny const& aElement)
{
using configuration::ElementTreeImpl;
SetElement* pTunneledImpl = 0;
Reference< XUnoTunnel > xElementTunnel;
if ( aElement.hasValue() && (aElement >>= xElementTunnel) )
{
OSL_ASSERT( xElementTunnel.is() );
sal_Int64 nSomething = xElementTunnel->getSomething(doGetElementTunnelID());
if (0 != nSomething)
{
void* pVoid = reinterpret_cast<void*>(nSomething);
pTunneledImpl = static_cast<SetElement*>(pVoid);
}
}
return pTunneledImpl;
}
//-----------------------------------------------------------------------------
bool Factory::tunnelSetElement(sal_Int64& nSomething, SetElement& rElement, uno::Sequence< sal_Int8 > const& aTunnelID)
{
if (aTunnelID == doGetElementTunnelID())
{
void* pVoid = &rElement;
nSomething = reinterpret_cast<sal_Int64>(pVoid);
return true;
}
else
return false;
}
//-----------------------------------------------------------------------------
ApiTreeImpl const* Factory::findDescendantTreeImpl(configuration::NodeID const& aNode, ApiTreeImpl const* pImpl)
{
ApiTreeImpl* pRet = 0;
if (pImpl)
{
if ( NodeElement* pElement = pImpl->getFactory().implFind( aNode ) )
pRet = &pElement->getApiTree();
}
return pRet;
}
//-----------------------------------------------------------------------------
}
}