// Copyright (c) 2003-2009 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 <ecom/ecom.h>

#include <xml/stringdictionarycollection.h>

#include "stringdictionarycollectionimpl.h"

using namespace Xml;

EXPORT_C RStringDictionaryCollection::RStringDictionaryCollection()

/**

Default constructor

@post				This object is properly constructed.

*/

:	iImpl(NULL)

	{

	// do nothing;

	}

void RStringDictionaryCollection::CreateImplL()

/**

Create the implementation object.

@pre				The object has just been constructed but not opened.

@post				The object is fully constructed and ready to be used.

*/

	{

	if (!iImpl)

		{

		iImpl = new (ELeave) RStringDictionaryCollectionImpl;

		}

	}

EXPORT_C void RStringDictionaryCollection::OpenL()

/**

This method opens this resource incrementing the reference count.

It must be the first method called after construction.

@post				The object is ready to be used.

*/

	{

	CreateImplL();

	iImpl->OpenL();

	}

EXPORT_C void RStringDictionaryCollection::Close()

/**

This method cleans up the object before destruction. It releases all resources in

accordance to the R Class pattern.

@post				This object may be allowed to go out of scope.

*/

	{

	if (iImpl)

		{

		if (iImpl->Close() == 0)

			{

			delete iImpl;

			iImpl = NULL;

			}

		}

	}

EXPORT_C void RStringDictionaryCollection::OpenDictionaryL(const TDesC8& aDictionaryDescription)

/**

This method loads the Dictionary.

@pre				Connect has been called.

@post				The Dictionary has been loaded.

@param				aDictionaryDescription The Namepspace MIME type.

*/

	{

	iImpl->OpenDictionaryL(aDictionaryDescription);

	}

EXPORT_C RStringPool& RStringDictionaryCollection::StringPool()

/**

This method obtains a handle to the RStringPool

@return				the RStringPool

*/

	{

	return iImpl->StringPool();

	}

EXPORT_C MStringDictionary& RStringDictionaryCollection::CurrentDictionaryL() const

/**

This method obtains the current string dictionary in use.

Also, serves as a way to test if any dictionaries have been loaded as none needs be.

@return				the current Dictionary in use, if any.

@leave 				KErrXmlMissingStringDictionary if there is no dictionary

*/

	{

	return iImpl->CurrentDictionaryL();

	}