01: /*******************************************************************************
02: * Copyright (c) 2005, 2006 IBM Corporation and others.
03: * All rights reserved. This program and the accompanying materials
04: * are made available under the terms of the Eclipse Public License v1.0
05: * which accompanies this distribution, and is available at
06: * http://www.eclipse.org/legal/epl-v10.html
07: *
08: * Contributors:
09: * IBM Corporation - initial API and implementation
10: *******************************************************************************/package org.eclipse.jdt.launching.environments;
11:
12: import org.eclipse.core.runtime.CoreException;
13: import org.eclipse.core.runtime.IProgressMonitor;
14: import org.eclipse.jdt.launching.IVMInstall;
15:
16: /**
17: * Analyzes vm installs for compatibility with execution environments.
18: * <p>
19: * An execution environment analyzer delegate is contributed in plug-in XML via
20: * the <code>org.eclipse.jdt.launching.executionEnvironments</code>
21: * extension point.
22: * </p>
23: * <p>
24: * Clients may implement this interface.
25: * </p>
26: * @since 3.2
27: */
28: public interface IExecutionEnvironmentAnalyzerDelegate {
29:
30: /**
31: * Analyzes the given vm install and returns a collection of compatible
32: * execution environments, possibly empty.
33: *
34: * @param vm vm install to analyze
35: * @param monitor progress monitor
36: * @return compatible execution environments, possibly empty
37: * @throws CoreException if an exception occurs analyzing the vm install
38: */
39: public CompatibleEnvironment[] analyze(IVMInstall vm,
40: IProgressMonitor monitor) throws CoreException;
41:
42: }
|