/*******************************************************************************
* Copyright (c) 2002 - 2006 IBM Corporation.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
* http://www.eclipse.org/legal/epl-v10.html
*
* Contributors:
* IBM Corporation - initial API and implementation
*******************************************************************************/
package com.ibm.wala.client;
import java.util.Collection;
import java.util.jar.JarFile;
import com.ibm.wala.classLoader.Module;
import com.ibm.wala.ipa.callgraph.AnalysisOptions;
import com.ibm.wala.ipa.callgraph.Entrypoint;
public interface AnalysisEngine {
/**
* Specify the list of modules that should be analyzed. If an EARFile is included in the list, all of its contained modules should
* be examined. Multiple ear files can be specified for cross-app invocations, which will become increasingly common in the 5.1
* release.
*
* @param moduleFiles A non-null Collection of module files: (EARFile, WARFile, ApplicationClientFile, EJBJarFile).
*/
void setModuleFiles(Collection moduleFiles);
/**
* Specify the jar files that represent the standard J2SE libraries
*
* @param libs an array of jar files; usually rt.jar for vanilla JDK core.jar, server.jar, and xml.jar for some WAS runtimes
*/
void setJ2SELibraries(JarFile[] libs);
/**
* Specify the mdoules that represent the standard J2SE libraries
*
* @param libs an array of Modules; usually rt.jar for vanilla JDK core.jar, server.jar, and xml.jar for some WAS runtimes
*/
void setJ2SELibraries(Module[] libs);
/**
* Specify whether the engine should or should not employ "closed-world" analysis.
*
* In a closed-world analysis, the engine considers only application client main methods and servlet entrypoints to the
* application.
*
* In an open-world analysis, the engine additionally considers all EJB local and remote interface methods as entrypoints.
*
* By default, this property is false; the default analysis is open-world
*
* @param b whether to use closed-world analysis
*/
void setClosedWorld(boolean b);
/**
* Get the default analysis options appropriate for this engine
*/
AnalysisOptions getDefaultOptions(Iterable<Entrypoint> entrypoints);
}