classfiletransformer.html
来自「j2se5-api-zh,java文档的中文版本」· HTML 代码 · 共 243 行
HTML
243 行
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><!--NewPage--><HTML><HEAD><!-- Generated by javadoc (build 1.5.0_03) on Wed Nov 02 09:50:12 CST 2005 --><META http-equiv="Content-Type" content="text/html; charset=gb2312"><TITLE>ClassFileTransformer (Java 2 Platform SE 5.0)</TITLE><META NAME="keywords" CONTENT="java.lang.instrument.ClassFileTransformer interface"><LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style"><SCRIPT type="text/javascript">function windowTitle(){ parent.document.title="ClassFileTransformer (Java 2 Platform SE 5.0)";}</SCRIPT><NOSCRIPT></NOSCRIPT></HEAD><BODY BGCOLOR="white" onload="windowTitle();"><!-- ========= START OF TOP NAVBAR ======= --><A NAME="navbar_top"><!-- --></A><A HREF="#skip-navbar_top" title="跳过导航链接"></A><TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY=""><TR><TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1"><A NAME="navbar_top_firstrow"><!-- --></A><TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY=""> <TR ALIGN="center" VALIGN="top"> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>概述</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>软件包</B></FONT></A> </TD> <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>类</B></FONT> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/ClassFileTransformer.html"><FONT CLASS="NavBarFont1"><B>使用</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>树</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>已过时</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-files/index-1.html"><FONT CLASS="NavBarFont1"><B>索引</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>帮助</B></FONT></A> </TD> </TR></TABLE></TD><TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM><b>Java<sup><font size=-2>TM</font></sup> 2 Platform<br>Standard Ed. 5.0</b></EM></TD></TR><TR><TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="ClassDefinition.html" title="java.lang.instrument 中的类"><B>上一个类</B></A> <A HREF="IllegalClassFormatException.html" title="java.lang.instrument 中的类"><B>下一个类</B></A></FONT></TD><TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="../../../index.html@java_2Flang_2Finstrument_2FClassFileTransformer.html" target="_top"><B>框架</B></A> <A HREF="ClassFileTransformer.html" target="_top"><B>无框架</B></A> <SCRIPT type="text/javascript"> <!-- if(window==top) { document.writeln('<A HREF="../../../allclasses-noframe.html"><B>所有类</B></A>'); } //--></SCRIPT><NOSCRIPT> <A HREF="../../../allclasses-noframe.html"><B>所有类</B></A></NOSCRIPT></FONT></TD></TR><TR><TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> 摘要： 嵌套 | 字段 | 构造方法 | <A HREF="#method_summary">方法</A></FONT></TD><TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">详细信息： 字段 | 构造方法 | <A HREF="#method_detail">方法</A></FONT></TD></TR></TABLE><A NAME="skip-navbar_top"></A><!-- ========= END OF TOP NAVBAR ========= --><HR><!-- ======== START OF CLASS DATA ======== --><H2><FONT SIZE="-1">java.lang.instrument</FONT><BR>接口 ClassFileTransformer</H2><HR><DL><DT><PRE>public interface <B>ClassFileTransformer</B></DL></PRE><P>代理提供此接口的实现，以便转换类文件。在 JVM 定义类之前发生转换。 <P>注意，按《<i>The Java Virtual Machine Specification</i>》的 <a href="../../../../../../../../../java.sun.com/docs/books/vmspec/2nd-edition/html/ClassFile.doc.html#80959">The class File Format</a> 一章中定义的方式使用术语<i>类文件</i>，它指的是以类文件格式表示的字节序列，无论该序列是否驻留于文件中。<P><P><DL><DT><B>从以下版本开始：</B></DT> <DD>JDK1.5</DD><DT><B>另请参见：</B><DD><A HREF="Instrumentation.html" title="java.lang.instrument 中的接口"><CODE>Instrumentation</CODE></A>, <A HREF="Instrumentation.html#addTransformer(java.lang.instrument.ClassFileTransformer)"><CODE>Instrumentation.addTransformer(java.lang.instrument.ClassFileTransformer)</CODE></A>, <A HREF="Instrumentation.html#removeTransformer(java.lang.instrument.ClassFileTransformer)"><CODE>Instrumentation.removeTransformer(java.lang.instrument.ClassFileTransformer)</CODE></A></DL><HR><P><!-- ========== METHOD SUMMARY =========== --><A NAME="method_summary"><!-- --></A><TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""><TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"><TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2"><B>方法摘要</B></FONT></TH></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> byte[]</CODE></FONT></TD><TD><CODE><B><A HREF="ClassFileTransformer.html#transform(java.lang.ClassLoader, java.lang.String, java.lang.Class, java.security.ProtectionDomain, byte[])">transform</A></B>(<A HREF="../ClassLoader.html" title="java.lang 中的类">ClassLoader</A> loader, <A HREF="../String.html" title="java.lang 中的类">String</A> className, <A HREF="../Class.html" title="java.lang 中的类">Class</A><?> classBeingRedefined, java.security.ProtectionDomain protectionDomain, byte[] classfileBuffer)</CODE><BR> 实现此方法可以转换提供的类文件，并返回一个新的替换类文件。</TD></TR></TABLE> <P><!-- ============ METHOD DETAIL ========== --><A NAME="method_detail"><!-- --></A><TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""><TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"><TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2"><B>方法详细信息</B></FONT></TH></TR></TABLE><A NAME="transform(java.lang.ClassLoader, java.lang.String, java.lang.Class, java.security.ProtectionDomain, byte[])"><!-- --></A><H3>transform</H3><PRE>byte[] <B>transform</B>(<A HREF="../ClassLoader.html" title="java.lang 中的类">ClassLoader</A> loader, <A HREF="../String.html" title="java.lang 中的类">String</A> className, <A HREF="../Class.html" title="java.lang 中的类">Class</A><?> classBeingRedefined, java.security.ProtectionDomain protectionDomain, byte[] classfileBuffer) throws <A HREF="IllegalClassFormatException.html" title="java.lang.instrument 中的类">IllegalClassFormatException</A></PRE><DL><DD>实现此方法可以转换提供的类文件，并返回一个新的替换类文件。 <P>在转换器利用 <A HREF="Instrumentation.html#addTransformer(java.lang.instrument.ClassFileTransformer)"><CODE>Instrumentation.addTransformer</CODE></A> 注册之后，在定义每个新类和重定义每个类时都将调用该转换器。对新的类定义的请求通过 <A HREF="../ClassLoader.html#defineClass(byte[], int, int)"><CODE>ClassLoader.defineClass</CODE></A> 进行。对类重定义的请求通过 <A HREF="Instrumentation.html#redefineClasses(java.lang.instrument.ClassDefinition[])"><CODE>Instrumentation.redefineClasses</CODE></A> 或其本机等效方法进行。转换器是在验证或应用类文件字节之前的处理请求过程中进行调用的。 <P>如果实现方法确定不需要进行转换，则将返回 <code>null</code>。否则，它将创建一个新的 <code>byte[]</code> 数组，将输入 <code>classfileBuffer</code> 连同所有需要的转换复制到其中，并返回新数组。不得修改输入 <code>classfileBuffer</code>。 <P>在重定义情形中，转换器必须支持重定义语义。如果转换器在最初定义期间更改的类在以后要重定义，转换器必须确保第二个输出类文件是第一个输出类文件的合法重定义文件。 <P>如果转换器认为 <code>classFileBuffer</code> 不表示一个有效格式的类文件，则将抛出 <code>IllegalClassFormatException</code>。随后仍将调用转换器，而且仍将尝试加载或重定义。因此,抛出 <code>IllegalClassFormatException</code> 与返回 null 具有相同的效果，但前者便于对格式毁坏进行记录或调试。<P><DD><DL><DT><B>参数：</B><DD><CODE>loader</CODE> - 定义要转换的类加载器，如果是引导加载器则可以为 <code>null</code><DD><CODE>className</CODE> - 完全限定的类的内部形式中的类名称和 <i>The Java Virtual Machine Specification</i> 中定义的接口名称。例如，<code>"java/util/List"</code>。<DD><CODE>classBeingRedefined</CODE> - 如果是重定义，则为要重定义的类，否则为 <code>null</code><DD><CODE>protectionDomain</CODE> - 要定义或重定义的类的保护域<DD><CODE>classfileBuffer</CODE> - 类文件格式的输入字节缓冲区（不得修改）<DT><B>返回：</B><DD>一个格式良好的类文件缓冲区（转换的结果），如果未执行转换,则返回 <code>null</code>。<DT><B>抛出：</B><DD><CODE><A HREF="IllegalClassFormatException.html" title="java.lang.instrument 中的类">IllegalClassFormatException</A></CODE> - 如果输入不表示一个格式良好的类文件<DT><B>另请参见：</B><DD><A HREF="Instrumentation.html#redefineClasses(java.lang.instrument.ClassDefinition[])"><CODE>Instrumentation.redefineClasses(java.lang.instrument.ClassDefinition[])</CODE></A></DL></DD></DL><!-- ========= END OF CLASS DATA ========= --><HR><!-- ======= START OF BOTTOM NAVBAR ====== --><A NAME="navbar_bottom"><!-- --></A><A HREF="#skip-navbar_bottom" title="跳过导航链接"></A><TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY=""><TR><TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1"><A NAME="navbar_bottom_firstrow"><!-- --></A><TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY=""> <TR ALIGN="center" VALIGN="top"> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>概述</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>软件包</B></FONT></A> </TD> <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>类</B></FONT> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/ClassFileTransformer.html"><FONT CLASS="NavBarFont1"><B>使用</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>树</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>已过时</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-files/index-1.html"><FONT CLASS="NavBarFont1"><B>索引</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>帮助</B></FONT></A> </TD> </TR></TABLE></TD><TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM><b>Java<sup><font size=-2>TM</font></sup> 2 Platform<br>Standard Ed. 5.0</b></EM></TD></TR><TR><TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="ClassDefinition.html" title="java.lang.instrument 中的类"><B>上一个类</B></A> <A HREF="IllegalClassFormatException.html" title="java.lang.instrument 中的类"><B>下一个类</B></A></FONT></TD><TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="../../../index.html@java_2Flang_2Finstrument_2FClassFileTransformer.html" target="_top"><B>框架</B></A> <A HREF="ClassFileTransformer.html" target="_top"><B>无框架</B></A> <SCRIPT type="text/javascript"> <!-- if(window==top) { document.writeln('<A HREF="../../../allclasses-noframe.html"><B>所有类</B></A>'); } //--></SCRIPT><NOSCRIPT> <A HREF="../../../allclasses-noframe.html"><B>所有类</B></A></NOSCRIPT></FONT></TD></TR><TR><TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> 摘要： 嵌套 | 字段 | 构造方法 | <A HREF="#method_summary">方法</A></FONT></TD><TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">详细信息： 字段 | 构造方法 | <A HREF="#method_detail">方法</A></FONT></TD></TR></TABLE><A NAME="skip-navbar_bottom"></A><!-- ======== END OF BOTTOM NAVBAR ======= --><HR><font size="-1"><a href="../../../../../../../../../java.sun.com/cgi-bin/bugreport.cgi">提交错误或意见</a><br>有关更多的 API 参考资料和开发人员文档，请参阅 <a href="../../../../../../../../../java.sun.com/j2se/1.5.0/docs/relnotes/devdocs-vs-specs.html">Java 2 SDK SE 开发人员文档</a>。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。 <p>版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守<a href="../../../../../../../../../java.sun.com/j2se/1.5.0/docs/relnotes/license.html">许可证条款</a>。另请参阅<a href="../../../../../../../../../java.sun.com/docs/redist.html">文档重新分发政策</a>。</font></BODY></HTML>⌨️ 快捷键说明
复制代码Ctrl + C
搜索代码Ctrl + F
全屏模式F11
增大字号Ctrl + =
减小字号Ctrl + -
显示快捷键?