Package org.apache.jasper.compiler

Class SmapStratum

java.lang.Object

org.apache.jasper.compiler.SmapStratum

public class SmapStratum
extends Object

Represents the line and file mappings associated with a JSR-045 "stratum".

Author:

Jayson Falkner, Shawn Bayern

Constructor Summary

Constructors

Constructor	Description
SmapStratum()

Method Summary

Modifier and Type	Method	Description
void	addFile(String filename)	Adds record of a new file, by filename.
void	addFile(String filename, String filePath)	Adds record of a new file, by filename and path.
void	addLineData(int inputStartLine, String inputFileName, int inputLineCount, int outputStartLine, int outputLineIncrement)	Adds complete information about a simple line mapping.
void	addLineInfo(org.apache.jasper.compiler.SmapStratum.LineInfo li)
String	getClassFileName()
SmapInput	getInputLineNumber(int outputLineNumber)
String	getSmapString()
void	optimizeLineSection()	Combines consecutive LineInfos wherever possible
void	setClassFileName(String classFileName)
void	setOutputFileName(String outputFileName)
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

SmapStratum

public SmapStratum()

Method Detail

addFile

public void addFile(String filename)

Adds record of a new file, by filename.

Parameters:

filename - the filename to add, unqualified by path.

addFile

public void addFile(String filename,
                    String filePath)

Adds record of a new file, by filename and path. The path may be relative to a source compilation path.

Parameters:

filename - the filename to add, unqualified by path

filePath - the path for the filename, potentially relative to a source compilation path

optimizeLineSection

public void optimizeLineSection()

Combines consecutive LineInfos wherever possible

addLineData

public void addLineData(int inputStartLine,
                        String inputFileName,
                        int inputLineCount,
                        int outputStartLine,
                        int outputLineIncrement)

Adds complete information about a simple line mapping. Specify all the fields in this method; the back-end machinery takes care of printing only those that are necessary in the final SMAP. (My view is that fields are optional primarily for spatial efficiency, not for programmer convenience. Could always add utility methods later.)

Parameters:

inputStartLine - starting line in the source file (SMAP InputStartLine)

inputFileName - the filepath (or name) from which the input comes (yields SMAP LineFileID) Use unqualified names carefully, and only when they uniquely identify a file.

inputLineCount - the number of lines in the input to map (SMAP LineFileCount)

outputStartLine - starting line in the output file (SMAP OutputStartLine)

outputLineIncrement - number of output lines to map to each input line (SMAP OutputLineIncrement). Given the fact that the name starts with "output", I continuously have the subconscious urge to call this field OutputLineExcrement.

addLineInfo

public void addLineInfo(org.apache.jasper.compiler.SmapStratum.LineInfo li)

setOutputFileName

public void setOutputFileName(String outputFileName)

setClassFileName

public void setClassFileName(String classFileName)

getClassFileName

public String getClassFileName()

toString

public String toString()

Overrides:

toString in class Object

getSmapString

public String getSmapString()

getInputLineNumber

public SmapInput getInputLineNumber(int outputLineNumber)