tzservices/tzloc/inc/TzLocalizationResourceReader.h
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Tue, 02 Feb 2010 10:12:00 +0200
changeset 0 2e3d3ce01487
permissions -rw-r--r--
Revision: 201002 Kit: 201005

// Copyright (c) 2004-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:
//

#ifndef __TZLOCAL_RESOURCE_READER_H__
#define __TZLOCAL_RESOURCE_READER_H__

#include "TzLocalizationDataTypes.h"
#include <barsc.h>		// RResourceFile
#include <barsread.h>	// TResourceReader
#include <f32file.h>	// RFs

/**
Concrete implementation of MTzLocalizationReader
Reads Localized time zone information and city information from resource files
@internalTechnology
*/
class CTzLocalizationResourceReader : public CBase
	{
		//enums
/**
Enum to get to the various resources in the resource files. These can be added
to the offset returned by RResourceFile::Offset() to get the relevant resource
ID
*/
	enum TTzResourceOffset
		{
/**
Offset of the RSS Signature, this is always the first resource, so the enum
starts at 1.
*/
		ETzRssSignature = 1,
/**
Offset of the first localized resource. In the time zones resource file, this
is the default cached zones resource, in the groups resource files, this is the
first group.
*/
		ETzFirstLocalizedResource,
/**
Offset of the first localized time zone resource. This simply allows the
default cached zones resource to be skipped over in the time zones resource
file.
*/
		ETzFirstTimeZoneResource
		};

	public:
		CTzLocalizedTimeZone* ReadTimeZoneL(const TInt aTimeZoneId);
		CTzLocalizedTimeZone* ReadTimeZoneL(const TTzLocalizedId& aTzLocalizedId);
		void ReadAllTimeZonesL(CTzLocalizedTimeZoneArray& aTimeZones);
		void ReadCitiesL(CTzLocalizedCityArray& aCities);
		void ReadCitiesL(CTzLocalizedCityArray& aCities, const TInt aTimeZoneId);
		void ReadCitiesL(CTzLocalizedCityArray& aCities, const TTzLocalizedId& aTzLocalizedId);
		void ReadCitiesInGroupL(CTzLocalizedCityArray& aCities, const TUint8 aGroupId);
		void ReadAllGroupsL(CTzLocalizedCityGroupArray& aGroups);
		CTzLocalizedCityGroup* ReadGroupL(const TUint8 aGroupId);
		CTzLocalizedCity* ReadDefaultCityL(const TInt aTimeZoneId);
		CTzLocalizedCity* ReadDefaultCityL(const TTzLocalizedId& aTzLocalizedId);
		CTzLocalizedTimeZone* ReadFrequentlyUsedZoneL(const CTzLocalizedTimeZone::TTzFrequentlyUsedZone aFrequentlyUsedZone);
		CTzLocalizedCity* ReadCachedTimeZoneCityL(const CTzLocalizedTimeZone::TTzFrequentlyUsedZone aFrequentlyUsedZone);

		//New Functions
		static CTzLocalizationResourceReader* NewL();
		static CTzLocalizationResourceReader* NewLC();
		~CTzLocalizationResourceReader();

	private:
		void ConstructL();
		TInt FindTimeZoneResourceIdL(const TInt aTimeZoneId);
		TInt LocalizedResourceIdL(const RResourceFile& aResourceFile, const TTzResourceOffset aOffset);
		TInt FirstTimeZoneResourceIdL();
		TInt FirstGroupResourceIdL();
		TInt CachedTimeZoneResourceIdL();
		void BufferResourceL(const RResourceFile& aResourceFile, const TInt aResourceId);
		void ResetResourceBuffer();
		CTzLocalizedTimeZone* DoReadTimeZoneL(const TInt aResourceId);
		CTzLocalizedTimeZone* CreateTimeZoneFromResourceL(const TInt aResourceId);
		void DoReadCitiesL(CTzLocalizedCityArray& aCities, const TInt aResourceId);
		void AddCityArrayFromResourceL(CTzLocalizedCityArray& aCities, const TInt aResourceId);
		CTzLocalizedCityGroup* DoReadGroupL(const TInt aResourceId);
		CTzLocalizedCityGroup* CreateGroupFromResourceL();

	private:
		RFs iFs;
		RResourceFile iTimeZoneResourceFile;
		RResourceFile iGroupResourceFile;
		TBool iGroupResourceFileExists;
		TResourceReader iResourceReader;
		HBufC8* iResourceBuffer;
	};

#endif //__TZLOCAL_RESOURCE_READER_H__