Qt 4.8
Public Functions | Protected Functions | List of all members
QNetworkCookieJar Class Reference

The QNetworkCookieJar class implements a simple jar of QNetworkCookie objects. More...

#include <qnetworkcookiejar.h>

Inheritance diagram for QNetworkCookieJar:
QObject

Public Functions

virtual QList< QNetworkCookiecookiesForUrl (const QUrl &url) const
 Returns the cookies to be added to when a request is sent to url. More...
 
 QNetworkCookieJar (QObject *parent=0)
 Creates a QNetworkCookieJar object and sets the parent object to be parent. More...
 
virtual bool setCookiesFromUrl (const QList< QNetworkCookie > &cookieList, const QUrl &url)
 Adds the cookies in the list cookieList to this cookie jar. More...
 
virtual ~QNetworkCookieJar ()
 Destroys this cookie jar object and discards all cookies stored in it. More...
 
- Public Functions inherited from QObject
bool blockSignals (bool b)
 If block is true, signals emitted by this object are blocked (i.e., emitting a signal will not invoke anything connected to it). More...
 
const QObjectListchildren () const
 Returns a list of child objects. More...
 
bool connect (const QObject *sender, const char *signal, const char *member, Qt::ConnectionType type=Qt::AutoConnection) const
 
bool disconnect (const char *signal=0, const QObject *receiver=0, const char *member=0)
 
bool disconnect (const QObject *receiver, const char *member=0)
 
void dumpObjectInfo ()
 Dumps information about signal connections, etc. More...
 
void dumpObjectTree ()
 Dumps a tree of children to the debug output. More...
 
QList< QByteArraydynamicPropertyNames () const
 Returns the names of all properties that were dynamically added to the object using setProperty(). More...
 
virtual bool event (QEvent *)
 This virtual function receives events to an object and should return true if the event e was recognized and processed. More...
 
virtual bool eventFilter (QObject *, QEvent *)
 Filters events if this object has been installed as an event filter for the watched object. More...
 
template<typename T >
findChild (const QString &aName=QString()) const
 Returns the child of this object that can be cast into type T and that is called name, or 0 if there is no such object. More...
 
template<typename T >
QList< T > findChildren (const QString &aName=QString()) const
 Returns all children of this object with the given name that can be cast to type T, or an empty list if there are no such objects. More...
 
template<typename T >
QList< T > findChildren (const QRegExp &re) const
 
bool inherits (const char *classname) const
 Returns true if this object is an instance of a class that inherits className or a QObject subclass that inherits className; otherwise returns false. More...
 
void installEventFilter (QObject *)
 Installs an event filter filterObj on this object. More...
 
bool isWidgetType () const
 Returns true if the object is a widget; otherwise returns false. More...
 
void killTimer (int id)
 Kills the timer with timer identifier, id. More...
 
virtual const QMetaObjectmetaObject () const
 Returns a pointer to the meta-object of this object. More...
 
void moveToThread (QThread *thread)
 Changes the thread affinity for this object and its children. More...
 
QString objectName () const
 
QObjectparent () const
 Returns a pointer to the parent object. More...
 
QVariant property (const char *name) const
 Returns the value of the object's name property. More...
 
Q_INVOKABLE QObject (QObject *parent=0)
 Constructs an object with parent object parent. More...
 
void removeEventFilter (QObject *)
 Removes an event filter object obj from this object. More...
 
void setObjectName (const QString &name)
 
void setParent (QObject *)
 Makes the object a child of parent. More...
 
bool setProperty (const char *name, const QVariant &value)
 Sets the value of the object's name property to value. More...
 
void setUserData (uint id, QObjectUserData *data)
 
bool signalsBlocked () const
 Returns true if signals are blocked; otherwise returns false. More...
 
int startTimer (int interval)
 Starts a timer and returns a timer identifier, or returns zero if it could not start a timer. More...
 
QThreadthread () const
 Returns the thread in which the object lives. More...
 
QObjectUserDatauserData (uint id) const
 
