global.cpp

Trolltech公司发布的图形界面操作系统。可在qt-embedded-2.3.10平台上编译为嵌入式图形界面操作系统。

/**********************************************************************
** Copyright (C) 2000-2005 Trolltech AS.  All rights reserved.
**
** This file is part of the Qtopia Environment.
** 
** 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; either version 2 of the License, or (at your
** option) any later version.
** 
** A copy of the GNU GPL license version 2 is included in this package as 
** LICENSE.GPL.
**
** This program 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 General Public License for more details.
**
** In addition, as a special exception Trolltech gives permission to link
** the code of this program with Qtopia applications copyrighted, developed
** and distributed by Trolltech under the terms of the Qtopia Personal Use
** License Agreement. You must comply with the GNU General Public License
** in all respects for all of the code used other than the applications
** licensed under the Qtopia Personal Use License Agreement. If you modify
** this file, you may extend this exception to your version of the file,
** but you are not obligated to do so. If you do not wish to do so, delete
** this exception statement from your version.
** 
** See http://www.trolltech.com/gpl/ for GPL licensing information.
**
** Contact [e-mail] if any conditions of this licensing are
** not clear to you.
**
**********************************************************************/


#define QTOPIA_INTERNAL_LANGLIST
#ifndef QTOPIA_INTERNAL_FILEOPERATIONS
#define QTOPIA_INTERNAL_FILEOPERATIONS
#endif
#ifndef QTOPIA_INTERNAL_DICTOPERATIONS
#define QTOPIA_INTERNAL_DICTOPERATIONS
#endif
#include <qtopia/global.h>

#ifdef Q_WS_QWS
#include <qtopia/qpedebug.h>
#include <qtopia/qdawg.h>
#include <qtopia/qpeapplication.h>
#include <qtopia/resource.h>
#include <qtopia/storage.h>
#include <qtopia/applnk.h>
#include <qwindowsystem_qws.h> 
#endif
#if defined(Q_WS_QWS) && !defined(QT_NO_COP)
#include <qtopia/qcopenvelope_qws.h>
#endif

#include <qfile.h>
#include <qlabel.h>
#include <qtimer.h>
#include <qmap.h>
#include <qdict.h>
#include <qdir.h>
#include <qmessagebox.h>
#include <qregexp.h>
#include <qdatetime.h>

#ifndef Q_OS_WIN32
#include <sys/stat.h>
#include <fcntl.h>
#include <unistd.h>
#include <qfileinfo.h>
#else
#include <sys/locking.h>
#include <io.h>
#include <string.h> // for strerror function
#include <stdlib.h>
#endif

#include <stdlib.h>
#include <stdio.h>
#include <errno.h>

#ifdef QTOPIA_DESKTOP
#include <qdconfig.h>
#endif

// this must be after <qdconfig.h>
#include "../qtopia1/qpe_homeDirPath.cpp"

#ifdef QTOPIA_HAVE_PROFILE
struct tms qtopia_prof_times;
#endif

extern bool mkdirRecursive( QString path );

// added in qtopia 1.6, so don't export this
QString qtopia_tempName( const QString &fname )
{
    QString temp;
    QFileInfo fileInfo( fname );
    temp = fileInfo.dirPath( TRUE ) + "/" + fileInfo.baseName() +
		 "_new." + fileInfo.extension(); // No tr
    return temp;
}

bool qtopia_renameFile( QString from, QString to )
{
    if ( from.isEmpty() || to.isEmpty() ) {
	qWarning("qtopia_renameFile emptry string(s) from '%s' to '%s'",
		 from.latin1(), to.latin1() );
	return FALSE;
    }

    // now do the rename
#ifdef Q_OS_WIN32
    if ( QFile::exists( to ) && !QFile::remove( to ) )
	qWarning("Global::renameFile failed removing %s before rename", to.latin1() );
#endif

    QDir dir;
    if ( dir.rename( from, to ) )
	return TRUE;

    qWarning( "problem renaming file using qdir::rename %s to %s",
	      from.latin1(), to.latin1() );
    //QFile::remove( from );
    // return FALSE;

    from = QDir::convertSeparators( QDir::cleanDirPath( from ) );
    to = QDir::convertSeparators( QDir::cleanDirPath( to ) );
    if ( ::rename( from, to ) != 0 ) {
 	qWarning( "::rename problem renaming file %s to %s errno %d",
	 	  from.latin1(), to.latin1(), errno );
#ifdef Q_OS_WIN32
 	qWarning("\trename error = %s", strerror(NULL) );
#endif
	return FALSE;
    }

    qDebug("worked using ::rename");
    return TRUE;
}

#ifdef Q_WS_QWS

Global::Command* Global::builtin=0;
QGuardedPtr<QWidget> *Global::running=0;

//#include "quickexec_p.h"
class Emitter : public QObject {
    Q_OBJECT
public:
    Emitter( QWidget* receiver, const QString& document )
    {
	connect(this, SIGNAL(setDocument(const QString&)),
	    receiver, SLOT(setDocument(const QString&)));
	emit setDocument(document);
	disconnect(this, SIGNAL(setDocument(const QString&)),
	       receiver, SLOT(setDocument(const QString&)));
    }

signals:
    void setDocument(const QString&);
};


