utility.html

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

public static final java.lang.String <B>classOrInterface</B>(int&nbsp;access_flags)</PRE>
<DL>
<DD><DL>
<DT><B>Returns:</B><DD>"class" or "interface", depending on the ACC_INTERFACE flag</DL>
</DD>
</DL>
<HR>

<A NAME="codeToString(byte[], org.apache.bcel.classfile.ConstantPool, int, int, boolean)"><!-- --></A><H3>
codeToString</H3>
<PRE>
public static final java.lang.String <B>codeToString</B>(byte[]&nbsp;code,
                                                  <A HREF="../../../../org/apache/bcel/classfile/ConstantPool.html">ConstantPool</A>&nbsp;constant_pool,
                                                  int&nbsp;index,
                                                  int&nbsp;length,
                                                  boolean&nbsp;verbose)</PRE>
<DL>
<DD>Disassemble a byte array of JVM byte codes starting from code line 
 `index' and return the disassembled string representation. Decode only
 `num' opcodes (including their operands), use -1 if you want to
 decompile everything.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>code</CODE> - byte code array<DD><CODE>constant_pool</CODE> - Array of constants<DD><CODE>index</CODE> - offset in `code' array
 <EM>(number of opcodes, not bytes!)</EM><DD><CODE>length</CODE> - number of opcodes to decompile, -1 for all<DD><CODE>verbose</CODE> - be verbose, e.g. print constant pool index<DT><B>Returns:</B><DD>String representation of byte codes</DL>
</DD>
</DL>
<HR>

<A NAME="codeToString(byte[], org.apache.bcel.classfile.ConstantPool, int, int)"><!-- --></A><H3>
codeToString</H3>
<PRE>
public static final java.lang.String <B>codeToString</B>(byte[]&nbsp;code,
                                                  <A HREF="../../../../org/apache/bcel/classfile/ConstantPool.html">ConstantPool</A>&nbsp;constant_pool,
                                                  int&nbsp;index,
                                                  int&nbsp;length)</PRE>
<DL>
</DL>
<HR>

<A NAME="codeToString(org.apache.bcel.util.ByteSequence, org.apache.bcel.classfile.ConstantPool, boolean)"><!-- --></A><H3>
codeToString</H3>
<PRE>
public static final java.lang.String <B>codeToString</B>(<A HREF="../../../../org/apache/bcel/util/ByteSequence.html">ByteSequence</A>&nbsp;bytes,
                                                  <A HREF="../../../../org/apache/bcel/classfile/ConstantPool.html">ConstantPool</A>&nbsp;constant_pool,
                                                  boolean&nbsp;verbose)
                                           throws java.io.IOException</PRE>
<DL>
<DD>Disassemble a stream of byte codes and return the
 string representation.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>bytes</CODE> - stream of bytes<DD><CODE>constant_pool</CODE> - Array of constants<DD><CODE>verbose</CODE> - be verbose, e.g. print constant pool index<DT><B>Returns:</B><DD>String representation of byte code</DL>
</DD>
</DL>
<HR>

<A NAME="codeToString(org.apache.bcel.util.ByteSequence, org.apache.bcel.classfile.ConstantPool)"><!-- --></A><H3>
codeToString</H3>
<PRE>
public static final java.lang.String <B>codeToString</B>(<A HREF="../../../../org/apache/bcel/util/ByteSequence.html">ByteSequence</A>&nbsp;bytes,
                                                  <A HREF="../../../../org/apache/bcel/classfile/ConstantPool.html">ConstantPool</A>&nbsp;constant_pool)
                                           throws java.io.IOException</PRE>
<DL>
</DL>
<HR>

<A NAME="compactClassName(java.lang.String)"><!-- --></A><H3>
compactClassName</H3>
<PRE>
public static final java.lang.String <B>compactClassName</B>(java.lang.String&nbsp;str)</PRE>
<DL>
<DD>Shorten long class names, <em>java/lang/String</em> becomes 
 <em>String</em>.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>str</CODE> - The long class name<DT><B>Returns:</B><DD>Compacted class name</DL>
</DD>
</DL>
<HR>

<A NAME="compactClassName(java.lang.String, java.lang.String, boolean)"><!-- --></A><H3>
compactClassName</H3>
<PRE>
public static final java.lang.String <B>compactClassName</B>(java.lang.String&nbsp;str,
                                                      java.lang.String&nbsp;prefix,
                                                      boolean&nbsp;chopit)</PRE>
<DL>
<DD>Shorten long class name <em>str</em>, i.e., chop off the <em>prefix</em>,
 if the
 class name starts with this string and the flag <em>chopit</em> is true.
 Slashes <em>/</em> are converted to dots <em>.</em>.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>str</CODE> - The long class name<DD><CODE>prefix</CODE> - The prefix the get rid off<DD><CODE>chopit</CODE> - Flag that determines whether chopping is executed or not<DT><B>Returns:</B><DD>Compacted class name</DL>
</DD>
</DL>
<HR>

<A NAME="compactClassName(java.lang.String, boolean)"><!-- --></A><H3>
compactClassName</H3>
<PRE>
public static final java.lang.String <B>compactClassName</B>(java.lang.String&nbsp;str,
                                                      boolean&nbsp;chopit)</PRE>
<DL>
<DD>Shorten long class names, <em>java/lang/String</em> becomes 
 <em>java.lang.String</em>,
 e.g.. If <em>chopit</em> is <em>true</em> the prefix <em>java.lang</em>
 is also removed.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>str</CODE> - The long class name<DD><CODE>chopit</CODE> - Flag that determines whether chopping is executed or not<DT><B>Returns:</B><DD>Compacted class name</DL>
</DD>
</DL>
<HR>

<A NAME="setBit(int, int)"><!-- --></A><H3>
setBit</H3>
<PRE>
public static final int <B>setBit</B>(int&nbsp;flag,
                               int&nbsp;i)</PRE>
<DL>
<DD><DL>
<DT><B>Returns:</B><DD>`flag' with bit `i' set to 1</DL>
</DD>
</DL>
<HR>

