Oracle VM VirtualBox 3.2.10 Programming Guide and Reference

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

摘要

The document provides a comprehensive guide to programming with Oracle VM VirtualBox 3.2.10. It details the Main API, which exposes the full feature set of the virtualization engine, allowing users to create, configure, and manage virtual machines. The guide also covers the COM/XPCOM API for Python, C++, and other languages, as well as the WebService API for Java, Python, and PHP. The document includes sections on raw web service usage, Main API documentation, and version compatibility changes. It emphasizes the importance of maintaining API compatibility within major releases and provides details on API changes between versions.

AI总结

《Oracle VM VirtualBox 3.2.10 编程指南和参考》主要介绍了 VirtualBox 的编程接口和相关文档，内容涵盖以下核心要点：

1. **VirtualBox 的模块化结构**
VirtualBox 分为多个层次，包括内核模式代码、用户空间代码、虚拟化核心（hypervisor）以及 API 层（Main API）。Main API 提供了对 VirtualBox 功能的全面控制，包括创建、配置、启动、停止虚拟机，获取性能统计信息，以及管理整体设置。

2. **面向对象的网络服务（OOWS）**
- **Java 实现**：通过 JAX-WS 提供 OOWS，支持通过样例代码快速上手，包括登录、获取机器信息、修改设置、启动虚拟机等操作。
- **Python 和 PHP 实现**：提供了针对这两种语言的 OOWS 接口，方便开发者使用。

3. **使用原始网络服务**
- 支持通过 Axis 和 Perl 等语言直接调用原始网络服务。
- 强调了编程时需要注意的事项，包括基本约定、对象引用管理以及WebService的操作细节。

4. **Main API 文档的使用**
通过详细的接口文档，开发者可以编写与 VirtualBox 的WebService交互的客户端程序。

5. **COM/XPCOM API**
- 提供了针对 Python、C++、Visual Basic 等语言的 COM/XPCOM 接口。
- 重点介绍了 XPCOM 的初始化、方法调用、属性访问、字符串处理和卸载流程。

6. **虚拟机壳（VirtualBox Shell）**
提供了一个交互式环境，允许开发者通过命令行或脚本形式与 VirtualBox 交互，支持动态加载扩展功能。

7. **API 变更日志**
- VirtualBox 在主版本（x.y.z 中的 x 或 y）升级时可能会导致 API 不兼容。
- 详细记录了从 2.0 到 3.2 版本之间的接口变更，包括接口重命名、新功能添加以及可能影响现有代码的更改。例如：
- IMachine 接口中的方法和枚举类型名称更改（如 getCpuProperty 改为 getCPUProperty）。
- 新增了忽略现有配置文件的功能。
- 扩展了对多显示器的支持，增加了 screenId 参数。

8. **许可证信息**
文档末尾提供了 VirtualBox 的许可证信息，明确了软件的使用条款。

9. **接口详细描述**
文档列出了多个接口（如 IAppliance、IAudioAdapter、IBIOSSettings、IConsole 等）及其属性和方法，便于开发者直接调用。

总结来看，该文档为开发者提供了全面的 VirtualBox 编程接口和使用指南，涵盖了WebService、COM/XPCOM 等多种编程方式，并详细记录了 API 的变更历史，帮助开发者更好地理解和迁移代码。