instructionhandle.html

一个用于对.class文件进行插桩的开源工具

<!-- ========= CONSTRUCTOR DETAIL ======== -->

<A NAME="constructor_detail"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Constructor Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="InstructionHandle(org.apache.bcel.generic.Instruction)"><!-- --></A><H3>
InstructionHandle</H3>
<PRE>
protected <B>InstructionHandle</B>(<A HREF="../../../../org/apache/bcel/generic/Instruction.html">Instruction</A>&nbsp;i)</PRE>
<DL>
</DL>

<!-- ============ METHOD DETAIL ========== -->

<A NAME="method_detail"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Method Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="getNext()"><!-- --></A><H3>
getNext</H3>
<PRE>
public final <A HREF="../../../../org/apache/bcel/generic/InstructionHandle.html">InstructionHandle</A> <B>getNext</B>()</PRE>
<DL>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="getPrev()"><!-- --></A><H3>
getPrev</H3>
<PRE>
public final <A HREF="../../../../org/apache/bcel/generic/InstructionHandle.html">InstructionHandle</A> <B>getPrev</B>()</PRE>
<DL>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="getInstruction()"><!-- --></A><H3>
getInstruction</H3>
<PRE>
public final <A HREF="../../../../org/apache/bcel/generic/Instruction.html">Instruction</A> <B>getInstruction</B>()</PRE>
<DL>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="setInstruction(org.apache.bcel.generic.Instruction)"><!-- --></A><H3>
setInstruction</H3>
<PRE>
public void <B>setInstruction</B>(<A HREF="../../../../org/apache/bcel/generic/Instruction.html">Instruction</A>&nbsp;i)</PRE>
<DL>
<DD>Replace current instruction contained in this handle.
 Old instruction is disposed using Instruction.dispose().<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="swapInstruction(org.apache.bcel.generic.Instruction)"><!-- --></A><H3>
swapInstruction</H3>
<PRE>
public <A HREF="../../../../org/apache/bcel/generic/Instruction.html">Instruction</A> <B>swapInstruction</B>(<A HREF="../../../../org/apache/bcel/generic/Instruction.html">Instruction</A>&nbsp;i)</PRE>
<DL>
<DD>Temporarily swap the current instruction, without disturbing
 anything. Meant to be used by a debugger, implementing
 breakpoints. Current instruction is returned.<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="updatePosition(int, int)"><!-- --></A><H3>
updatePosition</H3>
<PRE>
protected int <B>updatePosition</B>(int&nbsp;offset,
                             int&nbsp;max_offset)</PRE>
