soot.options.JBOptions Maven / Gradle / Ivy

package soot.options;

/*-
 * #%L
 * Soot - a J*va Optimization Framework
 * %%
 * Copyright (C) 2003 Ondrej Lhotak
 * %%
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Lesser General Public License as
 * published by the Free Software Foundation, either version 2.1 of the
 * License, or (at your option) any later version.
 * 
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Lesser Public License for more details.
 * 
 * You should have received a copy of the GNU General Lesser Public
 * License along with this program.  If not, see
 * .
 * #L%
 */

/* THIS FILE IS AUTO-GENERATED FROM soot_options.xml. DO NOT MODIFY. */

import java.util.*;

/** Option parser for Jimple Body Creation. */
@javax.annotation.Generated(value = "Saxonica v3.0", comments = "from soot_options.xml")
public class JBOptions {

    private Map options;

    public JBOptions(Map options) {
        this.options = options;
    }

    /**
     * Enabled
     */
    public boolean enabled() {
        return soot.PhaseOptions.getBoolean(options, "enabled");
    }

    /**
     * Use Original Names
     * Retain the original names for local variables when the source 
     * includes those names. Otherwise, Soot gives variables generic 
     * names based on their types.
     */
    public boolean use_original_names() {
        return soot.PhaseOptions.getBoolean(options, "use-original-names");
    }

    /**
     * Preserve source-level annotations
     * Preserves annotations of retention type SOURCE. (for everything 
     * but package and local variable annotations)
     */
    public boolean preserve_source_annotations() {
        return soot.PhaseOptions.getBoolean(options, "preserve-source-annotations");
    }

    /**
     * Stabilize local names
     * Make sure that local names are stable between runs. This 
     * requires re-normalizing all local names after the standard 
     * transformations, sorting them, and padding all local names with 
     * leading zeros up to the maximum number of digits in the local 
     * with the highest integer value. This can negatively impact 
     * performance. This option automatically sets "sort-locals" in 
     * "jb.lns" during the second re-normalization pass.
     */
    public boolean stabilize_local_names() {
        return soot.PhaseOptions.getBoolean(options, "stabilize-local-names");
    }

    /**
     * Model LambdaMetafactory --
     * Replace dynamic invoke instructions to the LambdaMetafactory by 
     * static invokes to a synthetic LambdaMetafactory implementation..
     *
     * When the asm bytecode frontend is used and this option is set to 
     * true, Soot creates an implementation of the LambdaMetafactory 
     * for each dynamic invoke and replaces the original dynamic invoke 
     * by a static invocation of the factory's bootstrap method. This 
     * allows the call-graph generation to find the lambda body 
     * reachable, i.e., call-graphs contain paths from the invocation 
     * of a functional interface to the lambda body implementing this 
     * interface. Note that this procedure is not reversed when 
     * writing-out. Therefore, written-out code will contain the 
     * created LambdaMetafactories and instrumented calls to the 
     * corresponding bootstrap methods.
     */
    public boolean model_lambdametafactory() {
        return soot.PhaseOptions.getBoolean(options, "model-lambdametafactory");
    }

}