/****************************************************************************** * 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.ipa.cfg; import java.util.ArrayList; import java.util.Collection; import java.util.Collections; import java.util.Iterator; import java.util.List; import java.util.NoSuchElementException; import java.util.Set; import java.util.function.Predicate; import com.ibm.wala.cfg.ControlFlowGraph; import com.ibm.wala.cfg.IBasicBlock; import com.ibm.wala.classLoader.IMethod; import com.ibm.wala.util.collections.FilterIterator; import com.ibm.wala.util.collections.Iterator2Collection; import com.ibm.wala.util.graph.AbstractNumberedGraph; import com.ibm.wala.util.graph.Graph; import com.ibm.wala.util.graph.NumberedEdgeManager; import com.ibm.wala.util.graph.NumberedNodeManager; import com.ibm.wala.util.graph.impl.GraphInverter; import com.ibm.wala.util.graph.traverse.DFS; import com.ibm.wala.util.intset.BitVector; import com.ibm.wala.util.intset.IntSet; import com.ibm.wala.util.intset.IntSetUtil; import com.ibm.wala.util.intset.MutableIntSet; /** * A pruned view of a {@link ControlFlowGraph}. Use this class along with an {@link EdgeFilter} to produce a custom view of a CFG. * * For example, you can use this class to produce a CFG view that ignores certain types of exceptional edges. */ public class PrunedCFG> extends AbstractNumberedGraph implements ControlFlowGraph { /** * @param cfg the original CFG that you want a view of * @param filter an object that selectively filters edges in the original CFG * @return a view of cfg that includes only edges accepted by the filter. * @throws IllegalArgumentException if cfg is null */ public static > PrunedCFG make(final ControlFlowGraph cfg, final EdgeFilter filter) { if (cfg == null) { throw new IllegalArgumentException("cfg is null"); } return new PrunedCFG(cfg, filter); } private static class FilteredCFGEdges> implements NumberedEdgeManager { private final ControlFlowGraph cfg; private final NumberedNodeManager currentCFGNodes; private final EdgeFilter filter; FilteredCFGEdges(ControlFlowGraph cfg, NumberedNodeManager currentCFGNodes, EdgeFilter filter) { this.cfg = cfg; this.filter = filter; this.currentCFGNodes = currentCFGNodes; } public Iterator getExceptionalSuccessors(final T N) { return new FilterIterator(cfg.getExceptionalSuccessors(N).iterator(), new Predicate() { @Override public boolean test(T o) { return currentCFGNodes.containsNode(o) && filter.hasExceptionalEdge(N, o); } }); } public Iterator getNormalSuccessors(final T N) { return new FilterIterator(cfg.getNormalSuccessors(N).iterator(), new Predicate() { @Override public boolean test(T o) { return currentCFGNodes.containsNode(o) && filter.hasNormalEdge(N, o); } }); } public Iterator getExceptionalPredecessors(final T N) { return new FilterIterator(cfg.getExceptionalPredecessors(N).iterator(), new Predicate() { @Override public boolean test(T o) { return currentCFGNodes.containsNode(o) && filter.hasExceptionalEdge(o, N); } }); } public Iterator getNormalPredecessors(final T N) { return new FilterIterator(cfg.getNormalPredecessors(N).iterator(), new Predicate() { @Override public boolean test(T o) { return currentCFGNodes.containsNode(o) && filter.hasNormalEdge(o, N); } }); } @Override public Iterator getSuccNodes(final T N) { return new FilterIterator(cfg.getSuccNodes(N), new Predicate() { @Override public boolean test(T o) { return currentCFGNodes.containsNode(o) && (filter.hasNormalEdge(N, o) || filter.hasExceptionalEdge(N, o)); } }); } @Override public int getSuccNodeCount(T N) { return Iterator2Collection.toSet(getSuccNodes(N)).size(); } @Override public IntSet getSuccNodeNumbers(T N) { MutableIntSet bits = IntSetUtil.make(); for (Iterator EE = getSuccNodes(N); EE.hasNext();) { bits.add(EE.next().getNumber()); } return bits; } @Override public Iterator getPredNodes(final T N) { return new FilterIterator(cfg.getPredNodes(N), new Predicate() { @Override public boolean test(T o) { return currentCFGNodes.containsNode(o) && (filter.hasNormalEdge(o, N) || filter.hasExceptionalEdge(o, N)); } }); } @Override public int getPredNodeCount(T N) { return Iterator2Collection.toSet(getPredNodes(N)).size(); } @Override public IntSet getPredNodeNumbers(T N) { MutableIntSet bits = IntSetUtil.make(); for (Iterator EE = getPredNodes(N); EE.hasNext();) { bits.add(EE.next().getNumber()); } return bits; } @Override public boolean hasEdge(T src, T dst) { for (Iterator EE = getSuccNodes(src); EE.hasNext();) { if (EE.next().equals(dst)) { return true; } } return false; } @Override public void addEdge(T src, T dst) { throw new UnsupportedOperationException(); } @Override public void removeEdge(T src, T dst) { throw new UnsupportedOperationException(); } @Override public void removeAllIncidentEdges(T node) { throw new UnsupportedOperationException(); } @Override public void removeIncomingEdges(T node) { throw new UnsupportedOperationException(); } @Override public void removeOutgoingEdges(T node) { throw new UnsupportedOperationException(); } } private static class FilteredNodes implements NumberedNodeManager { private final NumberedNodeManager nodes; private final Set subset; FilteredNodes(NumberedNodeManager nodes, Set subset) { this.nodes = nodes; this.subset = subset; } @Override public int getNumber(T N) { if (subset.contains(N)) return nodes.getNumber(N); else return -1; } @Override public T getNode(int number) { T N = nodes.getNode(number); if (subset.contains(N)) return N; else throw new NoSuchElementException(); } @Override public int getMaxNumber() { int max = -1; for (Iterator NS = nodes.iterator(); NS.hasNext();) { T N = NS.next(); if (subset.contains(N) && getNumber(N) > max) { max = getNumber(N); } } return max; } private Iterator filterNodes(Iterator nodeIterator) { return new FilterIterator(nodeIterator, new Predicate() { @Override public boolean test(T o) { return subset.contains(o); } }); } @Override public Iterator iterateNodes(IntSet s) { return filterNodes(nodes.iterateNodes(s)); } @Override public Iterator iterator() { return filterNodes(nodes.iterator()); } @Override public int getNumberOfNodes() { return subset.size(); } @Override public void addNode(T n) { throw new UnsupportedOperationException(); } @Override public void removeNode(T n) { throw new UnsupportedOperationException(); } @Override public boolean containsNode(T N) { return subset.contains(N); } } private final ControlFlowGraph cfg; private final FilteredNodes nodes; private final FilteredCFGEdges edges; private PrunedCFG(final ControlFlowGraph cfg, final EdgeFilter filter) { this.cfg = cfg; Graph temp = new AbstractNumberedGraph() { private final NumberedEdgeManager edges = new FilteredCFGEdges(cfg, cfg, filter); @Override protected NumberedNodeManager getNodeManager() { return cfg; } @Override protected NumberedEdgeManager getEdgeManager() { return edges; } }; Set reachable = DFS.getReachableNodes(temp, Collections.singleton(cfg.entry())); Set back = DFS.getReachableNodes(GraphInverter.invert(temp), Collections.singleton(cfg.exit())); reachable.retainAll(back); reachable.add(cfg.entry()); reachable.add(cfg.exit()); this.nodes = new FilteredNodes(cfg, reachable); this.edges = new FilteredCFGEdges(cfg, nodes, filter); } @Override protected NumberedNodeManager getNodeManager() { return nodes; } @Override protected NumberedEdgeManager getEdgeManager() { return edges; } @Override public List getExceptionalSuccessors(final T N) { ArrayList result = new ArrayList(); for (Iterator it = edges.getExceptionalSuccessors(N); it.hasNext();) { result.add(it.next()); } return result; } @Override public Collection getNormalSuccessors(final T N) { return Iterator2Collection.toSet(edges.getNormalSuccessors(N)); } @Override public Collection getExceptionalPredecessors(final T N) { return Iterator2Collection.toSet(edges.getExceptionalPredecessors(N)); } @Override public Collection getNormalPredecessors(final T N) { return Iterator2Collection.toSet(edges.getNormalPredecessors(N)); } @Override public T entry() { return cfg.entry(); } @Override public T exit() { return cfg.exit(); } @Override public T getBlockForInstruction(int index) { return cfg.getBlockForInstruction(index); } @Override public I[] getInstructions() { return cfg.getInstructions(); } @Override public int getProgramCounter(int index) { return cfg.getProgramCounter(index); } @Override public IMethod getMethod() { return cfg.getMethod(); } @Override public BitVector getCatchBlocks() { BitVector result = new BitVector(); BitVector blocks = cfg.getCatchBlocks(); int i = 0; while ((i = blocks.nextSetBit(i)) != -1) { if (nodes.containsNode(getNode(i))) { result.set(i); } } return result; } public IntSet getPhiIndices(T bb) { assert containsNode(bb); assert cfg.containsNode(bb); int i = 0; MutableIntSet valid = IntSetUtil.make(); for (Iterator pbs = cfg.getPredNodes(bb); pbs.hasNext(); i++) { if (nodes.containsNode(pbs.next())) { valid.add(i); } } return valid; } }