qhttpmultipart.h [include/QtNetwork/qhttpmultipart.h]

1	/****************************************************************************
2	**
3	** Copyright (C) 2012 Nokia Corporation and/or its subsidiary(-ies).
4	** Contact: http://www.qt-project.org/
5	**
6	** This file is part of the QtNetwork module of the Qt Toolkit.
7	**
8	** $QT_BEGIN_LICENSE:LGPL$
9	** GNU Lesser General Public License Usage
10	** This file may be used under the terms of the GNU Lesser General Public
11	** License version 2.1 as published by the Free Software Foundation and
12	** appearing in the file LICENSE.LGPL included in the packaging of this
13	** file. Please review the following information to ensure the GNU Lesser
14	** General Public License version 2.1 requirements will be met:
15	** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
16	**
17	** In addition, as a special exception, Nokia gives you certain additional
18	** rights. These rights are described in the Nokia Qt LGPL Exception
19	** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
20	**
21	** GNU General Public License Usage
22	** Alternatively, this file may be used under the terms of the GNU General
23	** Public License version 3.0 as published by the Free Software Foundation
24	** and appearing in the file LICENSE.GPL included in the packaging of this
25	** file. Please review the following information to ensure the GNU General
26	** Public License version 3.0 requirements will be met:
27	** http://www.gnu.org/copyleft/gpl.html.
28	**
29	** Other Usage
30	** Alternatively, this file may be used in accordance with the terms and
31	** conditions contained in a signed written agreement between you and Nokia.
32	**
33	**
34	**
35	**
36	**
37	**
38	** $QT_END_LICENSE$
39	**
40	****************************************************************************/
41
42	#ifndef QHTTPMULTIPART_H
43	#define QHTTPMULTIPART_H
44
45	#include <QtCore/QSharedDataPointer>
46	#include <QtCore/QByteArray>
47	#include <QtNetwork/QNetworkRequest>
48
49	QT_BEGIN_HEADER
50
51	QT_BEGIN_NAMESPACE
52
53	QT_MODULE(Network)
54
55	class QHttpPartPrivate;
56	class QHttpMultiPart;
57
58	class Q_NETWORK_EXPORT QHttpPart
59	{
60	public:
61	QHttpPart();
62	QHttpPart(const QHttpPart &other);
63	~QHttpPart();
64	QHttpPart &operator=(const QHttpPart &other);
65	bool operator==(const QHttpPart &other) const;
66	inline bool operator!=(const QHttpPart &other) const
67	{ return !operator==(other); }
68
69	void setHeader(QNetworkRequest::KnownHeaders header, const QVariant &value);
70	void setRawHeader(const QByteArray &headerName, const QByteArray &headerValue);
71
72	void setBody(const QByteArray &body);
73	void setBodyDevice(QIODevice *device);
74
75	private:
76	QSharedDataPointer<QHttpPartPrivate> d;
77
78	friend class QHttpMultiPartIODevice;
79	};
80
81	class QHttpMultiPartPrivate;
82
83	class Q_NETWORK_EXPORT QHttpMultiPart : public QObject
84	{
85	Q_OBJECT
86
87	public:
88
89	enum ContentType {
90	MixedType,
91	RelatedType,
92	FormDataType,
93	AlternativeType
94	};
95
96	QHttpMultiPart(QObject *parent = `0`);
97	QHttpMultiPart(ContentType contentType, QObject *parent = `0`);
98	~QHttpMultiPart();
99
100	void append(const QHttpPart &httpPart);
101
102	void setContentType(ContentType contentType);
103
104	QByteArray boundary() const;
105	void setBoundary(const QByteArray &boundary);
106
107	private:
108	Q_DECLARE_PRIVATE(QHttpMultiPart)
109	Q_DISABLE_COPY(QHttpMultiPart)
110
111	friend class QNetworkAccessManager;
112	friend class QNetworkAccessManagerPrivate;
113	};
114
115	QT_END_NAMESPACE
116
117	QT_END_HEADER
118
119	#endif // QHTTPMULTIPART_H
120