/*=========================================================================
                                                                                
  Program:   bbtk
  Module:    $RCSfile: bbtkFactory.h,v $
  Language:  C++
  Date:      $Date: 2008/04/09 11:16:57 $
  Version:   $Revision: 1.13 $
                                                                                
  Copyright (c) CREATIS (Centre de Recherche et d'Applications en Traitement de
  l'Image). All rights reserved. See doc/license.txt or
  http://www.creatis.insa-lyon.fr/Public/bbtk/License.html for details.
                                                                                
     This software is distributed WITHOUT ANY WARRANTY; without even
     the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
     PURPOSE.  See the above copyright notices for more information.
                                                                                
=========================================================================*/
/**
 *\file
 *\brief Class bbtk::Factory : can load and unload dynamic libraries containing black boxes packages and create instances of the black boxes registered in the packages loaded.
 */
/**
 *\class bbtk::Factory
 *\brief Can load and unload dynamic libraries containing black boxes packages and create instances of the black boxes registered in the packages loaded.
 *
 */


#ifndef __bbtkFactory_h__
#define __bbtkFactory_h__

//#include "bbtkBlackBox.h"
#include "bbtkPackage.h"
#include "bbtkDynamicLibraryHandling.h"

namespace bbtk
{

  class Executer;

  class BBTK_EXPORT Factory
  {

  public:

    Factory();
    ~Factory();
    
    void GetPackagesList(std::vector<std::string>&);
    void LoadPackage( const std::string& name );
    void UnLoadPackage( const std::string& name );
    void PrintPackages(bool details = true, bool adaptors = false) const;
    void HelpPackage(const std::string& name, bool adaptors = false) const;
    void HelpBlackBox(const std::string& name, std::string& package,
		      bool full=true ) const;
    void ShowGraphTypes(const std::string& name) const;
    void InsertPackage( Package* );
    void RemovePackage( Package* );

    const Package* GetPackage(const std::string& name) const;
    Package* GetPackage(const std::string& name);
    
    BlackBox* NewBlackBox(const std::string& type, 
                          const std::string& name) const;
    
    BlackBox* NewAdaptor(const DataInfo& typein,
			 const DataInfo& typeout,
                         const std::string& name) const;

    BlackBox* NewWidgetAdaptor(const DataInfo& typein,
			       const DataInfo& typeout,
			       const std::string& name) const;

    bool FindAdaptor(const DataInfo& typein,
		     const DataInfo& typeout,
		     std::string& adaptor) const;

    bool FindWidgetAdaptor(const DataInfo& typein,
			   const DataInfo& typeout,
			   std::string& adaptor) const;
    
    bool FindWidgetAdaptor2(const DataInfo& typein,
			    const DataInfo& typeout,
			    std::string& widget,
			    std::string& adaptor) const;

    Connection* NewConnection(BlackBox* from,
                              const std::string& output,
                              BlackBox* to,
                              const std::string& input) const;

    void WriteDotFilePackagesList(FILE *ff);

    void Reset();
    
    void CheckPackages() const;

    typedef enum
      {
	Packages,
	Categories,
	Initials,
	Adaptors
      }
      IndexEntryType;
    void CreateHtmlIndex(IndexEntryType type, const std::string& filename);

    /// Sets the executer who created the factory (if any)
    void SetExecuter(Executer *e) { mExecuter = e; }
    /// Gets the executer who created the factory (if any)
    Executer* GetExecuter() { return mExecuter; }
    /// Gets the executer who created the factory (if any) - const
    const Executer* GetExecuter() const { return mExecuter; }


  private:

    bool DoLoadPackage(std::string libname,
		       std::string pkgname,
		       std::string path);

  public:
    /// The structure storing info on a package
    class PackageInfoType
    {
    public :
      /// Ctor
      PackageInfoType() {}
      /// Dtor
      ~PackageInfoType() {}
      /// The pointer on the package
      Package* mPackage;
      /// The handler of the dynamic library 
      DynamicLibraryHandler mDynamicLibraryHandler;
    };
    /// The type of map of packages
    typedef std::map< std::string, PackageInfoType > PackageMapType;

    const PackageMapType& GetPackageMap() const { return mPackageMap; }

  private:
    /// The map of packages
    PackageMapType mPackageMap;

    /// The executer which created the factory (if any)
    Executer* mExecuter;

    void CloseAllPackages();
    void ClosePackage(PackageMapType::iterator& i);

  };
  // class Factory



  /*
  /// SYSTEM METHOD : Global method returning the global factory object pointer
  inline Factory*& GlobalFactoryPointer() 
  {
    static Factory* f = 0;
    return f;
  }

  /// SYSTEM METHOD : Global method returning the global factory object 
  inline Factory* GetGlobalFactory() 
  {
    if (!GlobalFactoryPointer()) 
    {
       GlobalFactoryPointer() = new Factory;
    }
    return GlobalFactoryPointer();
  }

  /// SYSTEM METHOD : Deletes the global factory pointer
  inline void DeleteGlobalFactory() 
  {
    if (GlobalFactoryPointer()) 
    {
      delete GlobalFactoryPointer();
    }
  }

  inline void LoadPackage( const std::string& name )
  {
    GetGlobalFactory()->LoadPackage(name);
  }

  inline void UnLoadPackage( const std::string& name )
  { 
    GetGlobalFactory()->UnLoadPackage(name);
  }

  inline void PrintPackages(bool details = true, bool adaptors = false)
  {
    GetGlobalFactory()->PrintPackages(details,adaptors);
  }

  inline void HelpPackage(const std::string& name, bool adaptors = false) 
  {
    GetGlobalFactory()->HelpPackage(name,adaptors);
  }
  
  inline void HelpBlackBox(const std::string& name, bool full=true) 
  {
    std::string package; 
    GetGlobalFactory()->HelpBlackBox(name, package, full);
  }

  inline void HelpBlackBox(const std::string& name, std::string& package,
			   bool full=true
			   )
  {
    GetGlobalFactory()->HelpBlackBox(name, package, full);
  }


  inline void ShowGraphTypes(const std::string& name)
  {
    GetGlobalFactory()->ShowGraphTypes(name);
  }

  inline void InsertPackage( Package* p)
  {
    GetGlobalFactory()->InsertPackage(p);
  }

  inline void RemovePackage( Package* p)
  {
    GetGlobalFactory()->RemovePackage(p);
  }
  
  inline const Package* GetPackage(const std::string& name) 
  {
    return GetGlobalFactory()->GetPackage(name);
  }
    
  inline BlackBox* NewBlackBox(const std::string& type, 
                               const std::string& name) 
  {
    return GetGlobalFactory()->NewBlackBox(type,name);
  }
    
  inline BlackBox* NewAdaptor(TypeInfo typein,
                              TypeInfo typeout,
                              const std::string& name) 
  {
    return GetGlobalFactory()->NewAdaptor(typein,typeout,name);
  }
  
  inline Connection* NewConnection(BlackBox* from,
                                   const std::string& output,
                                   BlackBox* to,
                                   const std::string& input) 
  {
    return GetGlobalFactory()->NewConnection(from,output,to,input);
  }
  
  inline void WriteDotFilePackagesList(FILE *ff)
  {
    GetGlobalFactory()->WriteDotFilePackagesList(ff);
  }
  */
}// namespace bbtk



#endif