/*
* Copyright (c) 2002 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:  ?Description
*
*/



#ifndef CCMSAttribute_H
#define CCMSAttribute_H

//  INCLUDES
#include "CCMSSequence.h"
#include <badesca.h>

// FORWARD DECLARATIONS
// Extension
class MCMSAttributeExtension;


// CLASS DECLARATION
/**
*  Attribute type module
*
*  ASN.1 Definition:
*  Attribute ::= SEQUENCE {
*  		attrType OBJECT IDENTIFIER,
*  		attrValues SET OF AttributeValue }
*
*  AttributeValue ::= ANY
*
*  @lib cms.lib
*  @since 2.8
*/
class CCMSAttribute : public CCMSSequence
    {
    public:  // Constructors and destructor
		/**
        * Two-phased constructor.
        * NOTE: Encrypt will leave with KErrBadDescriptor if
        * valid Attribute Type has not setted.
        */
        IMPORT_C static CCMSAttribute* NewLC();

	   /**
        * Two-phased constructor.
        * NOTE: Encrypt will leave with KErrBadDescriptor if
        * valid Attribute Type has not setted.
        */
        IMPORT_C static CCMSAttribute* NewL();
		
		/**
        * Two-phased constructor.
        * Takes copy of the both type and values.
        * @param aAttributeType	The attribute type in desc e.g.
        *						content type = "1.2.840.113549.1.9.3".
        * @param aAttriteValues	Set of attribute values. Each attribute must be
        *						already encoded since they are added as is.
        */
        IMPORT_C static CCMSAttribute* NewL( const TDesC& aAttributeType,
										     const CDesC8Array& aAttributeValues );

        /**
        * Two-phased constructor.
        * Takes copy of the both type and values.
		* Leaves newly created instance in CleanupStack
        * @param aAttributeType	The attribute type in desc e.g.
        *						content type = "1.2.840.113549.1.9.3".
        * @param aAttriteValues	Set of attribute values. Each attribute must be
        *						already encoded since they are added as is.
        */
        IMPORT_C static CCMSAttribute* NewLC( const TDesC& aAttributeType,
											  const CDesC8Array& aAttributeValues );

		/**
        * Two-phased constructor.
        * Same as above although takes only one value
        * @param aAttributeType	The attribute type in desc e.g.
        *						content type = "1.2.840.113549.1.9.3".
        * @param aAttriteValue	Single attribute value. Attribute must be
        *						already encoded since it is added as is.
        */
        IMPORT_C static CCMSAttribute* NewL( const TDesC& aAttributeType,
											 const TDesC8& aAttributeValue );

		/**
        * Two-phased constructor.
        * Same as above although takes only one value
		* Leaves newly created instance in CleanupStack
        * @param aAttributeType	The attribute type in desc e.g.
        *						content type = "1.2.840.113549.1.9.3".
        * @param aAttriteValue	Single attribute value. Attribute must be
        *						already encoded since it is added as is.
        */
        IMPORT_C static CCMSAttribute* NewLC( const TDesC& aAttributeType,
											  const TDesC8& aAttributeValue );

        /**
        * Destructor.
        */
        virtual ~CCMSAttribute();

    public: // New functions

        /**
		* Getter for attribute type
		* @since 2,8
		* @return Attribute type in TDesC reference
		*/
		IMPORT_C const TDesC& AttributeType() const;

        /**
        * Getter for attribute values
        * @since 2.8
        * @return Attribute values in CDesC8ArrayFlat reference
        */
		IMPORT_C const CDesC8Array& AttributeValues() const;

		/**
        * Setter for attribute type, takes copy
        * @since 2.8
        * @param aAttributeType	Attribute type to be set as TDesC.
        */
		IMPORT_C void SetAttributeTypeL( const TDesC& aAttributeType );

        /**
        * Setter for attribute values
        * @since 2,8
        * @param aSerialNumber Array of attribute values
        */
		IMPORT_C void SetAttributeValuesL( const CDesC8Array& aAttributeValues );

    public: // Functions from base classes

	 	/**
        * From MCMSModule
        * @since 2.8
        * @param aRawData raw-data to be parsed in this instance
        */
        void DecodeL( const TDesC8& aRawData );

	 	/**
        * From MCMSModule
        * @since 2.8
        * @return Returns ASN1 encoder and leaves it in CleanupStack
        */
        CASN1EncBase* EncoderLC() const;

    protected:  // New functions

	   /**
        * Protected construction to allow derivation
        */
        IMPORT_C void ConstructL();

	   /**
        * Protected construction to allow derivation
        */
        IMPORT_C void ConstructL( const TDesC& aAttributeType,
								  const CDesC8Array& aAttributeValues );

	   /**
        * Protected construction to allow derivation
        */
        IMPORT_C void ConstructL( const TDesC& aAttributeType,
								  const TDesC8& aAttributeValue );

        /**
        * C++ default constructor.
        */
        IMPORT_C CCMSAttribute();

    private:    // Data
        // Attribute Type, owned
        HBufC* iAttributeType;
        // Attribute values, owned
		CDesC8ArrayFlat* iAttributeValues;

		// Reserved for extensions
		MCMSAttributeExtension* iReserved;
    };

#endif      // CCMSAttribute_H

// End of File