Oracle VM VirtualBox 4.3.22 Programming Guide and Reference

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

摘要

The document provides a comprehensive guide to programming with Oracle VM VirtualBox 4.3.22. It details the Main API, which exposes the full feature set of the virtualization engine, allowing developers to create, configure, and manage virtual machines. The guide covers the structure of VirtualBox, its modular design, and the programming interfaces available for various languages. It also includes information on environment-specific notes, basic virtualization concepts, and significant API changes across different versions. The document emphasizes the importance of maintaining API compatibility and handling version-specific updates to ensure seamless integration and functionality.

AI总结

《Oracle VM VirtualBox 4.3.22 编程指南与参考》是一份详细的文档，旨在为开发者提供与VirtualBox交互所需的接口和功能的全面说明。以下是文档的核心内容总结：

### 1. 模块化设计
VirtualBox被清晰地划分为多个层次，包括内核模式代码、用户空间代码和虚拟化引擎（hypervisor）。API层（称为“Main API”）位于顶层，公开了虚拟化引擎的所有功能，允许开发者创建、配置、启动、停止和删除虚拟机，以及获取性能统计信息和配置VirtualBox安装。

### 2. Main API的形态
Main API有两种实现形式：
- **WebService**：基于SOAP协议，支持JAX-WS、Python和PHP等语言。
- **COM/XPCOM**：支持Python、C++、Visual Basic Script（VBS）等语言。

此外，还提供了**Raw WebService**，适用于任何语言，但需要开发者手动处理SOAP和WSDL的限制。

### 3. 环境特定说明
文档详细介绍了如何在不同环境中使用Main API：
- **OOWS（Object-Oriented Web Service）**：为Java、Python和PHP提供了面向对象的WebService封装。
- **Raw WebService**：通过示例展示了如何直接使用WebService接口（如Java和Perl）。
- **COM/XPCOM**：提供了Python和C++的绑定层，以及Visual Basic和VBS的支持。

### 4. 基本概念与示例
文档通过示例展示了如何使用Main API完成以下操作：
- 获取虚拟机信息。
- 修改虚拟机设置。
- 启动和控制虚拟机。
- 处理虚拟机事件。

### 5. VirtualBox Shell
VirtualBox Shell是一个交互式工具，允许开发者通过命令行或脚本方式与VirtualBox交互。它支持本地和远程（通过WebService或COM/XPCOM）使用。

### 6. 类（接口）
文档详细列出了VirtualBox的核心接口及其属性和方法，例如：
- `IVirtualBox`：表示VirtualBox的主要接口，提供了版本信息、虚拟机管理、硬件配置等功能。
- `IMachine`：表示单个虚拟机，提供了创建、启动和配置虚拟机的功能。
- `IMedium`：表示存储介质（如硬盘、CD/DVD镜像），支持克隆、挂载和管理存储设备。

### 7. 主要API变更
文档记录了从2.0到4.3版本之间的API不兼容变更，包括：
- `IMedium::lockRead()`和`lockWrite()`方法的重新设计。
- `IAppliance::write()`参数列表的调整。
- 接口和方法的重命名（如`IMachine::delete`改为`IMachine::deleteConfig()`）。
- `IMedium::variant()`类型从`unsigned long`改为`MediumVariant`数组。

### 8. 其他注意事项
- VirtualBox SDK提供了完整的接口文档和示例代码，便于开发者快速上手。
- 文档还提到了如何配置开发环境并运行示例脚本。

总结来看，这份文档为开发者提供了全面的接口和功能说明，帮助其通过编程方式控制和管理VirtualBox虚拟机。