/usr/include/kasten1/abstractmodelsynchronizer.h is in okteta-dev 4:4.8.4+dfsg-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 | /*
This file is part of the Kasten Framework, made within the KDE community.
Copyright 2007-2009 Friedrich W. H. Kossebau <kossebau@kde.org>
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) version 3, or any
later version accepted by the membership of KDE e.V. (or its
successor approved by the membership of KDE e.V.), which shall
act as a proxy defined in Section 6 of version 3 of the license.
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
Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public
License along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef ABSTRACTMODELSYNCHRONIZER_H
#define ABSTRACTMODELSYNCHRONIZER_H
// lib
#include "kastencore_export.h"
#include "kastencore.h"
// Qt
#include <QtCore/QObject>
class KUrl;
namespace Kasten1
{
class AbstractLoadJob;
class AbstractConnectJob;
class AbstractSyncToRemoteJob;
class AbstractSyncFromRemoteJob;
class AbstractSyncWithRemoteJob;
class AbstractDocument;
class AbstractModelSynchronizerPrivate;
// TODO: better names? Active Translator?
// synchronizers are created by factory functions (like plugins)
// TODO: should synchronizers set the document to readonly if remote is readonly? or who?
// TODO: should synchronizers offer to change writeflag at remote?
// TODO: allow synchronizers which can read-only, perhaps also write-only (usecase?)
/**
possible actions:
1. synchronizer loads document and synchronizes until closing
-> done by factory functions
2. synchronizer gets attached to a document new created or with other synchronizer
3. synchronizer used to export a model
*/
class KASTENCORE_EXPORT AbstractModelSynchronizer : public QObject
{
Q_OBJECT
public:
enum ConnectOption // TODO: better names
{
SyncLocalAndRemote = 0,
ReplaceRemote = 1,
ReplaceLocal = 2
};
protected:
explicit AbstractModelSynchronizer( AbstractModelSynchronizerPrivate* d );
public:
AbstractModelSynchronizer();
virtual ~AbstractModelSynchronizer();
public:
KUrl url() const;
public: // API to be implemented
// TODO: makes this a job, too
// TODO: filesystem synchronizer (or: to-passive-storage) does not need this: subclass or interface?
// virtual void startOffering( AbstractDocument* document ) = 0;
// TODO: once the synchronizer is attached to a document, this function should not be called
// is there a way to ensure this?
virtual AbstractLoadJob* startLoad( const KUrl& url ) = 0;
/** */
// TODO: not in constructor? cannot be called twice, each synchronizer is attached to its document
// virtual AbstractDocument* createWorkingCopy( const KUrl& originUrl, int* success ) const = 0;
/** */
// TODO: static? or by function? or another class? but
// virtual void copyTo( const KUrl& url, AbstractDocument* document, int* success ) const = 0;
/** overwrite remote with local (save) */
virtual AbstractSyncToRemoteJob* startSyncToRemote() = 0;
/** overwrite local with remote (reload) */
virtual AbstractSyncFromRemoteJob* startSyncFromRemote() = 0;
/** changes the */ // TODO: better name for replace: overwrite?
virtual AbstractSyncWithRemoteJob* startSyncWithRemote( const KUrl& url, AbstractModelSynchronizer::ConnectOption option ) = 0;
virtual AbstractConnectJob* startConnect( AbstractDocument* document,
const KUrl& url, AbstractModelSynchronizer::ConnectOption option ) = 0;
// virtual bool syncBiDirectly() = 0;
// virtual bool canSyncBiDirectly() const = 0;
// virtual bool deleteDocument();
virtual AbstractDocument* document() const = 0;
virtual RemoteSyncState remoteSyncState() const = 0;
Q_SIGNALS:
void urlChanged( const KUrl& url );
void dataPulled( int ) const;
void dataPushed( int ) const;
void synchronized();
void remoteSyncStateChanged( Kasten1::RemoteSyncState newState );
protected: // get
void setUrl( const KUrl& url );
protected:
Q_DECLARE_PRIVATE( AbstractModelSynchronizer )
protected:
AbstractModelSynchronizerPrivate* const d_ptr;
};
}
#endif
|