程序包 ohos.storageinfomgr

类 StorageInfoManager

java.lang.Object

ohos.storageinfomgr.StorageInfoManager

public final class StorageInfoManager
extends Object

Queries the available space of storage volumes and the application storage information of a specified user.

The storage information includes the application size, application data size, and application cached data size. It is stored in StorageInfo.

从以下版本开始:

3

另请参阅:

StorageInfo

SystemCapability

SystemCapability.ResourceSchedule#STORAGE_INFO

方法概要

限定符和类型	方法	说明
long	getFreeSize(UUID storageUuid)	Obtains the available space of a specified storage volume.
long	getWholeSize(UUID storageUuid)	Obtains the total space of a specified storage volume.
static StorageInfoManager	newInstance(Context context)	A static factory method used to create a StorageInfoManager instance.
StorageInfo	queryInfoByPackageName(UUID storageUuid, String packageName, int uid)	Obtains the storage information of a specified application that belongs to a specified user on a specified storage volume.
StorageInfo	queryInfoByUid(UUID storageUuid, int uid)	Obtains the application storage status of a specified user on a specified storage volume.

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

方法详细资料

newInstance

public static StorageInfoManager newInstance(Context context)

A static factory method used to create a StorageInfoManager instance.

参数:

context - Indicates the application context.

返回:

Returns a StorageInfoManager instance if the creation is successful; returns null if the context is null.

从以下版本开始:

3

getFreeSize

public long getFreeSize(UUID storageUuid)
                 throws IOException

Obtains the available space of a specified storage volume.

The available space includes the remaining space and the cache data space that can be released.

参数:

storageUuid - Indicates the storage volume to be queried. You can query the value using Volume.getVolUuid().

返回:

Returns the available size of the specified storage volume, in bytes.

抛出:

IOException - Throws this exception if the storage volume to be queried does not exist.

从以下版本开始:

3

getWholeSize

public long getWholeSize(UUID storageUuid)
                  throws IOException

Obtains the total space of a specified storage volume.

参数:

storageUuid - Indicates the UUID of the storage volume to be queried. You can obtain the UUID using Volume.getVolUuid().

返回:

Returns the total size of the specified storage volume, in bytes.

抛出:

IOException - Throws this exception if the storage volume to be queried does not exist.

从以下版本开始:

4

queryInfoByPackageName

public StorageInfo queryInfoByPackageName(UUID storageUuid,
                                          String packageName,
                                          int uid)
                                   throws IOException,
                                          NotExistException

Obtains the storage information of a specified application that belongs to a specified user on a specified storage volume.

参数:

storageUuid - Indicates the UUID of the storage volume to be queried. You can obtain the UUID using Volume.getVolUuid().

packageName - Indicates the name of the application package to be queried.

uid - Indicates the ID of the user to be queried. You can obtain the user ID using IBundleManager.getUidByBundleName(java.lang.String, int).

返回:

Returns the storage status of the application. For details, see StorageInfo.

抛出:

IOException - Throws this exception if the storage volume to be queried does not exist.

NotExistException - Throws this exception if the queried package does not exist.

从以下版本开始:

3

queryInfoByUid

public StorageInfo queryInfoByUid(UUID storageUuid,
                                  int uid)
                           throws IOException

Obtains the application storage status of a specified user on a specified storage volume.

参数:

storageUuid - Indicates the storage volume to be queried. You can query the value using Volume.getVolUuid().

uid - Indicates the ID of the user to be queried. You can obtain the user ID using IBundleManager.getUidByBundleName(java.lang.String, int).

返回:

Returns the storage status of the specified user. For details, see StorageInfo.

抛出:

IOException - Throws this exception if the storage volume to be queried does not exist.

从以下版本开始:

3