8263105: security-libs doclint cleanup

Reviewed-by: iris, darcy, dfuchs, mullan
This commit is contained in:
Bradford Wetmore 2021-03-11 00:26:26 +00:00
parent 6971c23a3a
commit 32cbd193d9
35 changed files with 294 additions and 79 deletions

View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 1997, 2019, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1997, 2021, 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
@ -421,8 +421,11 @@ public class SealedObject implements Serializable {
/**
* Restores the state of the SealedObject from a stream.
*
* @param s the object input stream.
* @exception NullPointerException if s is null.
* @throws IOException if an I/O error occurs
* @throws ClassNotFoundException if a serialized class cannot be loaded
* @throws NullPointerException if s is null
*/
@java.io.Serial
private void readObject(java.io.ObjectInputStream s)

View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 1999, 2019, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1999, 2021, 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
@ -26,6 +26,7 @@
package javax.security.auth;
import java.util.*;
import java.io.IOException;
import java.text.MessageFormat;
import java.security.Permission;
import java.security.PermissionCollection;
@ -475,10 +476,14 @@ public final class PrivateCredentialPermission extends Permission {
/**
* Reads this object from a stream (i.e., deserializes it)
*
* @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 void readObject(java.io.ObjectInputStream s) throws
java.io.IOException,
IOException,
ClassNotFoundException {
s.defaultReadObject();

View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 1998, 2020, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1998, 2021, 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
@ -949,6 +949,9 @@ public final class Subject implements java.io.Serializable {
/**
* Writes this object out to a stream (i.e., serializes it).
*
* @param oos the {@code ObjectOutputStream} to which data is written
* @throws IOException if an I/O error occurs
*/
@java.io.Serial
private void writeObject(java.io.ObjectOutputStream oos)
@ -960,6 +963,10 @@ public final class Subject implements java.io.Serializable {
/**
* Reads this object from a stream (i.e., deserializes it)
*
* @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
*/
@SuppressWarnings("unchecked")
@java.io.Serial
@ -1408,6 +1415,9 @@ public final class Subject implements java.io.Serializable {
* the caller has permission to access each credential
* in the set. If the security check passes,
* the set is serialized.
*
* @param oos the {@code ObjectOutputStream} to which data is written
* @throws IOException if an I/O error occurs
*/
@java.io.Serial
private void writeObject(java.io.ObjectOutputStream oos)
@ -1427,6 +1437,13 @@ public final class Subject implements java.io.Serializable {
oos.writeFields();
}
/**
* Restores the state of this object from the stream.
*
* @param ois 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
*/
@SuppressWarnings("unchecked")
@java.io.Serial
private void readObject(ObjectInputStream ois)

View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2000, 2019, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2000, 2021, 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
@ -494,6 +494,9 @@ public final class X500Principal implements Principal, java.io.Serializable {
* @serialData this {@code X500Principal} is serialized
* by writing out its DER-encoded form
* (the value of {@code getEncoded} is serialized).
*
* @param s the {@code ObjectOutputStream} to which data is written
* @throws IOException if an I/O error occurs
*/
@java.io.Serial
private void writeObject(java.io.ObjectOutputStream s)
@ -503,6 +506,11 @@ public final class X500Principal implements Principal, java.io.Serializable {
/**
* Reads this object from a stream (i.e., deserializes it).
*
* @param s the {@code ObjectInputStream} from which data is read
* @throws IOException if an I/O error occurs
* @throws NotActiveException if serialization is not active
* @throws ClassNotFoundException if a serialized class cannot be loaded
*/
@java.io.Serial
private void readObject(java.io.ObjectInputStream s)