archive/jdk
1
0
Fork 0
mirror of https://github.com/openjdk/jdk.git synced 2025-08-26 22:34:27 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

8338014: Improve usage of @jvms tags in class file API

Browse source 
Reviewed-by: darcy, liach, asotona
This commit is contained in:
Sonia Zaldana Calles 2024-08-15 13:28:25 +00:00
parent 74fdd6868d
commit 56dec215b0
40 changed files with 76 additions and 76 deletions
Download patch file Download diff file Expand all files Collapse all files

2
src/java.base/share/classes/java/lang/classfile/AnnotationValue.java
View file

@ -426,7 +426,7 @@ public sealed interface AnnotationValue {
}
/**
* {@return the tag character for this type as per {@jvms 4.7.16.1}}
* {@return the tag character for this type as per JVMS {@jvms 4.7.16.1}}
*/
char tag();

4
src/java.base/share/classes/java/lang/classfile/Attribute.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2022, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2022, 2024, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -66,7 +66,7 @@ import jdk.internal.classfile.impl.UnboundAttribute;
import jdk.internal.javac.PreviewFeature;
/**
* Models a classfile attribute {@jvms 4.7}. Many, though not all, subtypes of
* Models a classfile attribute (JVMS {@jvms 4.7}). Many, though not all, subtypes of
* {@linkplain Attribute} will implement {@link ClassElement}, {@link
* MethodElement}, {@link FieldElement}, or {@link CodeElement}; attributes that
* are also elements will be delivered when traversing the elements of the

2
src/java.base/share/classes/java/lang/classfile/ClassSignature.java
View file

@ -30,7 +30,7 @@ import static java.util.Objects.requireNonNull;
import jdk.internal.javac.PreviewFeature;
/**
* Models the generic signature of a class file, as defined by {@jvms 4.7.9}.
* Models the generic signature of a class file, as defined by JVMS {@jvms 4.7.9}.
*
* @since 22
*/

2
src/java.base/share/classes/java/lang/classfile/MethodSignature.java
View file

@ -32,7 +32,7 @@ import jdk.internal.classfile.impl.Util;
import jdk.internal.javac.PreviewFeature;
/**
* Models the generic signature of a method, as defined by {@jvms 4.7.9}.
* Models the generic signature of a method, as defined by JVMS {@jvms 4.7.9}.
*
* @since 22
*/