<A NAME="clearBit(int, int)"><!-- --></A><H3>
clearBit</H3>
<PRE>
public static final int <B>clearBit</B>(int&nbsp;flag,
                                 int&nbsp;i)</PRE>
<DL>
<DD><DL>
<DT><B>Returns:</B><DD>`flag' with bit `i' set to 0</DL>
</DD>
</DL>
<HR>

<A NAME="isSet(int, int)"><!-- --></A><H3>
isSet</H3>
<PRE>
public static final boolean <B>isSet</B>(int&nbsp;flag,
                                  int&nbsp;i)</PRE>
<DL>
<DD><DL>
<DT><B>Returns:</B><DD>true, if bit `i' in `flag' is set</DL>
</DD>
</DL>
<HR>

<A NAME="methodTypeToSignature(java.lang.String, java.lang.String[])"><!-- --></A><H3>
methodTypeToSignature</H3>
<PRE>
public static final java.lang.String <B>methodTypeToSignature</B>(java.lang.String&nbsp;ret,
                                                           java.lang.String[]&nbsp;argv)
                                                    throws java.lang.ClassFormatError</PRE>
<DL>
<DD>Converts string containing the method return and argument types 
 to a byte code method signature.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>ret</CODE> - Return type of method<DD><CODE>argv</CODE> - Types of method arguments<DT><B>Returns:</B><DD>Byte code representation of method signature</DL>
</DD>
</DL>
<HR>

<A NAME="methodSignatureArgumentTypes(java.lang.String)"><!-- --></A><H3>
methodSignatureArgumentTypes</H3>
<PRE>
public static final java.lang.String[] <B>methodSignatureArgumentTypes</B>(java.lang.String&nbsp;signature)
                                                             throws java.lang.ClassFormatError</PRE>
<DL>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>signature</CODE> - Method signature<DT><B>Returns:</B><DD>Array of argument types</DL>
</DD>
</DL>
<HR>

<A NAME="methodSignatureArgumentTypes(java.lang.String, boolean)"><!-- --></A><H3>
methodSignatureArgumentTypes</H3>
<PRE>
public static final java.lang.String[] <B>methodSignatureArgumentTypes</B>(java.lang.String&nbsp;signature,
                                                                    boolean&nbsp;chopit)
                                                             throws java.lang.ClassFormatError</PRE>
