322 lines
14 KiB
C#
322 lines
14 KiB
C#
/*
|
|
*
|
|
* (c) Copyright Ascensio System Limited 2010-2018
|
|
*
|
|
* This program is freeware. You can redistribute it and/or modify it under the terms of the GNU
|
|
* General Public License (GPL) version 3 as published by the Free Software Foundation (https://www.gnu.org/copyleft/gpl.html).
|
|
* In accordance with Section 7(a) of the GNU GPL its Section 15 shall be amended to the effect that
|
|
* Ascensio System SIA expressly excludes the warranty of non-infringement of any third-party rights.
|
|
*
|
|
* THIS PROGRAM IS DISTRIBUTED WITHOUT ANY WARRANTY; WITHOUT EVEN THE IMPLIED WARRANTY OF MERCHANTABILITY OR
|
|
* FITNESS FOR A PARTICULAR PURPOSE. For more details, see GNU GPL at https://www.gnu.org/copyleft/gpl.html
|
|
*
|
|
* You can contact Ascensio System SIA by email at sales@onlyoffice.com
|
|
*
|
|
* The interactive user interfaces in modified source and object code versions of ONLYOFFICE must display
|
|
* Appropriate Legal Notices, as required under Section 5 of the GNU GPL version 3.
|
|
*
|
|
* Pursuant to Section 7 § 3(b) of the GNU GPL you must retain the original ONLYOFFICE logo which contains
|
|
* relevant author attributions when distributing the software. If the display of the logo in its graphic
|
|
* form is not reasonably feasible for technical reasons, you must include the words "Powered by ONLYOFFICE"
|
|
* in every copy of the program you distribute.
|
|
* Pursuant to Section 7 § 3(e) we decline to grant you any rights under trademark law for use of our trademarks.
|
|
*
|
|
*/
|
|
|
|
|
|
using System;
|
|
using System.Collections.Generic;
|
|
using System.IO;
|
|
using System.Threading.Tasks;
|
|
|
|
using ASC.Data.Storage.Configuration;
|
|
|
|
namespace ASC.Data.Storage
|
|
{
|
|
///<summary>
|
|
/// Interface for working with files
|
|
///</summary>
|
|
public interface IDataStore
|
|
{
|
|
IQuotaController QuotaController { get; set; }
|
|
|
|
TimeSpan GetExpire(string domain);
|
|
|
|
///<summary>
|
|
/// Get absolute Uri for html links to handler
|
|
///</summary>
|
|
///<param name="path"></param>
|
|
///<returns></returns>
|
|
Task<Uri> GetUriAsync(string path);
|
|
|
|
///<summary>
|
|
/// Get absolute Uri for html links to handler
|
|
///</summary>
|
|
///<param name="domain"></param>
|
|
///<param name="path"></param>
|
|
///<returns></returns>
|
|
Task<Uri> GetUriAsync(string domain, string path);
|
|
|
|
/// <summary>
|
|
/// Get absolute Uri for html links to handler
|
|
/// </summary>
|
|
/// <param name="domain"></param>
|
|
/// <param name="path"></param>
|
|
/// <param name="expire"></param>
|
|
/// <param name="headers"></param>
|
|
/// <returns></returns>
|
|
Task<Uri> GetPreSignedUriAsync(string domain, string path, TimeSpan expire, IEnumerable<string> headers);
|
|
///<summary>
|
|
/// Supporting generate uri to the file
|
|
///</summary>
|
|
///<returns></returns>
|
|
bool IsSupportInternalUri { get; }
|
|
|
|
/// <summary>
|
|
/// Get absolute Uri for html links
|
|
/// </summary>
|
|
/// <param name="domain"></param>
|
|
/// <param name="path"></param>
|
|
/// <param name="expire"></param>
|
|
/// <param name="headers"></param>
|
|
/// <returns></returns>
|
|
Task<Uri> GetInternalUriAsync(string domain, string path, TimeSpan expire, IEnumerable<string> headers);
|
|
|
|
///<summary>
|
|
/// A stream of read-only. In the case of the C3 stream NetworkStream general, and with him we have to work
|
|
/// Very carefully as a Jedi cutter groin lightsaber.
|
|
///</summary>
|
|
///<param name="domain"></param>
|
|
///<param name="path"></param>
|
|
///<returns></returns>
|
|
Task<Stream> GetReadStreamAsync(string domain, string path);
|
|
|
|
///<summary>
|
|
/// A stream of read-only. In the case of the C3 stream NetworkStream general, and with him we have to work
|
|
/// Very carefully as a Jedi cutter groin lightsaber.
|
|
///</summary>
|
|
///<param name="domain"></param>
|
|
///<param name="path"></param>
|
|
///<returns></returns>
|
|
Task<Stream> GetReadStreamAsync(string domain, string path, int offset);
|
|
|
|
///<summary>
|
|
/// Saves the contents of the stream in the repository.
|
|
///</ Summary>
|
|
/// <param Name="domain"> </param>
|
|
/// <param Name="path"> </param>
|
|
/// <param Name="stream"> flow. Is read from the current position! Desirable to set to 0 when the transmission MemoryStream instance </param>
|
|
/// <returns> </Returns>
|
|
Task<Uri> SaveAsync(string domain, string path, Stream stream);
|
|
|
|
/// <summary>
|
|
/// Saves the contents of the stream in the repository.
|
|
/// </summary>
|
|
/// <param name="domain"></param>
|
|
/// <param name="path"></param>
|
|
/// <param name="stream"></param>
|
|
/// <param name="acl"></param>
|
|
/// <returns></returns>
|
|
Task<Uri> SaveAsync(string domain, string path, Stream stream, ACL acl);
|
|
|
|
/// <summary>
|
|
/// Saves the contents of the stream in the repository.
|
|
/// </summary>
|
|
/// <param name="domain"></param>
|
|
/// <param name="path"></param>
|
|
/// <param name="stream"></param>
|
|
/// <param name="attachmentFileName"></param>
|
|
/// <returns></returns>
|
|
Task<Uri> SaveAsync(string domain, string path, Stream stream, string attachmentFileName);
|
|
|
|
/// <summary>
|
|
/// Saves the contents of the stream in the repository.
|
|
/// </summary>
|
|
/// <param name="domain"></param>
|
|
/// <param name="path"></param>
|
|
/// <param name="stream"></param>
|
|
/// <param name="contentType"></param>
|
|
/// <param name="contentDisposition"></param>
|
|
/// <returns></returns>
|
|
Task<Uri> SaveAsync(string domain, string path, Stream stream, string contentType, string contentDisposition);
|
|
|
|
/// <summary>
|
|
/// Saves the contents of the stream in the repository.
|
|
/// </summary>
|
|
/// <param name="domain"></param>
|
|
/// <param name="path"></param>
|
|
/// <param name="stream"></param>
|
|
/// <param name="contentEncoding"></param>
|
|
/// <param name="cacheDays"></param>
|
|
/// <returns></returns>
|
|
Task<Uri> SaveAsync(string domain, string path, Stream stream, string contentEncoding, int cacheDays);
|
|
|
|
Task<string> InitiateChunkedUploadAsync(string domain, string path);
|
|
|
|
Task<string> UploadChunkAsync(string domain, string path, string uploadId, Stream stream, long defaultChunkSize, int chunkNumber, long chunkLength);
|
|
|
|
Task<Uri> FinalizeChunkedUploadAsync(string domain, string path, string uploadId, Dictionary<int, string> eTags);
|
|
|
|
Task AbortChunkedUploadAsync(string domain, string path, string uploadId);
|
|
|
|
bool IsSupportChunking { get; }
|
|
|
|
bool IsSupportedPreSignedUri { get; }
|
|
|
|
///<summary>
|
|
/// Deletes file
|
|
///</summary>
|
|
///<param name="domain"></param>
|
|
///<param name="path"></param>
|
|
Task DeleteAsync(string domain, string path);
|
|
|
|
///<summary>
|
|
/// Deletes file by mask
|
|
///</summary>
|
|
///<param name="domain"></param>
|
|
///<param name="folderPath"></param>
|
|
///<param name="pattern">Wildcard mask (*.png)</param>
|
|
///<param name="recursive"></param>
|
|
Task DeleteFilesAsync(string domain, string folderPath, string pattern, bool recursive);
|
|
|
|
///<summary>
|
|
/// Deletes files
|
|
///</summary>
|
|
///<param name="domain"></param>
|
|
///<param name="listPaths"></param>
|
|
Task DeleteFilesAsync(string domain, List<string> paths);
|
|
|
|
///<summary>
|
|
/// Deletes file by last modified date
|
|
///</summary>
|
|
///<param name="domain"></param>
|
|
///<param name="folderPath"></param>
|
|
///<param name="fromDate"></param>
|
|
///<param name="toDate"></param>
|
|
Task DeleteFilesAsync(string domain, string folderPath, DateTime fromDate, DateTime toDate);
|
|
|
|
///<summary>
|
|
/// Moves the contents of one directory to another. s3 for a very expensive procedure.
|
|
///</summary>
|
|
///<param name="srcdomain"></param>
|
|
///<param name="srcdir"></param>
|
|
///<param name="newdomain"></param>
|
|
///<param name="newdir"></param>
|
|
Task MoveDirectoryAsync(string srcdomain, string srcdir, string newdomain, string newdir);
|
|
|
|
///<summary>
|
|
/// Moves file
|
|
///</summary>
|
|
///<param name="srcdomain"></param>
|
|
///<param name="srcpath"></param>
|
|
///<param name="newdomain"></param>
|
|
///<param name="newpath"></param>
|
|
///<returns></returns>
|
|
Task<Uri> MoveAsync(string srcdomain, string srcpath, string newdomain, string newpath, bool quotaCheckFileSize = true);
|
|
|
|
///<summary>
|
|
/// Saves the file in the temp. In fact, almost no different from the usual Save except that generates the file name itself. An inconvenient thing.
|
|
///</summary>
|
|
///<param name="domain"></param>
|
|
///<param name="assignedPath"></param>
|
|
///<param name="stream"></param>
|
|
///<returns></returns>
|
|
Task<Uri> SaveTempAsync(string domain, out string assignedPath, Stream stream);
|
|
|
|
/// <summary>
|
|
/// Returns a list of links to all subfolders
|
|
/// </summary>
|
|
/// <param name="domain"></param>
|
|
/// <param name="path"></param>
|
|
/// <param name="recursive">iterate subdirectories or not</param>
|
|
/// <returns></returns>
|
|
IAsyncEnumerable<string> ListDirectoriesRelativeAsync(string domain, string path, bool recursive);
|
|
|
|
///<summary>
|
|
/// Returns a list of links to all files
|
|
///</summary>
|
|
///<param name="domain"></param>
|
|
///<param name="path"></param>
|
|
///<param name="pattern">Wildcard mask (*. jpg for example)</param>
|
|
///<param name="recursive">iterate subdirectories or not</param>
|
|
///<returns></returns>
|
|
IAsyncEnumerable<Uri> ListFilesAsync(string domain, string path, string pattern, bool recursive);
|
|
|
|
///<summary>
|
|
/// Returns a list of relative paths for all files
|
|
///</summary>
|
|
///<param name="domain"></param>
|
|
///<param name="path"></param>
|
|
///<param name="pattern">Wildcard mask (*. jpg for example)</param>
|
|
///<param name="recursive">iterate subdirectories or not</param>
|
|
///<returns></returns>
|
|
IAsyncEnumerable<string> ListFilesRelativeAsync(string domain, string path, string pattern, bool recursive);
|
|
|
|
///<summary>
|
|
/// Checks whether a file exists. On s3 it took long time.
|
|
///</summary>
|
|
///<param name="domain"></param>
|
|
///<param name="path"></param>
|
|
///<returns></returns>
|
|
|
|
Task<bool> IsFileAsync(string domain, string path);
|
|
|
|
///<summary>
|
|
/// Checks whether a directory exists. On s3 it took long time.
|
|
///</summary>
|
|
///<param name="domain"></param>
|
|
///<param name="path"></param>
|
|
///<returns></returns>
|
|
Task<bool> IsDirectoryAsync(string domain, string path);
|
|
|
|
Task DeleteDirectoryAsync(string domain, string path);
|
|
|
|
Task<long> GetFileSizeAsync(string domain, string path);
|
|
|
|
Task<long> GetDirectorySizeAsync(string domain, string path);
|
|
|
|
Task<long> ResetQuotaAsync(string domain);
|
|
|
|
Task<long> GetUsedQuotaAsync(string domain);
|
|
|
|
Task<Uri> CopyAsync(string srcdomain, string path, string newdomain, string newpath);
|
|
Task CopyDirectoryAsync(string srcdomain, string dir, string newdomain, string newdir);
|
|
|
|
//Then there are restarted methods without domain. functionally identical to the top
|
|
|
|
#pragma warning disable 1591
|
|
Task<Stream> GetReadStreamAsync(string path);
|
|
Task<Uri> SaveAsync(string path, Stream stream, string attachmentFileName);
|
|
Task<Uri> SaveAsync(string path, Stream stream);
|
|
Task DeleteAsync(string path);
|
|
Task DeleteFilesAsync(string folderPath, string pattern, bool recursive);
|
|
Task<Uri> MoveAsync(string srcpath, string newdomain, string newpath);
|
|
Task<Uri> SaveTempAsync(out string assignedPath, Stream stream);
|
|
IAsyncEnumerable<string> ListDirectoriesRelativeAsync(string path, bool recursive);
|
|
IAsyncEnumerable<Uri> ListFilesAsync(string path, string pattern, bool recursive);
|
|
Task<bool> IsFileAsync(string path);
|
|
Task<bool> IsDirectoryAsync(string path);
|
|
Task DeleteDirectoryAsync(string path);
|
|
Task<long> GetFileSizeAsync(string path);
|
|
Task<long> GetDirectorySizeAsync(string path);
|
|
Task<Uri> CopyAsync(string path, string newdomain, string newpath);
|
|
Task CopyDirectoryAsync(string dir, string newdomain, string newdir);
|
|
#pragma warning restore 1591
|
|
|
|
|
|
IDataStore Configure(string tenant, Handler handlerConfig, Module moduleConfig, IDictionary<string, string> props);
|
|
IDataStore SetQuotaController(IQuotaController controller);
|
|
|
|
Task<string> SavePrivateAsync(string domain, string path, Stream stream, DateTime expires);
|
|
Task DeleteExpiredAsync(string domain, string path, TimeSpan oldThreshold);
|
|
|
|
string GetUploadForm(string domain, string directoryPath, string redirectTo, long maxUploadSize,
|
|
string contentType, string contentDisposition, string submitLabel);
|
|
|
|
Task<string> GetUploadedUrlAsync(string domain, string directoryPath);
|
|
string GetUploadUrl();
|
|
|
|
string GetPostParams(string domain, string directoryPath, long maxUploadSize, string contentType,
|
|
string contentDisposition);
|
|
}
|
|
} |