Oracle VM VirtualBox 7.0.0_BETA2 Programming Guide and Reference

• 语言: 英语
• 格式: .pdf
• 来源: download.virtualbox.org

摘要

《Oracle VM VirtualBox 7.0.0_BETA2 Programming Guide and Reference》文档详细介绍了VirtualBox的编程接口及其使用方法。文档涵盖了VirtualBox的主要API，包括通过WebService和COM/XPCOM接口进行开发的内容，支持多种编程语言如Java、Python、C++等。文档还提供了不同版本之间的API变化日志，帮助开发者了解兼容性问题。此外，文档详细描述了如何使用COM/XPCOM进行开发，包括事件处理、虚拟机管理等功能，并提供了多个编程示例和注意事项。

AI总结

《Oracle VM VirtualBox 7.0.0_BETA2 编程指南和参考资料》是一份详细的技术文档，主要介绍了 VirtualBox 的主 API（Main API）及其使用方法。以下是文档的核心内容总结：

---

### 1. **主 API 的核心概念**
- **模块化设计**：VirtualBox 的主 API 是模块化的，提供了灵活的编程接口，适用于多种语言和环境。
- **接口形式**：
- **WebService**：通过 SOAP 协议提供服务，支持多种语言（如 Java、Python、PHP、Perl 等）。
- **COM/XPCOM**：适用于 Windows 环境，支持 C++、Java、Visual Basic 等语言。
- **面向对象的WebService（OOWS）**：为 Java 和 Python 提供了封装的类库，简化了调用流程。
- **原始WebService**：支持任何语言，但需要手动处理 WSDL 文件和生成客户端代码。

---

### 2. **编程环境与语言支持**
- **面向对象WebService（OOWS）**：
- Java：通过预生成的类库调用WebService。
- Python：通过 `vboxwebsrv` 提供的 Python 绑定调用WebService。
- PHP：通过 PHP 的WebService 客户端调用接口。
- **原始WebService**：
- 示例语言包括 Java（使用 Axis）和 Perl（使用 SOAP::Lite）。
- 注意事项：WebService 是无状态的，无法直接操作跨调用创建的对象。
- **COM/XPCOM 直接调用**：
- 支持 C++、Java、Visual Basic 等语言。
- 提供了 C 语言的绑定，简化了跨平台开发。
- **Visual Basic 脚本示例**：通过 COM 调用 VirtualBox API，例如查询 VirtualBox 版本或遍历虚拟机列表。

---

### 3. **主要 API 变更日志**
- **版本 7.0 的不兼容更改**：
- 移动音频适配器到新的 `IAudioSettings` 接口。
- `IVirtualBox::openMachine` 方法新增密码参数。
- 默认音频驱动改为 `AudioDriverType_Default`。
- 重构了主机更新功能，引入新的 `IHostUpdateAgent` 接口。
- `directoryCopyFromGuest` 和 `directoryCopyToGuest` 方法不再递归复制，需手动设置 `DirectoryCopyFlag::Recursive` 和 `DirectoryCopyFlag::FollowLinks` 标志。
- `VBoxEventType Last` 重命名为 `VBoxEventType End`。
- **版本 6.1 的不兼容更改**：
- 将 `IMachine` 的图形适配器部分移动到新的 `IGraphicsAdapter` 接口。

---

### 4. **云集成与导出功能**
- **Oracle Cloud Infrastructure（OCI）支持**：
- 提供 `ICloudClient`、`ICloudProvider` 等接口，用于与 OCI 集成。
- `ICloudClient::exportVM` 方法支持将虚拟机导出为 OCI 自定义镜像。
- 导出流程包括上传虚拟机镜像到 OCI 对象存储，并创建自定义镜像。
- **导出参数要求**：`description` 参数必须包含以下字段：
- `Name`：新实例名称。
- `HardDiskImage`：引导镜像路径或 ID。
- `CloudBucket`：上传目标存储桶名称。
- `CloudImageDisplayName`：自定义镜像显示名称。
- `CloudKeepObject`：是否保留上传对象。
- `CloudLaunchInstance`：是否启动新实例。

---

### 5. **其他重要功能**
- **虚拟机管理**：支持创建、启动、停止和删除虚拟机，获取性能统计信息等。
- **事件处理**：通过事件队列处理虚拟机状态变化。
- **编程注意事项**：
- 使用 COM/XPCOM 时需注意事件队列的处理。
- 使用WebService 时需手动处理无状态性问题。

---

### 总结
《Oracle VM VirtualBox 7.0.0_BETA2 编程指南和参考资料》详细介绍了 VirtualBox 的主 API，包括WebService、COM/XPCOM 的调用方式，以及不同编程语言的实现示例。文档还列出了版本升级中的不兼容更改，并提供了与 Oracle Cloud Infrastructure 的集成支持。开发者可以根据需求选择合适的接口和编程语言，实现对 VirtualBox 的功能扩展和定制开发。