src/java.instrument/share/classes/java/lang/instrument/Instrumentation.java
changeset 50735 2f2af62dfac7
parent 47216 71c04702a3d5
child 54954 6ec71a88b68e
equal deleted inserted replaced
50734:0828a0f6676b 50735:2f2af62dfac7
     1 /*
     1 /*
     2  * Copyright (c) 2003, 2016, Oracle and/or its affiliates. All rights reserved.
     2  * Copyright (c) 2003, 2018, Oracle and/or its affiliates. All rights reserved.
     3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
     3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
     4  *
     4  *
     5  * This code is free software; you can redistribute it and/or modify it
     5  * This code is free software; you can redistribute it and/or modify it
     6  * under the terms of the GNU General Public License version 2 only, as
     6  * under the terms of the GNU General Public License version 2 only, as
     7  * published by the Free Software Foundation.  Oracle designates this
     7  * published by the Free Software Foundation.  Oracle designates this
   217      *
   217      *
   218      * <P>
   218      * <P>
   219      * Instances of the retransformed class are not affected.
   219      * Instances of the retransformed class are not affected.
   220      *
   220      *
   221      * <P>
   221      * <P>
   222      * The retransformation may change method bodies, the constant pool and attributes.
   222      * The retransformation may change method bodies, the constant pool and
       
   223      * attributes (unless explicitly prohibited).
   223      * The retransformation must not add, remove or rename fields or methods, change the
   224      * The retransformation must not add, remove or rename fields or methods, change the
   224      * signatures of methods, or change inheritance.  These restrictions maybe be
   225      * signatures of methods, or change inheritance.
   225      * lifted in future versions.  The class file bytes are not checked, verified and installed
   226      * The retransformation must not change the <code>NestHost</code> or
       
   227      * <code>NestMembers</code> attributes.
       
   228      * These restrictions may be lifted in future versions.
       
   229      * The class file bytes are not checked, verified and installed
   226      * until after the transformations have been applied, if the resultant bytes are in
   230      * until after the transformations have been applied, if the resultant bytes are in
   227      * error this method will throw an exception.
   231      * error this method will throw an exception.
   228      *
   232      *
   229      * <P>
   233      * <P>
   230      * If this method throws an exception, no classes have been retransformed.
   234      * If this method throws an exception, no classes have been retransformed.
   304      *
   308      *
   305      * <P>
   309      * <P>
   306      * Instances of the redefined class are not affected.
   310      * Instances of the redefined class are not affected.
   307      *
   311      *
   308      * <P>
   312      * <P>
   309      * The redefinition may change method bodies, the constant pool and attributes.
   313      * The redefinition may change method bodies, the constant pool and attributes
       
   314      * (unless explicitly prohibited).
   310      * The redefinition must not add, remove or rename fields or methods, change the
   315      * The redefinition must not add, remove or rename fields or methods, change the
   311      * signatures of methods, or change inheritance.  These restrictions maybe be
   316      * signatures of methods, or change inheritance.
   312      * lifted in future versions.  The class file bytes are not checked, verified and installed
   317      * The redefinition must not change the <code>NestHost</code> or
       
   318      * <code>NestMembers</code> attributes.
       
   319      * These restrictions may be lifted in future versions.
       
   320      * The class file bytes are not checked, verified and installed
   313      * until after the transformations have been applied, if the resultant bytes are in
   321      * until after the transformations have been applied, if the resultant bytes are in
   314      * error this method will throw an exception.
   322      * error this method will throw an exception.
   315      *
   323      *
   316      * <P>
   324      * <P>
   317      * If this method throws an exception, no classes have been redefined.
   325      * If this method throws an exception, no classes have been redefined.