kde-playground/kdepimlibs/kldap/ldapmodel.h

/*
  This file is part of libkldap.
  Copyright (c) 2006 Sean Harmer <sh@theharmers.co.uk>

  This library is free software; you can redistribute it and/or
  modify it under the terms of the GNU Library General  Public
  License as published by the Free Software Foundation; either
  version 2 of the License, or (at your option) any later version.

  This library is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  Library General Public License for more details.

  You should have received a copy of the GNU Library General Public License
  along with this library; see the file COPYING.LIB.  If not, write to
  the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
  Boston, MA 02110-1301, USA.
*/

#ifndef KLDAP_LDAPMODEL_H
#define KLDAP_LDAPMODEL_H

#include <QtCore/QAbstractItemModel>

#include "ldapconnection.h"
#include "ldapobject.h"
#include "kldap_export.h"

namespace KLDAP {

/**
 * A ModelView interface to an LDAP tree. At present the model is read only. Editing is
 * planned for a future release.
 *
 * This class is best used in conjunction with an LdapStructureProxyModel object for
 * displaying the structure of an LDAP tree, and with LdapAttributeProxyModel for
 * displaying the attributes of particular objects within the tree.
 *
 * \author Sean Harmer <sh@theharmers.co.uk>
 */
class KLDAP_EXPORT LdapModel : public QAbstractItemModel
{
  Q_OBJECT
  public:
    enum Roles {
      NodeTypeRole = Qt::UserRole + 1
    };

    enum LdapDataType {
      DistinguishedName = 0,
      Attribute
    };

    /**
     * Constructs an LdapModel. You should set a connection for the model to use with
     * setConnection(). Clients of this class should connect a slot to the ready() signal
     * before setting this model onto a view.
     * @param parent the parent QObject
     * \see setConnection()
     * \see ready()
     */
    explicit LdapModel( QObject *parent = 0 );
    /**
     * Constructs an LdapModel. Clients of this class should connect a slot to the ready()
     * signal before setting this model onto a view.
     * @param connection the Ldap connection to use in model construction
     * @param parent the parent QObject
     * \see setConnection()
     * \see ready()
     */
    explicit LdapModel( LdapConnection &connection, QObject *parent = 0 );
    virtual ~LdapModel();

    /**
     * Set the connection that the model should use.
     * @param connection the model connection to set
     * \see LdapConnection
     * \see LdapUrl
     */
    void setConnection( LdapConnection &connection );

    //
    // Implement the usual QAbstractItemModel interface
    //
    /**
     * Reimplemented from QAbstractItemModel::index().
     */
    virtual QModelIndex index( int row, int col, const QModelIndex &parent ) const;
    /**
     * Reimplemented from QAbstractItemModel::parent().
     */
    virtual QModelIndex parent( const QModelIndex &child ) const;
    /**
     * Reimplemented from QAbstractItemModel::data().
     */
    virtual QVariant data( const QModelIndex &index, int role ) const;
    /**
     * Reimplemented from QAbstractItemModel::setData(). This is a placeholder for when
     * LdapModel beomes writeable and always returns false.
     */
    virtual bool setData( const QModelIndex &index,
                          const QVariant &value,
                          int role = Qt::EditRole );
    /**
     * Reimplemented from QAbstractItemModel::headerData().
     */
    virtual QVariant headerData( int section, Qt::Orientation orientation, int role ) const;
    /**
     * Reimplemented from QAbstractItemModel::flags().
     */
    virtual Qt::ItemFlags flags( const QModelIndex &index ) const;
    /**
     * Reimplemented from QAbstractItemModel::columnCount().
     */
    virtual int columnCount( const QModelIndex &parent ) const;
    /**
     * Reimplemented from QAbstractItemModel::rowCount().
     */
    virtual int rowCount( const QModelIndex &parent ) const;
    /**
     * Reimplemented from QAbstractItemModel::hasChildren().
     */
    virtual bool hasChildren( const QModelIndex &parent ) const;
    /**
     * Reimplemented from QAbstractItemModel::canFetchMore().
     */
    virtual bool canFetchMore( const QModelIndex &parent ) const;
    /**
     * Reimplemented from QAbstractItemModel::fetchMore().
     */
    virtual void fetchMore( const QModelIndex &parent );
    /**
     * Reimplemented from QAbstractItemModel::insertRows(). This is a placeholder for when
     * LdapModel beomes writeable and always returns false.
     */
    virtual bool insertRows( int row, int count,
                             const QModelIndex &parent = QModelIndex() );
    /**
     * Reimplemented from QAbstractItemModel::removeRows(). This is a placeholder for when
     * LdapModel beomes writeable and always returns false.
     */
    virtual bool removeRows( int row, int count,
                             const QModelIndex &parent = QModelIndex() );
    /**
     * Reimplemented from QAbstractItemModel::removeRows(). The default implementation
     * does nothing.
     */
    virtual void sort( int column, Qt::SortOrder order = Qt::AscendingOrder );

    //
    // Drag and drop support
    //
    /**
     * Reimplemented from QAbstractItemModel::supportedDropActions(). The default
     * implementation returns Qt::MoveAction.
     */
    virtual Qt::DropActions supportedDropActions() const;
    /**
     * Reimplemented from QAbstractItemModel::mimedata(). This is a placeholder for when
     * LdapModel beomes writeable and always returns 0.
     */
    virtual QMimeData *mimeData( const QModelIndexList &indexes ) const;
    /**
     * Reimplemented from QAbstractItemModel::dropMimedata(). This is a placeholder for when
     * LdapModel beomes writeable and always returns false.
     */
    virtual bool dropMimeData( const QMimeData *data, Qt::DropAction action,
                               int row, int column, const QModelIndex &parent );

    //
    // Other public utility functions
    //
    /**
     * Checks to see if the item referenced by \p parent has any children of
     * the type \p type. If the item has not been populated by fetchMore() yet,
     * then this function returns true.
     *
     * \see fetchMore()
     * \param parent Index to the item to query.
     * \param type The type of child item to search for.
     */
    bool hasChildrenOfType( const QModelIndex &parent, LdapDataType type ) const;

  public Q_SLOTS:
    /**
     * Reimplemented from QAbstractItemModel::revert(). This is a placeholder for when
     * LdapModel beomes writeable. This implementation does nothing.
     */
    virtual void revert();
    /**
     * Reimplemented from QAbstractItemModel::revert(). This is a placeholder for when
     * LdapModel beomes writeable. This implementation does nothing and returns false.
     */
    virtual bool submit();

  Q_SIGNALS:
    /**
     * The ready() signal is emitted when the model is ready for use by other components.
     * When the model is first created and a connection is set, the model queries the
     * LDAP server for its base DN and automatically creates items down to that level.
     * This requires the event loop to be running. This signal indicates that this process
     * has completed and the model can now be set onto views or queried directly from code.
     */
    void ready();

  private:
    class LdapModelPrivate;
    LdapModelPrivate *const m_d;

    Q_PRIVATE_SLOT( m_d, void gotSearchResult( KLDAP::LdapSearch* ) )
    Q_PRIVATE_SLOT( m_d, void gotSearchData( KLDAP::LdapSearch*, const KLDAP::LdapObject& ) )
};

}
#endif