/*

* Copyright (c) 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:  Basic Diagnostics Test Result Detail Item class

*

*/

#ifndef DIAGRESULTDETAILBASICITEM_H

#define DIAGRESULTDETAILBASICITEM_H

// INCLUDES

#include <e32base.h>                     //  CBase

// FORWARD DECLARATIONS

class RWriteStream;

class RReadStream;

/**

*  Diagnostics Result Database Detail  Item Classe.

*

*  This  class stores information needed for each entry in

*  CDiagResultDetailBasic.

*

*  @since S60 v5.0

*/

class CDiagResultDetailBasicItem : public CBase

    {

public: // Data Types

    enum TFieldType 

        {

        ETypeInt    = 0,    // data is TInt type

        ETypeDes16,         // data is TDesC16 type

        ETypeDes8,          // data is TDesC8 type

        };

public: // Constructors

    /**

    * Two-phase constructor.

    *

    * @param aFieldId   - Field Id.

    * @param aFieldName - Textual description of the field.

    * @param aValue     - TInt value.

    */

    static CDiagResultDetailBasicItem* NewL( TInt aFieldId,

                                             const TDesC8& aFieldName,

                                             TInt aValue );

    /**

    * Two-phase constructor.

    *

    * @param aFieldId   - Field Id.

    * @param aFieldName - Textual description of the field.

    * @param aValue     - TDesC8 Text value.

    */

    static CDiagResultDetailBasicItem* NewL( TInt aFieldId,

                                             const TDesC8& aFieldName,

                                             const TDesC8& aValue );

    /**

    * Two-phase constructor.

    *

    * @param aFieldId   - Field Id

    * @param aFieldName - Textual description of the field.

    * @param aValue     - TDesC16 Text value.

    */

    static CDiagResultDetailBasicItem* NewL( TInt aFieldId,

                                                const TDesC8& aFieldName,

                                                const TDesC16& aValue );

    /**

    * Two-phase constructor with RReadStream

    *

    * @param aReadStream - stream to internalize from

    */

    static CDiagResultDetailBasicItem* NewL( RReadStream& aReadStream );

    /**

    * Destructor

    */

    ~CDiagResultDetailBasicItem();

    /**

    * Get the field Id.

    *

    * @return Field Id.

    */

    TInt FieldId() const;

    /**

    * Get the name of the field. 

    *

    * @return Name of the field.

    */

    const TDesC8& FieldName() const;

    /**

    * Get the type of the field.

    *

    * @return Type of the field. 

    */

    TFieldType Type() const;

    /**

    * Get value. If invalid aFieldId is passed, or type does not 

    * match, function will leave with KErrArgument. 

    *

    * @param aValue - Output paramater. The data will be stored

    *   here.

    * @param KErrArgument if type does not match

    */

    TInt GetValue( TInt& aValue ) const;

    TInt GetValue( TPtrC8& aValue ) const;

    TInt GetValue( TPtrC16& aValue ) const;

    /**

    * Externalize to a stream.

    *

    */

    void ExternalizeL( RWriteStream& aWriteStream ) const;

private:  

    /**

    * Constructor 

    *

    */

    CDiagResultDetailBasicItem();

    /**

    * Internalize from stream.

    *

    * @param aReadStream - stream to read from.

    */

    void InternalizeL( RReadStream& aReadStream );

private: // Private Data Types

    typedef union 

        {

        HBufC16*    iBuffer16;

        HBufC8*     iBuffer8;

        TInt        iInt;

        } TValue;

private: // Data

    TFieldType  iFieldType;

    TInt        iFieldId;

    TValue      iValue;

    HBufC8*     iFieldName;

    };

#endif // DIAGRESULTDETAILBASICITEM_h

// End of File