CTK/Libs/PluginFramework/ctkPluginFrameworkContext_p.h

/*=============================================================================

  Library: CTK

  Copyright (c) 2010 German Cancer Research Center,
    Division of Medical and Biological Informatics

  Licensed under the Apache License, Version 2.0 (the "License");
  you may not use this file except in compliance with the License.
  You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

  Unless required by applicable law or agreed to in writing, software
  distributed under the License is distributed on an "AS IS" BASIS,
  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  See the License for the specific language governing permissions and
  limitations under the License.

=============================================================================*/

#ifndef CTKPLUGINFRAMEWORKCONTEXT_P_H
#define CTKPLUGINFRAMEWORKCONTEXT_P_H

#include <QDebug>
#include <QMutex>

#include "ctkPluginFrameworkFactory.h"
#include "ctkPluginFramework.h"
#include "ctkPluginStorage_p.h"
#include "ctkPlugins_p.h"
#include "ctkPluginFrameworkListeners_p.h"
#include "ctkServices_p.h"


  class ctkPlugin;

  class ctkPluginFrameworkContext {

  public:

      /**
       * All plugins in this framework.
       */
      ctkPlugins* plugins;

      /**
       * All listeners in this framework.
       */
      ctkPluginFrameworkListeners listeners;

      /**
       * All registered services in this framework.
       */
      ctkServices services;

      /**
       * System plugin
       */
      ctkPluginFramework systemPlugin;

      /**
       * ctkPlugin storage
       */
      ctkPluginStorage storage;

      /**
       * Framework id.
       */
      int id;

      /**
       * global lock.
       */
      static QMutex globalFwLock;

      /**
       * Id to use for next instance of plugin framework.
       */
      static int globalId;

      ctkPluginFrameworkFactory::Properties props;

      /**
       * Contruct a framework context
       *
       */
      ctkPluginFrameworkContext(const ctkPluginFrameworkFactory::Properties& initProps);


      /**
       * Initialize the framework
       *
       */
      void init();


      /**
       * Undo as much as possible of what init() does.
       *
       */
      void uninit();


      /**
       *
       */
      int getId() const;


      /**
       * Check that the plugin belongs to this framework instance.
       *
       */
      void checkOurPlugin(ctkPlugin* plugin) const;


      /**
       * Check that the plugin specified can resolve all its
       * Require-ctkPlugin constraints.
       *
       * @param plugin ctkPlugin to check, must be in INSTALLED state
       *
       * @throws ctkPluginException
       */
      void resolvePlugin(ctkPluginPrivate* plugin);


      /**
       * Log message for debugging framework
       *
       */
      QDebug log() const;

  private:

      QSet<ctkPluginPrivate*> tempResolved;

      void checkRequirePlugin(ctkPluginPrivate* plugin);
  };


#endif // CTKPLUGINFRAMEWORKCONTEXT_P_H