/*
* Copyright (c) 2005-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: Java Registy API header file
*
*/


#ifndef JAVAREGISTRYENTRY_H
#define JAVAREGISTRYENTRY_H

#include <e32base.h>
#include <e32cmn.h>
#include <f32file.h>
#include "javaregistryentrytype.h"
#include "javaattribute.h"


namespace Java
{
namespace Manager
{
namespace Registry
{

// FORWARD DECLARATION
class CWriteableJavaRegistryEntry;

}// namespace Registry
}// namespace Manager

/**
 * This class provides the Domain API for entries in JavaRegistry.
 * This class is intended for further derivation.
 * It supports only those attributes which exist in all types of
 * entries.
 *
 * @lib javaregistryclient.lib
 * @since S60 v3.2
 */
class CJavaRegistryEntry : public CBase
{
public:

    /**
     * Gets the Uid of this registry entry.
     *
     * @since S60 v3.2
     * @return A TUid object.
     */
    IMPORT_C TUid Uid() const;

    /**
     * Gets the type of this registry entry.
     * Enumeration TJavaRegistryEntryType defines the currently possible
     * options. Mandatory property.
     *
     * @since S60 v3.2
     * @return Type of this registry entry.
     */
    IMPORT_C TJavaRegistryEntryType Type() const;

    /**
     * Gets the drive letter where the content of the installation package
     * has been installed.
     *
     * @since S60 v3.2
     * @return Drive letter where the content of the installation package
     *         has been installed.
     *         Default value if not set: EDriveC.
     */
    IMPORT_C TDriveNumber Drive() const;

    /**
     * Gets the name of the entity (midlet, suite, etc.) this entry
     * represents.
     *
     * @since S60 v3.2
     * @return Name of the entity this entry represents.
     *         Default value if not set: KNullDesC.
     */
    IMPORT_C const TDesC& Name() const;

    /**
     * Returns the number of certificate chains belonging to the entity
     * this entry represents.
     *
     * @since S60 v3.2
     * @return Number of certificate chains.
     */
    IMPORT_C TInt NumberOfCertificateChains() const;

    /**
     * Returns the n-th certificate chain of the entity this entry
     * represents consisting of X.509 version 3 certificates
     * in their DER encoded format concatenated together
     * without any separators.
     * All certificate chains are returned indifferent if they could be
     * validated or not.
     * This format is directly suitable to be used with
     * function CX509CertChain::DecodeCertsL().
     *
     * @since S60 v3.2
     * @param aChain Zero-based index of the certificate chain to be
     *               retrieved.
     * @return N-th certificate chain
     *         Default value if not set: KNullDesC8.
     */
    IMPORT_C const TDesC8& CertificateChain(TInt aChain) const;

    /**
     * Returns the content id of the entity this entry represents.
     * The content id can be used to check if a DRM protected entity
     * has enough right to be launched or not.
     * The method can also be used to check if the entity is DRM
     * protected or not.
     *
     * @since S60 v3.2
     * @return Content id of the entity this entry represent or
     *          KNullDesC if the entity is not DRM protected.
     */
    IMPORT_C const TDesC& DrmContentId() const;

    /**
     * CJavaRegistryEntry::~CJavaRegistryEntry method
     * Destructor
     *
     * @since S60 v3.2
     */
    IMPORT_C ~CJavaRegistryEntry();

    /**
     * CJavaRegistryEntry::Attribute method gets the
     * additional attribute.
     *
     * @since S60 v5.0
     * @param aName The name the searched attribute.
     * @return MJavaAttribute poiter to instance, which contain attribute.
     * If attribute doesn't exist return NULL.
     */
    IMPORT_C const MJavaAttribute*
    CJavaRegistryEntry::AttributeL(const TDesC& aName) const;

    /**
     * CJavaRegistryEntry::Attributes method gets the
     * array of additional attributes.
     *
     * @since S60 v5.0
     * @return RPointerArray& with all additional attributes.
     */
    IMPORT_C const RPointerArray<MJavaAttribute>&
    CJavaRegistryEntry::AttributesL() const;

protected:

    /**
     * CJavaRegistryEntry::CJavaRegistryEntry constructor
     *
     * @since S60 v3.2
     * @param aWritableEntry Pointer to a writable entry, to delegate
     *          getter methods. Pointer ownership taken.
     */
    CJavaRegistryEntry(Java::Manager::Registry::
                       CWriteableJavaRegistryEntry* aWritableEntry);

    /**
     * CJavaRegistryEntry::WritableEntry method returns the member
     * of this class;
     *
     * @since S60 v3.2
     * @return Returns the member of this class.
     */
    Java::Manager::Registry::
    CWriteableJavaRegistryEntry* WritableEntry() const;

protected: // Data


    /**
     * CJavaRegistryEntry::iWritableEntry member
     * Pointer Owned
     *
     * @since S60 v3.2
     */
    Java::Manager::Registry::CWriteableJavaRegistryEntry* iWritableEntry;

private: // Data


    RPointerArray<MJavaAttribute> iAttributes;

};

} // namespace Java

#endif // JAVAREGISTRYENTRY_H