icalformat_p.h

Go to the documentation of this file.

/*
  This file is part of the kcalcore library.

  Copyright (c) 2001-2003 Cornelius Schumacher <schumacher@kde.org>
  Copyright (C) 2003-2004 Reinhold Kainhofer <reinhold@kainhofer.com>
  Copyright (c) 2006 David Jarvie <software@astrojar.org.uk>
  Copyright (C) 2012  Christian Mollekopf <mollekopf@kolabsys.com>

  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 KCALCORE_ICALFORMAT_P_H
#define KCALCORE_ICALFORMAT_P_H

#include "exceptions.h"
#include "freebusy.h"
#include "todo.h"
#include "journal.h"
#include "event.h"
#include "person.h"
#include "calendar.h"
#include "schedulemessage.h"

#include <KDateTime>

#include <libical/ical.h>

class QDate;

namespace KCalCore {

class Alarm;
class Attachment;
class Attendee;
class Duration;
class Event;
class FreeBusy;
class ICalFormat;
class ICalTimeZones;
class Incidence;
class Journal;
class Recurrence;
class RecurrenceRule;
class Todo;

#define _ICAL_VERSION "2.0"

#define _ICAL_IMPLEMENTATION_VERSION "1.0"

class ICalFormatImpl
{
public:
    explicit ICalFormatImpl(ICalFormat *parent);

    virtual ~ICalFormatImpl();

    bool populate(const Calendar::Ptr &calendar, icalcomponent *fs,
                  bool deleted = false, const QString &notebook = QString());

    icalcomponent *writeIncidence(const IncidenceBase::Ptr &incidence,
                                  iTIPMethod method = iTIPRequest,
                                  ICalTimeZones *tzList = 0,
                                  ICalTimeZones *tzUsedList = 0);

    icalcomponent *writeTodo(const Todo::Ptr &todo, ICalTimeZones *tzlist = 0,
                             ICalTimeZones *tzUsedList = 0);

    icalcomponent *writeEvent(const Event::Ptr &event, ICalTimeZones *tzlist = 0,
                              ICalTimeZones *tzUsedList = 0);

    icalcomponent *writeJournal(const Journal::Ptr &journal, ICalTimeZones *tzlist = 0,
                                ICalTimeZones *tzUsedList = 0);

    icalcomponent *writeFreeBusy(const FreeBusy::Ptr &freebusy,
                                 iTIPMethod method = iTIPPublish);

    void writeIncidence(icalcomponent *parent, const Incidence::Ptr &incidence,
                        ICalTimeZones *tzlist = 0, ICalTimeZones *tzUsedList = 0);

    icalproperty *writeDescription(const QString &description, bool isRich = false);
    icalproperty *writeSummary(const QString &summary, bool isRich = false);
    icalproperty *writeLocation(const QString &location, bool isRich = false);
    icalproperty *writeAttendee(const Attendee::Ptr &attendee);
    icalproperty *writeOrganizer(const Person::Ptr &organizer);
    icalproperty *writeAttachment(const Attachment::Ptr &attach);
    icalproperty *writeRecurrenceRule(Recurrence *);
    icalrecurrencetype writeRecurrenceRule(RecurrenceRule *recur);
    icalcomponent *writeAlarm(const Alarm::Ptr &alarm);

    QString extractErrorProperty(icalcomponent *);
    Todo::Ptr readTodo(icalcomponent *vtodo, ICalTimeZones *tzlist);
    Event::Ptr readEvent(icalcomponent *vevent, ICalTimeZones *tzlist);
    FreeBusy::Ptr readFreeBusy(icalcomponent *vfreebusy);
    Journal::Ptr readJournal(icalcomponent *vjournal, ICalTimeZones *tzlist);
    Attendee::Ptr readAttendee(icalproperty *attendee);
    Person::Ptr readOrganizer(icalproperty *organizer);
    Attachment::Ptr readAttachment(icalproperty *attach);
    void readIncidence(icalcomponent *parent, Incidence::Ptr incidence,
                       ICalTimeZones *tzlist);
    void readRecurrenceRule(icalproperty *rrule, Incidence::Ptr event);
    void readExceptionRule(icalproperty *rrule, Incidence::Ptr incidence);
    void readRecurrence(const struct icalrecurrencetype &r,
                        RecurrenceRule *recur);
    void readAlarm(icalcomponent *alarm, Incidence::Ptr incidence,
                   ICalTimeZones *tzlist);

    QString loadedProductId() const;

    static icaltimetype writeICalDate(const QDate &);

    static QDate readICalDate(icaltimetype);

    static icaltimetype writeICalDateTime(const KDateTime &);

    static icaltimetype writeICalUtcDateTime(const KDateTime &);

    static icalproperty *writeICalDateTimeProperty(const icalproperty_kind kind,
            const KDateTime &dt,
            ICalTimeZones *tzlist = 0,
            ICalTimeZones *tzUsedList = 0);

    static KDateTime readICalDateTime(icalproperty *p, const icaltimetype &t,
                                      ICalTimeZones *tzlist, bool utc = false);

    static KDateTime readICalUtcDateTime(icalproperty *p, icaltimetype &t,
                                         ICalTimeZones *tzlist = 0)
    //TODO: KDE5, move this implementation to icalformat_p.cpp
    {
        return readICalDateTime(p, t, tzlist, true);
    }

    static KDateTime readICalDateTimeProperty(icalproperty *p,
            ICalTimeZones *tzlist, bool utc = false);

    static KDateTime readICalUtcDateTimeProperty(icalproperty *p)
    {
        return readICalDateTimeProperty(p, 0, true);
    }

    static icaldurationtype writeICalDuration(const Duration &duration);

    static Duration readICalDuration(icaldurationtype d);

    static icaldatetimeperiodtype writeICalDatePeriod(const QDate &date);

    icalcomponent *createCalendarComponent(const Calendar::Ptr &calendar = Calendar::Ptr());

    icalcomponent *createScheduleComponent(const IncidenceBase::Ptr &incidence,
                                           iTIPMethod method);

protected:
    // void dumpIcalRecurrence( const icalrecurrencetype &r );

private:
    //@cond PRIVATE
    class Private;
    Private *const d;
    //@endcond
};

}

#endif