com.google.javascript.refactoring

Class SuggestedFix.Builder

java.lang.Object

com.google.javascript.refactoring.SuggestedFix.Builder

Enclosing class:

SuggestedFix

public static final class SuggestedFix.Builder
extends java.lang.Object

Builder class for SuggestedFix that contains helper functions to manipulate JS nodes.

Constructor Summary

Constructors

Constructor and Description
Builder()

Method Summary

Modifier and Type	Method and Description
SuggestedFix.Builder	addAlternative(SuggestedFix alternative)
SuggestedFix.Builder	addCast(Node n, AbstractCompiler compiler, java.lang.String type) Adds a cast of the given type to the provided node.
SuggestedFix.Builder	addChildToFront(Node parentNode, java.lang.String content) Inserts a new node as the first child of the provided node.
SuggestedFix.Builder	addGoogRequire(Match m, java.lang.String namespace) Adds a goog.require for the given namespace to the file if it does not already exist.
SuggestedFix.Builder	addLhsToGoogRequire(Match m, java.lang.String namespace)
SuggestedFix.Builder	addOrReplaceJsDoc(Node n, java.lang.String newJsDoc) Adds or replaces the JS Doc for the given node.
SuggestedFix.Builder	attachMatchedNodeInfo(Node node, AbstractCompiler compiler) Sets the node on this SuggestedFix that caused this SuggestedFix to be built in the first place.
SuggestedFix	build()
SuggestedFix.Builder	changeJsDocType(Node n, AbstractCompiler compiler, java.lang.String type) Changes the JS Doc Type of the given node.
SuggestedFix.Builder	delete(Node n) Deletes a node and its contents from the source file.
SuggestedFix.Builder	deleteArgument(Node n, int position) Deletes an argument from an existing function call, including any JS doc that precedes it.
SuggestedFix.Builder	deleteWithoutRemovingWhitespace(Node n) Deletes a node without touching any surrounding whitespace.
SuggestedFix.Builder	deleteWithoutRemovingWhitespaceBefore(Node n) Deletes a node and its contents from the source file.
java.lang.String	generateCode(AbstractCompiler compiler, Node node)
java.lang.String	getRequireName(Match m, java.lang.String namespace) If the namespace has a short name, return it.
SuggestedFix.Builder	insertAfter(Node node, java.lang.String text) Inserts the text after the given node
SuggestedFix.Builder	insertArguments(Node n, int position, java.lang.String... args) Inserts arguments into an existing function call.
SuggestedFix.Builder	insertBefore(Node nodeToInsertBefore, Node n, AbstractCompiler compiler) Inserts a new node before the provided node.
SuggestedFix.Builder	insertBefore(Node nodeToInsertBefore, java.lang.String content) Inserts a string before the provided node.
SuggestedFix.Builder	removeCast(Node n, AbstractCompiler compiler) Removes a cast from the given node.
SuggestedFix.Builder	removeGoogRequire(Match m, java.lang.String namespace) Removes a goog.require for the given namespace to the file if it already exists.
SuggestedFix.Builder	rename(Node n, java.lang.String name) Renames a given node to the provided name.
SuggestedFix.Builder	rename(Node n, java.lang.String name, boolean replaceEntireName) Renames a given node to the provided name.
SuggestedFix.Builder	replace(Node original, Node newNode, AbstractCompiler compiler) Replaces the provided node with new node in the source file.
SuggestedFix.Builder	replaceRange(Node first, Node last, java.lang.String newContent) Replaces a range of nodes with the given content.
SuggestedFix.Builder	setDescription(java.lang.String description)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Builder

public Builder()

Method Detail

attachMatchedNodeInfo

public SuggestedFix.Builder attachMatchedNodeInfo(Node node,
                                                  AbstractCompiler compiler)

Sets the node on this SuggestedFix that caused this SuggestedFix to be built in the first place.

addAlternative

public SuggestedFix.Builder addAlternative(SuggestedFix alternative)

addChildToFront

public SuggestedFix.Builder addChildToFront(Node parentNode,
                                            java.lang.String content)

Inserts a new node as the first child of the provided node.

insertAfter