static bool docDirCreated = FALSE;
static QDawg* fixed_dawg = 0;
static QDict<QDawg> *named_dawg = 0;

static QString dictDir()
{
    // Directory for fixed dawgs
    return QPEApplication::qpeDir() + "etc/dict";
}

/*!
  \class Global global.h
  \brief The Global class provides application-wide global functions.

  The Global functions are grouped as follows:
  \tableofcontents

  \section1 User Interface

  The statusMessage() function provides short-duration messages to the
  user. The showInputMethod() function shows the current input method,
  and hideInputMethod() hides the input method.

  \section1 Document related

  The findDocuments() function creates a set of \link doclnk.html
  DocLnk\endlink objects in a particular folder.

  \section1 Filesystem related

  Global provides an applicationFileName() function that returns the
  full path of an application-specific file.

  The execute() function runs an application.

  \section1 Word list related

  A list of words relevant to the current locale is maintained by the
  system. The list is held in a \link qdawg.html DAWG\endlink
  (implemented by the QDawg class). This list is used, for example, by
  the pickboard input method.

  The global QDawg is returned by fixedDawg(); this cannot be updated.
  An updatable copy of the global QDawg is returned by addedDawg().
  Applications may have their own word lists stored in \l{QDawg}s
  which are returned by dawg(). Use addWords() to add words to the
  updateable copy of the global QDawg or to named application
  \l{QDawg}s.

  \section1 Quoting

  The shellQuote() function quotes a string suitable for passing to a
  shell. The stringQuote() function backslash escapes '\' and '"'
  characters.

  \section1 Hardware

  The writeHWClock() function sets the hardware clock to the system
  clock's date and time.

  \ingroup qtopiaemb
*/

/*!
  \internal
*/
Global::Global()
{
}

void qtopia_load_fixedwords(QDawg* dawg, const QString& dictname)
{
    QString basename = dictDir() + "/" + dictname;
    QString words_lang;
    QString dawgfilename = basename + ".dawg";

    QStringList langs = Global::languageList();
    for (QStringList::ConstIterator it = langs.begin(); it!=langs.end(); ++it) {
	QString lang = *it;
	words_lang = basename + "-" + lang;
	QString dawgfilename_lang = words_lang + ".dawg";
	if ( QFile::exists(dawgfilename_lang) ||
	     QFile::exists(words_lang) ) {
	    dawgfilename = dawgfilename_lang;
	    break;
	}
    }

    if ( dawgfilename.isEmpty() || !QFile::exists(dawgfilename) ) {
	// Not recommended to generate the dawgs from the word lists
	// on a device (slow), but we put it here so eg. SDK can easily
	// generate dawgs as required.

	QString fn = QFile::exists(words_lang) ? words_lang : basename;
	qWarning("Generating '%s' dawg from word list.", fn.latin1());
	QFile in(fn);
	QFile dawgfile(fn+".dawg");
	if ( in.open(IO_ReadOnly) && dawgfile.open(IO_WriteOnly) ) {
	    dawg->createFromWords(&in);
	    dawg->write(&dawgfile);
	    dawgfile.close();
	}
    } else {
	dawg->readFile(dawgfilename);
    }
}

/*!
  Returns the unchangeable QDawg that contains general
  words for the current locale.

  \sa addedDawg()
*/
const QDawg& Global::fixedDawg()
{
    if ( !fixed_dawg ) {
	if ( !docDirCreated )
	    createDocDir();

	fixed_dawg = new QDawg;
	qtopia_load_fixedwords(fixed_dawg,"words");
    }

    return *fixed_dawg;
}

/*!
  Returns the changeable QDawg that contains general
  words for the current locale.

  \sa fixedDawg()
*/
const QDawg& Global::addedDawg()
{
    return dawg("local"); // No tr
}

void qtopia_reload_words(const QString& dictname)
{
    // Reload dictname, if we have it loaded.
    if ( named_dawg ) {
	QDawg* r = named_dawg->find(dictname);
	if ( r ) {
	    QString dawgfilename = Global::applicationFileName("Dictionary", dictname) + ".dawg"; // No tr
	    QFile dawgfile(dawgfilename);
	    if ( dawgfile.open(IO_ReadOnly) )
		r->readFile(dawgfilename);
	}
    }
}

/*!
  Returns the QDawg with the given \a name.
  This is an application-specific word list.

  \a name should not contain "/". If \a name starts
  with "_", it is a read-only system word list.
*/
const QDawg& Global::dawg(const QString& name)
{
    if ( !named_dawg )
	named_dawg = new QDict<QDawg>;
    QDawg* r = named_dawg->find(name);

    if ( !r ) {
	createDocDir();
	r = new QDawg;
	named_dawg->insert(name,r);

	if ( !r->root() ) {
	    if ( name[0] == '_' ) {
		QString n = name.mid(1);
		qtopia_load_fixedwords(r, n);
	    } else {
		qtopia_reload_words(name);
	    }
	}
    }

    return *r;
}

