com.aaronicsubstances.code.augmentor.core.util

Class SourceCodeTransformer

java.lang.Object

com.aaronicsubstances.code.augmentor.core.util.SourceCodeTransformer

public class SourceCodeTransformer
extends java.lang.Object

Used by CodeAugmentationGenericTask to make a series of replacements in a source code file at prespecified offsets in the file.

It enables one to start with a string (referred to as original string), and change that string using indices into original string. The class takes care of mapping the original string indices to positions in the modified version of the string.

Constructor Summary

Constructors

Constructor and Description
SourceCodeTransformer(java.lang.String originalText) Creates a new instance.

Method Summary

Modifier and Type	Method and Description
void	addTransform(java.lang.String replacement, int startPos) Inserts a string into original string and updates adjusting offset information.
void	addTransform(java.lang.String replacement, int startPos, int endPos) Changes a section in original string and updates adjusting offset information.
int	getPositionAdjustment() Gets offset that can be added to an index into original string to get corresponding position in modified string.
java.lang.String	getTransformedText() Gets string resulting from modification of original string by replacements.

Methods inherited from class java.lang.Object

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

Constructor Detail

SourceCodeTransformer

public SourceCodeTransformer(java.lang.String originalText)

Creates a new instance.

Parameters:

originalText - the original string

Method Detail

addTransform

public void addTransform(java.lang.String replacement,
                         int startPos)

Inserts a string into original string and updates adjusting offset information.

Parameters:

replacement - string to insert.

startPos - position in original string to insert at.

addTransform

public void addTransform(java.lang.String replacement,
                         int startPos,
                         int endPos)

Changes a section in original string and updates adjusting offset information.

Parameters:

replacement - replacement for string section.

startPos - starting position (inclusive) of original string section

endPos - ending position (exclusive) of original string section

getTransformedText

public java.lang.String getTransformedText()

Gets string resulting from modification of original string by replacements.

Returns:

modified string.

getPositionAdjustment

public int getPositionAdjustment()

Gets offset that can be added to an index into original string to get corresponding position in modified string. As long as index does not point within any section which has been changed, that index can be used as a position into modified string using this property.

Returns:

offset for adjusting original positions.