Merge branch 'master' into frameworks

Conflicts:
	dolphin/src/statusbar/statusbarspaceinfo.cpp
This commit is contained in:
Emmanuel Pescosta 2014-05-25 14:43:18 +02:00
commit fa36c3fd1f
9 changed files with 480 additions and 44 deletions

View file

@ -208,6 +208,9 @@ set(dolphin_SRCS
settings/viewmodes/viewmodesettings.cpp
settings/viewmodes/viewsettingstab.cpp
statusbar/dolphinstatusbar.cpp
statusbar/mountpointobserver.cpp
statusbar/mountpointobservercache.cpp
statusbar/spaceinfoobserver.cpp
statusbar/statusbarspaceinfo.cpp
views/zoomlevelinfo.cpp
)

View file

@ -0,0 +1,48 @@
/***************************************************************************
* Copyright (C) 2014 by Frank Reininghaus <frank78ac@googlemail.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; either version 2 of the License, or *
* (at your option) any later version. *
* *
* 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. *
* *
* 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., *
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA *
***************************************************************************/
#include "mountpointobserver.h"
#include "mountpointobservercache.h"
MountPointObserver::MountPointObserver(const QString& mountPoint, QObject* parent) :
QObject(parent),
m_mountPoint(mountPoint),
m_referenceCount(0),
m_spaceInfo(KDiskFreeSpaceInfo::freeSpaceInfo(mountPoint))
{
}
MountPointObserver* MountPointObserver::observerForPath(const QString& path)
{
MountPointObserver* observer = MountPointObserverCache::instance()->observerForPath(path);
return observer;
}
void MountPointObserver::update()
{
if (m_referenceCount == 0) {
delete this;
} else {
const KDiskFreeSpaceInfo spaceInfo = KDiskFreeSpaceInfo::freeSpaceInfo(m_mountPoint);
if (spaceInfo.size() != m_spaceInfo.size() || spaceInfo.available() != m_spaceInfo.available()) {
m_spaceInfo = spaceInfo;
emit spaceInfoChanged();
}
}
}

View file

@ -0,0 +1,109 @@
/***************************************************************************
* Copyright (C) 2014 by Frank Reininghaus <frank78ac@googlemail.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; either version 2 of the License, or *
* (at your option) any later version. *
* *
* 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. *
* *
* 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., *
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA *
***************************************************************************/
#ifndef MOUNTPOINTOBSERVER_H
#define MOUNTPOINTOBSERVER_H
#include <KDiskFreeSpaceInfo>
#include <QObject>
/**
* A MountPointObserver can be used to determine the free space on a mount
* point. It will then check the free space periodically, and emit the signal
* spaceInfoChanged() if the return value of spaceInfo() has changed.
*
* Since multiple users which watch paths on the same mount point can share
* a MountPointObserver, it is not possible to create a MountPointObserver
* manually. Instead, the function observerForPath(QString&) should be called,
* which returns either an existing or a newly created MountPointObserver for
* the mount point where the path is mounted. observerForPath(QString&) looks
* for a suitable MountPointObserver in an internal cache and creates new
* MountPointObservers and adds them to the cache if necessary.
*
* Reference counting is used to keep track of the number of users, and to
* decide when the object can be deleted. A user of this class should call
* the method ref() when it starts using it, and deref() when it does not need
* the MountPointObserver any more.
*
* The object will not be deleted immediately if the reference count reaches
* zero. The object will only be destroyed when the next periodic update of
* the free space information happens, and the reference count is still zero.
* This approach makes it possible to re-use the object if a new user requests
* the free space for the same mount point before the next update.
*/
class MountPointObserver : public QObject
{
Q_OBJECT
explicit MountPointObserver(const QString& mountPoint, QObject* parent = 0);
virtual ~MountPointObserver() {}
public:
/**
* Obtains information about the available space on the observed mount point.
*/
KDiskFreeSpaceInfo spaceInfo() const { return m_spaceInfo; }
/**
* Call this function to indicate that the caller intends to continue using this object. An
* internal reference count is increased then. When the observer is not needed any more,
* deref() should be called, which decreases the reference count again.
*/
void ref() { ++m_referenceCount; }
/**
* This function can be used to indicate that the caller does not need this MountPointObserver
* any more. Internally, a reference count is decreased. If the reference count is zero while
* update() is called, the object deletes itself.
*/
void deref()
{
--m_referenceCount;
Q_ASSERT(m_referenceCount >= 0);
}
/**
* Returns a MountPointObserver for the given \a path. If the caller intends to continue using
* the returned object, it must call its ref() method.
*/
static MountPointObserver* observerForPath(const QString& path);
signals:
/**
* This signal is emitted if the information that spaceInfo() will return has changed.
*/
void spaceInfoChanged();
public slots:
/**
* If this slot is invoked, MountPointObserver checks if the available space on the observed
* mount point has changed, and emits spaceInfoChanged() if that is the case.
*/
void update();
private:
const QString m_mountPoint;
int m_referenceCount;
KDiskFreeSpaceInfo m_spaceInfo;
friend class MountPointObserverCache;
};
#endif

