/*
* Copyright (c) 2007-2008 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 C_HNMDLOCALIZATION_H
#define C_HNMDLOCALIZATION_H


#include <e32base.h>
#include <xmlengelement.h> 

class CHnMdLocalizationElement;
class CCoeEnv;

/**
 * Localization.
 * 
 * This class is designed to support localization.
 *
 * @since S60 5.0
 * @ingroup group_hnmetadatamodel
 */
NONSHARABLE_CLASS(CHnMdLocalization) : public CBase
    {
public:

    /**
     * Two-phase constructor.
     *
     * @since S60 5.0
     * @return Fully constructed object.
     */
    static CHnMdLocalization* NewL();

    /**
     * Two-phase constructor.
     *
     * @since S60 5.0
     * @return Fully constructed object.
     */
    static CHnMdLocalization* NewLC();

    /**
     * Standard C++ virtual destructor.
     *
     * @since S60 5.0
     */
    virtual ~CHnMdLocalization();
    
    /**
     * Appends localizations.
     *
     * @since S60 5.0
     * @param aElement Xml element.
     */
    void AppendLocalizationsL( TXmlEngElement aElement );

    /**
     * Gets element by name.
     *
     * @since S60 5.0
     * @param aNamespace Namespace.
     * @return Localization element.
     */
    const CHnMdLocalizationElement* ElementByNamespace(
            const TDesC& aNamespace ) const;
            
    /**
     * Loads resource.
     * Resources can be defined in formats 
     * @code <namespace>:<id> @endcode
     * Namespaces can be defined by localization elements,
     * but can also point to rsg file.
     * Id can be rsg constants, but it can be also numbers.
     *
     * @since S60 5.0
     * @param aResourceName Resource name.
     * @param aDesParams descriptor parameters to format %U, %0U.
     * @param aIntParams integer parameters to format %N, %0N.* 
     * @return Descriptor.
     */
     HBufC* LoadL( const TDesC& aResourceName, 
                   const CDesC16Array* aDesParams, 
                   const CArrayFix<TInt>* aIntParams );
private:

    /**
     * Standard C++ constructor.
     *
     * @since S60 5.0
     */
    CHnMdLocalization();

    /**
     * Standard symbian 2nd pahse constructor.
     *
     * @since S60 5.0
     */
    void ConstructL();
    
    /**
     * Appends element the list of localization elements, it also checks for duplicates
     * if it is RSC file it load the file in CoeEnv
     * 
     * @param aElement element to add, ownership is taken
     *      if element with the same namespace exists element is ignored
     *
     * @since S60 5.0
     */
    void AppendElementL( CHnMdLocalizationElement*  aElement );

    /**
     * Check extension of file and decide it is a resource file
     * 
     * @param aFilename file name to check 
     * @return ETrue if it is rsc file, else EFalse
     */
    TBool IsResourceFile( const TDesC&  aFilename );
        
    /**
     * Formats text.
     * 
     * @since S60 5.0
     * @param aTextToFormat A text to format.
     * @param aDesParams Parameters of the text to be formated.
     * @param aIntParams Integer parameters of the text to be formated.
     */
    HBufC* FormatTextL( const TDesC& aTextToFormat,
                        const CDesC16Array* aDesParams, 
                        const CArrayFix<TInt>* aIntParams );
    
    /**
     * Checks whether the localization element identified by a namespace is
     * duplicated.
     *
     * @param aNamespace Namespace.
     */
    TBool IsDuplicateL( TDesC8& aNamespace );
    
    /**
     * Checks whether the localization element identified by a namespace is
     * duplicated.
     *
     * @param aNamespace Namespace.
     */
    TBool IsDuplicateL( TDesC& aNamespace );
    
    /**
     * Checks whether the localization element identified by a namespace is
     * internal.
     *
     * @param aName Name.
     */
    TBool IsInternalL( const TDesC& aName );
    
private: // data

    /**
     * CoeEnv.
     * Not own.
     */
    CCoeEnv* iCoeEnv;

    /**
     * Own - Internal offset.
     */
    RArray< TInt > iInternalOffset;
    
    /**
     * Own - Internal localization.
     */
    RPointerArray<CHnMdLocalizationElement> iInternalLocalization;

    };

#endif // C_HNMMLOCALIZATION_H