鸿蒙OS开发文档 鸿蒙OS ResourceManager

2024-02-25 开发教程 鸿蒙OS开发文档 匿名 3

ResourceManager

java.lang.Object
|---ohos.global.resource.ResourceManager

public abstract class ResourceManager
extends Object

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

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

Since:

1

构造函数摘要

构造函数描述
ResourceManager()

方法总结

修饰符和类型方法描述
abstract PatterncreatePattern(ListTypedAttribute.AttrData data)基于包含 TypedAttribute.AttrData 的数组创建 Pattern 实例。
abstract ThemecreateTheme(ListTypedAttribute.AttrData data)基于包含 TypedAttribute.AttrData 的数组创建一个 Theme 实例。
abstract ConfigManagergetConfigManager()获取 ConfigManager 以获取全局配置。
abstract ConfigurationgetConfiguration()获取当前配置。
abstract DeviceCapabilitygetDeviceCapability()获取设备能力。
abstract ElementgetElement(int resId)根据资源 ID 获取 Element 对象。
abstract StringgetIdentifier(int resId)根据资源ID获取资源名称。
abstract StringgetMediaPath(int resId)根据资源ID获取媒体文件路径。
abstract RawFileEntrygetRawFileEntry(String path)根据原始文件路径获取 RawFileEntry 对象以打开原始文件。
abstract ResourcegetResource(int resId)根据资源ID获取资源。
abstract SolidXmlgetSolidXml(int resId)根据资源 ID 获取一个可靠的 XML 文档。
abstract ThemegetTheme(int resId)已弃用。 此更改从 API 版本 4 开始生效。由 Element#getTheme() 替换
abstract voidupdateConfiguration(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