Oracle VM VirtualBox 4.2.8 Programming Guide and Reference

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

摘要

文档详细介绍了Oracle VM VirtualBox 4.2.8的编程接口和使用方法，包括WebService和COM/XPCOM的实现方式。主要内容涵盖如何通过WebService或COM/XPCOM调用Main API，创建和配置虚拟机，获取性能统计信息，以及使用Java、Python、PHP、Perl等语言开发客户程序。文档还列出了不同版本之间的API兼容性变化，特别是Guest控制API的迁移和新接口的引入。此外，文档提供了详细的API参考和示例，帮助开发者更好地理解和使用VirtualBox的功能。

AI总结

### Oracle VM VirtualBox 4.2.8 编程指南和参考手册总结

#### 1. 引言
- **VirtualBox 的模块化结构**：VirtualBox 分为内核模式和用户空间代码，核心是虚拟化引擎（hypervisor），负责控制虚拟机的执行。API 层（Main API）位于最上层，暴露了虚拟化引擎的所有功能。
- **Main API 的功能**：允许开发者创建、配置、启动、停止和删除虚拟机，获取性能统计数据，并配置 VirtualBox 安装。
- **开发支持**：VirtualBox 提供全面的 SDK，包含文档和接口文件，支持多种编程语言。

#### 2. Main API 的实现方式
- **WebService**：通过 `vboxwebsrv` 实现，支持 SOAP 连接。文档提供 WSDL 格式的 API 描述，支持 Java、C++、.NET、PHP、Python、Perl 等语言。
- **OOWS（面向对象WebService）**：为 Java 和 Python 提供封装，简化调用。
- **Raw WebService**：直接使用 WSDL，适用于其他语言，但缺乏类型安全和面向对象特性。
- **COM/XPCOM**：适用于 Windows（COM）和其他系统（XPCOM），支持 C++、Java、Visual Basic 等语言。

#### 3. 环境特定说明
- **OOWS**：为 Java、Python、PHP 提供面向对象的WebService 调用。
- **Raw WebService**：适用于其他语言，提供示例代码（如 Java 和 Perl）。
- **COM/XPCOM 直接使用**：支持 Python、C++ 等语言，提供事件队列处理和 Visual Basic 脚本支持。

#### 4. 基本 VirtualBox 概念与示例
- **虚拟机信息**：获取虚拟机的基本信息和属性。
- **虚拟机设置**：通过会话（Session）修改虚拟机配置。
- **启动虚拟机**：通过 API 启动和控制虚拟机。
- **虚拟机事件**：处理虚拟机启动、关闭等事件。

#### 5. VirtualBox Shell
- 提供命令行接口，用于管理虚拟机和配置 VirtualBox。

#### 6. 类接口（Interfaces）
- 列出了 VirtualBox 的主要接口（如 `IGuestSession`、`IGuestProcess` 等），并详细描述了每个接口的属性和方法。

#### 7. RDP Web Control
- 提供远程桌面协议（RDP）控制功能，支持嵌入 HTML 页面，适用于远程桌面场景。

#### 8. 外部认证模块
- 支持外部认证模块，允许集成第三方认证功能。

#### 9. Java API 使用
- 提供 Java API 的使用示例和要求，便于 Java 开发者快速上手。

#### 10. 许可证信息
- 文档末尾提供了许可证信息，适用于 LGPL 2.1。

#### 11. 主要 API 变更日志
- **版本兼容性**：VirtualBox 在同一主要版本内保持 API 兼容性。迁移至新版本时需注意不兼容的变更。
- **版本 4.2 的变更**：
- 引入 `IGuestSession` 接口，替代旧的 guest 控制 API。
- 增加了对 guest 进程、文件和目录的限制，部分功能尚未实现。
- **其他版本变更**：详细记录了从 2.0 到 4.2 各版本的不兼容变更，包括接口重命名、参数更改等。

### 总结
文档全面介绍了 VirtualBox 的编程接口（Main API）及其使用方法，涵盖了WebService、COM/XPCOM、虚拟机管理、事件处理、RDP 控制等功能。开发者可以根据需求选择合适的方式调用 API，并参考变更日志确保代码兼容性。