1 /*

     2  * Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).

     3  * All rights reserved.

     4  * This component and the accompanying materials are made available

     5  * under the terms of "Eclipse Public License v1.0"

     6  * which accompanies this distribution, and is available

     7  * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8  *

     9  * Initial Contributors:

    10  * Nokia Corporation - initial contribution.

    11  *

    12  * Contributors:

    13  *

    14  * Description: Metadata backend engine

    15  *

    16  */

    17 

    18 #ifndef CMETADATA_UTILITY_ITF_H

    19 #define CMETADATA_UTILITY_ITF_H

    20 

    21 #ifdef __cplusplus

    22 

    23 #include <e32base.h>

    24 #include <e32std.h>

    25 #include <e32hashtab.h>

    26 #include <openmaxalwrapper.h>

    27 

    28 #include <hxmetadatautil.h>

    29 #include <MetaDataUtility.h>

    30 #include <MetaDataFieldContainer.h>

    31 #include <MetaDataField.hrh>

    32 

    33 #define MAX_EXTENSION_SIZE 10

    34 #define uint32 unsigned int

    35 

    36 class CS60MetadataUtilityItf;

    37 class CHXMetadataUtilityItf;

    38 

    39 NONSHARABLE_CLASS(CMetadataUtilityItf)

    40     {

    41 public:

    42 

    43     enum TValueEncodingType

    44         {

    45         EUnknownEncoding, EAsciiEncoding, EUnicodeEncoding, EBinaryEncoding,

    46         };

    47 

    48     static CMetadataUtilityItf* New(char* uri);

    49 

    50     CMetadataUtilityItf();

    51     virtual ~CMetadataUtilityItf();

    52     TInt ParseSource(char* uri);

    53     TInt OpenSource(char* uri);

    54     TInt CalculateNumMetadataItems(TUint*);

    55     char* GetKey(TInt index);

    56     TInt GetValueSize(TInt index);

    57     TInt GetValue(TInt index, char* data, TInt maxLength, TInt* outSize,

    58             TInt* encodingType);

    59 

    60     //helper function

    61     //extracts left part of input descriptor upto (maxLen-1) and copies content in outPtr

    62     //append a null terminator

    63     static TInt ExtractUCS2(TDesC& inDes, char* outPtr, TInt maxLen);

    64 

    65 private:

    66     CS60MetadataUtilityItf* m_pS60Util;

    67     CHXMetadataUtilityItf* m_pHXUtil;

    68     };

    69 

    70 NONSHARABLE_CLASS(CS60MetadataUtilityItf)

    71     {

    72 public:

    73 

    74     static CS60MetadataUtilityItf* New();

    75     ~CS60MetadataUtilityItf();

    76 

    77     TInt CalculateNumMetadataItems(TUint*);

    78 

    79     char* GetKey(TInt index);

    80     TInt GetValueSize(TInt index);

    81     TInt GetValue(TInt index, char* data, TInt maxLength, TInt* outSize,

    82             TInt* encodingType);

    83 

    84     TInt ParseSource(TDesC&);

    85 

    86     char* KeyMapping(TMetaDataFieldId);

    87     TInt ValueEncoding(TMetaDataFieldId);

    88 

    89     static bool IsSupportedExtension(char* extn);

    90 

    91     TInt Reset();

    92 

    93 private:

    94 

    95     CS60MetadataUtilityItf();

    96     void ConstructL();

    97 

    98     CMetaDataUtility* pMetaDataUtility; //S60MetadataUtility

    99 

   100     TUint uNumMetadataItems;

   101 

   102     };

   103 

   104 NONSHARABLE_CLASS(CHXMetadataUtilityItf)

   105     {

   106 public:

   107 

   108     static CHXMetadataUtilityItf* New();

   109     ~CHXMetadataUtilityItf();

   110 

   111     TInt CalculateNumMetadataItems(TUint*);

   112 

   113     char* GetKey(TInt index);

   114 

   115     TInt ValueEncoding(HXMetaDataKeys::EHXMetaDataId fldID);

   116     TInt GetValueSize(TInt index);

   117     TInt GetValue(TInt index, char* data, TInt maxLength, TInt* outSize,

   118             TInt* encodingType);

   119 

   120     TInt ParseSource(TDesC&);

   121     char* KeyMapping(HXMetaDataKeys::EHXMetaDataId);

   122 

   123     TInt Reset();

   124 

   125 private:

   126     CHXMetadataUtilityItf();

   127     void ConstructL();

   128 

   129     CHXMetaDataUtility *pHXMetaDataUtility;

   130 

   131     TUint uNumMetadataItems;

   132     };

   133 

   134 #else

   135 

   136 extern void* mmf_metadata_utility_init(char*);

   137 extern void mmf_metadata_utility_destroy(void* context);

   138 extern XAresult mmf_metadata_utility_parse_source(void* , char*);

   139 extern XAresult mmf_get_item_count(void* context, XAuint32* itemCount);

   140 extern XAresult mmf_get_key_size(void* context, XAuint32 keyIndex, XAuint32* keySize);

   141 extern XAresult mmf_get_key(void* context, XAuint32 index,XAuint32 keySize, XAMetadataInfo *pKey);

   142 extern XAresult mmf_get_value_size(void* context, XAuint32 index, XAuint32 *pValueSize);

   143 extern XAresult mmf_get_value(void* context, XAuint32 index, XAuint32 valueSize, XAMetadataInfo *pValue);

   144 #endif //__cplusplus

   145 #endif