/**************************************************************************** ** ** Copyright (C) 2019 Volker Krause ** Copyright (C) 2022 The Qt Company Ltd. ** Contact: https://www.qt.io/licensing/ ** ** This file is part of the plugins of the Qt Toolkit. ** ** $QT_BEGIN_LICENSE:LGPL$ ** Commercial License Usage ** Licensees holding valid commercial Qt licenses may use this file in ** accordance with the commercial license agreement provided with the ** Software or, alternatively, in accordance with the terms contained in ** a written agreement between you and The Qt Company. For licensing terms ** and conditions see https://www.qt.io/terms-conditions. For further ** information use the contact form at https://www.qt.io/contact-us. ** ** GNU Lesser General Public License Usage ** Alternatively, this file may be used under the terms of the GNU Lesser ** General Public License version 3 as published by the Free Software ** Foundation and appearing in the file LICENSE.LGPL3 included in the ** packaging of this file. Please review the following information to ** ensure the GNU Lesser General Public License version 3 requirements ** will be met: https://www.gnu.org/licenses/lgpl-3.0.html. ** ** GNU General Public License Usage ** Alternatively, this file may be used under the terms of the GNU ** General Public License version 2.0 or (at your option) the GNU General ** Public license version 3 or any later version approved by the KDE Free ** Qt Foundation. The licenses are as published by the Free Software ** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3 ** included in the packaging of this file. Please review the following ** information to ensure the GNU General Public License requirements will ** be met: https://www.gnu.org/licenses/gpl-2.0.html and ** https://www.gnu.org/licenses/gpl-3.0.html. ** ** $QT_END_LICENSE$ ** ****************************************************************************/ #ifndef ANDROIDCONTENTFILEENGINE_H #define ANDROIDCONTENTFILEENGINE_H #include #include #include using DocumentFilePtr = std::shared_ptr; class AndroidContentFileEngine : public QFSFileEngine { public: AndroidContentFileEngine(const QString &fileName); bool open(QIODevice::OpenMode openMode) override; bool close() override; qint64 size() const override; bool remove() override; bool rename(const QString &newName) override; bool mkdir(const QString &dirName, bool createParentDirectories) const override; bool rmdir(const QString &dirName, bool recurseParentDirectories) const override; QByteArray id() const override; bool caseSensitive() const override { return true; } QDateTime fileTime(FileTime time) const override; FileFlags fileFlags(FileFlags type = FileInfoAll) const override; QString fileName(FileName file = DefaultName) const override; QAbstractFileEngine::Iterator *beginEntryList(QDir::Filters filters, const QStringList &filterNames) override; QAbstractFileEngine::Iterator *endEntryList() override; private: void closeNativeFileDescriptor(); QString m_initialFile; QJNIObjectPrivate m_pfd; DocumentFilePtr m_documentFile; }; class AndroidContentFileEngineHandler : public QAbstractFileEngineHandler { public: AndroidContentFileEngineHandler(); ~AndroidContentFileEngineHandler(); QAbstractFileEngine *create(const QString &fileName) const override; }; class AndroidContentFileEngineIterator : public QAbstractFileEngineIterator { public: AndroidContentFileEngineIterator(QDir::Filters filters, const QStringList &filterNames); ~AndroidContentFileEngineIterator(); QString next() override; bool hasNext() const override; QString currentFileName() const override; QString currentFilePath() const override; private: mutable QList m_files; mutable qsizetype m_index = -1; }; /*! * * DocumentFile Api. * Check https://developer.android.com/reference/androidx/documentfile/provider/DocumentFile * for more information. * */ class DocumentFile : public std::enable_shared_from_this { public: static DocumentFilePtr parseFromAnyUri(const QString &filename); static DocumentFilePtr fromSingleUri(const QJNIObjectPrivate &uri); static DocumentFilePtr fromTreeUri(const QJNIObjectPrivate &treeUri); DocumentFilePtr createFile(const QString &mimeType, const QString &displayName); DocumentFilePtr createDirectory(const QString &displayName); const QJNIObjectPrivate &uri() const; const DocumentFilePtr &parent() const; QString name() const; QString id() const; QString mimeType() const; bool isDirectory() const; bool isFile() const; bool isVirtual() const; QDateTime lastModified() const; int64_t length() const; bool canRead() const; bool canWrite() const; bool remove(); bool exists() const; std::vector listFiles(); bool rename(const QString &newName); protected: DocumentFile(const QJNIObjectPrivate &uri, const std::shared_ptr &parent); protected: QJNIObjectPrivate m_uri; DocumentFilePtr m_parent; }; #endif // ANDROIDCONTENTFILEENGINE_H