stan/jdk-24
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

8245392: Remove duplication in class redefinition and retransformation specs

Browse Source 
Remove duplications from the Instrumentation, JDI and JDWP redefinition specs

Reviewed-by: dholmes, cjplummer
This commit is contained in:
Serguei Spitsyn 2020-05-27 03:21:15 +00:00
parent eb20ed7374
commit 1357c01e57
3 changed files with 10 additions and 35 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
make/data/jdwp/jdwp.spec
View File

@ -461,16 +461,9 @@ JDWP "Java(tm) Debug Wire Protocol"
"<a href=\"#JDWP_StackFrame_PopFrames\">PopFrames</a> command can be used " "<a href=\"#JDWP_StackFrame_PopFrames\">PopFrames</a> command can be used "
"to pop frames with obsolete methods." "to pop frames with obsolete methods."
"<p>" "<p>"
"Unless the canUnrestrictedlyRedefineClasses capability is present the following " "Unless the canUnrestrictedlyRedefineClasses capability is present "
"redefinitions are restricted: " "the redefinition must follow the restrictions described in "
"<ul>" "<a href=\"../jvmti.html#RedefineClasses\">JVM TI RedefineClasses</a>."
"<li>changing the schema (the fields)</li>"
"<li>changing the hierarchy (superclasses, interfaces)</li>"
"<li>deleting a method</li>"
"<li>changing class modifiers</li>"
"<li>changing method modifiers</li>"
"<li>changing the <code>NestHost</code>, <code>NestMembers</code>, or <code>Record</code> class attributes</li>"
"</ul>"
"<p>" "<p>"
"Requires canRedefineClasses capability - see " "Requires canRedefineClasses capability - see "
"<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>. " "<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>. "

18
src/java.instrument/share/classes/java/lang/instrument/Instrumentation.java
View File

@ -222,13 +222,8 @@ public interface Instrumentation {
* Instances of the retransformed class are not affected. * Instances of the retransformed class are not affected.
* *
* <P> * <P>
* The retransformation may change method bodies, the constant pool and * The supported class file changes are described in
* attributes (unless explicitly prohibited). * <a href="{@docRoot}/../specs/jvmti.html#RetransformClasses">JVM TI RetransformClasses</a>.
* The retransformation must not add, remove or rename fields or methods, change the
* signatures of methods, or change inheritance.
* The retransformation must not change the <code>NestHost</code>,
* <code>NestMembers</code>, or <code>Record</code> attributes.
* These restrictions may be lifted in future versions.
* The class file bytes are not checked, verified and installed * The class file bytes are not checked, verified and installed
* until after the transformations have been applied, if the resultant bytes are in * until after the transformations have been applied, if the resultant bytes are in
* error this method will throw an exception. * error this method will throw an exception.
@ -313,13 +308,8 @@ public interface Instrumentation {
* Instances of the redefined class are not affected. * Instances of the redefined class are not affected.
* *
* <P> * <P>
* The redefinition may change method bodies, the constant pool and attributes * The supported class file changes are described in
* (unless explicitly prohibited). * <a href="{@docRoot}/../specs/jvmti.html#RedefineClasses">JVM TI RedefineClasses</a>.
* The redefinition must not add, remove or rename fields or methods, change the
* signatures of methods, or change inheritance.
* The redefinition must not change the <code>NestHost</code>,
* <code>NestMembers</code>, or <code>Record</code> attributes.
* These restrictions may be lifted in future versions.
* The class file bytes are not checked, verified and installed * The class file bytes are not checked, verified and installed
* until after the transformations have been applied, if the resultant bytes are in * until after the transformations have been applied, if the resultant bytes are in
* error this method will throw an exception. * error this method will throw an exception.

14
src/jdk.jdi/share/classes/com/sun/jdi/VirtualMachine.java
View File

@ -214,17 +214,9 @@ public interface VirtualMachine extends Mirror {
* attempting to add a method will throw this exception. * attempting to add a method will throw this exception.
* <LI>If {@link #canUnrestrictedlyRedefineClasses() * <LI>If {@link #canUnrestrictedlyRedefineClasses()
* canUnrestrictedlyRedefineClasses()} * canUnrestrictedlyRedefineClasses()}
* is false, attempting any of the following will throw * is false attempting any of the unsupported class file changes described
* this exception * in <a href="{@docRoot}/../specs/jvmti.html#RedefineClasses">
* <UL> * JVM TI RedefineClasses</a> will throw this exception.
* <LI>changing the schema (the fields)
* <LI>changing the hierarchy (superclasses, interfaces)
* <LI>deleting a method
* <LI>changing class modifiers
* <LI>changing method modifiers
* <LI>changing the {@code NestHost}, {@code NestMembers}, or {@code Record} class attributes
* </UL>
* </UL>
* *
* @throws java.lang.NoClassDefFoundError if the bytes * @throws java.lang.NoClassDefFoundError if the bytes
* don't correspond to the reference type (the names * don't correspond to the reference type (the names