1/****************************************************************************
2**
3** Copyright (C) 2016 The Qt Company Ltd.
4** Contact: https://www.qt.io/licensing/
5**
6** This file is part of the QtNetwork module of the Qt Toolkit.
7**
8** $QT_BEGIN_LICENSE:LGPL$
9** Commercial License Usage
10** Licensees holding valid commercial Qt licenses may use this file in
11** accordance with the commercial license agreement provided with the
12** Software or, alternatively, in accordance with the terms contained in
13** a written agreement between you and The Qt Company. For licensing terms
14** and conditions see https://www.qt.io/terms-conditions. For further
15** information use the contact form at https://www.qt.io/contact-us.
16**
17** GNU Lesser General Public License Usage
18** Alternatively, this file may be used under the terms of the GNU Lesser
19** General Public License version 3 as published by the Free Software
20** Foundation and appearing in the file LICENSE.LGPL3 included in the
21** packaging of this file. Please review the following information to
22** ensure the GNU Lesser General Public License version 3 requirements
23** will be met: https://www.gnu.org/licenses/lgpl-3.0.html.
24**
25** GNU General Public License Usage
26** Alternatively, this file may be used under the terms of the GNU
27** General Public License version 2.0 or (at your option) the GNU General
28** Public license version 3 or any later version approved by the KDE Free
29** Qt Foundation. The licenses are as published by the Free Software
30** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3
31** included in the packaging of this file. Please review the following
32** information to ensure the GNU General Public License requirements will
33** be met: https://www.gnu.org/licenses/gpl-2.0.html and
34** https://www.gnu.org/licenses/gpl-3.0.html.
35**
36** $QT_END_LICENSE$
37**
38****************************************************************************/
39
40#ifndef QABSTRACTNETWORKCACHE_H
41#define QABSTRACTNETWORKCACHE_H
42
43#include <QtNetwork/qtnetworkglobal.h>
44#include <QtCore/qobject.h>
45#include <QtCore/qshareddata.h>
46#include <QtCore/qpair.h>
47#include <QtNetwork/qnetworkrequest.h>
48
49QT_BEGIN_NAMESPACE
50
51
52class QIODevice;
53class QDateTime;
54class QUrl;
55
56class QNetworkCacheMetaDataPrivate;
57class Q_NETWORK_EXPORT QNetworkCacheMetaData
58{
59
60public:
61 typedef QPair<QByteArray, QByteArray> RawHeader;
62 typedef QList<RawHeader> RawHeaderList;
63 typedef QHash<QNetworkRequest::Attribute, QVariant> AttributesMap;
64
65 QNetworkCacheMetaData();
66 QNetworkCacheMetaData(const QNetworkCacheMetaData &other);
67 ~QNetworkCacheMetaData();
68
69 QNetworkCacheMetaData &operator=(QNetworkCacheMetaData &&other) noexcept { swap(other); return *this; }
70 QNetworkCacheMetaData &operator=(const QNetworkCacheMetaData &other);
71
72 void swap(QNetworkCacheMetaData &other) noexcept
73 { qSwap(d, other.d); }
74
75 bool operator==(const QNetworkCacheMetaData &other) const;
76 inline bool operator!=(const QNetworkCacheMetaData &other) const
77 { return !(*this == other); }
78
79 bool isValid() const;
80
81 QUrl url() const;
82 void setUrl(const QUrl &url);
83
84 RawHeaderList rawHeaders() const;
85 void setRawHeaders(const RawHeaderList &headers);
86
87 QDateTime lastModified() const;
88 void setLastModified(const QDateTime &dateTime);
89
90 QDateTime expirationDate() const;
91 void setExpirationDate(const QDateTime &dateTime);
92
93 bool saveToDisk() const;
94 void setSaveToDisk(bool allow);
95
96 AttributesMap attributes() const;
97 void setAttributes(const AttributesMap &attributes);
98
99private:
100 friend class QNetworkCacheMetaDataPrivate;
101 QSharedDataPointer<QNetworkCacheMetaDataPrivate> d;
102};
103
104Q_DECLARE_SHARED(QNetworkCacheMetaData)
105
106Q_NETWORK_EXPORT QDataStream &operator<<(QDataStream &, const QNetworkCacheMetaData &);
107Q_NETWORK_EXPORT QDataStream &operator>>(QDataStream &, QNetworkCacheMetaData &);
108
109
110class QAbstractNetworkCachePrivate;
111class Q_NETWORK_EXPORT QAbstractNetworkCache : public QObject
112{
113 Q_OBJECT
114
115public:
116 virtual ~QAbstractNetworkCache();
117
118 virtual QNetworkCacheMetaData metaData(const QUrl &url) = 0;
119 virtual void updateMetaData(const QNetworkCacheMetaData &metaData) = 0;
120 virtual QIODevice *data(const QUrl &url) = 0;
121 virtual bool remove(const QUrl &url) = 0;
122 virtual qint64 cacheSize() const = 0;
123
124 virtual QIODevice *prepare(const QNetworkCacheMetaData &metaData) = 0;
125 virtual void insert(QIODevice *device) = 0;
126
127public Q_SLOTS:
128 virtual void clear() = 0;
129
130protected:
131 explicit QAbstractNetworkCache(QObject *parent = nullptr);
132 QAbstractNetworkCache(QAbstractNetworkCachePrivate &dd, QObject *parent);
133
134private:
135 Q_DECLARE_PRIVATE(QAbstractNetworkCache)
136 Q_DISABLE_COPY(QAbstractNetworkCache)
137};
138
139QT_END_NAMESPACE
140
141#endif
142