messagingapp/msgui/msgaudiofetcher/inc/msgaudiofetchermodel.h
author hgs
Tue, 05 Oct 2010 13:58:47 +0530
changeset 73 ecf6a73a9186
parent 37 518b245aa84c
permissions -rw-r--r--
201039_03
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
37
hgs
parents:
diff changeset
     1
/*
hgs
parents:
diff changeset
     2
 * Copyright (c) 2010 Nokia Corporation and/or its subsidiary(-ies).
hgs
parents:
diff changeset
     3
 * All rights reserved.
hgs
parents:
diff changeset
     4
 * This component and the accompanying materials are made available
hgs
parents:
diff changeset
     5
 * under the terms of "Eclipse Public License v1.0"
hgs
parents:
diff changeset
     6
 * which accompanies this distribution, and is available
hgs
parents:
diff changeset
     7
 * at the URL "http://www.eclipse.org/legal/epl-v10.html".
hgs
parents:
diff changeset
     8
 *
hgs
parents:
diff changeset
     9
 * Initial Contributors:
hgs
parents:
diff changeset
    10
 * Nokia Corporation - initial contribution.
hgs
parents:
diff changeset
    11
 * 
hgs
parents:
diff changeset
    12
 * Contributors:
hgs
parents:
diff changeset
    13
 * 
hgs
parents:
diff changeset
    14
 * Description:
hgs
parents:
diff changeset
    15
 *     The header file for messaging's audio fetcher model
hgs
parents:
diff changeset
    16
 *     
hgs
parents:
diff changeset
    17
 */
hgs
parents:
diff changeset
    18
hgs
parents:
diff changeset
    19
#ifndef MSGAUDIOFETCHERMODEL_H
hgs
parents:
diff changeset
    20
#define MSGAUDIOFETCHERMODEL_H
hgs
parents:
diff changeset
    21
hgs
parents:
diff changeset
    22
// SYSTEM INCLUDES
hgs
parents:
diff changeset
    23
#include <QStandardItemModel>
hgs
parents:
diff changeset
    24
#include <QStringList>
hgs
parents:
diff changeset
    25
#include <QDir>
hgs
parents:
diff changeset
    26
hgs
parents:
diff changeset
    27
// FORWARD DECLARATIONS
hgs
parents:
diff changeset
    28
class MsgAudioSelectionEngine;
hgs
parents:
diff changeset
    29
hgs
parents:
diff changeset
    30
/**
hgs
parents:
diff changeset
    31
 * @class MsgAudioFetcherModel
hgs
parents:
diff changeset
    32
 * @brief This class is messaging's audio fetcher model
hgs
parents:
diff changeset
    33
 */
hgs
parents:
diff changeset
    34
