/*

* Copyright (c) 2002-2007 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:  Utility class for meta data gathering for audio files

*

*/

// INCLUDE FILES

#include <e32base.h>

#include <MetaDataUtility.h>

#include <MetaDataFieldContainer.h>

#include "upnpmetadatautility.h"

#include "upnpcommonutils.h"

// ============================ MEMBER FUNCTIONS ============================

// ---------------------------------------------------------------------------

// CUPnPMetaDataUtility::CUPnPMetaDataUtility

// C++ default constructor can NOT contain any code, that

// might leave.

// ---------------------------------------------------------------------------

//

CUPnPMetaDataUtility::CUPnPMetaDataUtility()

    {

    }

// ---------------------------------------------------------------------------

// CUPnPMetaDataUtility::NewL

// Two-phased constructor.

// ---------------------------------------------------------------------------

//

EXPORT_C CUPnPMetaDataUtility* CUPnPMetaDataUtility::NewL()

    {

    CUPnPMetaDataUtility* self = new( ELeave ) CUPnPMetaDataUtility;

    CleanupStack::PushL( self );

    self->ConstructL();

    CleanupStack::Pop();

    return self;

    }

// ---------------------------------------------------------------------------

// CUPnPMetaDataUtility::ConstructL

// Symbian 2nd phase constructor can leave.

// ---------------------------------------------------------------------------

//

void CUPnPMetaDataUtility::ConstructL()

    {

    iMetaDataUtility = CMetaDataUtility::NewL();

    }

// ---------------------------------------------------------------------------

// CUPnPMetaDataUtility::~CUPnPMetaDataUtility()

// Destructor

// ---------------------------------------------------------------------------

//

EXPORT_C CUPnPMetaDataUtility::~CUPnPMetaDataUtility()

    {

    if ( iMetaDataUtility )

        {

        TRAP_IGNORE( iMetaDataUtility->ResetL() );

        }

    delete iArtist;

    delete iAlbum;

    delete iGenre;

    delete iTitle;

    delete iDate;

    delete iMetaDataUtility;        

    }

// --------------------------------------------------------------------------

// CUPnPMetaDataUtility::LoadMetaDataL

// Finds correct MMF controller according to give file name

// (other items were commented in a header).

// --------------------------------------------------------------------------

//

EXPORT_C void CUPnPMetaDataUtility::LoadMetaDataL( const TDesC& aFileName )

    {

    // Cleanup existing information

    Reset();

    RArray<TMetaDataFieldId> wantedFields;

    CleanupClosePushL( wantedFields );

    wantedFields.AppendL( EMetaDataSongTitle );

    wantedFields.AppendL( EMetaDataArtist );

    wantedFields.AppendL( EMetaDataAlbum );

    wantedFields.AppendL( EMetaDataGenre );

    wantedFields.AppendL( EMetaDataDate );

    // Reset to be sure that no allocations are left over

    iMetaDataUtility->ResetL();

    // Open the file

    iMetaDataUtility->OpenFileL( aFileName, wantedFields );

    // wantedFields is not needed anymore

    CleanupStack::PopAndDestroy( &wantedFields );

    // Go through the meta data fields and pick the required ones

    TInt count = iMetaDataUtility->MetaDataCount();

    if ( count > 0 )

        {

        const CMetaDataFieldContainer& container = 

                                        iMetaDataUtility->MetaDataFieldsL();

        TMetaDataFieldId fieldId;

        for ( TInt index = 0; index < count; index++ )

            {

            TPtrC content = container.At( index, fieldId );

            switch ( fieldId )

                {

                case EMetaDataSongTitle:

                    {

                    iTitle = content.AllocL();

                    break;

                    }

                case EMetaDataArtist:

                    {

                    iArtist = content.AllocL();

                    break;

                    }

                case EMetaDataAlbum:

                    {

                    iAlbum = content.AllocL();

                    break;

                    }

                case EMetaDataGenre:

                    {

                    iGenre = content.AllocL();

                    break;

                    }

                case EMetaDataDate:

                    {

                    iDate = content.AllocL();

                    break;

                    }

                default:

                    {

                    // Nothing to do

                    break;

                    }

                }

            }

        }

    if( !iDate )

        {

        // Date was not found from metadata, so get it from file properties

        RFs fs;

        User::LeaveIfError( fs.Connect() );

        CleanupClosePushL( fs );

        RFile file;

        User::LeaveIfError( file.Open( fs,aFileName, EFileRead |

            EFileShareReadersOrWriters ) );

        CleanupClosePushL( file );

        TTime time;

        User::LeaveIfError( file.Modified( time ) );

        iDate = UPnPCommonUtils::TTimeToUPnPDateL( time );

        CleanupStack::PopAndDestroy( &file );        

        CleanupStack::PopAndDestroy( &fs );        

        }

    // Cleanup

    iMetaDataUtility->ResetL();

    }

