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

8251203: Fix "no comment" warnings in java.base/java.lang and java/io

Browse source 
Reviewed-by: dfuchs, lancea, mchung, naoto
This commit is contained in:
Roger Riggs 2020-08-25 10:20:14 -04:00
parent 5585e6f63a
commit afce1f4ebd
19 changed files with 177 additions and 28 deletions
Download patch file Download diff file Expand all files Collapse all files

9
src/java.base/share/classes/java/io/File.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 1994, 2019, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1994, 2020, 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
@ -2231,6 +2231,9 @@ public class File
* in case the path is reconstituted on a different host type.
*
* @serialData Default fields followed by separator character.
*
* @param s the {@code ObjectOutputStream} to which data is written
* @throws IOException if an I/O error occurs
*/
@java.io.Serial
private synchronized void writeObject(java.io.ObjectOutputStream s)
@ -2245,6 +2248,10 @@ public class File
* The original separator character is read. If it is different
* than the separator character on this system, then the old separator
* is replaced by the local separator.
*
* @param s the {@code ObjectInputStream} from which data is read
* @throws IOException if an I/O error occurs
* @throws ClassNotFoundException if a serialized class cannot be loaded
*/
@java.io.Serial
private synchronized void readObject(java.io.ObjectInputStream s)

11
src/java.base/share/classes/java/io/FilePermission.java
View file

@ -1247,9 +1247,12 @@ final class FilePermissionCollection extends PermissionCollection
/**
* @serialData "permissions" field (a Vector containing the FilePermissions).
*/
/*
/**
* Writes the contents of the perms field out as a Vector for
* serialization compatibility with earlier releases.
*
* @param out the {@code ObjectOutputStream} to which data is written
* @throws IOException if an I/O error occurs
*/
@java.io.Serial
private void writeObject(ObjectOutputStream out) throws IOException {
@ -1263,8 +1266,12 @@ final class FilePermissionCollection extends PermissionCollection
out.writeFields();
}
/*
/**
* Reads in a Vector of FilePermissions and saves them in the perms field.
*
* @param in the {@code ObjectInputStream} from which data is read
* @throws IOException if an I/O error occurs
* @throws ClassNotFoundException if a serialized class cannot be loaded
*/
@java.io.Serial
private void readObject(ObjectInputStream in)

7
src/java.base/share/classes/java/io/ObjectStreamClass.java
View file

@ -93,6 +93,9 @@ public class ObjectStreamClass implements Serializable {
@java.io.Serial
private static final long serialVersionUID = -6120832682080437368L;
/**
* {@code ObjectStreamClass} has no fields for default serialization.
*/
@java.io.Serial
private static final ObjectStreamField[] serialPersistentFields =
NO_FIELDS;
@ -2538,7 +2541,9 @@ public class ObjectStreamClass implements Serializable {
}
}
// a LRA cache of record deserialization constructors
/**
* A LRA cache of record deserialization constructors.
*/
@SuppressWarnings("serial")
private static final class DeserializationConstructorsCache
extends ConcurrentHashMap<DeserializationConstructorsCache.Key, MethodHandle> {

5
src/java.base/share/classes/java/io/UncheckedIOException.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2012, 2019, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2012, 2020, 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
@ -76,6 +76,9 @@ public class UncheckedIOException extends RuntimeException {
/**
* Called to read the object from a stream.
*
* @param s the {@code ObjectInputStream} from which data is read
* @throws IOException if an I/O error occurs
* @throws ClassNotFoundException if a serialized class cannot be loaded
* @throws InvalidObjectException
* if the object is invalid or has a cause that is not
* an {@code IOException}