鸿蒙OS ResourceManager

ResourceManager

java.lang.Object

|---ohos.global.resource.ResourceManager

public abstract class ResourceManager
extends Object

管理应用程序包资源目录下的所有资源。

ResourceManager 实例仅从上下文中获取。

Since:

1

构造函数摘要

构造函数	描述
ResourceManager()

方法总结

修饰符和类型	方法	描述
abstract Pattern	createPattern(ListTypedAttribute.AttrData data)	基于包含 TypedAttribute.AttrData 的数组创建 Pattern 实例。
abstract Theme	createTheme(ListTypedAttribute.AttrData data)	基于包含 TypedAttribute.AttrData 的数组创建一个 Theme 实例。
abstract ConfigManager	getConfigManager()	获取 ConfigManager 以获取全局配置。
abstract Configuration	getConfiguration()	获取当前配置。
abstract DeviceCapability	getDeviceCapability()	获取设备能力。
abstract Element	getElement(int resId)	根据资源 ID 获取 Element 对象。
abstract String	getIdentifier(int resId)	根据资源ID获取资源名称。
abstract String	getMediaPath(int resId)	根据资源ID获取媒体文件路径。
abstract RawFileEntry	getRawFileEntry(String path)	根据原始文件路径获取 RawFileEntry 对象以打开原始文件。
abstract Resource	getResource(int resId)	根据资源ID获取资源。
abstract SolidXml	getSolidXml(int resId)	根据资源 ID 获取一个可靠的 XML 文档。
abstract Theme	getTheme(int resId)	已弃用。 此更改从 API 版本 4 开始生效。由 Element#getTheme() 替换
abstract void	updateConfiguration(Configuration config, DeviceCapability capability)	通过修改配置和设备能力来更新配置。

从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造函数详细信息

ResourceManager

public ResourceManager()

方法详情

getResource

public abstract Resource getResource(int resId) throws IOException, NotExistException

根据资源ID获取资源。

参数：

参数名称	参数描述
resId	表示资源ID。

返回:

返回资源对象； 如果资源 ID 不匹配任何资源，则返回 null。

Throws:

Throw名称	Throw描述
NotExistException	如果资源 ID 与任何资源都不匹配，则引发此异常。 资源ID必须由IDE或资源工具自动生成，或者由系统提供。
IOException	如果在资源读取期间发生 I/O 错误，则引发此异常。

getIdentifier

public abstract String getIdentifier(int resId) throws IOException, NotExistException

根据资源ID获取资源名称。

参数：

参数名称	参数描述
resId	表示资源ID。

返回:

返回类型为 type_name 的资源名称； 如果资源 ID 不匹配任何资源，则返回 null。

Throws:

Throw名称	Throw描述
NotExistException	如果资源 ID 与任何资源都不匹配，则引发此异常。 资源ID必须由IDE或资源工具自动生成，或者由系统提供。
IOException	如果在资源读取期间发生 I/O 错误，则引发此异常。

getElement

public abstract Element getElement(int resId) throws IOException, NotExistException, WrongTypeException

根据资源 ID 获取 Element 对象。

参数：

参数名称	参数描述
resId	表示资源ID。

返回:

返回与资源 ID 关联的 Element 对象。

Throws:

Throw名称	Throw描述
NotExistException	如果资源 ID 与任何资源都不匹配，则引发此异常。 资源ID必须由IDE或资源工具自动生成，或者由系统提供。
IOException	如果在资源读取期间发生 I/O 错误，则引发此异常。
WrongTypeException	如果资源不是 Element 类型，则引发此异常。

Since:

3

getTheme

@Deprecated public abstract Theme getTheme(int resId) throws IOException, NotExistException, WrongTypeException

已弃用。 此更改从 API 版本 4 开始生效。由 Element#getTheme() 替换

根据资源 ID 获取 Theme 实例。

参数：

参数名称	参数描述
resId	表示资源ID。

返回:

返回一个主题实例。

Throws:

Throw名称	Throw描述
NotExistException	如果资源 ID 与任何资源都不匹配，则引发此异常。 资源ID必须由IDE或资源工具自动生成，或者由系统提供。
IOException	如果在资源读取期间发生 I/O 错误，则引发此异常。
WrongTypeException	如果资源不是主题类型，则引发此异常。

Since:

3

getSolidXml

public abstract SolidXml getSolidXml(int resId) throws IOException, NotExistException, WrongTypeException

根据资源 ID 获取一个可靠的 XML 文档。

参数：

参数名称	参数描述
resId	表示资源ID。

返回:

返回资源的实体 XML 文档； 如果在转换为实体 XML 文档期间发生错误，则返回 null。

Throws:

Throw名称	Throw描述
NotExistException	如果资源 ID 与任何资源都不匹配，则引发此异常。 资源ID必须由IDE或资源工具自动生成，或者由系统提供。
IOException	如果在资源读取期间发生 I/O 错误，则引发此异常。
WrongTypeException	如果资源不是 Solid XML 类型，则引发此异常。

getRawFileEntry

public abstract RawFileEntry getRawFileEntry(String path)

根据原始文件路径获取 RawFileEntry 对象以打开原始文件。

参数：

参数名称	参数描述
path	指示原始文件路径。

返回:

返回 RawFileEntry 对象。

Since:

3

getConfigManager

public abstract ConfigManager getConfigManager()

获取 ConfigManager 以获取全局配置。

返回:

返回 ConfigManager 对象； 如果发生错误，则返回 null。

getMediaPath

public abstract String getMediaPath(int resId) throws IOException, NotExistException, WrongTypeException

根据资源ID获取媒体文件路径。

参数：

参数名称	参数描述
resId	表示资源ID。

返回:

返回媒体文件路径。

Throws:

Throw名称	Throw描述
NotExistException	如果资源 ID 与任何资源都不匹配，则引发此异常。 资源ID必须由IDE或资源工具自动生成，或者由系统提供。
IOException	如果在资源读取期间发生 I/O 错误，则引发此异常。
WrongTypeException	如果资源不是字符串类型，则引发此异常。

getConfiguration

public abstract Configuration getConfiguration()

获取当前配置。

返回:

返回当前配置。

getDeviceCapability

public abstract DeviceCapability getDeviceCapability()

获取设备能力。

返回:

返回设备能力。

Since:

3

updateConfiguration

public abstract void updateConfiguration(Configuration config, DeviceCapability capability)

通过修改配置和设备能力来更新配置。

参数：

参数名称	参数描述
config	表示新配置。
capability	表示新的设备能力。

Since:

3

createPattern

public abstract Pattern createPattern(ListTypedAttribute.AttrData data)

基于包含 TypedAttribute.AttrData 的数组创建 Pattern 实例。

参数：

参数名称	参数描述
data	表示属性数据的集合。 每个属性数据都有自己的名称、值和类型。

返回:

返回创建的 Pattern 实例。

Since:

4

createTheme

public abstract Theme createTheme(ListTypedAttribute.AttrData data)

基于包含 TypedAttribute.AttrData 的数组创建一个 Theme 实例。

参数：

参数名称	参数描述
data	表示属性数据的集合。 每个属性数据都有自己的名称、值和类型。

返回:

返回创建的 Theme 实例。

Since:

4