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

8314738: Remove all occurrences of and support for @revised

Browse source 
Reviewed-by: mr
This commit is contained in:
Pavel Rappo 2023-08-22 13:02:53 +00:00
parent 6b9df037e4
commit f39fc0aa2d
28 changed files with 8 additions and 124 deletions
Download patch file Download diff file Expand all files Collapse all files

3
src/java.base/share/classes/java/lang/Class.java
View file

@ -1168,7 +1168,6 @@ public final class Class<T> implements java.io.Serializable,
* this method returns {@code null}.
*
* @return the package of this class.
* @revised 9
*/
public Package getPackage() {
if (isPrimitive() || isArray()) {
@ -3029,7 +3028,6 @@ public final class Class<T> implements java.io.Serializable,
*
* @see Module#getResourceAsStream(String)
* @since 1.1
* @revised 9
*/
@CallerSensitive
public InputStream getResourceAsStream(String name) {
@ -3125,7 +3123,6 @@ public final class Class<T> implements java.io.Serializable,
* manager.
* @throws NullPointerException If {@code name} is {@code null}
* @since 1.1
* @revised 9
*/
@CallerSensitive
public URL getResource(String name) {

19
src/java.base/share/classes/java/lang/ClassLoader.java
View file

@ -227,7 +227,6 @@ import sun.security.util.SecurityConstants;
* @jls 13.1 The Form of a Binary
* @see #resolveClass(Class)
* @since 1.0
* @revised 9
*/
public abstract class ClassLoader {
@ -881,7 +880,6 @@ public abstract class ClassLoader {
* @see java.security.SecureClassLoader
*
* @since 1.1
* @revised 9
*/
protected final Class<?> defineClass(String name, byte[] b, int off, int len)
throws ClassFormatError
@ -1015,8 +1013,6 @@ public abstract class ClassLoader {
* certificates than this class, or if {@code name} begins with
* "{@code java.}" and this class loader is not the platform
* class loader or its ancestor.
*
* @revised 9
*/
protected final Class<?> defineClass(String name, byte[] b, int off, int len,
ProtectionDomain protectionDomain)
@ -1091,7 +1087,6 @@ public abstract class ClassLoader {
* @see #defineClass(String, byte[], int, int, ProtectionDomain)
*
* @since 1.5
* @revised 9
*/
protected final Class<?> defineClass(String name, java.nio.ByteBuffer b,
ProtectionDomain protectionDomain)
@ -1404,7 +1399,6 @@ public abstract class ClassLoader {
* @throws NullPointerException If {@code name} is {@code null}
*
* @since 1.1
* @revised 9
*/
public URL getResource(String name) {
Objects.requireNonNull(name);
@ -1469,7 +1463,6 @@ public abstract class ClassLoader {
* @throws NullPointerException If {@code name} is {@code null}
*
* @since 1.2
* @revised 9
*/
public Enumeration<URL> getResources(String name) throws IOException {
Objects.requireNonNull(name);
@ -1567,7 +1560,6 @@ public abstract class ClassLoader {
* denied by the security manager.
*
* @since 1.2
* @revised 9
*/
protected URL findResource(String name) {
return null;
@ -1602,7 +1594,6 @@ public abstract class ClassLoader {
* If I/O errors occur
*
* @since 1.2
* @revised 9
*/
protected Enumeration<URL> findResources(String name) throws IOException {
return Collections.emptyEnumeration();
@ -1687,7 +1678,6 @@ public abstract class ClassLoader {
* denied by the security manager.
*
* @since 1.1
* @revised 9
*/
public static URL getSystemResource(String name) {
return getSystemClassLoader().getResource(name);
@ -1723,7 +1713,6 @@ public abstract class ClassLoader {
* If I/O errors occur
*
* @since 1.2
* @revised 9
*/
public static Enumeration<URL> getSystemResources(String name)
throws IOException
@ -1755,7 +1744,6 @@ public abstract class ClassLoader {
* @throws NullPointerException If {@code name} is {@code null}
*
* @since 1.1
* @revised 9
*/
public InputStream getResourceAsStream(String name) {
Objects.requireNonNull(name);
@ -1788,7 +1776,6 @@ public abstract class ClassLoader {
* denied by the security manager.
*
* @since 1.1
* @revised 9
*/
public static InputStream getSystemResourceAsStream(String name) {
URL url = getSystemResource(name);
@ -1948,9 +1935,6 @@ public abstract class ClassLoader {
* exception is thrown by that constructor when it is invoked. The
* underlying cause of the error can be retrieved via the
* {@link Throwable#getCause()} method.
*
* @revised 1.4
* @revised 9
*/
@CallerSensitive
public static ClassLoader getSystemClassLoader() {
@ -2217,7 +2201,6 @@ public abstract class ClassLoader {
*
*
* @since 1.2
* @revised 9
*
* @jvms 5.3 Creation and Loading
* @see <a href="{@docRoot}/../specs/jar/jar.html#package-sealing">
@ -2326,7 +2309,6 @@ public abstract class ClassLoader {
* @see ClassLoader#getDefinedPackage(String)
*
* @since 1.2
* @revised 9
*/
@Deprecated(since="9")
protected Package getPackage(String name) {
@ -2361,7 +2343,6 @@ public abstract class ClassLoader {
* @see ClassLoader#getDefinedPackages()
*
* @since 1.2
* @revised 9
*/
protected Package[] getPackages() {
Stream<Package> pkgs = packages();

9
src/java.base/share/classes/java/lang/Package.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 1997, 2021, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1997, 2023, 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
@ -114,7 +114,6 @@ import jdk.internal.reflect.Reflection;
* @see ClassLoader#definePackage(String, String, String, String, String, String, String, URL)
*
* @since 1.2
* @revised 9
*/
public class Package extends NamedPackage implements java.lang.reflect.AnnotatedElement {
/**
@ -211,8 +210,6 @@ public class Package extends NamedPackage implements java.lang.reflect.Annotated
* is returned if it is not known.
* @return the vendor that implemented this package, {@code null}
* is returned if it is not known.
*
* @revised 9
*/
public String getImplementationVendor() {
return versionInfo.implVendor;
@ -355,8 +352,6 @@ public class Package extends NamedPackage implements java.lang.reflect.Annotated
* a {@code Package} for the specified class loader.
*
* @see ClassLoader#getDefinedPackage
*
* @revised 9
*/
@CallerSensitive
@Deprecated(since="9")
@ -379,8 +374,6 @@ public class Package extends NamedPackage implements java.lang.reflect.Annotated
* class loader and its ancestors
*
* @see ClassLoader#getDefinedPackages
*
* @revised 9
*/
@CallerSensitive
public static Package[] getPackages() {

6
src/java.base/share/classes/java/lang/StackTraceElement.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2000, 2022, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2000, 2023, 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
@ -118,7 +118,6 @@ public final class StackTraceElement implements java.io.Serializable {
* @throws NullPointerException if {@code declaringClass} or
* {@code methodName} is null
* @since 1.5
* @revised 9
*/
public StackTraceElement(String declaringClass, String methodName,
String fileName, int lineNumber) {
@ -355,7 +354,6 @@ public final class StackTraceElement implements java.io.Serializable {
* {@link java.lang.StackWalker.StackFrame}, where an implementation may
* choose to omit some element in the returned string.
*
* @revised 9
* @see Throwable#printStackTrace()
*/
@Override
@ -426,8 +424,6 @@ public final class StackTraceElement implements java.io.Serializable {
* @return true if the specified object is another
* {@code StackTraceElement} instance representing the same
* execution point as this instance.
*
* @revised 9
*/
public boolean equals(Object obj) {
if (obj==this)

4
src/java.base/share/classes/java/lang/Thread.java
View file

@ -1693,8 +1693,6 @@ public class Thread implements Runnable {
*
* @throws SecurityException
* if the current thread cannot modify this thread
*
* @revised 6.0, 14
*/
public void interrupt() {
if (this != Thread.currentThread()) {
@ -1726,7 +1724,6 @@ public class Thread implements Runnable {
* @return {@code true} if the current thread has been interrupted;
* {@code false} otherwise.
* @see #isInterrupted()
* @revised 6.0, 14
*/
public static boolean interrupted() {
return currentThread().getAndClearInterrupt();
@ -1739,7 +1736,6 @@ public class Thread implements Runnable {
* @return {@code true} if this thread has been interrupted;
* {@code false} otherwise.
* @see #interrupted()
* @revised 6.0, 14
*/
public boolean isInterrupted() {
return interrupted;

9
src/java.base/share/classes/java/lang/invoke/MethodHandles.java
View file

@ -175,8 +175,6 @@ public class MethodHandles {
* Also, it cannot access
* <a href="MethodHandles.Lookup.html#callsens">caller sensitive methods</a>.
* @return a lookup object which is trusted minimally
*
* @revised 9
*/
public static Lookup publicLookup() {
return Lookup.PUBLIC_LOOKUP;
@ -1437,8 +1435,6 @@ public class MethodHandles {
* so that there can be a secure foundation for lookups.
* Nearly all other methods in the JSR 292 API rely on lookup
* objects to check access requests.
*
* @revised 9
*/
public static final
class Lookup {
@ -1621,8 +1617,6 @@ public class MethodHandles {
* @return the lookup modes, which limit the kinds of access performed by this lookup object
* @see #in
* @see #dropLookupMode
*
* @revised 9
*/
public int lookupModes() {
return allowedModes & ALL_MODES;
@ -1703,7 +1697,6 @@ public class MethodHandles {
* @throws IllegalArgumentException if {@code requestedLookupClass} is a primitive type or void or array class
* @throws NullPointerException if the argument is null
*
* @revised 9
* @see #accessClass(Class)
* @see <a href="#cross-module-lookup">Cross-module lookups</a>
*/
@ -2599,8 +2592,6 @@ public class MethodHandles {
* because it requires a direct subclass relationship between
* caller and callee.)
* @see #in
*
* @revised 9
*/
@Override
public String toString() {

5
src/java.base/share/classes/java/lang/reflect/AccessibleObject.java
View file

@ -74,7 +74,6 @@ import sun.security.util.SecurityConstants;
* @spec jni/index.html Java Native Interface Specification
* @jls 6.6 Access Control
* @since 1.2
* @revised 9
*/
public class AccessibleObject implements AnnotatedElement {
static {
@ -119,7 +118,6 @@ public class AccessibleObject implements AnnotatedElement {
* java.lang.Class}
* @see SecurityManager#checkPermission
* @see ReflectPermission
* @revised 9
*/
@CallerSensitive
public static void setAccessible(AccessibleObject[] array, boolean flag) {
@ -207,7 +205,6 @@ public class AccessibleObject implements AnnotatedElement {
* @spec jni/index.html Java Native Interface Specification
* @see #trySetAccessible
* @see java.lang.invoke.MethodHandles#privateLookupIn
* @revised 9
*/
@CallerSensitive // overrides in Method/Field/Constructor are @CS
public void setAccessible(boolean flag) {
@ -424,8 +421,6 @@ public class AccessibleObject implements AnnotatedElement {
* This method may return {@code false} on a reflected object that is
* accessible to the caller. To test if this reflected object is accessible,
* it should use {@link #canAccess(Object)}.
*
* @revised 9
*/
@Deprecated(since="9")
public boolean isAccessible() {

5
src/java.base/share/classes/java/lang/reflect/Proxy.java
View file

@ -292,7 +292,6 @@ import static java.lang.module.ModuleDescriptor.Modifier.SYNTHETIC;
* @author Peter Jones
* @see InvocationHandler
* @since 1.3
* @revised 9
*/
public class Proxy implements java.io.Serializable {
@java.io.Serial
@ -382,7 +381,6 @@ public class Proxy implements java.io.Serializable {
* to create a proxy instance instead.
*
* @see <a href="#membership">Package and Module Membership of Proxy Class</a>
* @revised 9
*/
@Deprecated
@CallerSensitive
@ -1015,7 +1013,6 @@ public class Proxy implements java.io.Serializable {
* {@code null}
*
* @see <a href="#membership">Package and Module Membership of Proxy Class</a>
* @revised 9
*/
@CallerSensitive
public static Object newProxyInstance(ClassLoader loader,
@ -1100,8 +1097,6 @@ public class Proxy implements java.io.Serializable {
* @return {@code true} if the class is a proxy class and
* {@code false} otherwise
* @throws NullPointerException if {@code cl} is {@code null}
*
* @revised 9
*/
public static boolean isProxyClass(Class<?> cl) {
return Proxy.class.isAssignableFrom(cl) && ProxyBuilder.isProxyClass(cl);

3
src/java.base/share/classes/java/lang/reflect/package-info.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 1998, 2021, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1998, 2023, 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
@ -94,6 +94,5 @@
* @jvms 5.3.1 Loading Using the Bootstrap Class Loader
* @jvms 5.3.2 Loading Using a User-defined Class Loader
* @since 1.1
* @revised 9
*/
package java.lang.reflect;