Oracle VM VirtualBox 3.2.28 Programming Guide and Reference

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

摘要

文档详细介绍了Oracle VM VirtualBox 3.2.28的编程指南和参考信息，涵盖了Main API的使用方法、COM/XPCOM接口的实现、Web服务的编程方式以及不同版本之间的API变化。文档还提供了如何通过不同编程语言（如Java、Python、Perl等）调用这些接口的示例，并详细说明了版本升级过程中可能遇到的不兼容问题及解决方案。

AI总结

《Oracle VM VirtualBox 3.2.28 编程指南和参考》主要介绍了 Oracle VM VirtualBox 的编程接口和相关技术细节，以下是文档的核心内容总结：

### 1. 主要内容概述
- **VirtualBox 的模块化结构**：VirtualBox 被设计为多个独立模块，包括内核模式的虚拟化引擎、用户空间的管理模块以及提供编程接口的 API 层。开发者可以通过“主 API”（Main API）控制和配置 VirtualBox 的所有功能。
- **主 API 的功能**：主 API 提供了创建、配置、启动、停止和删除虚拟机的能力，同时支持获取运行中的虚拟机性能统计信息，并对 VirtualBox 安装进行全局配置。

### 2. 网络服务接口（Web Service Interface）
- **面向对象的网络服务（OOWS）**：文档提供了针对 Java、Python 和 PHP 的面向对象网络服务接口，简化了与 VirtualBox 的交互。
- **Java 和 Python 的 OO 绑定**：通过预生成的类，开发者可以更直观地调用 VirtualBox 的功能。
- **网络服务的运行**：网络服务通过 `vboxwebsrv` 运行，支持 SOAP 协议，适用于多种编程语言。
- **原始网络服务（Raw Web Service）**：适用于没有 OO 绑定的语言，通过 WSDL 描述接口，使用工具生成客户端代码。

### 3. COM/XPCOM 接口
- **COM/XPCOM 的支持**：VirtualBox 在 Windows 上使用 COM，在其他平台使用 XPCOM，支持多种编程语言（如 C++、Python、Visual Basic）。
- **主要接口**：
- **Python 绑定**：通过 ` vboxapi` 模块访问 COM 接口。
- **C++ 接口**：直接使用 COM/XPCOM 方法调用。
- **事件队列处理**：支持注册回调函数，处理虚拟机状态变化。

### 4. 主 API 变更日志
- **版本兼容性**：主 API 在大版本号（x.y.z 中的 x 或 y）变化时可能不兼容，小版本号（z）变化时保持兼容。
- **版本 3.2 的变更**：
- 接口重命名：部分接口名称和枚举类型名称进行了调整，例如 `IMachine::getCpuProperty()` 改为 `IMachine::getCPUProperty()`。
- 新增功能：支持忽略现有配置文件创建虚拟机，新增 `override` 参数；支持删除运行中的虚拟机快照。
- 多显示器支持：新增 `screenId` 参数，扩展了对多显示器配置的 API 支持。

### 5. 类接口和枚举
- **类接口（Interfaces）**：文档详细列出了 VirtualBox 的主要接口，例如 `IAppliance`、`IConsole`、`IMachine` 等，每个接口包含属性和方法。
- **枚举（Enumerations）**：定义了多种枚举类型，例如 `AudioControllerType` 和 `HostNetworkInterfaceMediumType`，用于配置虚拟机硬件和网络设置。

### 6. 其他注意事项
- **许可信息**：文档末尾提供了 Oracle 的版权声明和许可信息。
- **虚拟机调试和性能监控**：通过 `IMachineDebugger` 接口，支持注入 NMI 信号和重置虚拟机统计信息。

总结来看，文档全面介绍了 VirtualBox 的编程接口和使用方法，适合开发者深入了解如何通过编程方式控制和管理虚拟机。