View file

@ -0,0 +1,99 @@
/***************************************************************************
* Copyright (C) 2014 by Frank Reininghaus <frank78ac@googlemail.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; either version 2 of the License, or *
* (at your option) any later version. *
* *
* 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. *
* *
* 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., *
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA *
***************************************************************************/
#include "mountpointobservercache.h"
#include "mountpointobserver.h"
#include <KGlobal>
#include <KMountPoint>
#include <QTimer>
class MountPointObserverCacheSingleton
{
public:
MountPointObserverCache instance;
};
K_GLOBAL_STATIC(MountPointObserverCacheSingleton, s_MountPointObserverCache)
MountPointObserverCache::MountPointObserverCache() :
m_observerForMountPoint(),
m_mountPointForObserver(),
m_updateTimer(0)
{
m_updateTimer = new QTimer(this);
}
MountPointObserverCache::~MountPointObserverCache()
{
}
MountPointObserverCache* MountPointObserverCache::instance()
{
return &s_MountPointObserverCache->instance;
}
MountPointObserver* MountPointObserverCache::observerForPath(const QString& path)
{
// Try to share the observer with other paths that have the same mount point.
QString mountPointPath;
KMountPoint::Ptr mountPoint = KMountPoint::currentMountPoints().findByPath(path);
if (mountPoint) {
mountPointPath = mountPoint->mountPoint();
} else {
// Even if determining the mount point failed, KDiskFreeSpaceInfo might still
// be able to retrieve information about the path.
mountPointPath = path;
}
MountPointObserver* observer = m_observerForMountPoint.value(mountPointPath);
if (!observer) {
observer = new MountPointObserver(mountPointPath, this);
m_observerForMountPoint.insert(mountPointPath, observer);
m_mountPointForObserver.insert(observer, mountPointPath);
Q_ASSERT(m_observerForMountPoint.count() == m_mountPointForObserver.count());
connect(observer, SIGNAL(destroyed(QObject*)), this, SLOT(slotObserverDestroyed(QObject*)));
if (!m_updateTimer->isActive()) {
m_updateTimer->start(10000);
}
connect(m_updateTimer, SIGNAL(timeout()), observer, SLOT(update()));
}
return observer;
}
void MountPointObserverCache::slotObserverDestroyed(QObject* observer)
{
Q_ASSERT(m_mountPointForObserver.contains(observer));
const QString& path = m_mountPointForObserver.value(observer);
Q_ASSERT(m_observerForMountPoint.contains(path));
m_observerForMountPoint.remove(path);
m_mountPointForObserver.remove(observer);
Q_ASSERT(m_observerForMountPoint.count() == m_mountPointForObserver.count());
if (m_mountPointForObserver.isEmpty()) {
m_updateTimer->stop();
}
}

View file

