infernap12/jdk
1
0
Fork 0
mirror of https://github.com/openjdk/jdk.git synced 2026-01-28 12:09:14 +00:00
Code Issues Packages Projects Releases Wiki Activity

8251182: Fix "no comment" warnings in java.naming

Browse Source 
Reviewed-by: lancea, rriggs, dfuchs
This commit is contained in:
Aleksei Efimov 2020-08-28 13:10:32 +01:00
parent 80d889189a
commit 30c2dbea95
7 changed files with 137 additions and 20 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

24
src/java.naming/share/classes/javax/naming/CompositeName.java
View File

@ -1,5 +1,5 @@
/*
* Copyright (c) 1999, 2019, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1999, 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
@ -562,12 +562,19 @@ public class CompositeName implements Name {
}
/**
* Overridden to avoid implementation dependency.
* The writeObject method is called to save the state of the
* {@code CompositeName} to a stream.
*
* @serialData The number of components (an {@code int}) followed by
* the individual components (each a {@code String}).
*
* @param s the {@code ObjectOutputStream} to write to
* @throws java.io.IOException if an I/O error occurs
*/
@java.io.Serial
private void writeObject(java.io.ObjectOutputStream s)
throws java.io.IOException {
// Overridden to avoid implementation dependency
s.writeInt(size());
Enumeration<String> comps = getAll();
while (comps.hasMoreElements()) {
@ -576,10 +583,20 @@ public class CompositeName implements Name {
}
/**
* Overridden to avoid implementation dependency.
* The readObject method is called to restore the state of
* the {@code CompositeName} from a stream.
*
* See {@code writeObject} for a description of the serial form.
*
* @param s the {@code ObjectInputStream} to read from
* @throws java.io.IOException if an I/O error occurs
* @throws ClassNotFoundException if the class of a serialized object
* could not be found
*/
@java.io.Serial
private void readObject(java.io.ObjectInputStream s)
throws java.io.IOException, ClassNotFoundException {
// Overridden to avoid implementation dependency
impl = new NameImpl(null); // null means use default syntax
int n = s.readInt(); // number of components
try {
@ -594,6 +611,7 @@ public class CompositeName implements Name {
/**
* Use serialVersionUID from JNDI 1.1.1 for interoperability
*/
@java.io.Serial
private static final long serialVersionUID = 1667768148915813118L;
/*

24
src/java.naming/share/classes/javax/naming/CompoundName.java
View File

@ -1,5 +1,5 @@
/*
* Copyright (c) 1999, 2019, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1999, 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
@ -547,13 +547,20 @@ public class CompoundName implements Name {
}
/**
* Overridden to avoid implementation dependency.
* The writeObject method is called to save the state of the
* {@code CompoundName} to a stream.
*
* @serialData The syntax {@code Properties}, followed by
* the number of components (an {@code int}), and the individual
* components (each a {@code String}).
*
* @param s the {@code ObjectOutputStream} to write to
* @throws java.io.IOException if an I/O error occurs
*/
@java.io.Serial
private void writeObject(java.io.ObjectOutputStream s)
throws java.io.IOException {
// Overridden to avoid implementation dependency
s.writeObject(mySyntax);
s.writeInt(size());
Enumeration<String> comps = getAll();
@ -563,10 +570,20 @@ public class CompoundName implements Name {
}
/**
* Overridden to avoid implementation dependency.
* The readObject method is called to restore the state of
* the {@code CompoundName} from a stream.
*
* See {@code writeObject} for a description of the serial form.
*
* @param s the {@code ObjectInputStream} to read from
* @throws java.io.IOException if an I/O error occurs
* @throws ClassNotFoundException if the class of a serialized object
* could not be found
*/
@java.io.Serial
private void readObject(java.io.ObjectInputStream s)
throws java.io.IOException, ClassNotFoundException {
// Overridden to avoid implementation dependency.
mySyntax = (Properties)s.readObject();
impl = new NameImpl(mySyntax);
int n = s.readInt(); // number of components
@ -582,6 +599,7 @@ public class CompoundName implements Name {
/**
* Use serialVersionUID from JNDI 1.1.1 for interoperability
*/
@java.io.Serial
private static final long serialVersionUID = 3513100557083972036L;
/*

28
src/java.naming/share/classes/javax/naming/directory/BasicAttribute.java
View File

@ -1,5 +1,5 @@
/*
* Copyright (c) 1999, 2017, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1999, 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
@ -494,13 +494,20 @@ public class BasicAttribute implements Attribute {
// ---- serialization methods
/**
* Overridden to avoid exposing implementation details
* @serialData Default field (the attribute ID -- a String),
* followed by the number of values (an int), and the
* The writeObject method is called to save the state of the
* {@code BasicAttribute} to a stream.
*
* @serialData Default field (the attribute ID - a {@code String}),
* followed by the number of values (an {@code int}), and the
* individual values.
*
* @param s the {@code ObjectOutputStream} to write to
* @throws java.io.IOException if an I/O error occurs
*/
@java.io.Serial
private void writeObject(java.io.ObjectOutputStream s)
throws java.io.IOException {
// Overridden to avoid exposing implementation details
s.defaultWriteObject(); // write out the attrID
s.writeInt(values.size());
for (int i = 0; i < values.size(); i++) {
@ -509,10 +516,20 @@ public class BasicAttribute implements Attribute {
}
/**
* Overridden to avoid exposing implementation details.
* The readObject method is called to restore the state of
* the {@code BasicAttribute} from a stream.
*
* See {@code writeObject} for a description of the serial form.
*
* @param s the {@code ObjectInputStream} to read from
* @throws java.io.IOException if an I/O error occurs
* @throws ClassNotFoundException if the class of a serialized object
* could not be found
*/
@java.io.Serial
private void readObject(java.io.ObjectInputStream s)
throws java.io.IOException, ClassNotFoundException {
// Overridden to avoid exposing implementation details.
s.defaultReadObject(); // read in the attrID
int n = s.readInt(); // number of values
values = new Vector<>(Math.min(1024, n));
@ -553,5 +570,6 @@ public class BasicAttribute implements Attribute {
/**
* Use serialVersionUID from JNDI 1.1.1 for interoperability.
*/
@java.io.Serial
private static final long serialVersionUID = 6743528196119291326L;
}

28
src/java.naming/share/classes/javax/naming/directory/BasicAttributes.java
View File

@ -1,5 +1,5 @@
/*
* Copyright (c) 1999, 2017, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1999, 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
@ -279,13 +279,20 @@ public class BasicAttributes implements Attributes {
}
/**
* Overridden to avoid exposing implementation details.
* @serialData Default field (ignoreCase flag -- a boolean), followed by
* The writeObject method is called to save the state of the
* {@code BasicAttributes} to a stream.
*
* @serialData Default field (ignoreCase flag - a {@code boolean}), followed by
* the number of attributes in the set
* (an int), and then the individual Attribute objects.
* (an {@code int}), and then the individual {@code Attribute} objects.
*
* @param s the {@code ObjectOutputStream} to write to
* @throws java.io.IOException if an I/O error occurs
*/
@java.io.Serial
private void writeObject(java.io.ObjectOutputStream s)
throws java.io.IOException {
// Overridden to avoid exposing implementation details
s.defaultWriteObject(); // write out the ignoreCase flag
s.writeInt(attrs.size());
Enumeration<Attribute> attrEnum = attrs.elements();
@ -295,10 +302,20 @@ public class BasicAttributes implements Attributes {
}
/**
* Overridden to avoid exposing implementation details.
* The readObject method is called to restore the state of
* the {@code BasicAttributes} from a stream.
*
* See {@code writeObject} for a description of the serial form.
*
* @param s the {@code ObjectInputStream} to read from
* @throws java.io.IOException if an I/O error occurs
* @throws ClassNotFoundException if the class of a serialized object
* could not be found
*/
@java.io.Serial
private void readObject(java.io.ObjectInputStream s)
throws java.io.IOException, ClassNotFoundException {
// Overridden to avoid exposing implementation details.
s.defaultReadObject(); // read in the ignoreCase flag
int n = s.readInt(); // number of attributes
attrs = (n >= 1)
@ -374,5 +391,6 @@ class IDEnumImpl implements NamingEnumeration<String> {
/**
* Use serialVersionUID from JNDI 1.1.1 for interoperability.
*/
@java.io.Serial
private static final long serialVersionUID = 4980164073184639448L;
}

25
src/java.naming/share/classes/javax/naming/ldap/LdapName.java
View File

@ -1,5 +1,5 @@
/*
* Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2003, 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
@ -106,6 +106,8 @@ public class LdapName implements Name {
private transient List<Rdn> rdns; // parsed name components
private transient String unparsed; // if non-null, the DN in unparsed form
@java.io.Serial
private static final long serialVersionUID = -1595520034788997356L;
/**
@ -755,17 +757,36 @@ public class LdapName implements Name {
}
/**
* The writeObject method is called to save the state of the
* {@code LdapName} to a stream.
*
* Serializes only the unparsed DN, for compactness and to avoid
* any implementation dependency.
*
* @serialData The DN string
* @serialData The DN {@code String} representation of this LDAP name.
*
* @param s the {@code ObjectOutputStream} to write to
* @throws java.io.IOException if an I/O error occurs
*/
@java.io.Serial
private void writeObject(ObjectOutputStream s)
throws java.io.IOException {
s.defaultWriteObject();
s.writeObject(toString());
}
/**
* The readObject method is called to restore the state of
* the {@code LdapName} from a stream.
*
* See {@code writeObject} for a description of the serial form.
*
* @param s the {@code ObjectInputStream} to read from
* @throws java.io.IOException if an I/O error occurs
* @throws ClassNotFoundException if the class of a serialized object
* could not be found
*/
@java.io.Serial
private void readObject(ObjectInputStream s)
throws java.io.IOException, ClassNotFoundException {
s.defaultReadObject();

24
src/java.naming/share/classes/javax/naming/ldap/Rdn.java
View File

@ -1,5 +1,5 @@
/*
* Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2003, 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
@ -110,6 +110,7 @@ public class Rdn implements Serializable, Comparable<Object> {
// The common case.
private static final int DEFAULT_SIZE = 1;
@java.io.Serial
private static final long serialVersionUID = -5994465067210009656L;
/**
@ -732,17 +733,36 @@ public class Rdn implements Serializable, Comparable<Object> {
}
/**
* The writeObject method is called to save the state of the
* {@code Rdn} to a stream.
*
* Serializes only the unparsed RDN, for compactness and to avoid
* any implementation dependency.
*
* @serialData The RDN string
* @serialData The unparsed RDN {@code String} representation.
*
* @param s the {@code ObjectOutputStream} to write to
* @throws java.io.IOException if an I/O error occurs
*/
@java.io.Serial
private void writeObject(ObjectOutputStream s)
throws java.io.IOException {
s.defaultWriteObject();
s.writeObject(toString());
}
/**
* The readObject method is called to restore the state of
* the {@code Rdn} from a stream.
*
* See {@code writeObject} for a description of the serial form.
*
* @param s the {@code ObjectInputStream} to read from
* @throws IOException if an I/O error occurs
* @throws ClassNotFoundException if the class of a serialized object
* could not be found
*/
@java.io.Serial
private void readObject(ObjectInputStream s)
throws IOException, ClassNotFoundException {
s.defaultReadObject();

4
src/java.naming/share/classes/javax/naming/spi/NamingManager.java
View File

@ -948,6 +948,10 @@ public class NamingManager {
return (answer != null) ? answer : obj;
}
/**
* Thrown when an error is encountered while loading and instantiating the
* context factory classes.
*/
private static class FactoryInitializationError extends Error {
@java.io.Serial
static final long serialVersionUID = -5805552256848841560L;