|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectedu.umd.cs.findbugs.SourceLineAnnotation
public class SourceLineAnnotation
A BugAnnotation that records a range of source lines in a class.
BugAnnotation
,
Serialized FormField Summary | |
---|---|
static java.lang.String |
UNKNOWN_SOURCE_FILE
String returned if the source file is unknown. |
Fields inherited from interface edu.umd.cs.findbugs.BugAnnotation |
---|
MESSAGE_TAG |
Constructor Summary | |
---|---|
SourceLineAnnotation(java.lang.String className,
java.lang.String sourceFile,
int startLine,
int endLine,
int startBytecode,
int endBytecode)
Constructor. |
Method Summary | |
---|---|
void |
accept(BugAnnotationVisitor visitor)
Accept a BugAnnotationVisitor. |
java.lang.Object |
clone()
|
int |
compareTo(BugAnnotation o)
|
static SourceLineAnnotation |
createUnknown(java.lang.String className)
Factory method to create an unknown source line annotation. |
static SourceLineAnnotation |
createUnknown(java.lang.String className,
java.lang.String sourceFile)
Factory method to create an unknown source line annotation. |
static SourceLineAnnotation |
createUnknown(java.lang.String className,
java.lang.String sourceFile,
int startBytecode,
int endBytecode)
Factory method to create an unknown source line annotation. |
boolean |
equals(java.lang.Object o)
|
static SourceLineAnnotation |
forEntireMethod(org.apache.bcel.classfile.JavaClass javaClass,
org.apache.bcel.classfile.Method method)
Create a SourceLineAnnotation covering an entire method. |
static SourceLineAnnotation |
forEntireMethod(org.apache.bcel.classfile.JavaClass javaClass,
XMethod xmethod)
Create a SourceLineAnnotation covering an entire method. |
static SourceLineAnnotation |
forEntireMethod(java.lang.String className,
java.lang.String sourceFile,
org.apache.bcel.classfile.LineNumberTable lineNumberTable,
int codeSize)
Create a SourceLineAnnotation covering an entire method. |
java.lang.String |
format(java.lang.String key)
Format the annotation as a String. |
static SourceLineAnnotation |
fromVisitedInstruction(BytecodeScanningDetector visitor)
Factory method for creating a source line annotation describing the source line number for the instruction being visited by given visitor. |
static SourceLineAnnotation |
fromVisitedInstruction(BytecodeScanningDetector visitor,
int pc)
Factory method for creating a source line annotation describing the source line number for the instruction being visited by given visitor. |
static SourceLineAnnotation |
fromVisitedInstruction(ClassContext classContext,
org.apache.bcel.generic.MethodGen methodGen,
java.lang.String sourceFile,
org.apache.bcel.generic.InstructionHandle handle)
Factory method for creating a source line annotation describing the source line number for a visited instruction. |
static SourceLineAnnotation |
fromVisitedInstruction(ClassContext classContext,
PreorderVisitor visitor,
int pc)
Factory method for creating a source line annotation describing the source line number for the instruction being visited by given visitor. |
static SourceLineAnnotation |
fromVisitedInstructionRange(BytecodeScanningDetector visitor,
int startPC,
int endPC)
Factory method for creating a source line annotation describing the source line numbers for a range of instructions in the method being visited by the given visitor. |
static SourceLineAnnotation |
fromVisitedInstructionRange(ClassContext classContext,
org.apache.bcel.generic.MethodGen methodGen,
java.lang.String sourceFile,
org.apache.bcel.generic.InstructionHandle start,
org.apache.bcel.generic.InstructionHandle end)
Factory method for creating a source line annotation describing the source line numbers for a range of instruction in a method. |
static SourceLineAnnotation |
fromVisitedInstructionRange(ClassContext classContext,
PreorderVisitor visitor,
int startPC,
int endPC)
Factory method for creating a source line annotation describing the source line numbers for a range of instructions in the method being visited by the given visitor. |
static SourceLineAnnotation |
fromVisitedMethod(org.apache.bcel.generic.MethodGen methodGen,
java.lang.String sourceFile)
Factory method for creating a source line annotation describing an entire method. |
static SourceLineAnnotation |
fromVisitedMethod(PreorderVisitor visitor)
Factory method for creating a source line annotation describing an entire method. |
java.lang.String |
getClassName()
Get the class name. |
java.lang.String |
getDescription()
Get a description of this bug annotation. |
int |
getEndBytecode()
Get end bytecode (inclusive). |
int |
getEndLine()
Get the ending line (inclusive). |
java.lang.String |
getPackageName()
Get the package name. |
java.lang.String |
getSourceFile()
Get the source file name. |
int |
getStartBytecode()
Get start bytecode (inclusive). |
int |
getStartLine()
Get the start line (inclusive). |
int |
hashCode()
|
boolean |
isSourceFileKnown()
Is the source file known? |
boolean |
isSynthetic()
|
boolean |
isUnknown()
Is this an unknown source line annotation? |
void |
setDescription(java.lang.String description)
Set a description of this bug annotation. |
void |
setSourceFile(java.lang.String sourceFile)
Set the source file name. |
void |
setSynthetic(boolean synthetic)
|
java.lang.String |
toString()
|
void |
writeXML(XMLOutput xmlOutput)
Write this object to given XMLOutput. |
void |
writeXML(XMLOutput xmlOutput,
boolean addMessages)
|
Methods inherited from class java.lang.Object |
---|
finalize, getClass, notify, notifyAll, wait, wait, wait |
Field Detail |
---|
public static final java.lang.String UNKNOWN_SOURCE_FILE
Constructor Detail |
---|
public SourceLineAnnotation(java.lang.String className, java.lang.String sourceFile, int startLine, int endLine, int startBytecode, int endBytecode)
className
- the class to which the line number(s) refersourceFile
- the name of the source filestartLine
- the first line (inclusive)endLine
- the ending line (inclusive)startBytecode
- the first bytecode offset (inclusive)endBytecode
- the end bytecode offset (inclusive)Method Detail |
---|
public java.lang.Object clone()
clone
in interface BugAnnotation
clone
in class java.lang.Object
public static SourceLineAnnotation createUnknown(java.lang.String className, java.lang.String sourceFile)
className
- the class namesourceFile
- the source file name
public static SourceLineAnnotation createUnknown(java.lang.String className)
className
- the class name
public static SourceLineAnnotation createUnknown(java.lang.String className, java.lang.String sourceFile, int startBytecode, int endBytecode)
className
- the class namesourceFile
- the source file name
public static SourceLineAnnotation fromVisitedMethod(PreorderVisitor visitor)
visitor
- a BetterVisitor which is visiting the method
public static SourceLineAnnotation fromVisitedMethod(org.apache.bcel.generic.MethodGen methodGen, java.lang.String sourceFile)
methodGen
- the method being visited
public static SourceLineAnnotation forEntireMethod(java.lang.String className, java.lang.String sourceFile, org.apache.bcel.classfile.LineNumberTable lineNumberTable, int codeSize)
className
- name of the class the method is insourceFile
- source file containing the methodlineNumberTable
- the method's LineNumberTablecodeSize
- size in bytes of the method's code
public static SourceLineAnnotation forEntireMethod(org.apache.bcel.classfile.JavaClass javaClass, org.apache.bcel.classfile.Method method)
javaClass
- JavaClass containing the methodmethod
- the method
public static SourceLineAnnotation forEntireMethod(org.apache.bcel.classfile.JavaClass javaClass, XMethod xmethod)
javaClass
- JavaClass containing the methodxmethod
- the method
public static SourceLineAnnotation fromVisitedInstruction(BytecodeScanningDetector visitor, int pc)
visitor
- a BetterVisitor which is visiting the methodpc
- the bytecode offset of the instruction in the method
public static SourceLineAnnotation fromVisitedInstruction(ClassContext classContext, PreorderVisitor visitor, int pc)
classContext
- the ClassContextvisitor
- a BetterVisitor which is visiting the methodpc
- the bytecode offset of the instruction in the method
public static SourceLineAnnotation fromVisitedInstructionRange(BytecodeScanningDetector visitor, int startPC, int endPC)
visitor
- a BetterVisitor which is visiting the methodstartPC
- the bytecode offset of the start instruction in the rangeendPC
- the bytecode offset of the end instruction in the range
public static SourceLineAnnotation fromVisitedInstructionRange(ClassContext classContext, PreorderVisitor visitor, int startPC, int endPC)
classContext
- the ClassContextvisitor
- a BetterVisitor which is visiting the methodstartPC
- the bytecode offset of the start instruction in the rangeendPC
- the bytecode offset of the end instruction in the range
public static SourceLineAnnotation fromVisitedInstruction(BytecodeScanningDetector visitor)
visitor
- a DismantleBytecode visitor which is visiting the method
public static SourceLineAnnotation fromVisitedInstruction(ClassContext classContext, org.apache.bcel.generic.MethodGen methodGen, java.lang.String sourceFile, @NonNull org.apache.bcel.generic.InstructionHandle handle)
classContext
- the ClassContextmethodGen
- the MethodGen object representing the methodhandle
- the InstructionHandle containing the visited instruction
public static SourceLineAnnotation fromVisitedInstructionRange(ClassContext classContext, org.apache.bcel.generic.MethodGen methodGen, java.lang.String sourceFile, org.apache.bcel.generic.InstructionHandle start, org.apache.bcel.generic.InstructionHandle end)
classContext
- theClassContextmethodGen
- the methodstart
- the start instructionend
- the end instruction (inclusive)public java.lang.String getClassName()
public java.lang.String getSourceFile()
public boolean isSourceFileKnown()
public void setSourceFile(java.lang.String sourceFile)
sourceFile
- the source file namepublic java.lang.String getPackageName()
public int getStartLine()
public int getEndLine()
public int getStartBytecode()
public int getEndBytecode()
public boolean isUnknown()
public void accept(BugAnnotationVisitor visitor)
BugAnnotation
accept
in interface BugAnnotation
visitor
- the visitor to acceptpublic java.lang.String format(java.lang.String key)
BugAnnotation
format
in interface BugAnnotation
key
- how the annotation should be formattedpublic java.lang.String getDescription()
BugAnnotation
getDescription
in interface BugAnnotation
public void setDescription(java.lang.String description)
BugAnnotation
setDescription
in interface BugAnnotation
public java.lang.String toString()
toString
in class java.lang.Object
public int compareTo(BugAnnotation o)
compareTo
in interface java.lang.Comparable<BugAnnotation>
public int hashCode()
hashCode
in class java.lang.Object
public boolean equals(java.lang.Object o)
equals
in class java.lang.Object
public void writeXML(XMLOutput xmlOutput) throws java.io.IOException
XMLWriteable
writeXML
in interface XMLWriteable
xmlOutput
- the XMLOutput for the document
java.io.IOException
public void writeXML(XMLOutput xmlOutput, boolean addMessages) throws java.io.IOException
writeXML
in interface XMLWriteableWithMessages
java.io.IOException
public void setSynthetic(boolean synthetic)
synthetic
- The synthetic to set.public boolean isSynthetic()
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |