DynamicLinker.h

Go to the documentation of this file.

// Copyright (C) 2002-2024, 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 Open Design Alliance software pursuant to a license 
//   agreement with Open Design Alliance.
//   Open Design Alliance Copyright (C) 2002-2024 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"
#include "LoadReasons.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 OdRxModulePtr loadApp(
      const OdString& applicationName,
      OdaApp::LoadReasons loadReason,
      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 + OD_T( " class was not found" ) ); //FELIX_CHANGE
}
 
 
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_)