<DL>
<DD>Called by InstructionList.setPositions when setting the position for every
 instruction. In the presence of variable length instructions `setPositions()'
 performs multiple passes over the instruction list to calculate the
 correct (byte) positions and offsets by calling this function.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>offset</CODE> - additional offset caused by preceding (variable length) instructions<DD><CODE>max_offset</CODE> - the maximum offset that may be caused by these instructions<DT><B>Returns:</B><DD>additional offset caused by possible change of this instruction's length</DL>
</DD>
</DL>
<HR>

<A NAME="getPosition()"><!-- --></A><H3>
getPosition</H3>
<PRE>
public int <B>getPosition</B>()</PRE>
<DL>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>the position, i.e., the byte code offset of the contained
 instruction. This is accurate only after
 InstructionList.setPositions() has been called.</DL>
</DD>
</DL>
<HR>

<A NAME="addHandle()"><!-- --></A><H3>
addHandle</H3>
<PRE>
protected void <B>addHandle</B>()</PRE>
<DL>
<DD>Overridden in BranchHandle<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="removeAllTargeters()"><!-- --></A><H3>
removeAllTargeters</H3>
<PRE>
public void <B>removeAllTargeters</B>()</PRE>
<DL>
<DD>Remove all targeters, if any.<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="removeTargeter(org.apache.bcel.generic.InstructionTargeter)"><!-- --></A><H3>
removeTargeter</H3>
<PRE>
public void <B>removeTargeter</B>(<A HREF="../../../../org/apache/bcel/generic/InstructionTargeter.html">InstructionTargeter</A>&nbsp;t)</PRE>
<DL>
<DD>Denote this handle isn't referenced anymore by t.<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="addTargeter(org.apache.bcel.generic.InstructionTargeter)"><!-- --></A><H3>
addTargeter</H3>
<PRE>
public void <B>addTargeter</B>(<A HREF="../../../../org/apache/bcel/generic/InstructionTargeter.html">InstructionTargeter</A>&nbsp;t)</PRE>
<DL>
<DD>Denote this handle is being referenced by t.<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="hasTargeters()"><!-- --></A><H3>
hasTargeters</H3>
<PRE>
public boolean <B>hasTargeters</B>()</PRE>
<DL>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="getTargeters()"><!-- --></A><H3>
getTargeters</H3>
<PRE>
public <A HREF="../../../../org/apache/bcel/generic/InstructionTargeter.html">InstructionTargeter</A>[] <B>getTargeters</B>()</PRE>
<DL>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>null, if there are no targeters</DL>
</DD>
</DL>
<HR>

<A NAME="toString(boolean)"><!-- --></A><H3>
toString</H3>
<PRE>
public java.lang.String <B>toString</B>(boolean&nbsp;verbose)</PRE>
<DL>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>a (verbose) string representation of the contained instruction.</DL>
</DD>
</DL>
<HR>

<A NAME="toString()"><!-- --></A><H3>
toString</H3>
<PRE>
public java.lang.String <B>toString</B>()</PRE>
<DL>
<DD><DL>
<DT><B>Overrides:</B><DD><CODE>toString</CODE> in class <CODE>java.lang.Object</CODE></DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>a string representation of the contained instruction.</DL>
</DD>
</DL>
<HR>

<A NAME="addAttribute(java.lang.Object, java.lang.Object)"><!-- --></A><H3>
addAttribute</H3>
<PRE>
public void <B>addAttribute</B>(java.lang.Object&nbsp;key,
                         java.lang.Object&nbsp;attr)</PRE>
<DL>
<DD>Add an attribute to an instruction handle.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>key</CODE> - the key object to store/retrieve the attribute<DD><CODE>attr</CODE> - the attribute to associate with this handle</DL>
</DD>
</DL>
<HR>

<A NAME="removeAttribute(java.lang.Object)"><!-- --></A><H3>
removeAttribute</H3>
<PRE>
public void <B>removeAttribute</B>(java.lang.Object&nbsp;key)</PRE>
<DL>
<DD>Delete an attribute of an instruction handle.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>key</CODE> - the key object to retrieve the attribute</DL>
</DD>
</DL>
<HR>

<A NAME="getAttribute(java.lang.Object)"><!-- --></A><H3>
getAttribute</H3>
<PRE>
public java.lang.Object <B>getAttribute</B>(java.lang.Object&nbsp;key)</PRE>
<DL>
<DD>Get attribute of an instruction handle.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>key</CODE> - the key object to store/retrieve the attribute</DL>
</DD>
</DL>
<HR>

<A NAME="getAttributes()"><!-- --></A><H3>
getAttributes</H3>
<PRE>
public java.util.Collection <B>getAttributes</B>()</PRE>
<DL>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>all attributes associated with this handle</DL>
</DD>
</DL>
<HR>

<A NAME="accept(org.apache.bcel.generic.Visitor)"><!-- --></A><H3>
accept</H3>
<PRE>
public void <B>accept</B>(<A HREF="../../../../org/apache/bcel/generic/Visitor.html">Visitor</A>&nbsp;v)</PRE>
<DL>
<DD>Convenience method, simply calls accept() on the contained instruction.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>v</CODE> - Visitor object</DL>
</DD>
</DL>
<!-- ========= END OF CLASS DATA ========= -->
<HR>

<!-- ========== START OF NAVBAR ========== -->
<A NAME="navbar_bottom"><!-- --></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
  <TR ALIGN="center" VALIGN="top">
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/InstructionHandle.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
  </TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>

<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="../../../../org/apache/bcel/generic/InstructionFactory.html"><B>PREV CLASS</B></A>&nbsp;
&nbsp;<A HREF="../../../../org/apache/bcel/generic/InstructionList.html"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../../../index.html" TARGET="_top"><B>FRAMES</B></A>  &nbsp;
&nbsp;<A HREF="InstructionHandle.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  SUMMARY: &nbsp;INNER&nbsp;|&nbsp;<A HREF="#field_summary">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL: &nbsp;<A HREF="#field_detail">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<!-- =========== END OF NAVBAR =========== -->

<HR>

</BODY>
</HTML>