4
src/java.base/share/classes/java/lang/classfile/Opcode.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2022, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2022, 2024, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -29,7 +29,7 @@ import java.lang.constant.ConstantDescs;
import jdk.internal.javac.PreviewFeature;
/**
* Describes the opcodes of the JVM instruction set, as described in {@jvms 6.5}.
* Describes the opcodes of the JVM instruction set, as described in JVMS {@jvms 6.5}.
* As well as a number of pseudo-instructions that may be encountered when
* traversing the instructions of a method.
*

2
src/java.base/share/classes/java/lang/classfile/Signature.java
View file

@ -34,7 +34,7 @@ import jdk.internal.classfile.impl.Util;
import jdk.internal.javac.PreviewFeature;
/**
* Models generic Java type signatures, as defined in {@jvms 4.7.9.1}.
* Models generic Java type signatures, as defined in JVMS {@jvms 4.7.9.1}.
*
* @sealedGraph
* @since 22

10
src/java.base/share/classes/java/lang/classfile/TypeAnnotation.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2022, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2022, 2024, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -60,7 +60,7 @@ import jdk.internal.classfile.impl.TemporaryConstantPool;
import jdk.internal.javac.PreviewFeature;
/**
* Models an annotation on a type use, as defined in {@jvms 4.7.19} and {@jvms 4.7.20}.
* Models an annotation on a type use, as defined in JVMS {@jvms 4.7.19} and {@jvms 4.7.20}.
*
* @see RuntimeVisibleTypeAnnotationsAttribute
* @see RuntimeInvisibleTypeAnnotationsAttribute
@ -73,7 +73,7 @@ public sealed interface TypeAnnotation
permits UnboundAttribute.UnboundTypeAnnotation {
/**
* The kind of target on which the annotation appears, as defined in {@jvms 4.7.20.1}.
* The kind of target on which the annotation appears, as defined in JVMS {@jvms 4.7.20.1}.
*
* @since 22
*/
@ -773,7 +773,7 @@ public sealed interface TypeAnnotation
/**
* JVMS: Type_path structure identifies which part of the type is annotated,
* as defined in {@jvms 4.7.20.2}
* as defined in JVMS {@jvms 4.7.20.2}
*
* @since 22
*/
@ -782,7 +782,7 @@ public sealed interface TypeAnnotation
permits UnboundAttribute.TypePathComponentImpl {
/**
* Type path kind, as defined in {@jvms 4.7.20.2}
* Type path kind, as defined in JVMS {@jvms 4.7.20.2}
*
* @since 22
*/

4
src/java.base/share/classes/java/lang/classfile/attribute/AnnotationDefaultAttribute.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2022, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2022, 2024, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -34,7 +34,7 @@ import jdk.internal.classfile.impl.UnboundAttribute;
import jdk.internal.javac.PreviewFeature;
/**
* Models the {@code AnnotationDefault} attribute {@jvms 4.7.22}, which can
* Models the {@code AnnotationDefault} attribute (JVMS {@jvms 4.7.22}), which can
* appear on methods of annotation types, and records the default value
* {@jls 9.6.2} for the element corresponding to this method. Delivered as a
* {@link MethodElement} when traversing the elements of a {@link MethodModel}.

4
src/java.base/share/classes/java/lang/classfile/attribute/BootstrapMethodsAttribute.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2022, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2022, 2024, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -35,7 +35,7 @@ import jdk.internal.classfile.impl.UnboundAttribute;
import jdk.internal.javac.PreviewFeature;
/**
* Models the {@code BootstrapMethods} attribute {@jvms 4.7.23}, which serves as
* Models the {@code BootstrapMethods} attribute (JVMS {@jvms 4.7.23}), which serves as
* an extension to the constant pool of a classfile. Elements of the bootstrap
* method table are accessed through {@link ConstantPool}.
* <p>

2
src/java.base/share/classes/java/lang/classfile/attribute/CodeAttribute.java
View file

@ -32,7 +32,7 @@ import jdk.internal.classfile.impl.BoundAttribute;
import jdk.internal.javac.PreviewFeature;
/**
* Models the {@code Code} attribute {@jvms 4.7.3}, appears on non-native,
* Models the {@code Code} attribute (JVMS {@jvms 4.7.3}), appears on non-native,
* non-abstract methods and contains the bytecode of the method body. Delivered
* as a {@link java.lang.classfile.MethodElement} when traversing the elements of a
* {@link java.lang.classfile.MethodModel}.

4
src/java.base/share/classes/java/lang/classfile/attribute/ConstantValueAttribute.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2022, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2022, 2024, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -34,7 +34,7 @@ import jdk.internal.classfile.impl.UnboundAttribute;
import jdk.internal.javac.PreviewFeature;
/**
* Models the {@code ConstantValue} attribute {@jvms 4.7.2}, which can appear on
* Models the {@code ConstantValue} attribute (JVMS {@jvms 4.7.2}), which can appear on
* fields and indicates that the field's value is a constant. Delivered as a
* {@link java.lang.classfile.FieldElement} when traversing the elements of a
* {@link java.lang.classfile.FieldModel}.

4
src/java.base/share/classes/java/lang/classfile/attribute/DeprecatedAttribute.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2022, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2022, 2024, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -33,7 +33,7 @@ import jdk.internal.classfile.impl.UnboundAttribute;
import jdk.internal.javac.PreviewFeature;
/**
* Models the {@code Deprecated} attribute {@jvms 4.7.15}, which can appear on
* Models the {@code Deprecated} attribute (JVMS {@jvms 4.7.15}), which can appear on
* classes, methods, and fields. Delivered as a {@link ClassElement},
* {@link MethodElement}, or {@link FieldElement} when traversing the elements
* of a corresponding model.

4
src/java.base/share/classes/java/lang/classfile/attribute/EnclosingMethodAttribute.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2022, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2022, 2024, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -40,7 +40,7 @@ import jdk.internal.classfile.impl.Util;
import jdk.internal.javac.PreviewFeature;
/**
* Models the {@code EnclosingMethod} attribute {@jvms 4.7.7}, which can appear
* Models the {@code EnclosingMethod} attribute (JVMS {@jvms 4.7.7}), which can appear
* on classes, and indicates that the class is a local or anonymous class.
* Delivered as a {@link ClassElement} when traversing the elements of a {@link
* java.lang.classfile.ClassModel}.

4
src/java.base/share/classes/java/lang/classfile/attribute/ExceptionsAttribute.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2022, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2022, 2024, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -37,7 +37,7 @@ import jdk.internal.classfile.impl.Util;
import jdk.internal.javac.PreviewFeature;
/**
* Models the {@code Exceptions} attribute {@jvms 4.7.5}, which can appear on
* Models the {@code Exceptions} attribute (JVMS {@jvms 4.7.5}), which can appear on
* methods, and records the exceptions declared to be thrown by this method.
* Delivered as a {@link MethodElement} when traversing the elements of a
* {@link java.lang.classfile.MethodModel}.

4
src/java.base/share/classes/java/lang/classfile/attribute/InnerClassesAttribute.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2022, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2022, 2024, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -34,7 +34,7 @@ import jdk.internal.classfile.impl.UnboundAttribute;
import jdk.internal.javac.PreviewFeature;
/**
* Models the {@code InnerClasses} attribute {@jvms 4.7.6}, which can
* Models the {@code InnerClasses} attribute (JVMS {@jvms 4.7.6}), which can
* appear on classes, and records which classes referenced by this classfile
* are inner classes. Delivered as a {@link java.lang.classfile.ClassElement} when
* traversing the elements of a {@link java.lang.classfile.ClassModel}.

4
src/java.base/share/classes/java/lang/classfile/attribute/LineNumberTableAttribute.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2022, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2022, 2024, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -32,7 +32,7 @@ import jdk.internal.classfile.impl.UnboundAttribute;
import jdk.internal.javac.PreviewFeature;
/**
* Models the {@code LineNumberTable} attribute {@jvms 4.7.12}, which can appear
* Models the {@code LineNumberTable} attribute (JVMS {@jvms 4.7.12}), which can appear
* on a {@code Code} attribute, and records the mapping between indexes into
* the code table and line numbers in the source file.
* Delivered as a {@link java.lang.classfile.instruction.LineNumber} when traversing the

4
src/java.base/share/classes/java/lang/classfile/attribute/LocalVariableTableAttribute.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2022, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2022, 2024, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -32,7 +32,7 @@ import java.util.List;
import jdk.internal.javac.PreviewFeature;
/**
* Models the {@code LocalVariableTable} attribute {@jvms 4.7.13}, which can appear
* Models the {@code LocalVariableTable} attribute (JVMS {@jvms 4.7.13}), which can appear
* on a {@code Code} attribute, and records debug information about local
* variables.
* Delivered as a {@link java.lang.classfile.instruction.LocalVariable} when traversing the

4
src/java.base/share/classes/java/lang/classfile/attribute/LocalVariableTypeTableAttribute.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2022, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2022, 2024, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -33,7 +33,7 @@ import java.util.List;
import jdk.internal.javac.PreviewFeature;
/**
* Models the {@code LocalVariableTypeTable} attribute {@jvms 4.7.14}, which can appear
* Models the {@code LocalVariableTypeTable} attribute (JVMS {@jvms 4.7.14}), which can appear
* on a {@code Code} attribute, and records debug information about local
* variables.
* Delivered as a {@link java.lang.classfile.instruction.LocalVariable} when traversing the

4
src/java.base/share/classes/java/lang/classfile/attribute/MethodParametersAttribute.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2022, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2022, 2024, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -34,7 +34,7 @@ import jdk.internal.classfile.impl.UnboundAttribute;
import jdk.internal.javac.PreviewFeature;
/**
* Models the {@code MethodParameters} attribute {@jvms 4.7.24}, which can
* Models the {@code MethodParameters} attribute (JVMS {@jvms 4.7.24}), which can
* appear on methods, and records optional information about the method's
* parameters. Delivered as a {@link java.lang.classfile.MethodElement} when
* traversing the elements of a {@link java.lang.classfile.MethodModel}.

2
src/java.base/share/classes/java/lang/classfile/attribute/ModuleAttribute.java
View file

@ -46,7 +46,7 @@ import jdk.internal.classfile.impl.Util;
import jdk.internal.javac.PreviewFeature;
/**
* Models the {@code Module} attribute {@jvms 4.7.25}, which can
* Models the {@code Module} attribute (JVMS {@jvms 4.7.25}), which can
* appear on classes that represent module descriptors.
* Delivered as a {@link java.lang.classfile.ClassElement} when
* traversing the elements of a {@link java.lang.classfile.ClassModel}.

4
src/java.base/share/classes/java/lang/classfile/attribute/ModuleMainClassAttribute.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2022, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2022, 2024, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -35,7 +35,7 @@ import jdk.internal.classfile.impl.UnboundAttribute;
import jdk.internal.javac.PreviewFeature;
/**
* Models the {@code ModuleMainClass} attribute {@jvms 4.7.27}, which can
* Models the {@code ModuleMainClass} attribute (JVMS {@jvms 4.7.27}), which can
* appear on classes that represent module descriptors.
* Delivered as a {@link java.lang.classfile.ClassElement} when
* traversing the elements of a {@link java.lang.classfile.ClassModel}.

4
src/java.base/share/classes/java/lang/classfile/attribute/ModulePackagesAttribute.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2022, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2022, 2024, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -38,7 +38,7 @@ import jdk.internal.classfile.impl.UnboundAttribute;
import jdk.internal.javac.PreviewFeature;
/**
* Models the {@code ModulePackages} attribute {@jvms 4.7.26}, which can
* Models the {@code ModulePackages} attribute (JVMS {@jvms 4.7.26}), which can
* appear on classes that represent module descriptors.
* Delivered as a {@link java.lang.classfile.ClassElement} when
* traversing the elements of a {@link java.lang.classfile.ClassModel}.

4
src/java.base/share/classes/java/lang/classfile/attribute/NestHostAttribute.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2022, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2022, 2024, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -35,7 +35,7 @@ import jdk.internal.classfile.impl.UnboundAttribute;
import jdk.internal.javac.PreviewFeature;
/**
* Models the {@code NestHost} attribute {@jvms 4.7.28}, which can
* Models the {@code NestHost} attribute (JVMS {@jvms 4.7.28}), which can
* appear on classes to indicate that this class is a member of a nest.
* Delivered as a {@link java.lang.classfile.ClassElement} when
* traversing the elements of a {@link java.lang.classfile.ClassModel}.

4
src/java.base/share/classes/java/lang/classfile/attribute/NestMembersAttribute.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2022, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2022, 2024, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -37,7 +37,7 @@ import jdk.internal.classfile.impl.Util;
import jdk.internal.javac.PreviewFeature;
/**
* Models the {@code NestMembers} attribute {@jvms 4.7.29}, which can
* Models the {@code NestMembers} attribute (JVMS {@jvms 4.7.29}), which can
* appear on classes to indicate that this class is the host of a nest.
* Delivered as a {@link java.lang.classfile.ClassElement} when
* traversing the elements of a {@link java.lang.classfile.ClassModel}.

4
src/java.base/share/classes/java/lang/classfile/attribute/PermittedSubclassesAttribute.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2022, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2022, 2024, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -37,7 +37,7 @@ import jdk.internal.classfile.impl.Util;
import jdk.internal.javac.PreviewFeature;
/**
* Models the {@code PermittedSubclasses} attribute {@jvms 4.7.31}, which can
* Models the {@code PermittedSubclasses} attribute (JVMS {@jvms 4.7.31}), which can
* appear on classes to indicate which classes may extend this class.
* Delivered as a {@link java.lang.classfile.ClassElement} when
* traversing the elements of a {@link java.lang.classfile.ClassModel}.

4
src/java.base/share/classes/java/lang/classfile/attribute/RecordAttribute.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2022, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2022, 2024, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -34,7 +34,7 @@ import jdk.internal.classfile.impl.UnboundAttribute;
import jdk.internal.javac.PreviewFeature;
/**
* Models the {@code Record} attribute {@jvms 4.7.30}, which can
* Models the {@code Record} attribute (JVMS {@jvms 4.7.30}), which can
* appear on classes to indicate that this class is a record class.
* Delivered as a {@link java.lang.classfile.ClassElement} when
* traversing the elements of a {@link java.lang.classfile.ClassModel}.

4
src/java.base/share/classes/java/lang/classfile/attribute/RuntimeInvisibleAnnotationsAttribute.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2022, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2022, 2024, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -33,7 +33,7 @@ import java.util.List;
import jdk.internal.javac.PreviewFeature;
/**
* Models the {@code RuntimeInvisibleAnnotations} attribute {@jvms 4.7.17}, which
* Models the {@code RuntimeInvisibleAnnotations} attribute (JVMS {@jvms 4.7.17}), which
* can appear on classes, methods, and fields. Delivered as a
* {@link java.lang.classfile.ClassElement}, {@link java.lang.classfile.FieldElement}, or
* {@link java.lang.classfile.MethodElement} when traversing the corresponding model type.

4
src/java.base/share/classes/java/lang/classfile/attribute/RuntimeInvisibleParameterAnnotationsAttribute.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2022, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2022, 2024, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -37,7 +37,7 @@ import jdk.internal.javac.PreviewFeature;
/**
* Models the {@code RuntimeInvisibleParameterAnnotations} attribute
* {@jvms 4.7.19}, which can appear on methods. Delivered as a {@link
* (JVMS {@jvms 4.7.19}), which can appear on methods. Delivered as a {@link
* java.lang.classfile.MethodElement} when traversing a {@link MethodModel}.
* <p>
* The attribute does not permit multiple instances in a given location.

4
src/java.base/share/classes/java/lang/classfile/attribute/RuntimeInvisibleTypeAnnotationsAttribute.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2022, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2022, 2024, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -38,7 +38,7 @@ import jdk.internal.classfile.impl.UnboundAttribute;
import jdk.internal.javac.PreviewFeature;
/**
* Models the {@code RuntimeInvisibleTypeAnnotations} attribute {@jvms 4.7.21}, which
* Models the {@code RuntimeInvisibleTypeAnnotations} attribute (JVMS {@jvms 4.7.21}), which
* can appear on classes, methods, fields, and code attributes. Delivered as a
* {@link java.lang.classfile.ClassElement}, {@link java.lang.classfile.FieldElement},
* {@link java.lang.classfile.MethodElement}, or {@link CodeElement} when traversing

4
src/java.base/share/classes/java/lang/classfile/attribute/RuntimeVisibleAnnotationsAttribute.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2022, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2022, 2024, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -33,7 +33,7 @@ import java.util.List;
import jdk.internal.javac.PreviewFeature;
/**
* Models the {@code RuntimeVisibleAnnotations} attribute {@jvms 4.7.16}, which
* Models the {@code RuntimeVisibleAnnotations} attribute (JVMS {@jvms 4.7.16}), which
* can appear on classes, methods, and fields. Delivered as a
* {@link java.lang.classfile.ClassElement}, {@link java.lang.classfile.FieldElement}, or
* {@link java.lang.classfile.MethodElement} when traversing the corresponding model type.

4
src/java.base/share/classes/java/lang/classfile/attribute/RuntimeVisibleParameterAnnotationsAttribute.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2022, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2022, 2024, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -36,7 +36,7 @@ import jdk.internal.classfile.impl.UnboundAttribute;
import jdk.internal.javac.PreviewFeature;
/**
* Models the {@code RuntimeVisibleParameterAnnotations} attribute {@jvms 4.7.18}, which
* Models the {@code RuntimeVisibleParameterAnnotations} attribute (JVMS {@jvms 4.7.18}), which
* can appear on methods. Delivered as a {@link java.lang.classfile.MethodElement}
* when traversing a {@link MethodModel}.
*

4
src/java.base/share/classes/java/lang/classfile/attribute/RuntimeVisibleTypeAnnotationsAttribute.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2022, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2022, 2024, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -38,7 +38,7 @@ import jdk.internal.classfile.impl.UnboundAttribute;
import jdk.internal.javac.PreviewFeature;
/**
* Models the {@code RuntimeVisibleTypeAnnotations} attribute {@jvms 4.7.20}, which
* Models the {@code RuntimeVisibleTypeAnnotations} attribute (JVMS {@jvms 4.7.20}), which
* can appear on classes, methods, fields, and code attributes. Delivered as a
* {@link java.lang.classfile.ClassElement}, {@link java.lang.classfile.FieldElement},
* {@link java.lang.classfile.MethodElement}, or {@link CodeElement} when traversing

4
src/java.base/share/classes/java/lang/classfile/attribute/SignatureAttribute.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2022, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2022, 2024, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -39,7 +39,7 @@ import jdk.internal.classfile.impl.UnboundAttribute;
import jdk.internal.javac.PreviewFeature;
/**
* Models the {@code Signature} attribute {@jvms 4.7.9}, which
* Models the {@code Signature} attribute (JVMS {@jvms 4.7.9}), which
* can appear on classes, methods, or fields. Delivered as a
* {@link java.lang.classfile.ClassElement}, {@link java.lang.classfile.FieldElement}, or
* {@link java.lang.classfile.MethodElement} when traversing

4
src/java.base/share/classes/java/lang/classfile/attribute/SourceFileAttribute.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2022, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2022, 2024, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -35,7 +35,7 @@ import jdk.internal.classfile.impl.UnboundAttribute;
import jdk.internal.javac.PreviewFeature;
/**
* Models the {@code SourceFile} attribute {@jvms 4.7.10}, which
* Models the {@code SourceFile} attribute (JVMS {@jvms 4.7.10}), which
* can appear on classes. Delivered as a {@link java.lang.classfile.ClassElement}
* when traversing a {@link ClassModel}.
* <p>

4
src/java.base/share/classes/java/lang/classfile/attribute/StackMapFrameInfo.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2023, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2023, 2024, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -36,7 +36,7 @@ import static java.lang.classfile.ClassFile.*;
import jdk.internal.javac.PreviewFeature;
/**
* Models stack map frame of {@code StackMapTable} attribute {@jvms 4.7.4}.
* Models stack map frame of {@code StackMapTable} attribute (JVMS {@jvms 4.7.4}).
*
* @since 22
*/

4
src/java.base/share/classes/java/lang/classfile/attribute/StackMapTableAttribute.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2022, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2022, 2024, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -34,7 +34,7 @@ import jdk.internal.classfile.impl.UnboundAttribute;
import jdk.internal.javac.PreviewFeature;
/**
* Models the {@code StackMapTable} attribute {@jvms 4.7.4}, which can appear
* Models the {@code StackMapTable} attribute (JVMS {@jvms 4.7.4}), which can appear
* on a {@code Code} attribute.
* <p>
* The attribute does not permit multiple instances in a given location.

4
src/java.base/share/classes/java/lang/classfile/attribute/SyntheticAttribute.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2022, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2022, 2024, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -34,7 +34,7 @@ import jdk.internal.classfile.impl.UnboundAttribute;
import jdk.internal.javac.PreviewFeature;
/**
* Models the {@code Synthetic} attribute {@jvms 4.7.8}, which can appear on
* Models the {@code Synthetic} attribute (JVMS {@jvms 4.7.8}), which can appear on
* classes, methods, and fields. Delivered as a {@link ClassElement},
* {@link MethodElement}, or {@link FieldElement} when traversing the elements
* of a corresponding model.

2
src/java.base/share/classes/java/lang/classfile/constantpool/ConstantPoolBuilder.java
View file

@ -365,7 +365,7 @@ public sealed interface ConstantPoolBuilder
* it is returned; otherwise, a new entry is added and the new entry is
* returned.
*
* @param refKind the reference kind of the method handle {@jvms 4.4.8}
* @param refKind the reference kind of the method handle (JVMS {@jvms 4.4.8})
* @param reference the constant pool entry describing the field or method
*/
MethodHandleEntry methodHandleEntry(int refKind, MemberRefEntry reference);

4
src/java.base/share/classes/java/lang/classfile/constantpool/MethodHandleEntry.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2022, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2022, 2024, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -48,7 +48,7 @@ public sealed interface MethodHandleEntry
}
/**
* {@return the reference kind of this method handle {@jvms 4.4.8}}
* {@return the reference kind of this method handle (JVMS {@jvms 4.4.8})}
* @see java.lang.invoke.MethodHandleInfo
*/
int kind();

4
src/java.base/share/classes/java/lang/classfile/instruction/InvokeInstruction.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2022, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2022, 2024, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -64,7 +64,7 @@ public sealed interface InvokeInstruction extends Instruction
boolean isInterface();
/**
* {@return the {@code count} value of an {@code invokeinterface} instruction, as defined in {@jvms 6.5}
* {@return the {@code count} value of an {@code invokeinterface} instruction, as defined in JVMS {@jvms 6.5}
* or {@code 0} for {@code invokespecial}, {@code invokestatic} and {@code invokevirtual} instructions}
*/
int count();