/*

* Copyright (c) 2010 Nokia Corporation and/or its subsidiary(-ies).

* All rights reserved.

* This component and the accompanying materials are made available

* under the terms of "Eclipse Public License v1.0"

* which accompanies this distribution, and is available

* at the URL "http://www.eclipse.org/legal/epl-v10.html".

*

* Initial Contributors:

* Nokia Corporation - initial contribution.

*

* Contributors:

*

* Description: 

*

*/

#include <agendaentry.h>

#include "agendaentry_p.h"

#include <calalarm.h>

#include <QDateTime>

/****************************************************

 *

 * AgendaAttendee

 *

 ****************************************************/

/*!

    \class AgendaAttendee

    \brief Class representing an attendee of an event.

           Contains the status and the role information of the attendee.

           Contains information about whether or not a response was requested for this attendee.

*/

/*!

    \enum AgendaAttendee::ParticipantRole

    This enum defines the possible roles for a AgendaAttendee object

    in case of entry's type is event.

*/

/*! \var AgendaAttendee::ParticipantRole AgendaAttendee::RequiredParticipant

    A required participant of the event.

*/

/*! \var AgendaAttendee::ParticipantRole AgendaAttendee::OptionalParticipant

    An optional participant of the event

*/

/*! \var AgendaAttendee::ParticipantRole AgendaAttendee::NonParticipant

    A non-participant of the event

*/

/*! \var AgendaAttendee::ParticipantRole AgendaAttendee::ChairParticipant

    This participant will chair the event

*/

/*! \var AgendaAttendee::ParticipantRole AgendaAttendee::ParticipantRoleUnknown

    The role is unknown

*/

/*!

    \enum AgendaAttendee::StatusType

    This enum defines the possible statuses for a AgendaAttendee object.

*/

/*! \var AgendaAttendee::StatusType AgendaAttendee::StatusNeedsAction

    Action is required by attendee

*/

/*! \var AgendaAttendee::StatusType AgendaAttendee::StatusAccepted

    Attendee has accepted request

*/

/*! \var AgendaAttendee::StatusType AgendaAttendee::StatusTentative

    Attendee has tentatively accepted the request

*/

/*! \var AgendaAttendee::StatusType AgendaAttendee::StatusConfirmed

    Attendee's presence is confirmed

*/

/*! \var AgendaAttendee::StatusType AgendaAttendee::StatusDeclined

    Attendee has declined request

*/

/*! \var AgendaAttendee::StatusType AgendaAttendee::StatusCompleted

    The required action has been completed by attendee

*/

/*! \var AgendaAttendee::StatusType AgendaAttendee::StatusDelegated

    Attendee has delegated the request to another person

*/

/*! \var AgendaAttendee::StatusType AgendaAttendee::StatusInProcess

    A to-do action in the process of being completed

*/

/*! \var AgendaAttendee::StatusType AgendaAttendee::StatusUnknown

    The status is unknown

*/

/*!

    Creates an attendee.

*/

AgendaAttendee::AgendaAttendee()

    : d(NULL)

{

}

/*!

    Constructs a new attendee using given \a address.

    \param address The address of the attendee

*/

AgendaAttendee::AgendaAttendee(const QString& address)

    : d(new AgendaAttendeePrivate)

{

    d->m_address = address;

    d->ref.ref();

}

/*!

    Destroys the attendee.

*/

AgendaAttendee::~AgendaAttendee()

{

    if (d && !d->ref.deref())

    {

        delete d;

    }

}

/*!

    Creates a copy of a given attendee.

    \param other attendee to be copied.

*/

AgendaAttendee::AgendaAttendee(const AgendaAttendee& other)

    : d(other.d)

{

    if (d) {

        d->ref.ref();

    }

}

/*!

    Sets the email address of the attendee.

    \param address The email address of the attendee

    \sa address()

*/

void AgendaAttendee::setAddress(const QString& address)

{

    detach();

    d->m_address = address;

}

/*!

    Gets the email address of the attendee.

    \return The email address of the attendee on success;

            otherwise returns a null QString.

    \sa setAddress()

*/

QString AgendaAttendee::address() const