// --------------------------------------------------------------------------

// CUPnPMetaDataUtility::Title

// Returns title for the song

// (other items were commented in a header).

// --------------------------------------------------------------------------

//

EXPORT_C const TDesC& CUPnPMetaDataUtility::Title() const

    {

    if ( iTitle )

        {

        return *iTitle;

        }

    else

        {

        return KNullDesC;

        }

    }   

// --------------------------------------------------------------------------

// CUPnPMetaDataUtility::Artist

// Returns artist for the song

// (other items were commented in a header).

// --------------------------------------------------------------------------

//

EXPORT_C const TDesC& CUPnPMetaDataUtility::Artist() const

    {

    if ( iArtist )

        {

        return *iArtist;

        }

    else

        {

        return KNullDesC;

        }

    }       

// --------------------------------------------------------------------------

// CUPnPMetaDataUtility::Album

// Returns album for the song

// (other items were commented in a header).

// --------------------------------------------------------------------------

//

EXPORT_C const TDesC& CUPnPMetaDataUtility::Album() const

    {

    if ( iAlbum )

        {

        return *iAlbum;

        }

    else

        {

        return KNullDesC;

        }

    }

// --------------------------------------------------------------------------

// CUPnPMetaDataUtility::Genre

// Returns genre for the song

// (other items were commented in a header).

// --------------------------------------------------------------------------

//

EXPORT_C const TDesC& CUPnPMetaDataUtility::Genre() const

    {

    if ( iGenre )

        {

        return *iGenre;

        }

    else

        {

        return KNullDesC;

        }

    }

// --------------------------------------------------------------------------

// CUPnPMetaDataUtility::Date

// Returns date for the file

// (other items were commented in a header).

// --------------------------------------------------------------------------

//

EXPORT_C const TDesC& CUPnPMetaDataUtility::Date() const

    {

    if ( iDate )

        {

        return *iDate;

        }

    else

        {

        return KNullDesC;

        }

    }

// --------------------------------------------------------------------------

// CUPnPMetaDataUtility::LoadTitleL

// Finds the title(ID3 tag) of the file according to give file name

// (other items were commented in a header).

// --------------------------------------------------------------------------

//

EXPORT_C void CUPnPMetaDataUtility::LoadTitleL( const TDesC& aFileName )

    {

    // Cleanup existing information

    Reset();

    RArray<TMetaDataFieldId> wantedFields;

    CleanupClosePushL( wantedFields );

    wantedFields.Append( EMetaDataSongTitle );

    // Reset to be sure that no allocations are left over

    iMetaDataUtility->ResetL();

    // Open the file

    iMetaDataUtility->OpenFileL( aFileName, wantedFields );

    // wantedFields is not needed anymore

    CleanupStack::PopAndDestroy( &wantedFields );

    // Go through the meta data fields and pick the required ones

    TInt count = iMetaDataUtility->MetaDataCount();

    if ( count > 0 )

        {

        const CMetaDataFieldContainer& container = 

                                        iMetaDataUtility->MetaDataFieldsL();

        TMetaDataFieldId fieldId;

        for ( TInt index = 0; index < count; index++ )

            {

            TPtrC content = container.At( index, fieldId );

            if ( EMetaDataSongTitle == fieldId )

                {

                iTitle = content.AllocL();

                break;

                }

            }

        }

    // Cleanup

    iMetaDataUtility->ResetL();

    }

// ---------------------------------------------------------------------------

// CUPnPMetaDataUtility::Reset

// Reset member variables

// (other items were commented in a header).

// ---------------------------------------------------------------------------

//

void CUPnPMetaDataUtility::Reset()

    {

    delete iTitle;

    iTitle = NULL;

    delete iArtist;

    iArtist = NULL;

    delete iAlbum;

    iAlbum = NULL;

    delete iGenre;

    iGenre = NULL;

    delete iDate;

    iDate = NULL;

    }

//  End of File