Oracle VM VirtualBox 4.3.12 Programming Guide and Reference

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

摘要

The document provides a comprehensive guide to programming with Oracle VM VirtualBox 4.3.12. It details the Main API, which allows interaction with VirtualBox's virtualization engine, including creating, configuring, and managing virtual machines. Key topics include session management to prevent conflicts when modifying machine settings, enumerating virtual machines, and handling attributes such as UUID, name, memory, and operating system. The guide also covers API versioning and incompatible changes across major releases, ensuring compatibility with different programming environments.

AI总结

### Oracle VM VirtualBox 4.3.12 编程指南和参考文档总结

#### 1. 引言
- **模块化设计**：VirtualBox 分层设计清晰，包括 hypervisor、内部模块（如 RDP 服务器、实时迁移）和 API 层（Main API）。Main API 提供了对虚拟化功能的全面控制，如创建、配置和管理虚拟机。
- **Main API**：完全文档化，支持通过WebService（基于JAX-WS、Python、PHP等）或COM/XPCOM接口访问。

#### 2. 环境特定说明
- **对象-oriented Web Service (OOWS)**：支持多种语言，如Java（JAX-WS）、Python和PHP。
- **原始WebService**：适用于任何语言，提供直接的WebService接口。
- **COM/XPCOM**：支持Python、C++、Visual Basic等，推荐使用Python COM API。
- **C绑定**：旧版C接口已逐步淘汰，建议使用新的OOWS。

#### 3. 基本VirtualBox概念与示例
- **虚拟机信息获取**：通过 `IVirtualBox` 接口访问全局对象，获取虚拟机列表（`IMachine` 实例），并读取其属性（如UUID、名称、内存等）。
- **虚拟机设置更改**：需要通过 `ISession` 接口锁定虚拟机以避免并发修改。会话对象由 `IWebsessionManager::getSessionObject()` 创建。
- **虚拟机启动**：通过 `IMachine::launchVMProcess()` 方法启动虚拟机，支持指定前端类型。

#### 4. 虚拟机壳（Appliance）管理
- **Appliance接口**：用于处理OVF（Open Virtualization Format）文件，支持导入、导出和写入操作。
- **主要方法**：
- `read()`：读取OVF文件。
- `interpret()`：解析文件内容。
- `exportTo()`：导出为OVF文件。
- `write()`：写入OVF文件。
- **磁盘管理**：通过 `IMedium` 接口处理虚拟磁盘，支持克隆、锁定和解锁操作。

#### 5. 接口类（Interfaces）
- **核心接口**：
- `IVirtualBox`：全局接口，提供版本、修订号和机器列表等信息。
- `IMachine`：表示单个虚拟机，支持读取和设置属性。
- `IAppliance`：处理OVF文件，包含虚拟系统描述和磁盘信息。
- **其他接口**：如音频适配器、事件队列处理等。

#### 6. API变更日志
- **版本4.3的重大变更**：
- 中止锁定方法重设计：返回锁令牌对象，避免因程序崩溃导致的未决锁。
- `IMachine::launchVMProcess()` 的参数含义变更。
- `IMachine::export()` 和 `IMachine::delete()` 方法重命名为 `exportTo()` 和 `deleteConfig()`。
- **兼容性**：OOWS Java包装器通过版本特定包（如 `org.virtualbox_2_2`）确保不同版本兼容性。

#### 7. 总结
- VirtualBox 提供了强大且灵活的编程接口，支持多种语言和应用场景。
- 开发时需注意会话管理、锁机制和版本兼容性问题。
- 推荐使用新的OOWS接口，避免依赖即将淘汰的C绑定。

如需更详细的信息，可参考文档中的具体接口和方法描述。