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

8162520: (fs) FileStore should support file stores with > Long.MAX_VALUE capacity

Browse source 
Reviewed-by: alanb, darcy, rriggs
This commit is contained in:
Brian Burkhalter 2019-11-01 13:16:50 -07:00
parent 012dffcd27
commit 2cea148cdf
3 changed files with 61 additions and 40 deletions
Download patch file Download diff file Expand all files Collapse all files

49
src/java.base/share/classes/java/nio/file/FileStore.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2007, 2017, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2007, 2019, 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
@ -84,7 +84,9 @@ public abstract class FileStore {
public abstract boolean isReadOnly();
/**
* Returns the size, in bytes, of the file store.
* Returns the size, in bytes, of the file store. If the total number of
* bytes in the file store is greater than {@link Long#MAX_VALUE}, then
* {@code Long.MAX_VALUE} will be returned.
*
* @return the size of the file store, in bytes
*
@ -95,7 +97,8 @@ public abstract class FileStore {
/**
* Returns the number of bytes available to this Java virtual machine on the
* file store.
* file store. If the number of bytes available is greater than
* {@link Long#MAX_VALUE}, then {@code Long.MAX_VALUE} will be returned.
*
* <p> The returned number of available bytes is a hint, but not a
* guarantee, that it is possible to use most or any of these bytes. The
@ -111,6 +114,25 @@ public abstract class FileStore {
*/
public abstract long getUsableSpace() throws IOException;
/**
* Returns the number of unallocated bytes in the file store.
* If the number of unallocated bytes is greater than
* {@link Long#MAX_VALUE}, then {@code Long.MAX_VALUE} will be returned.
*
* <p> The returned number of unallocated bytes is a hint, but not a
* guarantee, that it is possible to use most or any of these bytes. The
* number of unallocated bytes is most likely to be accurate immediately
* after the space attributes are obtained. It is likely to be
* made inaccurate by any external I/O operations including those made on
* the system outside of this virtual machine.
*
* @return the number of unallocated bytes
*
* @throws IOException
* if an I/O error occurs
*/
public abstract long getUnallocatedSpace() throws IOException;
/**
* Returns the number of bytes per block in this file store.
*
@ -118,8 +140,8 @@ public abstract class FileStore {
* called <i>blocks</i>. A block is the smallest storage unit of a file store.
* Every read and write operation is performed on a multiple of blocks.
*
* @implSpec The implementation in this class throws an
* {@code UnsupportedOperationException}.
* @implSpec The implementation in this class throws
* {@code UnsupportedOperationException}.
*
* @return a positive value representing the block size of this file store,
* in bytes
@ -136,23 +158,6 @@ public abstract class FileStore {
throw new UnsupportedOperationException();
}
/**
* Returns the number of unallocated bytes in the file store.
*
* <p> The returned number of unallocated bytes is a hint, but not a
* guarantee, that it is possible to use most or any of these bytes. The
* number of unallocated bytes is most likely to be accurate immediately
* after the space attributes are obtained. It is likely to be
* made inaccurate by any external I/O operations including those made on
* the system outside of this virtual machine.
*
* @return the number of unallocated bytes
*
* @throws IOException
* if an I/O error occurs
*/
public abstract long getUnallocatedSpace() throws IOException;
/**
* Tells whether or not this file store supports the file attributes
* identified by the given file attribute view.