/*

* Copyright (c) 2002-2004 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: This file implements class CESMRICalBase.

*

*/

// Class include.

#include "emailtrace.h"

#include "cesmricalbase.h"	// CESMRICalBase

//debug

// User includes.

#include "cesmricalcomponent.h"			// CESMRICalComponent

#include "cesmricalcontentlinereader.h"	// CESMRICalContentLineReader

#include "cesmricalcontentlinewriter.h"	// CESMRICalContentLineWriter

#include "esmricalerrors.h"				// Error codes

#include "esmricalkeywords.h"			// Literals

#include "cesmricalproperty.h"			// CESMRICalProperty

#include "esmricalutil.h"				// NESMRICalUtil

#include "cesmricalvalue.h"				// CESMRICalValue

using namespace NESMRICalUtil;

/**

Destructor.

@internalTechnology

*/

CESMRICalBase::~CESMRICalBase()

	{

    FUNC_LOG;

	iComponents.ResetAndDestroy();

	iProperties.ResetAndDestroy();

	}

/**

Creates a new property with a value from the given parameters, adds it to 

this object and returns a modifiable reference to it.

@param aName Name of the property to add.

@param aValue Value of the property to add.

@return A reference to a new property owned by this object.

@leave Leaves with KErrUnsupportedProperty if the given property is not valid.

for this component.

@publishedPartner

*/

EXPORT_C CESMRICalProperty& CESMRICalBase::AddPropertyL(const TDesC& aName, const TDesC& aValue)

	{

    FUNC_LOG;

	CESMRICalProperty* property = CreatePropertyL(aName);	// Not taking ownership.

	if (!property)

		{

		User::Leave(KErrUnsupportedProperty);	

		}

	property->AddValueL(aValue);

	return *property;

	}

/**

Creates a new property with a value and adds it to this object, returning a

reference to it. Ownership of aValue is transferred and it will be deleted if

this function leaves.

@leave Leaves with KErrPropertyHasNoValue if aValue is Null.

@leave Leaves with KErrUnsupportedProperty if the given property is not valid.

@return A new property

@publishedPartner

*/

EXPORT_C CESMRICalProperty& CESMRICalBase::AddPropertyL(const TDesC& aName, CESMRICalValue* aValue)

	{

    FUNC_LOG;

	if (!aValue)

		{

		User::Leave(KErrPropertyHasNoValue);

		}

	CleanupStack::PushL(aValue);

	CESMRICalProperty* property = CreatePropertyL(aName);	// Not taking ownership.

	if (!property)

		{

		User::Leave(KErrUnsupportedProperty);	

		}

	CleanupStack::Pop(aValue);

	property->AddValueL(aValue);

	return *property;

	}

/**

Creates a new component, adds it to this object, and returns a modifiable

reference to it.

@param aType The type of component to be created.

@return A new component

@leave Leaves with KErrUnsupportedComponent if the given component is not a

valid subcomponent for this object.

@publishedPartner

*/

EXPORT_C CESMRICalComponent& CESMRICalBase::AddComponentL(TICalComponentType aType)

	{

    FUNC_LOG;

	CESMRICalComponent* component = CreateComponentL(aType);	// Not taking ownership.

	if (!component)

		{

		User::Leave(KErrUnsupportedComponent);

		}

	return *component;

	}

/**

Access function for the component array.

@return The array of components as a constant reference.

@publishedPartner

*/

EXPORT_C const RPointerArray<CESMRICalComponent>& CESMRICalBase::Components() const

	{

	return iComponents; 

	}

/**

Access function for the property array.

@return The array of properties as a constant reference.

@publishedPartner

*/

EXPORT_C const RPointerArray<CESMRICalProperty>& CESMRICalBase::Properties() const

	{

	return iProperties;

	}

/**

Returns the descriptor form of this component type.

@return The descriptor form of this component type.

@publishedPartner

*/

EXPORT_C const TDesC& CESMRICalBase::TypeStringL() const

	{

    FUNC_LOG;

	return TypeStringL(iComponentType);

	}

/**

Access method returning the concrete type as an enumeration.

@return The type of the concrete derived class.

@publishedPartner

*/

EXPORT_C CESMRICalBase::TICalComponentType CESMRICalBase::Type() const

	{

    FUNC_LOG;

	return iComponentType;

	}

/**

Checks for a component already existing in current object's sub-components

@param aType The type of the component to check.

@return ETrue if the property does exist, EFalse otherwise

@publishedPartner

*/

