/******************************************************************************* * 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.examples.drivers; import java.io.File; import java.io.IOException; import java.util.Collection; import java.util.Properties; import com.ibm.wala.classLoader.IClass; import com.ibm.wala.core.tests.callGraph.CallGraphTestUtil; import com.ibm.wala.examples.properties.WalaExamplesProperties; import com.ibm.wala.ipa.callgraph.AnalysisScope; import com.ibm.wala.ipa.cha.ClassHierarchy; import com.ibm.wala.ipa.cha.IClassHierarchy; import com.ibm.wala.properties.WalaProperties; import com.ibm.wala.types.ClassLoaderReference; import com.ibm.wala.util.WalaException; import com.ibm.wala.util.collections.CollectionFilter; import com.ibm.wala.util.Predicate; import com.ibm.wala.util.config.AnalysisScopeReader; import com.ibm.wala.util.debug.Assertions; import com.ibm.wala.util.graph.Graph; import com.ibm.wala.util.graph.GraphSlicer; import com.ibm.wala.util.graph.impl.SlowSparseNumberedGraph; import com.ibm.wala.util.io.FileProvider; import com.ibm.wala.viz.DotUtil; import com.ibm.wala.viz.PDFViewUtil; /** * * This simple example WALA application builds a TypeHierarchy and fires off * ghostview to viz a DOT representation. * * @author sfink */ public class PDFTypeHierarchy { // This example takes one command-line argument, so args[1] should be the "-classpath" parameter final static int CLASSPATH_INDEX = 1; public final static String DOT_FILE = "temp.dt"; private final static String PDF_FILE = "th.pdf"; public static Properties p; static { try { p = WalaProperties.loadProperties(); p.putAll(WalaExamplesProperties.loadProperties()); } catch (WalaException e) { e.printStackTrace(); Assertions.UNREACHABLE(); } } public static void main(String[] args) throws IOException { run(args); } public static Process run(String[] args) throws IOException { try { validateCommandLine(args); String classpath = args[CLASSPATH_INDEX]; AnalysisScope scope = AnalysisScopeReader.makeJavaBinaryAnalysisScope(classpath, (new FileProvider()).getFile(CallGraphTestUtil.REGRESSION_EXCLUSIONS)); // invoke WALA to build a class hierarchy ClassHierarchy cha = ClassHierarchy.make(scope); Graph<IClass> g = typeHierarchy2Graph(cha); g = pruneForAppLoader(g); String dotFile = p.getProperty(WalaProperties.OUTPUT_DIR) + File.separatorChar + DOT_FILE; String pdfFile = p.getProperty(WalaProperties.OUTPUT_DIR) + File.separatorChar + PDF_FILE; String dotExe = p.getProperty(WalaExamplesProperties.DOT_EXE); String gvExe = p.getProperty(WalaExamplesProperties.PDFVIEW_EXE); DotUtil.dotify(g, null, dotFile, pdfFile, dotExe); return PDFViewUtil.launchPDFView(pdfFile, gvExe); } catch (WalaException e) { // TODO Auto-generated catch block e.printStackTrace(); return null; } } public static <T> Graph<T> pruneGraph(Graph<T> g, Predicate<T> f) throws WalaException { Collection<T> slice = GraphSlicer.slice(g, f); return GraphSlicer.prune(g, new CollectionFilter<T>(slice)); } /** * Restrict g to nodes from the Application loader */ public static Graph<IClass> pruneForAppLoader(Graph<IClass> g) throws WalaException { Predicate<IClass> f = new Predicate<IClass>() { @Override public boolean test(IClass c) { return (c.getClassLoader().getReference().equals(ClassLoaderReference.Application)); } }; return pruneGraph(g, f); } /** * Validate that the command-line arguments obey the expected usage. * * Usage: args[0] : "-classpath" args[1] : String, a ";"-delimited class path * * @throws UnsupportedOperationException if command-line is malformed. */ public static void validateCommandLine(String[] args) { if (args.length < 2) { throw new UnsupportedOperationException("must have at least 2 command-line arguments"); } if (!args[0].equals("-classpath")) { throw new UnsupportedOperationException("invalid command-line, args[0] should be -classpath, but is " + args[0]); } } /** * Return a view of an {@link IClassHierarchy} as a {@link Graph}, with edges from classes to immediate subtypes */ public static Graph<IClass> typeHierarchy2Graph(IClassHierarchy cha) throws WalaException { Graph<IClass> result = SlowSparseNumberedGraph.make(); for (IClass c : cha) { result.addNode(c); } for (IClass c : cha) { for (IClass x : cha.getImmediateSubclasses(c)) { result.addEdge(c, x); } if (c.isInterface()) { for (IClass x : cha.getImplementors(c.getReference())) { result.addEdge(c, x); } } } return result; } }