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