Copyright (c) 2005 IBM Corporation and others.
This program and the accompanying materials
are made available under the terms of the Eclipse Public License 2.0
which accompanies this distribution, and is available at
https://www.eclipse.org/legal/epl-2.0/
SPDX-License-Identifier: EPL-2.0
Contributors:
    IBM Corporation - initial API and implementation
/*******************************************************************************
 * Copyright (c) 2005 IBM Corporation and others.
 *
 * This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License 2.0
 * which accompanies this distribution, and is available at
 * https://www.eclipse.org/legal/epl-2.0/
 *
 * SPDX-License-Identifier: EPL-2.0
 *
 * Contributors:
 *     IBM Corporation - initial API and implementation
 *******************************************************************************/

package org.eclipse.jdt.launching;


Optional extensions that may be implemented by an IVMInstall. 

When an IVMInstall implements this interface,
clients must call getVMArgs() in place of
getVMArguments() and setVMArgs(String) in place of
setVMArguments(String[]). This avoids the problem noted
in bug 73493.


Additionally, this interface optionally provides the Java version
associated with a VM install.

 Clients that implement IVMInstall may additionally implement this interface. However, it is strongly recommended that clients subclass AbstractVMInstall instead, which already implements this interface, and will insulate clients from additional API additions in the future. 
Since:
3.1/**
 * Optional extensions that may be implemented by an
 * {@link org.eclipse.jdt.launching.IVMInstall}.
 * <p>
 * When an <code>IVMInstall</code> implements this interface,
 * clients must call <code>getVMArgs()</code> in place of
 * <code>getVMArguments()</code> and <code>setVMArgs(String)</code> in place of
 * <code>setVMArguments(String[])</code>. This avoids the problem noted
 * in bug 73493.
 * </p>
 * <p>
 * Additionally, this interface optionally provides the Java version
 * associated with a VM install.
 * </p>
 * <p>
 * Clients that implement {@link org.eclipse.jdt.launching.IVMInstall} may additionally
 * implement this interface. However, it is strongly recommended that clients subclass
 * {@link org.eclipse.jdt.launching.AbstractVMInstall} instead, which already implements
 * this interface, and will insulate clients from additional API additions in the future.
 * </p>
 * @since 3.1
 */
public interface IVMInstall2 {

	
Returns VM arguments to be used with this vm install whenever this
VM is launched as a raw string, or null if none.
Returns:
VM arguments to be used with this vm install whenever this
VM is launched as a raw string, or null if none/**
	 * Returns VM arguments to be used with this vm install whenever this
	 * VM is launched as a raw string, or <code>null</code> if none.
	 *
	 * @return VM arguments to be used with this vm install whenever this
	 * VM is launched as a raw string, or <code>null</code> if none
	 */
	public String getVMArgs();

	
Sets VM arguments to be used with this vm install whenever this
VM is launched as a raw string, possibly null.
Params:
vmArgs – VM arguments to be used with this vm install whenever this
VM is launched as a raw string, possibly null/**
	 * Sets VM arguments to be used with this vm install whenever this
	 * VM is launched as a raw string, possibly <code>null</code>.
	 *
	 * @param vmArgs VM arguments to be used with this vm install whenever this
	 * VM is launched as a raw string, possibly <code>null</code>
	 */
	public void setVMArgs(String vmArgs);

    
Returns a string representing the java.version system property
of this VM install, or null if unknown.
Returns:
a string representing the java.version system property
of this VM install, or null if unknown./**
     * Returns a string representing the <code>java.version</code> system property
     * of this VM install, or <code>null</code> if unknown.
     *
     * @return a string representing the <code>java.version</code> system property
     * of this VM install, or <code>null</code> if unknown.
     */
    public String getJavaVersion();
}