virtual ~QObject ()
 Destroys the object, deleting all its child objects. More...
 

Protected Functions

QList< QNetworkCookieallCookies () const
 Returns all cookies stored in this cookie jar. More...
 
void setAllCookies (const QList< QNetworkCookie > &cookieList)
 Sets the internal list of cookies held by this cookie jar to be cookieList. More...
 
- Protected Functions inherited from QObject
virtual void childEvent (QChildEvent *)
 This event handler can be reimplemented in a subclass to receive child events. More...
 
virtual void connectNotify (const char *signal)
 This virtual function is called when something has been connected to signal in this object. More...
 
virtual void customEvent (QEvent *)
 This event handler can be reimplemented in a subclass to receive custom events. More...
 
virtual void disconnectNotify (const char *signal)
 This virtual function is called when something has been disconnected from signal in this object. More...
 
 QObject (QObjectPrivate &dd, QObject *parent=0)
 
int receivers (const char *signal) const
 Returns the number of receivers connected to the signal. More...
 
QObjectsender () const
 Returns a pointer to the object that sent the signal, if called in a slot activated by a signal; otherwise it returns 0. More...
 
int senderSignalIndex () const
 
virtual void timerEvent (QTimerEvent *)
 This event handler can be reimplemented in a subclass to receive timer events for the object. More...
 

Additional Inherited Members

- Public Slots inherited from QObject
void deleteLater ()
 Schedules this object for deletion. More...
 
- Signals inherited from QObject
void destroyed (QObject *=0)
 This signal is emitted immediately before the object obj is destroyed, and can not be blocked. More...
 
- Static Public Functions inherited from QObject
static bool connect (const QObject *sender, const char *signal, const QObject *receiver, const char *member, Qt::ConnectionType=Qt::AutoConnection)
 Creates a connection of the given type from the signal in the sender object to the method in the receiver object. More...
 
static bool connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type=Qt::AutoConnection)
 
static bool disconnect (const QObject *sender, const char *signal, const QObject *receiver, const char *member)
 Disconnects signal in object sender from method in object receiver. More...
 
static bool disconnect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &member)
 
static uint registerUserData ()
 
static QString tr (const char *sourceText, const char *comment=0, int n=-1)
 
static QString trUtf8 (const char *sourceText, const char *comment=0, int n=-1)
 
- Static Public Variables inherited from QObject
static const QMetaObject staticMetaObject
 This variable stores the meta-object for the class. More...
 
- Protected Variables inherited from QObject
QScopedPointer< QObjectDatad_ptr
 
- Static Protected Variables inherited from QObject
static const QMetaObject staticQtMetaObject
 

Detailed Description

The QNetworkCookieJar class implements a simple jar of QNetworkCookie objects.

Since
4.4

Cookies are small bits of information that stateless protocols like HTTP use to maintain some persistent information across requests.

A cookie is set by a remote server when it replies to a request and it expects the same cookie to be sent back when further requests are sent.

The cookie jar is the object that holds all cookies set in previous requests. Web browsers save their cookie jars to disk in order to conserve permanent cookies across invocations of the application.

QNetworkCookieJar does not implement permanent storage: it only keeps the cookies in memory. Once the QNetworkCookieJar object is deleted, all cookies it held will be discarded as well. If you want to save the cookies, you should derive from this class and implement the saving to disk to your own storage format.

This class implements only the basic security recommended by the cookie specifications and does not implement any cookie acceptance policy (it accepts all cookies set by any requests). In order to override those rules, you should reimplement the cookiesForUrl() and setCookiesFromUrl() virtual functions. They are called by QNetworkReply and QNetworkAccessManager when they detect new cookies and when they require cookies.

See also
QNetworkCookie, QNetworkAccessManager, QNetworkReply, QNetworkRequest, QNetworkAccessManager::setCookieJar()

Definition at line 58 of file qnetworkcookiejar.h.

Constructors and Destructors

◆ QNetworkCookieJar()

QNetworkCookieJar::QNetworkCookieJar ( QObject parent = 0)

