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

8305206: Add @spec tags in java.base/java.* (part 1)

Browse source 
Reviewed-by: alanb, naoto, darcy, lancea, dfuchs, iris, mchung
This commit is contained in:
Jonathan Gibbons 2023-04-04 00:09:38 +00:00
parent ccbb0e8d89
commit c6bd489cc8
60 changed files with 268 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

4
src/java.base/share/classes/java/nio/file/Files.java
View file

@ -1719,6 +1719,10 @@ public final class Files {
* @throws SecurityException
* If a security manager is installed and it denies an unspecified
* permission required by a file type detector implementation.
*
* @spec https://www.rfc-editor.org/info/rfc2045
* RFC 2045: Multipurpose Internet Mail Extensions (MIME) Part One:
* Format of Internet Message Bodies
*/
public static String probeContentType(Path path)
throws IOException

2
src/java.base/share/classes/java/nio/file/attribute/AclEntry.java
View file

@ -58,6 +58,8 @@ import java.util.*;
* <p> ACL entries are immutable and are safe for use by multiple concurrent
* threads.
*
* @spec https://www.rfc-editor.org/info/rfc3530
* RFC 3530: Network File System (NFS) version 4 Protocol
* @since 1.7
*/

6
src/java.base/share/classes/java/nio/file/attribute/AclEntryPermission.java
View file

@ -55,6 +55,9 @@ public enum AclEntryPermission {
* <p> <a href="http://www.ietf.org/rfc/rfc3530.txt">RFC&nbsp;3530: Network
* File System (NFS) version 4 Protocol</a> defines <em>named attributes</em>
* as opaque files associated with a file in the file system.
*
* @spec https://www.rfc-editor.org/info/rfc3530
* RFC 3530: Network File System (NFS) version 4 Protocol
*/
READ_NAMED_ATTRS,
@ -64,6 +67,9 @@ public enum AclEntryPermission {
* <p> <a href="http://www.ietf.org/rfc/rfc3530.txt">RFC&nbsp;3530: Network
* File System (NFS) version 4 Protocol</a> defines <em>named attributes</em>
* as opaque files associated with a file in the file system.
*
* @spec https://www.rfc-editor.org/info/rfc3530
* RFC 3530: Network File System (NFS) version 4 Protocol
*/
WRITE_NAMED_ATTRS,

2
src/java.base/share/classes/java/nio/file/attribute/AclFileAttributeView.java
View file

@ -139,6 +139,8 @@ import java.io.IOException;
* any attempt to create a file that would be less secure as a result of the
* translation.
*
* @spec https://www.rfc-editor.org/info/rfc3530
* RFC 3530: Network File System (NFS) version 4 Protocol
* @since 1.7
*/

3
src/java.base/share/classes/java/nio/file/attribute/FileTime.java
View file

@ -409,6 +409,9 @@ public final class FileTime
* are not present. The year before "{@code 0001}" is "{@code -0001}".
*
* @return the string representation of this file time
*
* @spec https://www.w3.org/TR/NOTE-datetime Date and Time Formats
* @spec https://www.w3.org/TR/xmlschema-2 XML Schema Part 2: Datatypes Second Edition
*/
@Override
public String toString() {

2
src/java.base/share/classes/java/nio/file/attribute/package-info.java
View file

@ -124,6 +124,8 @@
* or method in any class or interface in this package will cause a {@link
* java.lang.NullPointerException NullPointerException} to be thrown.
*
* @spec https://www.rfc-editor.org/info/rfc3530
* RFC 3530: Network File System (NFS) version 4 Protocol
* @since 1.7
*/

2
src/java.base/share/classes/java/nio/file/spi/FileTypeDetector.java
View file

@ -100,6 +100,8 @@ public abstract class FileTypeDetector {
* provider then the {@link SecurityManager#checkRead(String)} method
* is invoked to check read access to the file.
*
* @spec https://www.rfc-editor.org/info/rfc2045
* RFC 2045: Multipurpose Internet Mail Extensions (MIME) Part One: Format of Internet Message Bodies
* @see java.nio.file.Files#probeContentType
*/
public abstract String probeContentType(Path path)