EXPORT_C TBool CESMRICalBase::ComponentExists(TICalComponentType aType) const

	{

    FUNC_LOG;

	const TInt count = iComponents.Count();

	for (TInt i = 0; i < count; i++)

		{

		if (iComponents[i]->Type() == aType)

			{

			return ETrue;

			}

		}

	return EFalse;

	}

/**

Finds the first property with a particular name and returns a pointer to it.

Ownership is not passed out.

@param aName The name of the property to search for.

@return A pointer to the property, or NULL.

@publishedPartner

*/

EXPORT_C const CESMRICalProperty* CESMRICalBase::FindProperty(const TDesC& aName) const

	{

    FUNC_LOG;

	const TInt count = iProperties.Count();

	for (TInt p = 0; p < count; ++p)

		{

		if (iProperties[p]->Type().CompareF(aName) == 0)

			{

			return iProperties[p];

			}

		}

	return NULL;

	}

/**

Takes a line reader and reads lines from it until the end of the component is

located. Any other END:, or an end of file, are treated as errors.

@param aReader The line reader to read from.

@leave Leaves with KErrCorrupt if the component is corrupt.

@internalTechnology

*/

void CESMRICalBase::InternalizeL(CESMRICalContentLineReader& aReader)

	{

    FUNC_LOG;

	TPtrC line;

	TPtrC name;

	TPtrC parameters;

	TPtrC values;

	TInt error(aReader.GetNextContentLine(line));

	while (error == KErrNone)

		{

		if (ExtractSectionsL(line, name, parameters, values) == KErrNone)

			{	

			if (name.CompareF(KICalBegin) == 0)

				{

				// This is the start of a component:

				TICalComponentType type(TypeFromNameL(values));

				if (type == EICalInvalid)

					{

					aReader.SkipComponentL(values);

					}

				else

					{

					CESMRICalComponent* component = CreateComponentL(type);	// Not taking ownership.

					if (component)

						{

						component->InternalizeL(aReader);	

						}

					else

						{

						// This component cannot be nested - ignore it

						aReader.SkipComponentL(values);

						}

					}

				}

			else if (name.CompareF(KICalEnd) == 0)

				{

				// This is the end of a component.

				if (values.CompareF(TypeStringL(iComponentType)) != 0)

					{

					User::Leave(KErrCorrupt);	// This is the end of a different component

					}

				break;

				}

			else

				{

				// This is a property

				// Only allow properties with at least one value - if there is no value then

				// ignore the property and continue.

				if (values.Length() > 0)

					{	

					CESMRICalProperty* property = CreatePropertyL(name); // Not taking ownership

					if (property)

						{

						if (name.CompareF(KICalRRule) == 0)

							{

							// This is a special case - commas have a different meaning.

							ExtractParametersL(parameters, *property);

							property->AddValueL(values);

							}

						else if (name.CompareF(KICalCategories) == 0)

							{

							// Outlook escapes the comma separators between categories.

							// This is not part of the iCal specification.

							ExtractParametersL(parameters, *property);

							ExtractPropertyValuesL(values, *property, EEscapeValueSeparators);

							}

						else if (name.CompareF(KICalTzid) == 0)

							{

							// Outlook doesn't escape commas in TZID fields.

							// This is not part of the iCal specification.

							ExtractParametersL(parameters, *property);

							property->AddValueL(values);

							}

						else

							{

							ExtractPropertyL(parameters, values, *property);

							}

						// Remove property if it doesn't have a value.

						if (property->Values().Count() == 0)

							{

							TInt index(iProperties.Find(property));

							if (index >= 0)

								{

								iProperties.Remove(index);

								}

							delete property;

							}

						else

							{

							// If the property is a method, remember it.

							if (name.CompareF(KICalMethod) == 0)

								{

								TPtrC val;

								val.Set(property->Values()[0]->TextL());

								if (val.CompareF(KICalPublish) == 0)

									{

									iMethod = CESMRICalBase::EMethodPublish;

									}

								else if (val.CompareF(KICalRequest) == 0)

									{

									iMethod = CESMRICalBase::EMethodRequest;

									}

								else if (val.CompareF(KICalReply) == 0)

									{

									iMethod = CESMRICalBase::EMethodReply;

									}

								else if (val.CompareF(KICalAdd) == 0)

									{

									iMethod = CESMRICalBase::EMethodAdd;

									}

								else if (val.CompareF(KICalCancel) == 0)

									{

									iMethod = CESMRICalBase::EMethodCancel;

									}

								else if (val.CompareF(KICalRefresh) == 0)

									{

									iMethod = CESMRICalBase::EMethodRefresh;

									}

								else if (val.CompareF(KICalCounter) == 0)

									{

									iMethod = CESMRICalBase::EMethodCounter;

									}

								else if (val.CompareF(KICalDeclineCounter) == 0)

									{

									iMethod = CESMRICalBase::EMethodDeclineCounter;

									}

								else

									{

									User::Leave(KErrCorrupt);

									}

								}

							}

						}

					}

				}

			}

		error = aReader.GetNextContentLine(line);

		}

	if ((error != KErrNone) && (error != KErrEof))

		{

		User::Leave(error);

		}

	}