Creates a QNetworkCookieJar object and sets the parent object to be parent.

The cookie jar is initialized to empty.

Definition at line 98 of file qnetworkcookiejar.cpp.

99  : QObject(*new QNetworkCookieJarPrivate, parent)
100 {
101 }
Q_INVOKABLE QObject(QObject *parent=0)
Constructs an object with parent object parent.
Definition: qobject.cpp:753

◆ ~QNetworkCookieJar()

QNetworkCookieJar::~QNetworkCookieJar ( )
virtual

Destroys this cookie jar object and discards all cookies stored in it.

Cookies are not saved to disk in the QNetworkCookieJar default implementation.

If you need to save the cookies to disk, you have to derive from QNetworkCookieJar and save the cookies to disk yourself.

Definition at line 111 of file qnetworkcookiejar.cpp.

112 {
113 }

Functions

◆ allCookies()

QList< QNetworkCookie > QNetworkCookieJar::allCookies ( ) const
protected

Returns all cookies stored in this cookie jar.

This function is suitable for derived classes to save cookies to disk, as well as to implement cookie expiration and other policies.

See also
setAllCookies(), cookiesForUrl()

Definition at line 122 of file qnetworkcookiejar.cpp.

123 {
124  return d_func()->allCookies;
125 }

◆ cookiesForUrl()

QList< QNetworkCookie > QNetworkCookieJar::cookiesForUrl ( const QUrl url) const
virtual

Returns the cookies to be added to when a request is sent to url.

This function is called by the default QNetworkAccessManager::createRequest(), which adds the cookies returned by this function to the request being sent.

If more than one cookie with the same name is found, but with differing paths, the one with longer path is returned before the one with shorter path. In other words, this function returns cookies sorted decreasingly by path length.

The default QNetworkCookieJar class implements only a very basic security policy (it makes sure that the cookies' domain and path match the reply's). To enhance the security policy with your own algorithms, override cookiesForUrl().

See also
setCookiesFromUrl(), QNetworkAccessManager::setCookieJar()

Definition at line 278 of file qnetworkcookiejar.cpp.

