|
|
|
/*
|
|
|
|
Copyright (c) 2006 Nikolaj Hald Nielsen <nhnFreespirit@gmail.com>
|
|
|
|
|
|
|
|
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 MAGNATUNEXMLPARSER_H
|
|
|
|
#define MAGNATUNEXMLPARSER_H
|
|
|
|
|
|
|
|
|
|
|
|
#include "magnatunetypes.h"
|
|
|
|
#include "threadmanager.h"
|
|
|
|
|
|
|
|
#include <tqdom.h>
|
|
|
|
#include <tqstring.h>
|
|
|
|
#include <tqxml.h>
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Parser for the XML file from http://magnatune.com/info/album_info.xml
|
|
|
|
*
|
|
|
|
* @author Nikolaj Hald Nielsen
|
|
|
|
*/
|
|
|
|
#ifdef Q_MOC_RUN
|
|
|
|
// MOC_SKIP_BEGIN
|
|
|
|
class MagnatuneXmlParser : public JobBase
|
|
|
|
// MOC_SKIP_END
|
|
|
|
#else
|
|
|
|
class MagnatuneXmlParser : public ThreadManager::Job
|
|
|
|
#endif
|
|
|
|
{
|
|
|
|
Q_OBJECT
|
|
|
|
|
|
|
|
|
|
|
|
public:
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Constructor
|
|
|
|
* @param fileName The file to parse
|
|
|
|
* @return Pointer to new object
|
|
|
|
*/
|
|
|
|
MagnatuneXmlParser( TQString fileName );
|
|
|
|
|
|
|
|
/**
|
|
|
|
* The function that starts the actual work. Inherited fromThreadManager::Job
|
|
|
|
* Note the work is performed in a separate thread
|
|
|
|
* @return Returns true on success and false on failure
|
|
|
|
*/
|
|
|
|
bool doJob();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Called when the job has completed. Is executed in the GUI thread
|
|
|
|
*/
|
|
|
|
void completeJob();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Destructor
|
|
|
|
* @return none
|
|
|
|
*/
|
|
|
|
~MagnatuneXmlParser();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Reads, and starts parsing, file. Should not be used directly.
|
|
|
|
* @param filename The file to read
|
|
|
|
*/
|
|
|
|
void readConfigFile( TQString filename );
|
|
|
|
|
|
|
|
signals:
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Signal emmited when parsing is complete.
|
|
|
|
*/
|
|
|
|
void doneParsing();
|
|
|
|
|
|
|
|
private:
|
|
|
|
|
|
|
|
TQString m_currentArtist;
|
|
|
|
TQString m_currentArtistGenre;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Parses a DOM element
|
|
|
|
* @param e The element to parse
|
|
|
|
*/
|
|
|
|
void parseElement( TQDomElement e );
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Parses all children of a DOM element
|
|
|
|
* @param e The element whose children is to be parsed
|
|
|
|
*/
|
|
|
|
void parseChildren( TQDomElement e );
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Parse a DOM element representing an album
|
|
|
|
* @param e The album element to parse
|
|
|
|
*/
|
|
|
|
void parseAlbum( TQDomElement e );
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Parse a DOM element representing a track
|
|
|
|
* @param e The track element to parse
|
|
|
|
*/
|
|
|
|
void parseTrack( TQDomElement e );
|
|
|
|
|
|
|
|
MagnatuneAlbum *m_pCurrentAlbum;
|
|
|
|
MagnatuneArtist *m_pCurrentArtist;
|
|
|
|
MagnatuneTrackList m_currentAlbumTracksList;
|
|
|
|
|
|
|
|
TQString m_sFileName;
|
|
|
|
|
|
|
|
int m_nNumberOfTracks;
|
|
|
|
int m_nNumberOfAlbums;
|
|
|
|
int m_nNumberOfArtists;
|
|
|
|
|
|
|
|
|
|
|
|
};
|
|
|
|
|
|
|
|
#endif
|