Qt 4.8
qnetworkaccesscache_p.h
Go to the documentation of this file.
1 /****************************************************************************
2 **
3 ** Copyright (C) 2014 Digia Plc and/or its subsidiary(-ies).
4 ** Contact: http://www.qt-project.org/legal
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 Digia. For licensing terms and
14 ** conditions see http://qt.digia.com/licensing. For further information
15 ** use the contact form at http://qt.digia.com/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 2.1 as published by the Free Software
20 ** Foundation and appearing in the file LICENSE.LGPL included in the
21 ** packaging of this file. Please review the following information to
22 ** ensure the GNU Lesser General Public License version 2.1 requirements
23 ** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
24 **
25 ** In addition, as a special exception, Digia gives you certain additional
26 ** rights. These rights are described in the Digia Qt LGPL Exception
27 ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
28 **
29 ** GNU General Public License Usage
30 ** Alternatively, this file may be used under the terms of the GNU
31 ** General Public License version 3.0 as published by the Free Software
32 ** Foundation and appearing in the file LICENSE.GPL included in the
33 ** packaging of this file. Please review the following information to
34 ** ensure the GNU General Public License version 3.0 requirements will be
35 ** met: http://www.gnu.org/copyleft/gpl.html.
36 **
37 **
38 ** $QT_END_LICENSE$
39 **
40 ****************************************************************************/
41 
42 #ifndef QNETWORKACCESSCACHE_P_H
43 #define QNETWORKACCESSCACHE_P_H
44 
45 //
46 // W A R N I N G
47 // -------------
48 //
49 // This file is not part of the Qt API. It exists for the convenience
50 // of the Network Access API. This header file may change from
51 // version to version without notice, or even be removed.
52 //
53 // We mean it.
54 //
55 
56 #include "QtCore/qobject.h"
57 #include "QtCore/qbasictimer.h"
58 #include "QtCore/qbytearray.h"
59 #include "QtCore/qhash.h"
60 #include "QtCore/qmetatype.h"
61 
63 
64 class QNetworkRequest;
65 class QUrl;
66 
67 // this class is not about caching files but about
68 // caching objects used by QNetworkAccessManager, e.g. existing TCP connections
69 // or credentials.
71 {
72  Q_OBJECT
73 public:
74  struct Node;
76 
78  {
79  friend class QNetworkAccessCache;
81  bool expires;
82  bool shareable;
83  public:
85  virtual ~CacheableObject();
86  virtual void dispose() = 0;
87  inline QByteArray cacheKey() const { return key; }
88 
89  protected:
90  void setExpires(bool enable);
91  void setShareable(bool enable);
92  };
93 
96 
97  void clear();
98 
99  void addEntry(const QByteArray &key, CacheableObject *entry);
100  bool hasEntry(const QByteArray &key) const;
101  bool requestEntry(const QByteArray &key, QObject *target, const char *member);
103  void releaseEntry(const QByteArray &key);
104  void removeEntry(const QByteArray &key);
105 
106 signals:
108 
109 protected:
110  void timerEvent(QTimerEvent *);
111 
112 private:
113  // idea copied from qcache.h
114  NodeHash hash;
117 
119 
120  void linkEntry(const QByteArray &key);
121  bool unlinkEntry(const QByteArray &key);
122  void updateTimer();
123  bool emitEntryReady(Node *node, QObject *target, const char *member);
124 };
125 
127 
129 
130 #endif
bool requestEntry(const QByteArray &key, QObject *target, const char *member)
#define QT_END_NAMESPACE
This macro expands to.
Definition: qglobal.h:90
void timerEvent(QTimerEvent *)
This event handler can be reimplemented in a subclass to receive timer events for the object...
The QByteArray class provides an array of bytes.
Definition: qbytearray.h:135
void entryReady(QNetworkAccessCache::CacheableObject *)
CacheableObject * requestEntryNow(const QByteArray &key)
The QUrl class provides a convenient interface for working with URLs.
Definition: qurl.h:61
The QObject class is the base class of all Qt objects.
Definition: qobject.h:111
#define QT_BEGIN_NAMESPACE
This macro expands to.
Definition: qglobal.h:89
void addEntry(const QByteArray &key, CacheableObject *entry)
bool unlinkEntry(const QByteArray &key)
Removes the entry pointed by key from the linked list.
bool emitEntryReady(Node *node, QObject *target, const char *member)
QHash< QByteArray, Node > NodeHash
#define Q_OBJECT
Definition: qobjectdefs.h:157
#define Q_DECLARE_METATYPE(TYPE)
This macro makes the type Type known to QMetaType as long as it provides a public default constructor...
Definition: qmetatype.h:265
bool hasEntry(const QByteArray &key) const
The QTimerEvent class contains parameters that describe a timer event.
Definition: qcoreevent.h:341
void linkEntry(const QByteArray &key)
Appens the entry given by key to the end of the linked list.
The QNetworkRequest class holds a request to be sent with QNetworkAccessManager.
The QBasicTimer class provides timer events for objects.
Definition: qbasictimer.h:55
void releaseEntry(const QByteArray &key)
#define signals
Definition: qobjectdefs.h:69
void removeEntry(const QByteArray &key)