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

   Program: ParaView
   Module:    $RCSfile$

   Copyright (c) 2005,2006 Sandia Corporation, Kitware Inc.
   All rights reserved.

   ParaView is a free software; you can redistribute it and/or modify it
   under the terms of the ParaView license version 1.2. 
   
   See License_v1.2.txt for the full ParaView license.
   A copy of this license can be obtained by contacting
   Kitware Inc.
   28 Corporate Drive
   Clifton Park, NY 12065
   USA

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS OR
CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

========================================================================*/
#ifndef __pqServerConfigurationCollection_h 
#define __pqServerConfigurationCollection_h

#include <QObject>
#include <QMap>
#include <QList>
#include "pqCoreModule.h"

class vtkPVXMLElement;
class pqServerResource;
class pqServerConfiguration;

/// pqServerConfigurationCollection maintains a serializable collection of
/// server-configurations defined in pqServerConfiguration instances.
///
/// During construction, this class attempts to read server-configurations from
/// following locations:
/// \li QApplication::applicationDirPath()/default_servers.pvsc
/// \li ${COMMON_APPDATA}/QApplication::organizationName()/servers.pvsc
/// \li /usr/share/QApplication::organizationName()/servers.pvsc
/// \li ${QSettings INI Path}/servers.pvsc -- User-specific servers.
///
/// The location marked as "User-specific servers" is the location where any
/// server-configurations created/imported by user are saved. User can only
/// modify the server-configurations loaded from this file. All others are
/// treated as read-only configurations.
class PQCORE_EXPORT pqServerConfigurationCollection : public QObject
{
  Q_OBJECT
  typedef QObject Superclass;
public:
  pqServerConfigurationCollection(QObject* parent=0);
  virtual ~pqServerConfigurationCollection();

  /// load a pvsc txt. If mutable_configs==true, then the server-configurations
  /// loaded from this file can be edited by the user and get saved in
  /// "User-specific servers" configuration file at destruction.
  bool loadContents(const QString& contents, bool mutable_configs);

  /// save the currently loaded configurations to a file. If only_mutable==true,
  /// only the configurations that were marked mutable are saved, otherwise all
  /// configurations are saved.
  QString saveContents(bool only_mutable) const;

  /// load/save configurations from/to file.
  bool load(const QString& filename, bool mutable_configs);
  bool save(const QString& filename, bool only_mutable);
  bool saveNow();

  /// Add a server configuration.
  void addConfiguration(vtkPVXMLElement* configuration, bool mutable_config=true);
  void addConfiguration(const pqServerConfiguration&);

  /// remove a configuration given the name.
  void removeConfiguration(const QString&);

  /// returns the set of server-configurations.
  QList<pqServerConfiguration> configurations() const;

  /// returns the configurations matching the selector's host.
  QList<pqServerConfiguration> configurations(
    const pqServerResource& selector) const;

  /// Returns a configuration with the given name. Returns NULL when none is
  /// found.
  const pqServerConfiguration* configuration(
    const char* configuration_name) const;

signals:
  /// fired when the collection is modified.
  void changed();

protected:
  QMap<QString, pqServerConfiguration> Configurations;

private:
  Q_DISABLE_COPY(pqServerConfigurationCollection)
};

#endif
