src/osd1/linux-r3-main-app/trunk/neuros-qt4-libs/neux/tools/nfontupdater.h

Go to the documentation of this file.

#ifndef NFONTUPDATER_H
#define NFONTUPDATER_H
/*
 *  Copyright(C) 2007 Neuros Technology International LLC. 
 *               <www.neurostechnology.com>
 *
 *
 *  This program is free software; you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation, version 2 of the License.
 *  
 *
 *  This program is distributed in the hope that, in addition to its 
 *  original purpose to support Neuros hardware, it will be useful 
 *  otherwise, but WITHOUT ANY WARRANTY; without even the implied 
 *  warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  
 *  See the GNU General Public License for more details.
 *
 *  You should have received a copy of the GNU General Public License
 *  along with this program; if not, write to the Free Software
 *  Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
 *
 ****************************************************************************
 *
 * NFontUpdater header
 * 
 * 
 * REVISION:
 * 
 * 1) Initial creation. ----------------------------------- 2008-04-28 WX
 *
 */

#include <QtGlobal>
#include <QObject>
#include <QString>
#include <QStringList>
#include <QUrl>
#include <QVector>
#include <QFile>
#include <QHttp>
#include <QFontDatabase>

class NFontUpdater : public QObject
{
    Q_OBJECT
    Q_ENUMS(Source);
    Q_ENUMS(Step);
    Q_ENUMS(Error);

public:
    enum Source
    {
        FromNone = 0, FromServer, FromLocal, 
    };

    enum Step
    {
        Initialize = 0, 
        CleanupDownloadDirectory, 
        CheckNextPackageToDownload,
        DownloadCurrentPackage, 
        CheckAllRequiredPackagesAvailable,
        RemoveFontSymlinks,
        RemoveFontFiles, 
        CheckNextPackageToUnpack,
        UnpackCurrentPackage, 
        RemoveCurrentPackage,
        MakeFontSymlinks, 
        UpdateApplicationFont,
        Finish
    };

    enum Error
    {
        NoError = 0, 
        InvalidUrl, 
        PackageNoFoundOnLocal, 
        PackageNoFoundOnServer, 
        LocalStorageNonexistent, 
        LocalStorageUnReadable,
        LocalStorageUnWritable, 
        FontFilesNoFoundOnLocal,
        CleanDownloadDirectoryFailed, 
        RemoveFontLinksFailed,
        RemoveFontFilesFailed, 
        UnpackFailed,
        MakeFontLinksFailed, 
        UpdateApplicationFontFailed,
        DownloadFailed, 
    };

    explicit NFontUpdater(QObject *parent = 0);
    ~NFontUpdater( );

    static bool needExtendedFont(const QString &font);

    void setSource(Source source) { fontSource = source; }
    void setFontFrom(const QString &from) { fromFont = from; }
    void setFontTo(const QString &to) { toFont = to; }

    Source source( ) const { return fontSource; }
    QString from( ) const { return fromFont; }
    QString to( ) const { return toFont; }

     //FromServer: it is the directory to storage downloaded package, AND it will be cleanuped.
     //FromLocal: it is the storage directory where should contain font packages.
    void setLocalStorage(const QString &path) { localStorageDir = path; }

    QString currentPackage( ) const { return -1 == currentPackageIndex ? "" : fontPackageList[currentPackageIndex]; }

    Error error( ) const { return updateError; }
    QString errorString( ) { return updateErrorString; }

    Step currentStep( ) const { return stepSequence[currentStepIndex]; }
    Step nextStep( ) const { return stepSequence[nextStepIndex]; }
    void initUpdater( );
    void cleanup( );
    void doNextStep( );

    bool init( );
    bool cleanupDownloadDirectory( );
    bool startDownloadCurrentPackage( );
    int checkNextPackageToDownload( ); // -1: error, 0: no more package, 1: there is a next package need to process
    int checkNextPackageToUnpack( );
    bool checkAllRequiredPackagesAvailable( );
    bool removeFontSymlinks( );
    bool removeFontFiles( );
    bool unpackCurrentPackage( );
    bool removeCurrentPackage( );
    bool makeFontSymlinks( );
    bool updateApplicationFont( );
    bool finish( );

Q_SIGNALS:
    void stepFinished(bool error);
    void httpDone(bool error);

private Q_SLOTS:
    void onHttpResponseHeaderReceived(const QHttpResponseHeader &resp);
    void onHttpRequestFinished(int id, bool error);

private:
    void setError(Error error) { updateError = error; }
    void setErrorString(const QString &text) { updateErrorString = text; }
    QVector<Step> getStepSequence(Source source, const QString &from, const QString &to) const;
    QStringList getDefaultPackages(const QString &font) const;
    QString getPackageName(int index) const;
    QString getDefaultServerStorageDir(const QString &font) const;
    QString getDefaultLocalStorageDir(Source source) const;
    QString convertToPath(const QStringList &list) const;

private:
    Source fontSource;
    Error updateError;
    QString updateErrorString;
    QString fromFont;
    QString toFont;

    QVector<Step> stepSequence;
    int currentStepIndex;
    int nextStepIndex;

    int currentHttpGetId;
    bool currentHttpGetFinished;
    QFile *currentHttpGetFile;
    QHttp *currentHttp;
    QUrl currentPackageUrl;
    QString serverStorageDir;
    QString localStorageDir;
    QStringList fontPackageList;
    int currentPackageIndex;
};

#endif // NFONTUPDATER_H

---