/*
* 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:  A method for modifying the JVM args.
*
*/


#ifndef JVMARGSMODIFIER_H
#define JVMARGSMODIFIER_H

#include "javaoslayer.h"

#include <string>
#include <list>

namespace java // codescanner::namespace
{

namespace runtime // codescanner::namespace
{

/**
 * Provides a way for modifying the JVM arguments from some external
 * source. In the rom there will be an empty implementation of this method
 * which can be overridden by eclipsing javajvmargsmodifier.dll having this
 * method in ordinal 1. The modifier has full control of each argument passed
 * to the JVM. The arguments are divided into two categories - the arguments
 * for the JVM and the arguments for the application. Both are modifyable by
 * the external source modifier.
 * @param identifier An idetifier that can be used to distinguish different
 *                   runtimes.
 * @param jvmArgs    A list of Jvm args. This list contains all the arguments
 *                   before the main class.
 * @param applicationAndArgs A list that contains the main class as a first
 *                           item in the list. The leading item(s) in the
 *                           list are the arguments for the main method of
 *                           the main class.
 */
OS_IMPORT void modifyJvmArguments(const std::wstring& identifier,
                                  std::list<std::wstring>& jvmArgs,
                                  std::list<std::wstring>& applicationAndArgs);
} // end namespace runtime
} // end namespace java


#endif // JVMARGSMODIFIER_H