public SuggestedFix.Builder insertAfter(Node node,
                                        java.lang.String text)

Inserts the text after the given node

insertBefore

public SuggestedFix.Builder insertBefore(Node nodeToInsertBefore,
                                         Node n,
                                         AbstractCompiler compiler)

Inserts a new node before the provided node.

insertBefore

public SuggestedFix.Builder insertBefore(Node nodeToInsertBefore,
                                         java.lang.String content)

Inserts a string before the provided node. This is useful for inserting comments into a file since the JS Compiler doesn't currently support printing comments.

delete

public SuggestedFix.Builder delete(Node n)

Deletes a node and its contents from the source file. If the node is a child of a block or top level statement, this will also delete the whitespace before the node.

deleteWithoutRemovingWhitespaceBefore

public SuggestedFix.Builder deleteWithoutRemovingWhitespaceBefore(Node n)

Deletes a node and its contents from the source file.

deleteWithoutRemovingWhitespace

public SuggestedFix.Builder deleteWithoutRemovingWhitespace(Node n)

Deletes a node without touching any surrounding whitespace.

rename

public SuggestedFix.Builder rename(Node n,
                                   java.lang.String name)

Renames a given node to the provided name.

Parameters:

n - The node to rename.

name - The new name for the node.

rename

public SuggestedFix.Builder rename(Node n,
                                   java.lang.String name,
                                   boolean replaceEntireName)

Renames a given node to the provided name.

Parameters:

n - The node to rename.

name - The new name for the node.

replaceEntireName - True to replace the entire name of the node. The default is to replace just the last property in the node with the new name. For instance, if replaceEntireName is false, then this.foo() will be renamed to this.bar(). However, if it is true, it will be renamed to bar().

replaceRange

public SuggestedFix.Builder replaceRange(Node first,
                                         Node last,
                                         java.lang.String newContent)

Replaces a range of nodes with the given content.

replace

public SuggestedFix.Builder replace(Node original,
                                    Node newNode,
                                    AbstractCompiler compiler)

Replaces the provided node with new node in the source file.

addCast

public SuggestedFix.Builder addCast(Node n,
                                    AbstractCompiler compiler,
                                    java.lang.String type)

Adds a cast of the given type to the provided node.

removeCast

public SuggestedFix.Builder removeCast(Node n,
                                       AbstractCompiler compiler)

Removes a cast from the given node.

addOrReplaceJsDoc

public SuggestedFix.Builder addOrReplaceJsDoc(Node n,
                                              java.lang.String newJsDoc)

Adds or replaces the JS Doc for the given node.

changeJsDocType

public SuggestedFix.Builder changeJsDocType(Node n,
                                            AbstractCompiler compiler,
                                            java.lang.String type)

Changes the JS Doc Type of the given node.

insertArguments

public SuggestedFix.Builder insertArguments(Node n,
                                            int position,
                                            java.lang.String... args)

Inserts arguments into an existing function call.

deleteArgument

public SuggestedFix.Builder deleteArgument(Node n,
                                           int position)

Deletes an argument from an existing function call, including any JS doc that precedes it. WARNING: If jsdoc erroneously follows the argument, it will not be removed as the parser considers the comment to belong to the next argument.

addLhsToGoogRequire

public SuggestedFix.Builder addLhsToGoogRequire(Match m,
                                                java.lang.String namespace)

addGoogRequire

public SuggestedFix.Builder addGoogRequire(Match m,
                                           java.lang.String namespace)

Adds a goog.require for the given namespace to the file if it does not already exist.

getRequireName

public java.lang.String getRequireName(Match m,
                                       java.lang.String namespace)

If the namespace has a short name, return it. Otherwise return the full name.

Assumes addGoogRequire was already called.

removeGoogRequire

public SuggestedFix.Builder removeGoogRequire(Match m,
                                              java.lang.String namespace)

Removes a goog.require for the given namespace to the file if it already exists.

generateCode

public java.lang.String generateCode(AbstractCompiler compiler,
                                     Node node)

setDescription

public SuggestedFix.Builder setDescription(java.lang.String description)

build

public SuggestedFix build()