DynamicLinker.h

Go to the documentation of this file.

// Copyright (C) 2002-2017, Open Design Alliance (the "Alliance"). 
// All rights reserved. 
// 
// This software and its documentation and related materials are owned by 
// the Alliance. The software may only be incorporated into application 
// programs owned by members of the Alliance, subject to a signed 
// Membership Agreement and Supplemental Software License Agreement with the
// Alliance. The structure and organization of this software are the valuable  
// trade secrets of the Alliance and its suppliers. The software is also 
// protected by copyright law and international treaty provisions. Application  
// programs incorporating this software must include the following statement 
// with their copyright notices:
//   
//   This application incorporates Teigha(R) software pursuant to a license 
//   agreement with Open Design Alliance.
//   Teigha(R) Copyright (C) 2002-2017 by Open Design Alliance. 
//   All rights reserved.
//
// By use of this software, its documentation or related materials, you 
// acknowledge and accept the above terms.
 
 
 
 
// DynamicLinker.h: interface for the OdaDynamicLinkerI class.
//
 
#if !defined(_ODADYNAMICLINKERI_H_INCLUDED_)
#define _ODADYNAMICLINKERI_H_INCLUDED_
 
class OdRxDictionary;
class OdRxDLinkerReactor;
 
#include "RxDictionary.h"
#include "RxModule.h"
 
class OdRxModule;
typedef OdSmartPtr<OdRxModule> OdRxModulePtr;
 
class OdRxSystemServices;
typedef OdSmartPtr<OdRxSystemServices> OdRxSystemServicesPtr;
 
#include "TD_PackPush.h"
 
class FIRSTDLL_EXPORT OdRxDynamicLinker : public OdRxObject
{
public:
  ODRX_DECLARE_MEMBERS(OdRxDynamicLinker);
 
  virtual void addReactor (
    OdRxDLinkerReactor* pReactor) = 0;
  virtual void removeReactor (
    OdRxDLinkerReactor* pReactor) = 0;
 
  virtual OdRxModulePtr loadModule(
    const OdString& moduleFileName, bool silent = true) = 0;
 
  virtual bool unloadModule(
    const OdString& moduleFileName) = 0;
 
 
  virtual bool unloadUnreferenced() = 0;
 
  virtual OdRxModulePtr loadApp(
    const OdString& applicationName, 
    bool silent = true) = 0;
 
  virtual OdRxSystemServicesPtr sysServices() const = 0;
 
  virtual OdRxDictionaryPtr sysRegistry() const = 0;
 
  virtual OdRxModule* loadModuleObj(
    OdRxModule* pModuleObj, bool bSilent = true) = 0;
 
  virtual int getModuleCount() const = 0;
 
  virtual OdRxModulePtr getModule(
    int index,
    OdString& key) const = 0;
 
  virtual OdRxModulePtr getModule(
    const OdString& key) const = 0;
};
 
typedef OdSmartPtr<OdRxDynamicLinker> OdRxDynamicLinkerPtr;
 
 
FIRSTDLL_EXPORT OdRxDynamicLinker* odrxDynamicLinker();
 
template <class TClass>
OdSmartPtr<TClass> odrxSafeCreateObject( const OdString& sClassName, const OdString& sAppName = OdString::kEmpty )
{
    OdRxDictionaryPtr clsdict = odrxClassDictionary();
    OdRxClass* pClass = ( OdRxClass* )clsdict->getAt( sClassName ).get();
    if ( pClass )
        return ( TClass* )pClass->create().get();
    if ( !sAppName.isEmpty() )
    {
        odrxDynamicLinker()->loadApp( sAppName, false );
        pClass = ( OdRxClass* )clsdict->getAt( sClassName ).get();
        if ( pClass )
            return ( TClass* )pClass->create().get();
    }
    throw OdError( sClassName + " class was not found" );
}
 
inline OdRxModulePtr odrxLoadApp( const OdString& applicationName ) { return odrxDynamicLinker()->loadApp( applicationName ); }
 
inline OdRxModulePtr odrxSafeLoadApp( const OdString& applicationName ) { return odrxDynamicLinker()->loadApp( applicationName, false ); }
 
 
#include "TD_PackPop.h"
 
#endif // !defined(_ODADYNAMICLINKERI_H_INCLUDED_)