article.cpp

/*
 * article.cpp
 *
 * Copyright (c) 2001, 2002, 2003, 2004 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'.
 */
#include "article.h"
#include "tools_p.h"
#include "enclosure.h"
#include "category.h"
 
#include <kdebug.h>
#include <krfcdate.h>
#include <kurl.h>
#include <kurllabel.h>
#include <kmdcodec.h> 
 
#include <tqdatetime.h>
#include <tqdom.h>
 
using namespace RSS;
namespace RSS
{
    KMD5 md5Machine;
}
 
struct Article::Private : public Shared
{
    TQString title;
    KURL link;
    TQString description;
    TQDateTime pubDate;
    TQString guid;
        TQString author;
    bool guidIsPermaLink;
    MetaInfoMap meta;
    KURL commentsLink;
        int numComments;
        Enclosure enclosure;
    TQValueList<Category> categories;
};
 
Article::Article() : d(new Private)
{
}
 
Article::Article(const Article &other) : d(0)
{
    *this = other;
}
 
Enclosure Article::enclosure() const
{
    return d->enclosure;
}
 
TQValueList<Category> Article::categories() const
{
    return d->categories;
}
 
 
Article::Article(const TQDomNode &node, Format format, Version version) : d(new Private)
{
    TQString elemText;
 
    d->numComments=0;
 
    if (!(elemText = extractTitle(node)).isNull())
        d->title = elemText;
   
    if (format==AtomFeed)
    {
        TQDomNode n;
        for (n = node.firstChild(); !n.isNull(); n = n.nextSibling()) {
            const TQDomElement e = n.toElement();
            if ( (e.tagName()==TQString::fromLatin1("link")) &&
                (e.attribute(TQString::fromLatin1("rel"), TQString::fromLatin1("alternate")) == TQString::fromLatin1("alternate")))
                {   
                    d->link=n.toElement().attribute(TQString::fromLatin1("href"));
                    break;
                }
        }
    }
    else
    {
        if (!(elemText = extractNode(node, TQString::fromLatin1("link"))).isNull())
            d->link = elemText;
    }
 
    // prefer content/content:encoded over summary/description for feeds that provide it
    if (format == AtomFeed)
    {
        d->description = extractNode(node, TQString::fromLatin1("content"), false);
    }
    else
    {
        d->description = extractElementTextNS(node, ContentNamespace, TQString::fromLatin1("encoded"), false);
    }
 
    if (d->description.isEmpty())
    {
        if (!(elemText = extractNode(node, TQString::fromLatin1("body"), false)).isNull())
            d->description = elemText;
    
        if (d->description.isEmpty())  // 3rd try: see http://www.intertwingly.net/blog/1299.html
        {
            if (!(elemText = extractNode(node, TQString::fromLatin1((format==AtomFeed)? "summary" : "description"), false)).isNull())
                d->description = elemText;
        }
    }
    
    time_t time = 0;
 
    if (format == AtomFeed)
    {
        if (version == vAtom_1_0)
            elemText = extractNode(node, TQString::fromLatin1("updated"));
        else
           elemText = extractNode(node, TQString::fromLatin1("issued"));
 
        if (!elemText.isNull())
            time = parseISO8601Date(elemText);  
    }
    else 
    {
        elemText = extractNode(node, TQString::fromLatin1("pubDate"));
        if (!elemText.isNull())
            time = KRFCDate::parseDate(elemText);
    }
    
    if (!(elemText = extractElementTextNS(node, DublinCoreNamespace, TQString::fromLatin1("date"))).isNull())
    {
        time = parseISO8601Date(elemText);
    }
 
    // 0 means invalid, not epoch (parsers return epoch+1 when parsing epoch, see the KRFCDate::parseDate() docs)
        if (time != 0)
        d->pubDate.setTime_t(time);
 
    d->commentsLink = extractElementTextNS(node, CommentAPINamespace, TQString::fromLatin1("comment"));
    d->numComments = extractElementTextNS(node, SlashNamespace, TQString::fromLatin1("comments")).toInt();
 
    TQDomElement element = TQDomNode(node).toElement();
 
    // in RSS 1.0, we use <item about> attribute as ID
    // FIXME: pass format version instead of checking for attribute
 
    if (!element.isNull() && element.hasAttributeNS(RDFNamespace, TQString::fromLatin1("about")))
    {
        d->guid = element.attributeNS(RDFNamespace, TQString::fromLatin1("about"), TQString::null);
        d->guidIsPermaLink = false;
    }
    else
    {
        TQString tagName=(format==AtomFeed)? TQString::fromLatin1("id"): TQString::fromLatin1("guid");
        TQDomNode n = node.namedItem(tagName);
        if (!n.isNull())
        {
            d->guidIsPermaLink = (format==AtomFeed)? false : true;
            if (n.toElement().attribute(TQString::fromLatin1("isPermaLink"), "true") == "false") d->guidIsPermaLink = false;
            if (!(elemText = extractNode(node, tagName)).isNull())
                d->guid = elemText;
        }
    }    
 
    if(d->guid.isEmpty()) {
        d->guidIsPermaLink = false;
        
        md5Machine.reset();
        TQDomNode n(node);
        md5Machine.update(d->title.utf8());
        md5Machine.update(d->description.utf8());
        d->guid = TQString(md5Machine.hexDigest().data());
        d->meta[TQString::fromLatin1("guidIsHash")] = TQString::fromLatin1("true");
    }
 
    TQDomNode enclosure = element.namedItem(TQString::fromLatin1("enclosure"));
    if (enclosure.isElement())
        d->enclosure = Enclosure::fromXML(enclosure.toElement());
 
    d->author = parseItemAuthor(element, format, version);
    
    for (TQDomNode i = node.firstChild(); !i.isNull(); i = i.nextSibling())
    {
        if (i.isElement())
        {
            if (i.toElement().tagName() == TQString::fromLatin1("metaInfo:meta"))
            {
                TQString type = i.toElement().attribute(TQString::fromLatin1("type"));
                d->meta[type] = i.toElement().text();
            }
            else if (i.toElement().tagName() == TQString::fromLatin1("category"))
            {
                d->categories.append(Category::fromXML(i.toElement()));
            }
        }
    }
}
 
Article::~Article()
{
    if (d->deref())
        delete d;
}
 
TQString Article::title() const
{
    return d->title;
}
 
TQString Article::author() const
{
    return d->author;
}
 
const KURL &Article::link() const
{
    return d->link;
}
 
TQString Article::description() const
{
    return d->description;
}
 
TQString Article::guid() const
{
    return d->guid;
}
 
bool Article::guidIsPermaLink() const
{
    return d->guidIsPermaLink;
}
 
const TQDateTime &Article::pubDate() const
{
    return d->pubDate;
}
 
const KURL &Article::commentsLink() const
{
    return d->commentsLink;
}
 
int Article::comments() const
{
    return d->numComments;
}
 
 
TQString Article::meta(const TQString &key) const
{
    return d->meta[key];
}
 
KURLLabel *Article::widget(TQWidget *parent, const char *name) const
{
    KURLLabel *label = new KURLLabel(d->link.url(), d->title, parent, name);
    label->setUseTips(true);
    if (!d->description.isNull())
        label->setTipText(d->description);
    
    return label;
}
 
Article &Article::operator=(const Article &other)
{
    if (this != &other) {
        other.d->ref();
        if (d && d->deref())
            delete d;
        d = other.d;
    }
    return *this;
}
 
bool Article::operator==(const Article &other) const
{
    return d->guid == other.guid();
}