pimappservices/calendar/client/src/caldataexchange.cpp
changeset 0 f979ecb2b13e
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/pimappservices/calendar/client/src/caldataexchange.cpp	Tue Feb 02 10:12:19 2010 +0200
@@ -0,0 +1,172 @@
+// Copyright (c) 2005-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 <caldataexchange.h>
+#include "caldataexchangeimpl.h"
+
+/** Destructor
+@publishedAll
+@released
+@capability None
+*/
+EXPORT_C CCalDataExchange::~CCalDataExchange()
+	{
+	delete iImpl;
+	}
+
+CCalDataExchange::CCalDataExchange()
+	{
+	}
+	
+void CCalDataExchange::ConstructL(CCalSession& aSession)
+	{
+	iImpl = new (ELeave) CCalDataExchangeImpl(aSession);
+	}
+	
+/** Allocates and constructs a CCalDataExchange object.
+@publishedAll
+@released
+@capability None
+@param aSession The handle to the calender session.
+@return A pointer to the new synchronisation object.
+*/		
+EXPORT_C CCalDataExchange* CCalDataExchange::NewL(CCalSession& aSession)	
+	{
+	CCalDataExchange* self = new (ELeave) CCalDataExchange();
+	CleanupStack::PushL(self);
+	self->ConstructL(aSession);
+	CleanupStack::Pop(self);
+	return self;
+	}
+
+
+/** Imports data of aDataFormat type and returns an array of CCalEntries corresponding to this data
+
+Currently only VCal 1.0 (with extensions) is supported.
+The vCalendar is read from the read stream specified and its entities are converted 
+into CCalEntries and passed back in the array parameter aCalEntryArray.
+@publishedAll
+@released
+@capability WriteUserData
+@param aDataFormat Specifies the format of the data to be imported.  Currently this must be KUidVCalendar (see CalDataFormat.h)
+@param aReadStream The read stream which contains the (vCalendar) data.
+@param aCalEntryArray On return, a list of the calender entries which were imported. 
+The list contains the vEvents followed by the vTodos
+and are specific to the data format
+*/
+EXPORT_C void CCalDataExchange::ImportL(TUid aDataFormat, RReadStream& aReadStream, RPointerArray<CCalEntry>& aCalEntryArray)
+	{
+	iImpl->ImportL(aDataFormat, aReadStream, aCalEntryArray);
+	}  
+	
+/** Imports data of aDataFormat type and returns an array of CCalEntries corresponding to this data
+
+Currently only VCal 1.0 (with extensions) is supported.
+The vCalendar is read from the read stream specified and its entities are converted 
+into CCalEntries and passed back in the array parameter aCalEntryArray.
+@publishedAll
+@released
+@capability WriteUserData
+@param aDataFormat Specifies the format of the data to be imported.  Currently this must be KUidVCalendar (see CalDataFormat.h)
+@param aReadStream The read stream which contains the (vCalendar) data.
+@param aCalEntryArray On return, a list of the calender entries which were imported. 
+The list contains the vEvents followed by the vTodos
+and are specific to the data format
+@param aFlags controls the behaviour of the parser during the import process.
+*/
+EXPORT_C void CCalDataExchange::ImportL(TUid aDataFormat, RReadStream& aReadStream, RPointerArray<CCalEntry>& aCalEntryArray, TInt aFlags)
+	{
+	iImpl->ImportL(aDataFormat, aReadStream, aCalEntryArray, aFlags);
+	}   
+	
+/** Imports data of aDataFormat type and returns an array of a selected number of CCalEntries corresponding to this data.
+
+Currently only VCal 1.0 (with extensions) is supported.
+The vCalendar is read from the read stream specified and its entities are converted 
+into CCalEntries and passed back in the array parameter aCalEntryArray.
+@publishedAll
+@released
+@capability WriteUserData
+@param aDataFormat Specifies the format of the data to be imported.  Currently this must be KUidVCalendar (see CalDataFormat.h)
+@param aReadStream The read stream which contains the (vCalendar) data.
+@param aCalEntryArray On return, a list of the calender entries which were imported. 
+The list contains the vEvents followed by the vTodos
+and are specific to the data format
+@param aFlags controls the behaviour of the parser during the import process.
+@param aNumEntries Specifies how many entries are to be imported at once.
+*/
+EXPORT_C void CCalDataExchange::ImportL(TUid aDataFormat, RReadStream& aReadStream, RPointerArray<CCalEntry>& aCalEntryArray, TInt aFlags, TInt aNumEntries)
+	{
+	iImpl->ImportL(aDataFormat, aReadStream, aCalEntryArray, aFlags, aNumEntries);
+	}
+	
+/** Exports data of aDataFormat type from an array of CCalEntries corresponding to this data
+
+Currently only VCal 1.0 (with extensions) is supported.
+The entry is exported either as a vTodo (if it is a to-do), or as a vEvent. The exported 
+property values are converted from Unicode into the character set indicated by the last 
+parameter (UTF-8 by default).
+@publishedAll
+@released
+@capability ReadUserData
+@param aDataFormat Specifies the format of the data to be exported.  Currently this must be KUidVCalendar (see CalDataFormat.h)
+@param aWriteStream The stream to which the calender entries should be externalised.
+@param aCalEntryArray The array of calender entries to export. 
+*/	
+EXPORT_C void CCalDataExchange::ExportL(TUid aDataFormat, RWriteStream& aWriteStream, RPointerArray<CCalEntry>& aCalEntryArray)
+	{
+	iImpl->ExportL(aDataFormat, aWriteStream, aCalEntryArray);
+	}
+	
+/** Asynchronously imports data of aDataFormat type and returns an array of CCalEntries corresponding to this data
+
+Currently only VCal 1.0 (with extensions) is supported.
+The vCalendar is read from the read stream specified and its entities are converted 
+into CCalEntries and passed back in the array parameter aCalEntryArray.
+@publishedAll
+@released
+@capability WriteUserData
+@param aDataFormat Specifies the format of the data to be imported.  Currently this must be KUidVCalendar (see CalDataFormat.h)
+@param aReadStream The read stream which contains the (vCalendar) data.
+@param aCalEntryArray On return, a list of the calender entries which were imported. 
+The list contains the vEvents followed by the vTodos
+and are specific to the data format
+@param aObserver Callback class to indicate the progress of the import and when it has completed.
+@param aFlags controls the behaviour of the parser during the import process.
+*/
+EXPORT_C void CCalDataExchange::ImportAsyncL(TUid aDataFormat, RReadStream& aReadStream, RPointerArray<CCalEntry>& aCalEntryArray, MCalDataExchangeCallBack& aObserver, TInt aFlags)
+	{	
+	iImpl->ImportAsyncL(aDataFormat, aReadStream, aCalEntryArray, aObserver, aFlags);
+	}
+
+/** Asynchronously exports data of aDataFormat type from an array of CCalEntries corresponding to this data
+
+Currently only VCal 1.0 (with extensions) is supported.
+The entry is exported either as a vTodo (if it is a to-do), or as a vEvent. The exported 
+property values are converted from Unicode into the character set indicated by the last 
+parameter (UTF-8 by default).
+@publishedAll
+@released
+@capability ReadUserData
+@param aDataFormat Specifies the format of the data to be exported.  Currently this must be KUidVCalendar (see CalDataFormat.h)
+@param aWriteStream The stream to which the calender entries should be externalised.
+@param aCalEntryArray The array of calender entries to export. 
+@param aObserver Callback class to indicate the progress of the import and when it has completed.
+*/	
+EXPORT_C void CCalDataExchange::ExportAsyncL(TUid aDataFormat, RWriteStream& aWriteStream, RPointerArray<CCalEntry>& aCalEntryArray, MCalDataExchangeCallBack& aObserver)
+	{
+	iImpl->ExportAsyncL(aDataFormat, aWriteStream, aCalEntryArray, aObserver);
+	}
+