<DL>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>signature</CODE> - Method signature<DD><CODE>chopit</CODE> - Shorten class names ?<DT><B>Returns:</B><DD>Array of argument types</DL>
</DD>
</DL>
<HR>

<A NAME="methodSignatureReturnType(java.lang.String)"><!-- --></A><H3>
methodSignatureReturnType</H3>
<PRE>
public static final java.lang.String <B>methodSignatureReturnType</B>(java.lang.String&nbsp;signature)
                                                        throws java.lang.ClassFormatError</PRE>
<DL>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>signature</CODE> - Method signature<DT><B>Returns:</B><DD>return type of method</DL>
</DD>
</DL>
<HR>

<A NAME="methodSignatureReturnType(java.lang.String, boolean)"><!-- --></A><H3>
methodSignatureReturnType</H3>
<PRE>
public static final java.lang.String <B>methodSignatureReturnType</B>(java.lang.String&nbsp;signature,
                                                               boolean&nbsp;chopit)
                                                        throws java.lang.ClassFormatError</PRE>
<DL>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>signature</CODE> - Method signature<DD><CODE>chopit</CODE> - Shorten class names ?<DT><B>Returns:</B><DD>return type of method</DL>
</DD>
</DL>
<HR>

<A NAME="methodSignatureToString(java.lang.String, java.lang.String, java.lang.String)"><!-- --></A><H3>
methodSignatureToString</H3>
<PRE>
public static final java.lang.String <B>methodSignatureToString</B>(java.lang.String&nbsp;signature,
                                                             java.lang.String&nbsp;name,
                                                             java.lang.String&nbsp;access)</PRE>
<DL>
<DD>Converts method signature to string with all class names compacted.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>signature</CODE> - to convert<DD><CODE>name</CODE> - of method<DD><CODE>access</CODE> - flags of method<DT><B>Returns:</B><DD>Human readable signature</DL>
</DD>
</DL>
<HR>

<A NAME="methodSignatureToString(java.lang.String, java.lang.String, java.lang.String, boolean)"><!-- --></A><H3>
methodSignatureToString</H3>
<PRE>
public static final java.lang.String <B>methodSignatureToString</B>(java.lang.String&nbsp;signature,
                                                             java.lang.String&nbsp;name,
                                                             java.lang.String&nbsp;access,
                                                             boolean&nbsp;chopit)</PRE>
<DL>
</DL>
<HR>

<A NAME="methodSignatureToString(java.lang.String, java.lang.String, java.lang.String, boolean, org.apache.bcel.classfile.LocalVariableTable)"><!-- --></A><H3>
methodSignatureToString</H3>
<PRE>
public static final java.lang.String <B>methodSignatureToString</B>(java.lang.String&nbsp;signature,
                                                             java.lang.String&nbsp;name,
                                                             java.lang.String&nbsp;access,
                                                             boolean&nbsp;chopit,
                                                             <A HREF="../../../../org/apache/bcel/classfile/LocalVariableTable.html">LocalVariableTable</A>&nbsp;vars)
                                                      throws java.lang.ClassFormatError</PRE>
<DL>
<DD>A return璽ype signature represents the return value from a method.
 It is a series of bytes in the following grammar:

 <return_signature> ::= <field_type> | V

 The character V indicates that the method returns no value. Otherwise, the
 signature indicates the type of the return value.
 An argument signature represents an argument passed to a method:

 <argument_signature> ::= <field_type>

 A method signature represents the arguments that the method expects, and
 the value that it returns.
 <method_signature> ::= (<arguments_signature>) <return_signature>
 <arguments_signature>::= <argument_signature>*

 This method converts such a string into a Java type declaration like
 `void main(String[])' and throws a `ClassFormatError' when the parsed 
 type is invalid.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>signature</CODE> - Method signature<DD><CODE>name</CODE> - Method name<DD><CODE>access</CODE> - Method access rights<DT><B>Returns:</B><DD>Java type declaration</DL>
</DD>
</DL>
<HR>

<A NAME="replace(java.lang.String, java.lang.String, java.lang.String)"><!-- --></A><H3>
replace</H3>
<PRE>
public static final java.lang.String <B>replace</B>(java.lang.String&nbsp;str,
                                             java.lang.String&nbsp;old,
                                             java.lang.String&nbsp;new_)</PRE>
<DL>