279 {
280 // \b Warning! This is only a dumb implementation!
281 // It does NOT follow all of the recommendations from
282 // http://wp.netscape.com/newsref/std/cookie_spec.html
283 // It does not implement a very good cross-domain verification yet.
284 
285  Q_D(const QNetworkCookieJar);
287  QList<QNetworkCookie> result;
288  bool isEncrypted = url.scheme().toLower() == QLatin1String("https");
289 
290  // scan our cookies for something that matches
291  QList<QNetworkCookie>::ConstIterator it = d->allCookies.constBegin(),
292  end = d->allCookies.constEnd();
293  for ( ; it != end; ++it) {
294  if (!isParentDomain(url.host(), it->domain()))
295  continue;
296  if (!isParentPath(url.path(), it->path()))
297  continue;
298  if (!(*it).isSessionCookie() && (*it).expirationDate() < now)
299  continue;
300  if ((*it).isSecure() && !isEncrypted)
301  continue;
302 
303  // insert this cookie into result, sorted by path
304  QList<QNetworkCookie>::Iterator insertIt = result.begin();
305  while (insertIt != result.end()) {
306  if (insertIt->path().length() < it->path().length()) {
307  // insert here
308  insertIt = result.insert(insertIt, *it);
309  break;
310  } else {
311  ++insertIt;
312  }
313  }
314 
315  // this is the shortest path yet, just append
316  if (insertIt == result.end())
317  result += *it;
318  }
319 
320  return result;
321 }
double d
Definition: qnumeric_p.h:62
#define it(className, varName)
iterator begin()
Returns an STL-style iterator pointing to the first item in the list.
Definition: qlist.h:267
void insert(int i, const T &t)
Inserts value at index position i in the list.
Definition: qlist.h:575
QLatin1String(DBUS_INTERFACE_DBUS))) Q_GLOBAL_STATIC_WITH_ARGS(QString
QString host() const
Returns the host of the URL if it is defined; otherwise an empty string is returned.
Definition: qurl.cpp:4837
#define Q_D(Class)
Definition: qglobal.h:2482
QString path() const
Returns the path of the URL.
Definition: qurl.cpp:4977
iterator end()
Returns an STL-style iterator pointing to the imaginary item after the last item in the list...
Definition: qlist.h:270
The QNetworkCookieJar class implements a simple jar of QNetworkCookie objects.
QString scheme() const
Returns the scheme of the URL.
Definition: qurl.cpp:4550
The QDateTime class provides date and time functions.
Definition: qdatetime.h:216
static bool isParentPath(QString path, QString reference)
int length() const
This function is identical to count().
Definition: qlist.h:281
QString toLower() const Q_REQUIRED_RESULT
Returns a lowercase copy of the string.
Definition: qstring.cpp:5389
static QDateTime currentDateTime()
Returns the current datetime, as reported by the system clock, in the local time zone.
Definition: qdatetime.cpp:3138
static bool isParentDomain(QString domain, QString reference)
static const KeyPair *const end

◆ setAllCookies()

void QNetworkCookieJar::setAllCookies ( const QList< QNetworkCookie > &  cookieList)
protected

Sets the internal list of cookies held by this cookie jar to be cookieList.

This function is suitable for derived classes to implement loading cookies from permanent storage, or their own cookie acceptance policies by reimplementing setCookiesFromUrl().

See also
allCookies(), setCookiesFromUrl()

Definition at line 136 of file qnetworkcookiejar.cpp.

137 {
139  d->allCookies = cookieList;
140 }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
The QNetworkCookieJar class implements a simple jar of QNetworkCookie objects.

◆ setCookiesFromUrl()

bool QNetworkCookieJar::setCookiesFromUrl ( const QList< QNetworkCookie > &  cookieList,
const QUrl url 
)
virtual

Adds the cookies in the list cookieList to this cookie jar.

Default values for path and domain are taken from the url object.

Returns true if one or more cookies are set for url, otherwise false.

If a cookie already exists in the cookie jar, it will be overridden by those in cookieList.

The default QNetworkCookieJar class implements only a very basic security policy (it makes sure that the cookies' domain and path match the reply's). To enhance the security policy with your own algorithms, override setCookiesFromUrl().

Also, QNetworkCookieJar does not have a maximum cookie jar size. Reimplement this function to discard older cookies to create room for new ones.

See also
cookiesForUrl(), QNetworkAccessManager::setCookieJar()

Definition at line 181 of file qnetworkcookiejar.cpp.

Referenced by QNetworkReplyImplPrivate::metaDataChanged().

183 {
185  QString defaultDomain = url.host();
186  QString pathAndFileName = url.path();
187  QString defaultPath = pathAndFileName.left(pathAndFileName.lastIndexOf(QLatin1Char('/'))+1);
188  if (defaultPath.isEmpty())
189  defaultPath = QLatin1Char('/');
190 
191  int added = 0;
193  foreach (QNetworkCookie cookie, cookieList) {
194  bool isDeletion = !cookie.isSessionCookie() &&
195  cookie.expirationDate() < now;
196 
197  // validate the cookie & set the defaults if unset
198  if (cookie.path().isEmpty())
199  cookie.setPath(defaultPath);
200  // don't do path checking. See http://bugreports.qt-project.org/browse/QTBUG-5815
201 // else if (!isParentPath(pathAndFileName, cookie.path())) {
202 // continue; // not accepted
203 // }
204  if (cookie.domain().isEmpty()) {
205  cookie.setDomain(defaultDomain);
206  } else {
207  // Ensure the domain starts with a dot if its field was not empty
208  // in the HTTP header. There are some servers that forget the
209  // leading dot and this is actually forbidden according to RFC 2109,
210  // but all browsers accept it anyway so we do that as well.
211  if (!cookie.domain().startsWith(QLatin1Char('.')))
212  cookie.setDomain(QLatin1Char('.') + cookie.domain());
213 
214  QString domain = cookie.domain();
215  if (!(isParentDomain(domain, defaultDomain)
216  || isParentDomain(defaultDomain, domain)))
217  continue; // not accepted
218 
219  // the check for effective TLDs makes the "embedded dot" rule from RFC 2109 section 4.3.2
220  // redundant; the "leading dot" rule has been relaxed anyway, see above
221  // we remove the leading dot for this check
222  if (qIsEffectiveTLD(domain.remove(0, 1)))
223  continue; // not accepted
224  }
225 
226  for (int i = 0; i < d->allCookies.size(); ++i) {
227  // does this cookie already exist?
228  const QNetworkCookie &current = d->allCookies.at(i);
229  if (cookie.name() == current.name() &&
230  cookie.domain() == current.domain() &&
231  cookie.path() == current.path()) {
232  // found a match
233  d->allCookies.removeAt(i);
234  break;
235  }
236  }
237 
238  // did not find a match
239  if (!isDeletion) {
240  int countForDomain = 0;
241  for (int i = d->allCookies.size() - 1; i >= 0; --i) {
242  // Start from the end and delete the oldest cookies to keep a maximum count of 50.
243  const QNetworkCookie &current = d->allCookies.at(i);
244  if (isParentDomain(cookie.domain(), current.domain())
245  || isParentDomain(current.domain(), cookie.domain())) {
246  if (countForDomain >= 49)
247  d->allCookies.removeAt(i);
248  else
249  ++countForDomain;
250  }
251  }
252 
253  d->allCookies += cookie;
254  ++added;
255  }
256  }
257  return (added > 0);
258 }
double d
Definition: qnumeric_p.h:62
QString domain() const
Returns the domain this cookie is associated with.
bool isSessionCookie() const
Returns true if this cookie is a session cookie.
bool startsWith(const QString &s, Qt::CaseSensitivity cs=Qt::CaseSensitive) const
Returns true if the string starts with s; otherwise returns false.
Definition: qstring.cpp:3734
void setDomain(const QString &domain)
Sets the domain associated with this cookie to be domain.
void setPath(const QString &path)
Sets the path associated with this cookie to be path.
The QString class provides a Unicode character string.
Definition: qstring.h:83
QString host() const
Returns the host of the URL if it is defined; otherwise an empty string is returned.
Definition: qurl.cpp:4837
#define Q_D(Class)
Definition: qglobal.h:2482
QString path() const
Returns the path of the URL.
Definition: qurl.cpp:4977
QString left(int n) const Q_REQUIRED_RESULT
Returns a substring that contains the n leftmost characters of the string.
Definition: qstring.cpp:3664
QString path() const
Returns the path associated with this cookie.
bool isEmpty() const
Returns true if the string has no characters; otherwise returns false.
Definition: qstring.h:704
QDateTime expirationDate() const
Returns the expiration date for this cookie.
The QNetworkCookieJar class implements a simple jar of QNetworkCookie objects.
The QNetworkCookie class holds one network cookie.
The QDateTime class provides date and time functions.
Definition: qdatetime.h:216
int lastIndexOf(QChar c, int from=-1, Qt::CaseSensitivity cs=Qt::CaseSensitive) const
Definition: qstring.cpp:3000
QByteArray name() const
Returns the name of this cookie.
static QDateTime currentDateTime()
Returns the current datetime, as reported by the system clock, in the local time zone.
Definition: qdatetime.cpp:3138
Q_CORE_EXPORT bool qIsEffectiveTLD(const QString &domain)
Return true if domain is a top-level-domain per Qt&#39;s copy of the Mozilla public suffix list...
Definition: qtldurl.cpp:97
static bool isParentDomain(QString domain, QString reference)
QString & remove(int i, int len)
Removes n characters from the string, starting at the given position index, and returns a reference t...
Definition: qstring.cpp:1867
The QLatin1Char class provides an 8-bit ASCII/Latin-1 character.
Definition: qchar.h:55

The documentation for this class was generated from the following files: