3b53a957ee
2008/03/31 12:22:35 rt 1.12.16.1: #i87441# Change license header to LPGL v3.
392 lines
14 KiB
C++
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;
|
|
}
|
|
|
|
//-----------------------------------------------------------------------------
|
|
}
|
|
}
|