/*!
  Adds \a wordlist to the addedDawg(). Words that are already there
  are not added. Words that are in the 'deleted' dictionary are
  removed from there.

  Note that the addition of words persists between program executions
  (they are saved in the dictionary files), so you should confirm the
  words with the user before adding them.

  This is a slow operation. Call it once with a large list rather than
  multiple times with a small list.
*/
void Global::addWords(const QStringList& wordlist)
{
    QStringList toadd;
    QStringList toundel;
    QDawg& del = (QDawg&)dawg("deleted"); // No tr
    for (QStringList::ConstIterator it=wordlist.begin(); it!=wordlist.end(); ++it) {
	if ( del.contains(*it) )
	    toundel.append(*it);
	else
	    toadd.append(*it);
    }
    addWords("local",toadd); // No tr
    removeWords("deleted",toundel); // No tr
}

static void setDawgWords(const QString& dictname, const QStringList& words)
{
    QDawg& d = (QDawg&)Global::dawg(dictname);
    d.createFromWords(words);

    QString dawgfilename = Global::applicationFileName("Dictionary", dictname) + ".dawg"; // No tr
    QString dawgfilenamenew = dawgfilename + ".new";
    QFile dawgfile(dawgfilenamenew);
    if ( dawgfile.open(IO_WriteOnly) ) {
	d.write(&dawgfile);
	dawgfile.close();
	qtopia_renameFile(dawgfilenamenew,dawgfilename);
    }

    // Signal *other* processes to re-read.
    QCopEnvelope e( "QPE/System", "wordsChanged(QString,int)" );
    e << dictname << (int)getpid();
}

/*!
  Adds \a wordlist to the dawg() named \a dictname.

  Note that the addition of words persists between program executions
  (they are saved in the dictionary files), so you should confirm the
  words with the user before adding them.

  This is a slow operation. Call it once with a large list rather than
  multiple times with a small list.
*/
void Global::addWords(const QString& dictname, const QStringList& wordlist)
{
    if ( wordlist.isEmpty() )
	return;
    QDawg& d = (QDawg&)dawg(dictname);
    QStringList all = d.allWords() + wordlist;
    setDawgWords(dictname,all);
}

/*!
  Removes \a wordlist from the addedDawg(). If the words are in
  the fixed dictionary, they are added to the "deleted" dictionary.

  This is a slow operation. Call it once with a large list rather than
  multiple times with a small list.
*/
void Global::removeWords(const QStringList& wordlist)
{
    if ( wordlist.isEmpty() )
	return;
    QDawg& d = (QDawg&)dawg("local");
    QStringList loc = d.allWords();
    int nloc = loc.count();
    QStringList del;
    for (QStringList::ConstIterator it=wordlist.begin(); it!=wordlist.end(); ++it) {
	loc.remove(*it);
	if ( fixedDawg().contains(*it) )
	    del.append(*it);
    }
    if ( nloc != (int)loc.count() )
	setDawgWords("local",loc);
    addWords("deleted",del);
}

/*!
  Removes \a wordlist from the dawg() named \a dictname.

  This is a slow operation. Call it once with a large list rather than
  multiple times with a small list.
*/
void Global::removeWords(const QString& dictname, const QStringList& wordlist)
{
    QDawg& d = (QDawg&)dawg(dictname);
    QStringList all = d.allWords();
    for (QStringList::ConstIterator it=wordlist.begin(); it!=wordlist.end(); ++it)
	all.remove(*it);
    setDawgWords(dictname,all);
}

/*!
  \internal
*/
void Global::createDocDir()
{
    if ( !docDirCreated ) {
	QDir d;
	if (!d.exists(QPEApplication::documentDir().latin1())){
	    docDirCreated = TRUE;
#ifndef Q_WS_WIN32
	    mkdir( QPEApplication::documentDir().latin1(), 0755 );
#else
	    mkdirRecursive(QPEApplication::documentDir());
#endif
	}else{
	    docDirCreated = TRUE;
	}
    }
}


/*!
  \internal
*/
void Global::applyStyle()
{
#ifndef QT_NO_COP
    QCopChannel::send( "QPE/System", "applyStyle()" );
#else
    ((QPEApplication *)qApp)->applyStyle(); // apply without needing QCop for floppy version
#endif
}

/*!
  \internal
*/
QWidget *Global::shutdown( bool )
{
#ifndef QT_NO_COP
    QCopChannel::send( "QPE/System", "shutdown()" );
#endif
    return 0;
}

/*!
  \internal
*/
QWidget *Global::restart( bool )
{
#if defined(Q_WS_QWS) && !defined(QT_NO_COP)
    QCopChannel::send( "QPE/System", "restart()" );
#endif
    return 0;
}

/*!
  Explicitly show the current input method.

  Input methods are indicated in the taskbar by a small icon. If the
  input method is activated (shown) then it takes up some proportion
  of the bottom of the screen, to allow the user to interact (input
  characters) with it.

  \sa hideInputMethod()
*/
void Global::showInputMethod()
{
#ifndef QT_NO_COP