2015-10-29 13:09:10 +03:00
|
|
|
/*
|
|
|
|
* Copyright (C) by Roeland Jago Douma <rullzer@owncloud.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
|
2016-10-25 12:00:07 +03:00
|
|
|
* the Free Software Foundation; either version 2 of the License, or
|
|
|
|
* (at your option) any later version.
|
2015-10-29 13:09:10 +03:00
|
|
|
*
|
|
|
|
* 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.
|
|
|
|
*/
|
|
|
|
|
2016-09-14 16:31:05 +03:00
|
|
|
#ifndef SHAREMANAGER_H
|
|
|
|
#define SHAREMANAGER_H
|
2015-10-29 13:09:10 +03:00
|
|
|
|
|
|
|
#include "accountfwd.h"
|
2015-11-05 00:00:35 +03:00
|
|
|
#include "sharee.h"
|
2016-03-30 12:33:34 +03:00
|
|
|
#include "sharepermissions.h"
|
2015-10-29 13:09:10 +03:00
|
|
|
|
|
|
|
#include <QObject>
|
|
|
|
#include <QDate>
|
|
|
|
#include <QString>
|
|
|
|
#include <QList>
|
|
|
|
#include <QSharedPointer>
|
|
|
|
#include <QUrl>
|
2017-04-26 12:38:10 +03:00
|
|
|
|
|
|
|
class QJsonDocument;
|
|
|
|
class QJsonObject;
|
2015-10-29 13:09:10 +03:00
|
|
|
|
|
|
|
namespace OCC {
|
|
|
|
|
2017-05-17 11:55:42 +03:00
|
|
|
class Share : public QObject
|
|
|
|
{
|
2015-10-29 13:09:10 +03:00
|
|
|
Q_OBJECT
|
|
|
|
|
|
|
|
public:
|
2015-10-29 23:47:47 +03:00
|
|
|
/**
|
|
|
|
* Possible share types
|
2015-11-19 12:50:21 +03:00
|
|
|
* Need to be in sync with Sharee::Type
|
2015-10-29 23:47:47 +03:00
|
|
|
*/
|
|
|
|
enum ShareType {
|
2017-05-17 11:55:42 +03:00
|
|
|
TypeUser = Sharee::User,
|
|
|
|
TypeGroup = Sharee::Group,
|
|
|
|
TypeLink = 3,
|
2020-12-04 14:01:04 +03:00
|
|
|
TypeEmail = Sharee::Email,
|
2020-03-05 12:44:06 +03:00
|
|
|
TypeRemote = Sharee::Federated,
|
2020-12-04 14:01:04 +03:00
|
|
|
TypeCircle = Sharee::Circle,
|
|
|
|
TypeRoom = Sharee::Room
|
2015-10-29 23:47:47 +03:00
|
|
|
};
|
|
|
|
|
2020-08-12 16:23:11 +03:00
|
|
|
using Permissions = SharePermissions;
|
2015-10-29 23:47:47 +03:00
|
|
|
|
2015-10-29 13:09:10 +03:00
|
|
|
/*
|
2015-10-29 15:48:53 +03:00
|
|
|
* Constructor for shares
|
2015-10-29 13:09:10 +03:00
|
|
|
*/
|
|
|
|
explicit Share(AccountPtr account,
|
2017-05-17 11:55:42 +03:00
|
|
|
const QString &id,
|
2019-06-21 19:36:45 +03:00
|
|
|
const QString &owner,
|
|
|
|
const QString &ownerDisplayName,
|
2017-05-17 11:55:42 +03:00
|
|
|
const QString &path,
|
|
|
|
const ShareType shareType,
|
|
|
|
const Permissions permissions = SharePermissionDefault,
|
2018-11-11 12:56:22 +03:00
|
|
|
const QSharedPointer<Sharee> shareWith = QSharedPointer<Sharee>(nullptr));
|
2015-10-29 13:09:10 +03:00
|
|
|
|
2015-12-08 14:58:56 +03:00
|
|
|
/**
|
|
|
|
* The account the share is defined on.
|
|
|
|
*/
|
|
|
|
AccountPtr account() const;
|
|
|
|
|
2017-10-23 20:08:46 +03:00
|
|
|
QString path() const;
|
|
|
|
|
2015-10-29 13:09:10 +03:00
|
|
|
/*
|
|
|
|
* Get the id
|
|
|
|
*/
|
2015-10-29 15:48:53 +03:00
|
|
|
QString getId() const;
|
2015-10-29 13:09:10 +03:00
|
|
|
|
2019-06-21 19:36:45 +03:00
|
|
|
/*
|
|
|
|
* Get the uid_owner
|
|
|
|
*/
|
|
|
|
QString getUidOwner() const;
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Get the owner display name
|
|
|
|
*/
|
|
|
|
QString getOwnerDisplayName() const;
|
|
|
|
|
2015-10-29 13:09:10 +03:00
|
|
|
/*
|
|
|
|
* Get the shareType
|
|
|
|
*/
|
2015-10-29 23:47:47 +03:00
|
|
|
ShareType getShareType() const;
|
2015-10-29 13:09:10 +03:00
|
|
|
|
2015-10-31 15:39:08 +03:00
|
|
|
/*
|
|
|
|
* Get the shareWith
|
|
|
|
*/
|
2015-11-05 00:00:35 +03:00
|
|
|
QSharedPointer<Sharee> getShareWith() const;
|
2015-10-31 15:39:08 +03:00
|
|
|
|
2015-10-29 13:09:10 +03:00
|
|
|
/*
|
|
|
|
* Get permissions
|
|
|
|
*/
|
2015-10-29 23:47:47 +03:00
|
|
|
Permissions getPermissions() const;
|
2015-10-29 13:09:10 +03:00
|
|
|
|
|
|
|
/*
|
|
|
|
* Set the permissions of a share
|
|
|
|
*
|
|
|
|
* On success the permissionsSet signal is emitted
|
|
|
|
* In case of a server error the serverError signal is emitted.
|
|
|
|
*/
|
2015-10-31 15:39:08 +03:00
|
|
|
void setPermissions(Permissions permissions);
|
2015-10-29 13:09:10 +03:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Deletes a share
|
|
|
|
*
|
|
|
|
* On success the shareDeleted signal is emitted
|
2015-10-29 15:39:29 +03:00
|
|
|
* In case of a server error the serverError signal is emitted.
|
2015-10-29 13:09:10 +03:00
|
|
|
*/
|
|
|
|
void deleteShare();
|
|
|
|
|
|
|
|
signals:
|
|
|
|
void permissionsSet();
|
|
|
|
void shareDeleted();
|
|
|
|
void serverError(int code, const QString &message);
|
|
|
|
|
|
|
|
protected:
|
|
|
|
AccountPtr _account;
|
|
|
|
QString _id;
|
2019-06-21 19:36:45 +03:00
|
|
|
QString _uidowner;
|
|
|
|
QString _ownerDisplayName;
|
2015-10-29 13:09:10 +03:00
|
|
|
QString _path;
|
2015-10-29 23:47:47 +03:00
|
|
|
ShareType _shareType;
|
|
|
|
Permissions _permissions;
|
2015-11-05 00:00:35 +03:00
|
|
|
QSharedPointer<Sharee> _shareWith;
|
2015-10-29 13:09:10 +03:00
|
|
|
|
2015-10-29 18:56:23 +03:00
|
|
|
protected slots:
|
|
|
|
void slotOcsError(int statusCode, const QString &message);
|
|
|
|
|
2015-10-29 13:09:10 +03:00
|
|
|
private slots:
|
2015-10-29 18:56:23 +03:00
|
|
|
void slotDeleted();
|
2017-04-26 12:38:10 +03:00
|
|
|
void slotPermissionsSet(const QJsonDocument &, const QVariant &value);
|
2015-10-29 13:09:10 +03:00
|
|
|
};
|
|
|
|
|
|
|
|
/**
|
|
|
|
* A Link share is just like a regular share but then slightly different.
|
|
|
|
* There are several methods in the API that either work differently for
|
|
|
|
* link shares or are only available to link shares.
|
|
|
|
*/
|
2017-05-17 11:55:42 +03:00
|
|
|
class LinkShare : public Share
|
|
|
|
{
|
2015-10-29 13:09:10 +03:00
|
|
|
Q_OBJECT
|
|
|
|
public:
|
|
|
|
explicit LinkShare(AccountPtr account,
|
2017-05-17 11:55:42 +03:00
|
|
|
const QString &id,
|
2019-06-21 19:36:45 +03:00
|
|
|
const QString &uidowner,
|
|
|
|
const QString &ownerDisplayName,
|
2017-05-17 11:55:42 +03:00
|
|
|
const QString &path,
|
|
|
|
const QString &name,
|
|
|
|
const QString &token,
|
|
|
|
const Permissions permissions,
|
|
|
|
bool passwordSet,
|
|
|
|
const QUrl &url,
|
|
|
|
const QDate &expireDate);
|
2015-10-29 13:09:10 +03:00
|
|
|
|
|
|
|
/*
|
|
|
|
* Get the share link
|
|
|
|
*/
|
2015-10-29 15:48:53 +03:00
|
|
|
QUrl getLink() const;
|
2015-10-29 13:09:10 +03:00
|
|
|
|
2017-05-02 13:58:01 +03:00
|
|
|
/*
|
|
|
|
* The share's link for direct downloading.
|
|
|
|
*/
|
|
|
|
QUrl getDirectDownloadLink() const;
|
|
|
|
|
2015-10-29 13:47:14 +03:00
|
|
|
/*
|
|
|
|
* Get the publicUpload status of this share
|
|
|
|
*/
|
2017-06-15 16:38:22 +03:00
|
|
|
bool getPublicUpload() const;
|
2015-10-29 13:47:14 +03:00
|
|
|
|
2015-10-29 13:09:10 +03:00
|
|
|
/*
|
2017-06-15 16:38:22 +03:00
|
|
|
* Whether directory listings are available (READ permission)
|
2015-10-29 13:09:10 +03:00
|
|
|
*/
|
2017-06-15 16:38:22 +03:00
|
|
|
bool getShowFileListing() const;
|
2016-09-14 16:31:05 +03:00
|
|
|
|
2017-04-05 10:38:46 +03:00
|
|
|
/*
|
2017-04-12 12:09:20 +03:00
|
|
|
* Returns the name of the link share. Can be empty.
|
2017-04-05 10:38:46 +03:00
|
|
|
*/
|
|
|
|
QString getName() const;
|
|
|
|
|
2019-09-18 14:37:49 +03:00
|
|
|
/*
|
|
|
|
* Returns the note of the link share.
|
|
|
|
*/
|
|
|
|
|
|
|
|
QString getNote() const;
|
|
|
|
|
2017-04-12 12:09:20 +03:00
|
|
|
/*
|
|
|
|
* Set the name of the link share.
|
|
|
|
*
|
|
|
|
* Emits either nameSet() or serverError().
|
|
|
|
*/
|
2017-05-17 11:55:42 +03:00
|
|
|
void setName(const QString &name);
|
2017-04-12 12:09:20 +03:00
|
|
|
|
2019-09-18 14:37:49 +03:00
|
|
|
|
|
|
|
/*
|
|
|
|
* Set the note of the link share.
|
|
|
|
*/
|
|
|
|
void setNote(const QString ¬e);
|
|
|
|
|
2017-04-12 12:09:20 +03:00
|
|
|
/*
|
|
|
|
* Returns the token of the link share.
|
|
|
|
*/
|
|
|
|
QString getToken() const;
|
|
|
|
|
2015-10-29 13:09:10 +03:00
|
|
|
/*
|
|
|
|
* Set the password
|
|
|
|
*
|
|
|
|
* On success the passwordSet signal is emitted
|
|
|
|
* In case of a server error the serverError signal is emitted.
|
|
|
|
*/
|
2017-05-17 11:55:42 +03:00
|
|
|
void setPassword(const QString &password);
|
2015-10-29 13:09:10 +03:00
|
|
|
|
|
|
|
/*
|
|
|
|
* Is the password set?
|
|
|
|
*/
|
2015-10-29 15:48:53 +03:00
|
|
|
bool isPasswordSet() const;
|
2015-10-29 13:09:10 +03:00
|
|
|
|
|
|
|
/*
|
|
|
|
* Get the expiration date
|
|
|
|
*/
|
2015-10-29 15:48:53 +03:00
|
|
|
QDate getExpireDate() const;
|
2015-10-29 13:09:10 +03:00
|
|
|
|
|
|
|
/*
|
|
|
|
* Set the expiration date
|
|
|
|
*
|
|
|
|
* On success the expireDateSet signal is emitted
|
|
|
|
* In case of a server error the serverError signal is emitted.
|
|
|
|
*/
|
2017-05-17 11:55:42 +03:00
|
|
|
void setExpireDate(const QDate &expireDate);
|
2015-10-29 13:09:10 +03:00
|
|
|
|
|
|
|
signals:
|
|
|
|
void expireDateSet();
|
|
|
|
void passwordSet();
|
2019-09-18 14:37:49 +03:00
|
|
|
void noteSet();
|
2016-01-22 13:56:05 +03:00
|
|
|
void passwordSetError(int statusCode, const QString &message);
|
2017-04-12 12:09:20 +03:00
|
|
|
void nameSet();
|
2015-10-29 13:09:10 +03:00
|
|
|
|
|
|
|
private slots:
|
2017-05-17 11:55:42 +03:00
|
|
|
void slotPasswordSet(const QJsonDocument &, const QVariant &value);
|
2019-09-18 14:37:49 +03:00
|
|
|
void slotNoteSet(const QJsonDocument &, const QVariant &value);
|
2017-05-17 11:55:42 +03:00
|
|
|
void slotExpireDateSet(const QJsonDocument &reply, const QVariant &value);
|
2016-01-22 13:56:05 +03:00
|
|
|
void slotSetPasswordError(int statusCode, const QString &message);
|
2017-05-17 11:55:42 +03:00
|
|
|
void slotNameSet(const QJsonDocument &, const QVariant &value);
|
2015-10-29 13:09:10 +03:00
|
|
|
|
|
|
|
private:
|
2017-04-05 10:38:46 +03:00
|
|
|
QString _name;
|
2017-04-12 12:09:20 +03:00
|
|
|
QString _token;
|
2015-10-29 13:09:10 +03:00
|
|
|
bool _passwordSet;
|
2019-09-18 14:37:49 +03:00
|
|
|
QString _note;
|
2015-10-29 13:09:10 +03:00
|
|
|
QDate _expireDate;
|
|
|
|
QUrl _url;
|
|
|
|
};
|
|
|
|
|
|
|
|
/**
|
|
|
|
* The share manager allows for creating, retrieving and deletion
|
|
|
|
* of shares. It abstracts away from the OCS Share API, all the usages
|
|
|
|
* shares should talk to this manager and not use OCS Share Job directly
|
|
|
|
*/
|
2017-05-17 11:55:42 +03:00
|
|
|
class ShareManager : public QObject
|
|
|
|
{
|
2015-10-29 13:09:10 +03:00
|
|
|
Q_OBJECT
|
|
|
|
public:
|
2018-11-11 12:56:22 +03:00
|
|
|
explicit ShareManager(AccountPtr _account, QObject *parent = nullptr);
|
2015-10-29 13:09:10 +03:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Tell the manager to create a link share
|
|
|
|
*
|
|
|
|
* @param path The path of the linkshare relative to the user folder on the server
|
2017-04-05 10:38:46 +03:00
|
|
|
* @param name The name of the created share, may be empty
|
|
|
|
* @param password The password of the share, may be empty
|
2015-10-29 13:09:10 +03:00
|
|
|
*
|
|
|
|
* On success the signal linkShareCreated is emitted
|
|
|
|
* For older server the linkShareRequiresPassword signal is emitted when it seems appropiate
|
|
|
|
* In case of a server error the serverError signal is emitted
|
|
|
|
*/
|
2017-05-17 11:55:42 +03:00
|
|
|
void createLinkShare(const QString &path,
|
|
|
|
const QString &name,
|
|
|
|
const QString &password);
|
2015-10-29 13:09:10 +03:00
|
|
|
|
2015-10-31 15:39:08 +03:00
|
|
|
/**
|
|
|
|
* Tell the manager to create a new share
|
|
|
|
*
|
|
|
|
* @param path The path of the share relative to the user folder on the server
|
|
|
|
* @param shareType The type of share (TypeUser, TypeGroup, TypeRemote)
|
|
|
|
* @param Permissions The share permissions
|
|
|
|
*
|
|
|
|
* On success the signal shareCreated is emitted
|
|
|
|
* In case of a server error the serverError signal is emitted
|
|
|
|
*/
|
2017-05-17 11:55:42 +03:00
|
|
|
void createShare(const QString &path,
|
|
|
|
const Share::ShareType shareType,
|
|
|
|
const QString shareWith,
|
|
|
|
const Share::Permissions permissions);
|
2015-10-31 15:39:08 +03:00
|
|
|
|
2015-10-29 13:09:10 +03:00
|
|
|
/**
|
|
|
|
* Fetch all the shares for path
|
|
|
|
*
|
|
|
|
* @param path The path to get the shares for relative to the users folder on the server
|
|
|
|
*
|
|
|
|
* On success the sharesFetched signal is emitted
|
|
|
|
* In case of a server error the serverError signal is emitted
|
|
|
|
*/
|
2017-05-17 11:55:42 +03:00
|
|
|
void fetchShares(const QString &path);
|
2015-10-29 13:09:10 +03:00
|
|
|
|
|
|
|
signals:
|
2015-10-31 15:39:08 +03:00
|
|
|
void shareCreated(const QSharedPointer<Share> &share);
|
2015-10-29 16:27:49 +03:00
|
|
|
void linkShareCreated(const QSharedPointer<LinkShare> &share);
|
|
|
|
void sharesFetched(const QList<QSharedPointer<Share>> &shares);
|
2015-10-29 13:09:10 +03:00
|
|
|
void serverError(int code, const QString &message);
|
|
|
|
|
2016-01-19 16:03:13 +03:00
|
|
|
/** Emitted when creating a link share with password fails.
|
|
|
|
*
|
|
|
|
* @param message the error message reported by the server
|
|
|
|
*
|
|
|
|
* See createLinkShare().
|
|
|
|
*/
|
|
|
|
void linkShareRequiresPassword(const QString &message);
|
|
|
|
|
2015-10-29 13:09:10 +03:00
|
|
|
private slots:
|
2017-04-26 12:38:10 +03:00
|
|
|
void slotSharesFetched(const QJsonDocument &reply);
|
|
|
|
void slotLinkShareCreated(const QJsonDocument &reply);
|
|
|
|
void slotShareCreated(const QJsonDocument &reply);
|
2015-10-29 18:56:23 +03:00
|
|
|
void slotOcsError(int statusCode, const QString &message);
|
2015-10-29 13:09:10 +03:00
|
|
|
private:
|
2017-04-26 12:38:10 +03:00
|
|
|
QSharedPointer<LinkShare> parseLinkShare(const QJsonObject &data);
|
|
|
|
QSharedPointer<Share> parseShare(const QJsonObject &data);
|
2015-10-29 13:09:10 +03:00
|
|
|
|
|
|
|
AccountPtr _account;
|
|
|
|
};
|
|
|
|
}
|
|
|
|
|
2016-09-14 16:31:05 +03:00
|
|
|
#endif // SHAREMANAGER_H
|