/**

Takes a line writer and exports this component, including all owned properties

and sub components, to it.

@param aWriter the writer to export to.

@internalTechnology

*/

void CESMRICalBase::ExternalizeL(CESMRICalContentLineWriter& aWriter) const

	{

    FUNC_LOG;

	aWriter.AppendL(KICalBegin());

	aWriter.AppendL(KICalColon());

	aWriter.AppendL(TypeStringL(iComponentType));

	aWriter.WriteContentLineL();

	// Externalize any component properties:

	TInt count(iProperties.Count());

	for (TInt prop = 0; prop < count; ++prop)

		{

		// Only externalise properties with a value.

		if (iProperties[prop]->Values().Count() > 0)

			{

			iProperties[prop]->ExternalizeL(aWriter);

			}

		}

	// Externalize any child components:	

	count = iComponents.Count();

	for (TInt comp = 0; comp < count; ++comp)

		{

		iComponents[comp]->ExternalizeL(aWriter);

		}

	aWriter.AppendL(KICalEnd());

	aWriter.AppendL(KICalColon());

	aWriter.AppendL(TypeStringL(iComponentType));

	aWriter.WriteContentLineL();

	}

/**

Converts between a TICalComponentType and the type as a descriptor. 

@param aName The type as a descriptor.

@return The type as an enumeration.

@leave KErrCorrupt if this is not a valid type.

@internalTechnology

*/

CESMRICalBase::TICalComponentType CESMRICalBase::TypeFromNameL(const TDesC& aName)

	{

    FUNC_LOG;

	TICalComponentType type(EICalInvalid);

	if (aName.CompareF(KICalVCalendar) == 0)

		{

		type = EICalCalendar;

		}

	else if (aName.CompareF(KICalEvent) == 0)

		{

		type = EICalEvent;

		}

	else if (aName.CompareF(KICalTodo) == 0)

		{

		type = EICalTodo;

		}

	else if (aName.CompareF(KICalJournal) == 0)

		{

		type = EICalJournal;

		}

	else if (aName.CompareF(KICalAlarm) == 0)

		{

		type = EICalAlarm;

		}

	else if (aName.CompareF(KICalTimeZone) == 0)

		{

		type = EICalTimeZone;

		}

	else if (aName.CompareF(KICalFreeBusy) == 0)

		{

		type = EICalFreeBusy;

		}

	else if (aName.CompareF(KICalStandard) == 0)

		{

		type = EICalStandard;

		}

	else if (aName.CompareF(KICalDaylight) == 0)

		{

		type = EICalDaylight;

		}

	else

		{

		type = EICalInvalid;

		}

	return type;

	}

/**

Constructor

@internalTechnology

*/

CESMRICalBase::CESMRICalBase()

	{

    FUNC_LOG;

	}

/**

Converts between a TICalComponentType and the type as a descriptor.

@param aType The type as an enumeration.

@return The type as a descriptor.

@leave KErrCorrupt if this is not a valid type.

@internalTechnology

*/

const TDesC& CESMRICalBase::TypeStringL(TICalComponentType aType) const

	{

    FUNC_LOG;

	switch (aType)

		{

		case EICalCalendar:

			return KICalVCalendar();

		case EICalEvent:

			return KICalEvent();

		case EICalJournal:

			return KICalJournal();

		case EICalAlarm:

			return KICalAlarm();

		case EICalFreeBusy:

			return KICalFreeBusy();

		case EICalTodo:

			return KICalTodo();

		case EICalTimeZone:

			return KICalTimeZone();

		case EICalStandard:

			return KICalStandard();

		case EICalDaylight:

			return KICalDaylight();

		case EICalInvalid:

			// Fall through...

		default:

			User::Leave(KErrCorrupt);

			break;	

		};

	return KNullDesC;	// Never reached.

	}