/*

* Copyright (c) 2009 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 environment information utilities

*

*/

#ifndef JAVAENVINFO_H

#define JAVAENVINFO_H

//  INCLUDES

#include <e32cmn.h>

// CLASS DECLARATION

namespace Java

{

/**

 * Class provides information about Java environment version.

 *

 * @lib javaenvinfo.lib

 * @since S60 5.1

 */

NONSHARABLE_CLASS(JavaEnvInfo)

{

public:

    /**

      * Returns the Java environment version

      *

      * @since S60 5.1

      * @return TVersion instance representing the Java environment version

      */

    IMPORT_C static TVersion Version();

    /**

      * Returns the part of the user agent header describing the Java environment.

      * This string can be used by Browser or any other HTTP client when sending

      * HTTP requests to describe the supported Java environment.

      *

      * The returned string could be for example

      * "Configuration/CLDC-1.1 Profile/MIDP-2.1".

      *

      * @since S60 5.1

      * @return User Agent header string. Caller is responsible for deleting

      * this when done with it.

      */

    IMPORT_C static HBufC* GetUserAgentHeaderL();

    /**

      * Returns the Java configuration and profile information in human

      * readable format.

      *

      * The used format is <profile> ", " <configuration> - as an example

      * "MIDP 2.1, CLDC 1.1".

      *

      * @since S60 5.1

      * @return String in the format. Caller is responsible for deleting

      * this when done with it.

      */

    IMPORT_C static HBufC* GetPlatformInfoL();

private:

    static TVersion JavaEnvInfo::GetJavaVersionL();

};

}

#endif // JAVAENVINFO_H