第 2 章 使用软件开发组件
本章定义了 Ruby 软件开发套件的模块和类,并描述了它们的用法。
2.1. 类
OvirtSDK4 模块包含以下软件开发 kit 类:
- 连接
- Connection 类是连接到服务器的机制,并获取对服务树根目录的引用。详情请查看 第 3.1 节 “连接到 Red Hat Virtualization Manager”。
- 类型
Type 类实施 API 支持的类型。例如,Vm 类是虚拟机类型的实施。类是数据容器,不包含任何逻辑。您将使用类型实例。
这些类的实例用作参数并返回服务方法值。到底层表示的转换由软件开发工具包透明处理。
- 服务
Service 类实施 API 支持的服务。例如,VmsService 类是服务实施,用于管理系统中虚拟机的集合。
当引用服务时,SDK 会自动创建这些类的实例。例如,当您调用
SystemService
类的vms_service
方法时,SDK 会自动创建VmsService
类的新实例:vms_service = connection.system_service.vms_service
警告
不要手动创建这些类的实例。构造器参数和方法将来可能会改变。
- Error
Error 类是软件开发工具包在报告错误时引发的基础例外类。
某些特定的错误类扩展基本错误类:
- AuthError - 身份验证或授权失败
- ConnectionError - 服务器名称无法解析,或者服务器无法访问
- NotFoundError - Requested 对象不存在
- TimeoutError - Operation time-out
- 其他类
- 其他类(如 HTTP 客户端类、读取器和作者)用于 HTTP 通信,以及用于 XML 解析和渲染。不建议使用这些类,因为它们组成将来可能会改变的内部实施详情。无法依赖于其向后兼容。