@ -0,0 +1,58 @@
/***************************************************************************
* Copyright (C) 2014 by Frank Reininghaus <frank78ac@googlemail.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; either version 2 of the License, or *
* (at your option) any later version. *
* *
* 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. *
* *
* 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., *
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA *
***************************************************************************/
#ifndef MOUNTPOINTOBSERVERCACHE_H
#define MOUNTPOINTOBSERVERCACHE_H
#include <QHash>
#include <QObject>
class MountPointObserver;
class QTimer;
class MountPointObserverCache : public QObject
{
Q_OBJECT
MountPointObserverCache();
virtual ~MountPointObserverCache();
public:
static MountPointObserverCache* instance();
/**
* Returns a MountPointObserver for the given \a path. A new observer is created if necessary.
*/
MountPointObserver* observerForPath(const QString& path);
private slots:
/**
* Removes the given \a observer from the cache.
*/
void slotObserverDestroyed(QObject* observer);
private:
QHash<QString, MountPointObserver*> m_observerForMountPoint;
QHash<QObject*, QString> m_mountPointForObserver;
QTimer* m_updateTimer;
friend class MountPointObserverCacheSingleton;
};
#endif

View file

@ -0,0 +1,89 @@
/***************************************************************************
* Copyright (C) 2014 by Frank Reininghaus <frank78ac@googlemail.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; either version 2 of the License, or *
* (at your option) any later version. *
* *
* 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. *
* *
* 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., *
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA *
***************************************************************************/
#include "spaceinfoobserver.h"
#include "mountpointobserver.h"
#include <KUrl>
SpaceInfoObserver::SpaceInfoObserver(const KUrl& url, QObject* parent) :
QObject(parent),
m_mountPointObserver(0)
{
if (url.isLocalFile()) {
m_mountPointObserver = MountPointObserver::observerForPath(url.toLocalFile());
m_mountPointObserver->ref();
connect(m_mountPointObserver, SIGNAL(spaceInfoChanged()), this, SIGNAL(valuesChanged()));
}
}
SpaceInfoObserver::~SpaceInfoObserver()
{
if (m_mountPointObserver) {
m_mountPointObserver->deref();
m_mountPointObserver = 0;
}
}
quint64 SpaceInfoObserver::size() const
{
if (m_mountPointObserver && m_mountPointObserver->spaceInfo().isValid()) {
return m_mountPointObserver->spaceInfo().size();
} else {
return 0;
}
}
quint64 SpaceInfoObserver::available() const
{
if (m_mountPointObserver && m_mountPointObserver->spaceInfo().isValid()) {
return m_mountPointObserver->spaceInfo().available();
} else {
return 0;
}
}
void SpaceInfoObserver::setUrl(const KUrl& url)
{
if (url.isLocalFile()) {
MountPointObserver* newObserver = MountPointObserver::observerForPath(url.toLocalFile());
if (newObserver != m_mountPointObserver) {
if (m_mountPointObserver) {
disconnect(m_mountPointObserver, SIGNAL(spaceInfoChanged()), this, SIGNAL(valuesChanged()));
m_mountPointObserver->deref();
m_mountPointObserver = 0;
}
m_mountPointObserver = newObserver;
m_mountPointObserver->ref();
connect(m_mountPointObserver, SIGNAL(spaceInfoChanged()), this, SIGNAL(valuesChanged()));
emit valuesChanged();
}
} else {
if (m_mountPointObserver) {
disconnect(m_mountPointObserver, SIGNAL(spaceInfoChanged()), this, SIGNAL(valuesChanged()));
m_mountPointObserver->deref();
m_mountPointObserver = 0;
emit valuesChanged();
}
}
}

View file

@ -0,0 +1,51 @@
/***************************************************************************
* Copyright (C) 2014 by Frank Reininghaus <frank78ac@googlemail.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; either version 2 of the License, or *
* (at your option) any later version. *
* *
* 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. *
* *
* 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., *
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA *
***************************************************************************/
#ifndef SPACEINFOOBSERVER_H
#define SPACEINFOOBSERVER_H
#include <QObject>
class KUrl;
class MountPointObserver;
class SpaceInfoObserver : public QObject
{
Q_OBJECT
public:
explicit SpaceInfoObserver(const KUrl& url, QObject* parent = 0);
virtual ~SpaceInfoObserver();
quint64 size() const;
quint64 available() const;
void setUrl(const KUrl& url);
signals:
/**
* This signal is emitted if the information that size() and/or available() will return has changed.
*/
void valuesChanged();
private:
MountPointObserver* m_mountPointObserver;
};
#endif

