Class SmapStratum


  • public class SmapStratum
    extends java.lang.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

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      void addFile​(java.lang.String filename)
      Adds record of a new file, by filename.
      void addFile​(java.lang.String filename, java.lang.String filePath)
      Adds record of a new file, by filename and path.
      void addLineData​(int inputStartLine, java.lang.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)  
      java.lang.String getClassFileName()  
      SmapInput getInputLineNumber​(int outputLineNumber)  
      java.lang.String getSmapString()  
      void optimizeLineSection()
      Combines consecutive LineInfos wherever possible
      void setClassFileName​(java.lang.String classFileName)  
      void setOutputFileName​(java.lang.String outputFileName)  
      java.lang.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​(java.lang.String filename)
        Adds record of a new file, by filename.
        Parameters:
        filename - the filename to add, unqualified by path.
      • addFile

        public void addFile​(java.lang.String filename,
                            java.lang.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,
                                java.lang.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​(java.lang.String outputFileName)
      • setClassFileName

        public void setClassFileName​(java.lang.String classFileName)
      • getClassFileName

        public java.lang.String getClassFileName()
      • toString

        public java.lang.String toString()
        Overrides:
        toString in class java.lang.Object
      • getSmapString

        public java.lang.String getSmapString()
      • getInputLineNumber

        public SmapInput getInputLineNumber​(int outputLineNumber)