/*

* 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:  Presence attribute constructor container.

*

*/

#ifndef CPENGATTRCONSTRUCTORCON_H

#define CPENGATTRCONSTRUCTORCON_H

//  INCLUDES

#include <E32Base.h>

#include <MPEngPresenceAttrTypeProperties2.h>

//FORWARD DECLARATION

class CPEngPresenceAttrConstructor;

class MPEngPresenceAttrConstructorTypeImp;

class CPEngSessionSlotObject;

// CLASS DECLARATION

/**

 * Presence attribute model constructor container.

 *

 * @lib PEngAttrLib

 * @since 3.0

 */

NONSHARABLE_CLASS( CPEngAttrConstructorCon ) : public CBase

    {

public: /* Construction */

    /**

     * Instantiates CPEngAttrConstructorCon object.

     *

     * @return New CPEngAttrConstructorCon instance.

     */

    static CPEngAttrConstructorCon* NewL( CPEngSessionSlotObject& aOwner );

    /**

     * Destructor.

     */

    ~CPEngAttrConstructorCon();

private:

    /**

     * C++ constructor.

     */

    CPEngAttrConstructorCon( CPEngSessionSlotObject& aOwner );

public: // Constructor management

    /**

     * Adds new attribute type constructor.

     * Takes always the ownership of given aTypeConstructor object.

     *

     * @param aTypeConstructor The type constructor.

     * @param aType The attribute type.

     * @param aOrigin The attribute origin setting.

     */

    void AddConstructorL( MPEngPresenceAttrConstructorTypeImp* aTypeConstructor,

                          TUint32 aType,

                          TPEngAttributeOriginator aOrigin );

    /**

     * Finds a constructor by attribute type.

     *

     * @param aType The attribute type.

     * @return The attribute constructor. NULL if no constructor

     * found for requested type. Constructor ownership stays

     * on the container.

     */

    CPEngPresenceAttrConstructor* FindByType( TUint32 aType );

    /**

     * Finds a constructor by attribute type.

     * Leaves if the attribute type is unknown.

     *

     * @param aType The attribute type.

     * @return The attribute constructor.

     * Constructor ownership stays on the container.

     */

    CPEngPresenceAttrConstructor& FindByTypeL( TUint32 aType );

    /**

     * Gets a TArray presenting known attribute types.

     *

     * @return The TArray of known attribute types.

     */

    TArray<TUint32> TypeArray() const;

private:    // Reference access for CPEngPresenceAttrConstructor

    /**

     * CPEngPresenceAttrConstructor is a friend

     * so it can increase / decrease reference count when needed.

     *

     * @since 3.0

     */

    friend class CPEngPresenceAttrConstructor;      // CSI: 36 #

    /**

     * Opens a reference to container.

     *

     * @since 3.0

     */

    void OpenRef();

    /**

     * Closes a reference to container.

     *

     * @since 3.0

     */

    void CloseRef();

private:    // Helpers

    /**

     * Assertion function to verify attribute

     * constructor contents.

     * @param aConstructor The constructor instance to verify.

     */

    void __AssertConstructorValidL( const CPEngPresenceAttrConstructor& aConstructor );

    /**

     * TArray accessor functions for attribute type list.

     */

    static TInt GetTypeCount( const CBase* aPtr );

    static const TAny* GetTypePtr( const CBase* aPtr, TInt aIndex );

private:    // Data

    //REF: The Presence Attribute Manger owning this container

    CPEngSessionSlotObject&  iOwner;

    //OWN: The attribute constructors.

    RPointerArray< CPEngPresenceAttrConstructor > iConstructors;

    };

#endif      // CPENGATTRCONSTRUCTORCON_H

// End of File