View file

@ -20,22 +20,17 @@
#include "statusbarspaceinfo.h"
#include <KDiskFreeSpaceInfo>
#include "spaceinfoobserver.h"
#include <KLocale>
#include <KIO/Job>
#include <QTimer>
#include <QKeyEvent>
StatusBarSpaceInfo::StatusBarSpaceInfo(QWidget* parent) :
KCapacityBar(KCapacityBar::DrawTextInline, parent),
m_kBSize(0),
m_timer(0)
m_observer(0)
{
// Use a timer to update the space information. Polling is useful
// here, as files can be deleted/added outside the scope of Dolphin.
m_timer = new QTimer(this);
connect(m_timer, &QTimer::timeout, this, &StatusBarSpaceInfo::calculateSpaceInfo);
}
StatusBarSpaceInfo::~StatusBarSpaceInfo()
@ -46,8 +41,8 @@ void StatusBarSpaceInfo::setUrl(const KUrl& url)
{
if (m_url != url) {
m_url = url;
if (isVisible()) {
calculateSpaceInfo();
if (m_observer) {
m_observer->setUrl(url);
}
}
}
@ -60,47 +55,33 @@ KUrl StatusBarSpaceInfo::url() const
void StatusBarSpaceInfo::showEvent(QShowEvent* event)
{
KCapacityBar::showEvent(event);
if (!event->spontaneous()) {
calculateSpaceInfo();
m_timer->start(10000);
}
m_observer.reset(new SpaceInfoObserver(m_url, this));
slotValuesChanged();
connect(m_observer.data(), SIGNAL(valuesChanged()), this, SLOT(slotValuesChanged()));
}
void StatusBarSpaceInfo::hideEvent(QHideEvent* event)
{
m_timer->stop();
m_observer.reset();
KCapacityBar::hideEvent(event);
}
void StatusBarSpaceInfo::calculateSpaceInfo()
void StatusBarSpaceInfo::slotValuesChanged()
{
// KDiskFreeSpace is for local paths only
if (!m_url.isLocalFile()) {
Q_ASSERT(m_observer);
const quint64 size = m_observer->size();
if (size == 0) {
setText(i18nc("@info:status", "Unknown size"));
setValue(0);
update();
return;
}
KDiskFreeSpaceInfo job = KDiskFreeSpaceInfo::freeSpaceInfo(m_url.toLocalFile());
if (!job.isValid()) {
setText(i18nc("@info:status", "Unknown size"));
setValue(0);
update();
return;
}
KIO::filesize_t kBSize = job.size() / 1024;
KIO::filesize_t kBUsed = job.used() / 1024;
const bool valuesChanged = (kBUsed != static_cast<quint64>(value())) || (kBSize != m_kBSize);
if (valuesChanged) {
setText(i18nc("@info:status Free disk space", "%1 free",
KIO::convertSize(job.available())));
} else {
const quint64 available = m_observer->available();
const quint64 used = size - available;
const int percentUsed = qRound(100.0 * qreal(used) / qreal(size));
setText(i18nc("@info:status Free disk space", "%1 free", KIO::convertSize(available)));
setUpdatesEnabled(false);
m_kBSize = kBSize;
setValue(kBSize > 0 ? (kBUsed * 100) / kBSize : 0);
setValue(percentUsed);
setUpdatesEnabled(true);
update();
}

View file

@ -31,6 +31,8 @@
class QHideEvent;
class QShowEvent;
class SpaceInfoObserver;
/**
* @short Shows the available space for the volume represented
* by the given URL as part of the status bar.
@ -51,15 +53,11 @@ protected:
void hideEvent(QHideEvent* event);
private slots:
/**
* Calculates the space information for the current set URL.
*/
void calculateSpaceInfo();
void slotValuesChanged();
private:
quint64 m_kBSize;
QScopedPointer<SpaceInfoObserver> m_observer;
KUrl m_url;
QTimer* m_timer;
};
#endif