{

    return d ? d->m_address : QString();

}

/*!

    Sets the common name of the attendee.

    \param name Common name

    \sa commonName()

*/

void AgendaAttendee::setCommonName(const QString& name)

{

    detach();

    d->m_commonName = name;

}

/*!

    Gets the common name of the attendee.

    \return The common name of the attendee on success;

            otherwise returns a null QString.

    \sa setCommonName()

*/

QString AgendaAttendee::commonName() const

{

    return d ? d->m_commonName : QString();

}

/*!

    Sets the role of the attendee.

    \param role The role

    \sa role()

*/

void AgendaAttendee::setRole(AgendaAttendee::ParticipantRole role)

{

    detach();

    d->m_role = role;

}

/*!

    Gets the role of the attendee.

    \return The role

    \sa setRole()

*/

AgendaAttendee::ParticipantRole AgendaAttendee::role() const

{

    return d ? d->m_role : ParticipantRoleUnknown;

}

/*!

    Sets the status of the attendee.

    \param status Attendees's status

    \sa status()

 */

void AgendaAttendee::setStatus(AgendaAttendee::StatusType status)

{

    detach();

    d->m_status = status;

}

/*!

    Gets the status of the attendee.

    \return Attendees's status

    \sa status()

 */

AgendaAttendee::StatusType AgendaAttendee::status() const

{

    return d ? d->m_status : StatusUnknown;

}

/*!

    Sets whether or not a response is/was requested for this attendee.

    \param responseRequested True if a response is/was requested, false if not.

    \sa responseRequested()

 */

void AgendaAttendee::setResponseRequested(bool responseRequested)

{

    detach();

    d->m_responseRequested = responseRequested;

}

/*!

    Sets whether or not a response is/was requested for this attendee.

    \return True if a response is/was requested, false if not.

    \sa setResponseRequested()

 */

bool AgendaAttendee::responseRequested() const

{

    return d ? d->m_responseRequested : false;

}

/*!

    Returns true if the attendee is empty; otherwise returns false.

    \return true if the attendee is empty; otherwise returns false.

*/

bool AgendaAttendee::isNull() const

{

    return !d;

}

void AgendaAttendee::detach()

{

    if (!d) {

        d = new AgendaAttendeePrivate;

    } else {

        qAtomicDetach(d);

    }

}

/*!

    Assigns \a other to this attendee and returns a reference

    to this attendee.

    \param other the other attendee

    \return a reference to this attendee

*/

AgendaAttendee& AgendaAttendee::operator=(const AgendaAttendee& other)

{

    if (d == other.d)

    {

        return *this;

    }

    if (other.d)

    {

        other.d->ref.ref();

    }

    if (d && !d->ref.deref())

    {

        delete d;

    }

    d = other.d;

    return *this;

}

/*!

    Returns true if this AgendaAttendee is equal to the \a other

    info, otherwise returns false.

*/

bool AgendaAttendee::operator==(const AgendaAttendee& other) const

{

    if (d == other.d)

        return true;

    return (d->m_address == other.d->m_address

            && d->m_commonName == other.d->m_commonName

            && d->m_responseRequested == other.d->m_responseRequested

            && d->m_role == other.d->m_role

            && d->m_status == other.d->m_status);

}

/*!

    Returns true if this AgendaAttendee is not equal to the \a other

    info, otherwise returns false.

*/

bool AgendaAttendee::operator!=(const AgendaAttendee& other) const

{

    return !(*this == other);

}

AgendaAttendeePrivate::AgendaAttendeePrivate()

    : ref(1)

{

	m_status = AgendaAttendee::StatusConfirmed;

}

/****************************************************

 *

 * AgendaCategory

 *

 ****************************************************/

/*!

    \class AgendaCategory

    \brief Calendar categories can be associated with a calendar entry.

           There are 12 built in category types defined by CategoryType.

           Additionally, it is possible to define extended category

           types which are held as a string.

           Any number of categories can be specified for an entry.

           Calendar entry provides member functions for adding, deleting

           and fetching categories for an entry.

*/

/*!

    \enum AgendaCategory::CategoryType

    This enum defines the possible category types for a AgendaCategory object.

*/

