/*
* Copyright (c) 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:  A class for creating country and city tags for media files.
*
*/


#ifndef C_TAGCREATOR_H
#define C_TAGCREATOR_H

#include "mdesession.h"
#include "mdenamespacedef.h"
#include <mdeconstants.h>

/**
 *
 *  @since S60 9.2
 */
class CTagCreator : public CBase
    {
public:  
    /**
     * 2-phased constructor.
     */
    IMPORT_C static CTagCreator* NewL( );

    /**
     * C++ destructor.
     */    
    IMPORT_C virtual ~CTagCreator();
    
    /**
     * Attach country and city tags to an image file/object.
     * @param aObjectId, object Id for image/video to be tagged.
     * @param aCountryTagId, a country tag Id.
     * @param aCityTagId, a city tag Id.
	   * @return None.
     */
   IMPORT_C void AttachTagsL( const TUint32 aObjectId, const TItemId aCountryTagId, 
                              const TItemId aCityTagId );
    /**
     * Creates country and city tags.
     * @param aCountry, a country name.
     * @param aCountryTagId, reference to a country tag Id.
     * @param aCity, a city name.
     * @param aCityTagId, a reference to a city tag Id.
	   * @return None.
     */
    IMPORT_C void CreateLocationTagsL( const TPtrC& aCountry, TItemId& aCountryTagId, 
                                      const TPtrC& aCity, TItemId& aCityTagId );

	/**
	  * Sets the CMdESession for tag creation
	  * @param aSession  the CMdESession object
	  */
    IMPORT_C void SetSession( CMdESession* aSession );

public:

	/**
	  * Creates a tag for the country
	  * @param aCountry country name
	  * @param aCity city name
	  * @param aCountryTagId   The country tag Id
	  */    
    void CreateTagForCountryL( const TPtrC& aCountry, 
                TItemId& aCountryTagId );

	/**
	  * Creates a tag for the city
	  * @param aCountry The country name
	  * @param aCity   The city name
	  *	@param aCityTagId  The city tag Id
	  */		
    void CreateTagForCityL( const TPtrC& aCountry, const TPtrC& aCity, TItemId& aCityTagId);
    
private:
    /**
     * C++ constructor.
     */  
    CTagCreator( );
    
    /**
     * 2nd phase constructor.
     */
    void ConstructL();

	/**
	  * Creates a tag object and adds it to the database
	  * @param aTitle  The title associated with the tag
	  * @param aUri  The uri associated with the tag
	  * @return The itemId of the newly created tag in the database	
	  */	
    TUint32 CreateTagL( const TPtrC& aTitle, 
        const TPtrC& aUri, 
        MdeConstants::Tag::TTagType aTagType );
	/**
	  * Finds if a tag with the given uri exists
	  * @param  aUri The uri by which the tag is to be searched
	  * @return  The ItemId of the tag if it exists,0 otherwise
	  */	
    
    TUint32 TagExistsL( const TPtrC& aUri  );
    
private:

	/**
	  *  iMdeSession
	  *  an instance of the CMdESession 
	  */		
    CMdESession* iMdeSession;
    
    };

#endif // C_TAGCREATOR_H

// End of file.