item.h

/*
 * This file is part of the syndication library
 *
 * Copyright (C) 2005 Frank Osterfeld <osterfeld@kde.org>
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Library General Public
 * License as published by the Free Software Foundation; either
 * version 2 of the License, or (at your option) any later version.
 *
 * This library 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.  See the GNU
 * Library General Public License for more details.
 *
 * You should have received a copy of the GNU Library General Public License
 * along with this library; see the file COPYING.LIB.  If not, write to
 * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
 * Boston, MA 02110-1301, USA.
 *
 */

#ifndef SYNDICATION_RSS2_ITEM_H
#define SYNDICATION_RSS2_ITEM_H

#include <syndication/rss2/document.h>
#include <syndication/elementwrapper.h>
#include <boost/shared_ptr.hpp>
#include <syndication/specificitem.h>

#include <ctime>

class QDomElement;
class QString;
template <class T> class QList;

namespace Syndication {

class SpecificItemVisitor;

namespace RSS2 {

class Category;
class Enclosure;
class Source;

class SYNDICATION_EXPORT Item : public ElementWrapper, public Syndication::SpecificItem
{
    public:

        explicit Item(boost::shared_ptr<Document> doc=boost::shared_ptr<Document>());

        explicit Item(const QDomElement& element, boost::shared_ptr<Document> doc=boost::shared_ptr<Document>());

        Item(const Item& other);

        ~Item();

        Item& operator=(const Item& other);


        bool accept(SpecificItemVisitor* visitor);

        QString title() const;

        QString link() const;

        QString description() const;

        QString content() const;

        QList<Category> categories() const;

        QString comments() const;

        QString author() const;

        QList<Enclosure> enclosures() const;

        QString guid() const;

        bool guidIsPermaLink() const;

        time_t pubDate() const;

        time_t expirationDate() const;

        QString rating() const;

        Source source() const;

        QList<QDomElement> unhandledElements() const;


        QString debugInfo() const;

        //@cond PRIVATE
        QString originalDescription() const;

        QString originalTitle() const;
        //@endcond

    private:

        class ItemPrivate;
        boost::shared_ptr<ItemPrivate> d;
};

} // namespace RSS2
} // namespace Syndication

#endif // SYNDICATION_RSS2_ITEM_H