class MsgAudioFetcherModel : public QStandardItemModel
hgs
parents:
diff changeset
    35
{
hgs
parents:
diff changeset
    36
Q_OBJECT
hgs
parents:
diff changeset
    37
hgs
parents:
diff changeset
    38
public:
hgs
parents:
diff changeset
    39
    /**
hgs
parents:
diff changeset
    40
     * Constructor
hgs
parents:
diff changeset
    41
     */
hgs
parents:
diff changeset
    42
    explicit MsgAudioFetcherModel(QObject *parent);
hgs
parents:
diff changeset
    43
hgs
parents:
diff changeset
    44
    /**
hgs
parents:
diff changeset
    45
     * Destructor
hgs
parents:
diff changeset
    46
     */
hgs
parents:
diff changeset
    47
    virtual ~MsgAudioFetcherModel();
hgs
parents:
diff changeset
    48
hgs
parents:
diff changeset
    49
    /**
hgs
parents:
diff changeset
    50
     * Clears model
hgs
parents:
diff changeset
    51
     */
hgs
parents:
diff changeset
    52
    void clearAll();
hgs
parents:
diff changeset
    53
    
hgs
parents:
diff changeset
    54
    /**
hgs
parents:
diff changeset
    55
     * adds a row into the model
hgs
parents:
diff changeset
    56
     */
hgs
parents:
diff changeset
    57
    void addRow(QString filepath);
hgs
parents:
diff changeset
    58
hgs
parents:
diff changeset
    59
public: //from QAbstractItemModel
hgs
parents:
diff changeset
    60
    QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const;
hgs
parents:
diff changeset
    61
hgs
parents:
diff changeset
    62
private:
hgs
parents:
diff changeset
    63
    /**
hgs
parents:
diff changeset
    64
     * binary search (ascendant) for the correct index to insert.
hgs
parents:
diff changeset
    65
     * @param low the start of search
hgs
parents:
diff changeset
    66
     * @param high the end of search.
hgs
parents:
diff changeset
    67
     * @return the correct index
hgs
parents:
diff changeset
    68
     */
hgs
parents:
diff changeset
    69
    int insertIndex(int low, int high, QString variant);
hgs
parents:
diff changeset
    70
hgs
parents:
diff changeset
    71
    /**
hgs
parents:
diff changeset
    72
     * Add audio files into the model
hgs
parents:
diff changeset
    73
     * @param toneDir, Dir from which to get audio files to add to model
hgs
parents:
diff changeset
    74
     */
hgs
parents:
diff changeset
    75
    void addToneFiles(QDir& toneDir);
hgs
parents:
diff changeset
    76
    
hgs
parents:
diff changeset
    77
    /**
hgs
parents:
diff changeset
    78
     * Finds and adds audio files into the model
hgs
parents:
diff changeset
    79
     */
hgs
parents:
diff changeset
    80
    void getRomToneFiles();
hgs
parents:
diff changeset
    81
hgs
parents:
diff changeset
    82
    /**
hgs
parents:
diff changeset
    83
     * Initialize the model
hgs
parents:
diff changeset
    84
     */
hgs
parents:
diff changeset
    85
    void init();
hgs
parents:
diff changeset
    86
    
hgs
parents:
diff changeset
    87
    /**
hgs
parents:
diff changeset
    88
     * checks if the given file is DRM protected
hgs
parents:
diff changeset
    89
     * @param filepath, path of audio file
hgs
parents:
diff changeset
    90
     */
hgs
parents:
diff changeset
    91
    bool isDRM(QString filepath);
hgs
parents:
diff changeset
    92
hgs
parents:
diff changeset
    93
private slots:
hgs
parents:
diff changeset
    94
    /**
hgs
parents:
diff changeset
    95
     * Handle MDS session open
hgs
parents:
diff changeset
    96
     */
hgs
parents:
diff changeset
    97
    void mdeSessionOpened();
hgs
parents:
diff changeset
    98
hgs
parents:
diff changeset
    99
    /**
hgs
parents:
diff changeset
   100
     * Handle MDS session open error
hgs
parents:
diff changeset
   101
     */
hgs
parents:
diff changeset
   102
    void mdeSessionError(int error);
hgs
parents:
diff changeset
   103
    
hgs
parents:
diff changeset
   104
    /**
hgs
parents:
diff changeset
   105
     * Handle MDS query complete
hgs
parents:
diff changeset
   106
     */
hgs
parents:
diff changeset
   107
    void queryComplete(const QStringList &nameList,
hgs
parents:
diff changeset
   108
            const QStringList &uriList);
hgs
parents:
diff changeset
   109
hgs
parents:
diff changeset
   110
    /**
hgs
parents:
diff changeset
   111
     * Handle MDS query error
hgs
parents:
diff changeset
   112
     */
hgs
parents:
diff changeset
   113
    void queryError(int error);
hgs
parents:
diff changeset
   114
hgs
parents:
diff changeset
   115
    /**
hgs
parents:
diff changeset
   116
     * Handle object observer callback
hgs
parents:
diff changeset
   117
     */
hgs
parents:
diff changeset
   118
    void onObjectChanged();
hgs
parents:
diff changeset
   119
hgs
parents:
diff changeset
   120
private:
hgs
parents:
diff changeset
   121
    /**
hgs
parents:
diff changeset
   122
     * audio selection engine
hgs
parents:
diff changeset
   123
     */
hgs
parents:
diff changeset
   124
    MsgAudioSelectionEngine* mSelectionEngine;
73
ecf6a73a9186 201039_03
hgs
parents: 37
diff changeset
   125
#ifdef AUDIO_FETCHER_UNIT_TEST
ecf6a73a9186 201039_03
hgs
parents: 37
diff changeset
   126
    /**
ecf6a73a9186 201039_03
hgs
parents: 37
diff changeset
   127
     * Unit Testing
ecf6a73a9186 201039_03
hgs
parents: 37
diff changeset
   128
     */
ecf6a73a9186 201039_03
hgs
parents: 37
diff changeset
   129
    friend class TestMsgAudioFetcherModel;
ecf6a73a9186 201039_03
hgs
parents: 37
diff changeset
   130
#endif
ecf6a73a9186 201039_03
hgs
parents: 37
diff changeset
   131
    
37
hgs
parents:
diff changeset
   132
};
hgs
parents:
diff changeset
   133
hgs
parents:
diff changeset
   134
#endif /* MsgAudioFetcherModel_H_ */