1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
|
/*
* article.h
*
* Copyright (c) 2001, 2002, 2003 Frerich Raabe <raabe@kde.org>
*
* This program is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. For licensing and distribution details, check the
* accompanying file 'COPYING'.
*/
#ifndef LIBRSS_ARTICLE_H
#define LIBRSS_ARTICLE_H
#include <qmap.h>
#include "global.h"
class QDateTime;
class QDomNode;
template <class> class QValueList;
class QString;
class QWidget;
class KURL;
class KURLLabel;
namespace RSS
{
class Category;
class Enclosure;
/**
* Represents an article as stored in a RSS file. You don't have to
* instantiate one of these yourself, the common way to access instances
* is via Document::articles().
* @see Document::articles()
*/
class KDE_EXPORT Article
{
public:
/**
* A list of articles.
*/
typedef QValueList<Article> List;
/**
* Default constructor.
*/
Article();
/**
* Copy constructor.
* @param other The Article object to copy.
*/
Article(const Article &other);
/**
* Constructs an Article from a piece of RSS markup.
* @param node A QDomNode which references the DOM leaf to be used
* for constructing the Article.
*/
Article(const QDomNode &node, Format format, Version version);
/**
* Assignment operator.
* @param other The Article object to clone.
* @return A reference to the cloned Article object.
*/
Article &operator=(const Article &other);
/**
* Compares two articles. Two articles are treated to be identical
* if all their properties (title, link, description etc.) are
* equal.
* @param other The article this article should be compared with.
* @return Whether the two articles are equal.
*/
bool operator==(const Article &other) const;
/**
* Convenience method. Simply calls !operator==().
* @param other The article this article should be compared with.
* @return Whether the two articles are unequal.
*/
bool operator!=(const Article &other) const { return !operator==(other); }
/**
* Destructor.
*/
virtual ~Article();
/**
* RSS 0.90 and upwards
* @return The headline of this article, or QString::null if
* no headline was available.
*/
QString title() const;
/**
* RSS 0.90 and upwards
* @return A URL referencing the complete text for this article,
* or an empty KURL if no link was available.
* Note that the RSS 0.91 Specification dictates that URLs not
* starting with "http://" or "ftp://" are considered invalid.
*/
const KURL &link() const;
/**
* RSS 0.91 and upwards
* @return A story synopsis, or QString::null if no description
* was available.
*/
QString description() const;
/**
* a string desribing the author of the item.
*/
QString author() const;
/**
* RSS 2.0 and upwards
* @return An article GUID (globally unique identifier).
*/
QString guid() const;
/**
* RSS 2.0 and upwards
* @return If this article GUID is permalink. Has no meaning when guid() is QString::null.
*/
bool guidIsPermaLink() const;
/**
* RSS 2.0 and upwards
* @return The date when the article was published.
*/
const QDateTime &pubDate() const;
const KURL &commentsLink() const;
int comments() const;
Enclosure enclosure() const;
/** returns a list of categories this article is assigned to. (RSS2 only, Atom is not supported yet) */
QValueList<Category> categories() const;
QString meta(const QString &key) const;
/**
* @param parent The parent widget for the KURLLabel.
* @param name A name for the widget which will be used internally.
* @return a widget (a KURLLabel in this case) for the Article.
* This makes building a user-interface which contains the
* information in this Article object more convenient.
* The returned KURLLabel's caption will be the title(), clicking
* on it will emit the URL link(), and it has a QToolTip attached
* to it which displays the description() (in case it has one,
* if there is no description, the URL which the label links to
* will be used).
* Note that you have to delete the KURLLabel object returned by
* this method yourself.
*/
KURLLabel *widget(QWidget *parent = 0, const char *name = 0) const;
typedef QMap<QString, QString> MetaInfoMap;
private:
struct Private;
Private *d;
};
}
#endif // LIBRSS_ARTICLE_H
// vim: noet:ts=4
|