/*! \var AgendaCategory::CategoryType AgendaCategory::AppointmentCategory

    Appointment

*/

/*! \var AgendaCategory::CategoryType AgendaCategory::BusinessCategory

    Business

*/

/*! \var AgendaCategory::CategoryType AgendaCategory::EducationCategory

    Education

*/

/*! \var AgendaCategory::CategoryType AgendaCategory::HolidayCategory

    Holiday

*/

/*! \var AgendaCategory::CategoryType AgendaCategory::MeetingCategory

    Meeting

*/

/*! \var AgendaCategory::CategoryType AgendaCategory::MiscellaneousCategory

    All other types

*/

/*! \var AgendaCategory::CategoryType AgendaCategory::PersonalCategory

    Personal

*/

/*! \var AgendaCategory::CategoryType AgendaCategory::PhoneCallCategory

    Phone call

*/

/*! \var AgendaCategory::CategoryType AgendaCategory::SickDayCategory

    Sick day

*/

/*! \var AgendaCategory::CategoryType AgendaCategory::SpecialOccasionCategory

    Special occasion

*/

/*! \var AgendaCategory::CategoryType AgendaCategory::TravelCategory

    Travel

*/

/*! \var AgendaCategory::CategoryType AgendaCategory::VacationCategory

    Vacation

*/

/*! \var AgendaCategory::CategoryType AgendaCategory::ExtendedCategory

     Extended

*/

/*! \var AgendaCategory::CategoryType AgendaCategory::UnknownCategory

    Unknown

*/

/*!

    Creates a category.

*/

AgendaCategory::AgendaCategory()

    : d(NULL)

{

}

/*!

    Creates a copy of a given category.

   \param other catecory to be copied.

 */

AgendaCategory::AgendaCategory(const AgendaCategory& other) : d(other.d)

{

    if (d) {

        d->ref.ref();

    }

}

/*!

    Constructs a new category using given \a category.

    \param category The type of the category

*/

AgendaCategory::AgendaCategory(AgendaCategory::CategoryType category)

    : d(new AgendaCategoryPrivate)

{

    d->m_categoryType = category;

}

/*!

    Destroys the category.

*/

AgendaCategory::~AgendaCategory()

{

    if (d && !d->ref.deref())

    {

        delete d;

    }

}

/*!

    Sets the category type.

    \param categoryType The category type

    \sa category()

*/

void AgendaCategory::setCategory(AgendaCategory::CategoryType categoryType)

{

    detach();

    d->m_categoryType = categoryType;

}

/*!

    Sets the extended category name.

    \param name The entended category name

    \sa extendedCategoryName()

*/

void AgendaCategory::setExtendedCategoryName(const QString& name)

{

    detach();

    d->m_categoryType = AgendaCategory::ExtendedCategory;

    d->m_extendedCategory = name;

}

/*!

    Gets the extended category name.

    \return The entended category name

    \sa setExtendedCategoryName()

*/

QString AgendaCategory::extendedCategoryName() const

{

    return d ? d->m_extendedCategory : QString();

}

/*!

    Gets the category type.

    \return The category type

    \sa setCategory()

*/

AgendaCategory::CategoryType AgendaCategory::category() const

{

    return d ? d->m_categoryType : UnknownCategory;

}

void AgendaCategory::detach()

{

    if (!d) {

        d = new AgendaCategoryPrivate();

    } else {

        qAtomicDetach(d);

    }

}

/*!

    Assigns \a other to this category and returns a reference

    to this category.

    \param other the other category

    \return a reference to this category

*/

AgendaCategory& AgendaCategory::operator=(const AgendaCategory& other)

{

    if (d == other.d)

    {

        return *this;

    }

    if (other.d)

    {

        other.d->ref.ref();

    }

    if (d && !d->ref.deref())

    {

        delete d;

    }

    d = other.d;

    return *this;

}

/*!

    Returns true if this AgendaCategory is equal to the \a other

    info, otherwise returns false.

*/

bool AgendaCategory::operator==(const AgendaCategory& other) const

{

    if (d == other.d)

        return true;

    return (d->m_categoryType == other.d->m_categoryType