/*

* Copyright (c) 2004 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 CCMSOriginatorIdentifierOrKey_H

#define CCMSOriginatorIdentifierOrKey_H

// INCLUDES

#include <e32base.h>

#include <asn1cons.h>

#include "MCMSModule.h"

// FORWARD DECLARATIONS

class CCMSIssuerAndSerialNumber;

class CCMSOriginatorPublicKey;

class CASN1EncBase;

// CLASS DECLARATION

/**

*  OriginatorIdentifierOrKey type module

*

*  ASN.1 definition:

*  OriginatorIdentifierOrKey ::= CHOICE {

*        issuerAndSerialNumber IssuerAndSerialNumber,

*        subjectKeyIdentifier [0] SubjectKeyIdentifier,

*        originatorKey [1] OriginatorPublicKey }

*  @lib cms.lib

*  @since 2.8

*/

class CCMSOriginatorIdentifierOrKey : public CBase, public MCMSModule

    {

    public: // data types

        enum TType

            {

            ESubjectKeyIdentifier = 0,

            EOriginatorKey = 1,

            EIssuerAndSerialNumber

            };

    public:  // Constructors and destructor

		/**

        * Two-phased constructor.

        */

        IMPORT_C static CCMSOriginatorIdentifierOrKey* NewL();

        /**

        * Two-phased constructor. Copies of the parameters are made.

        *

        * @param aIssuerAndSerialNumber identifies sender's certificate

        */

        IMPORT_C static CCMSOriginatorIdentifierOrKey* NewL(

            const CCMSIssuerAndSerialNumber& aIssuerAndSerialNumber );

        /**

        * Two-phased constructor. Copies of the parameters are made.

        *

        * @param aSubjectKeyIdentifier X.509 subjectKeyIdentifier

        */

        IMPORT_C static CCMSOriginatorIdentifierOrKey* NewL(

            const TDesC8& aSubjectKeyIdentifier );

        /**

        * Two-phased constructor. Copies of the parameters are made.

        *

        * @param aOriginatorKey includes algorithm identifier and public key

        */

        IMPORT_C static CCMSOriginatorIdentifierOrKey* NewL(

            const CCMSOriginatorPublicKey& aOriginatorKey );

        /**

        * Destructor.

        */

        virtual ~CCMSOriginatorIdentifierOrKey();

    public: // New functions

        /**

         * Getter for the CHOICE type. There is no corresponding

         * setter method as the type is set implicitly by the member

         * value setters.

         * @since 2.8

         * @return the CHOICE type

         */

        IMPORT_C TType Type() const;

        /**

        * Getter for IssuerAndSerialNumber. Leaves with KErrNotFound

        * if the type of this CHOICE is not EIssuerAndSerialNumber.

        * @since 2.8

        * @return IssuerAndSerialNumber

        */

		IMPORT_C const CCMSIssuerAndSerialNumber&

        IssuerAndSerialNumberL() const;

        /**

        * Getter for the X.509 subjectKeyIdentifier. Leaves with

        * KErrNotFound if the type of this CHOICE is not ESubjectKeyIdentifier.

        * @since 2,8

        * @return subjectKeyIdentifier

        */

		IMPORT_C const TDesC8& SubjectKeyIdentifierL() const;

        /**

         * Getter for OriginatorKey. Leaves with KErrNotFound if the

         * type of this CHOICE is not EOriginatorKey.

         * @since 2,8

         * @return OriginatorKey

         */

        IMPORT_C const CCMSOriginatorPublicKey& OriginatorKeyL() const;

		/**

        * Setter for IssuerAndSerialNumber. Create a copy of the parameters.

        * @since 2.8

        * @param aIssuerAndSerialNumber identifies sender's certificate

        */

		IMPORT_C void SetIssuerAndSerialNumberL(

            const CCMSIssuerAndSerialNumber& aIssuerAndSerialNumber );

        /**

        * Setter for subjectKeyIdentifier

        * @since 2,8

        * @param aSubjectKeyIdentifier X.509 subjectKeyIdentifier

        */

		IMPORT_C void SetSubjectKeyIdentifierL(

            const TDesC8& aSubjectKeyIdentifier );

        /**

         * Setter for originatorKey

         * @since 2.8

         * @param aOriginatorKey includes algorithm identifier and

         * public key

         */

        IMPORT_C void SetOriginatorKeyL(

            const CCMSOriginatorPublicKey& aOriginatorKey );

    public: // Functions from base classes

        /**

        * From MCMSModule

        * @since 2.8

        * @param aResult Allocates and sets result in this variable

        * @return ?description

        */

        void EncodeL( HBufC8*& aResult ) const;

	 	/**

        * 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(

            const CCMSIssuerAndSerialNumber& aIssuerAndSerialNumber );

        /**

        * Protected construction to allow derivation

        */

        IMPORT_C void ConstructL(

            const TDesC8& aSubjectKeyIdentifier );

        /**

        * Protected construction to allow derivation

        */

        IMPORT_C void ConstructL(

            const CCMSOriginatorPublicKey& aOriginatorKey );

        /**

        * C++ default constructor.

        */

        IMPORT_C CCMSOriginatorIdentifierOrKey();

    private: // New functions

        /**

         * Deletes old value and changes the type of the choice.

         * @param aNewType The type of the CHOICE will be set to

         * aNewType.

         */

        void DeleteOldValueAndChangeTypeL( TType aNewType );

        /**

         * Creates Encoder for the SubjectKeyIdentifier value 

         * @return ASN1 encoder

         */

        CASN1EncBase* EncoderSubjectKeyIdentifierLC() const;

        /**

         * Creates Encoder for the OriginatorKey value

         * @return ASN1 encoder

         */

        CASN1EncBase* EncoderOriginatorKeyLC() const;

    private:    // Data

        // defines the type of this CHOICE

        TType iType;

        // IssuerAndSerialNumber value. owned.

        CCMSIssuerAndSerialNumber* iIssuerAndSerialNumber;

        // SubjectKeyIdentifier value. owned.

        HBufC8* iSubjectKeyIdentifier;

        // OriginatorPublicKey value. owned.

        CCMSOriginatorPublicKey* iOriginatorKey;

    };

#endif      // CCMSOriginatorIdentifierOrKey_H

// End of File