编写规范

OpenOffice.org 开发者指南

编写 UNO 组件

< 上一章

下一章 >

• 所需的文件
• 使用 UNOIDL 指定新组件

• 编写规范

• 预处理
• 将定义分组为模块
• 简单类型
• 定义接口
• 定义服务
• 定义序列
• 定义结构
• 定义异常
• 预设的值
• 使用注释
• 单一元素
• 预留的类型
• 已发布的实体

• 从 UNOIDL 定义生成源代码

• 组件的体系结构
• 可实现的核心接口

• XInterface
• XTypeProvider
• XServiceInfo
• XWeak
• XComponent
• XInitialization
• XMain
• XAggregation
• XUnoTunnel

• Java 中的简单组件

• 使用 Helper 类定义类
• 实现您自己的接口
• 使用 Helper 的方法提供单个工厂
• 使用 Helper 的方法编写注册信息
• 不使用 Helper 的方法实现
• 存储服务管理器已备后用
• 使用参数创建实例
• Java 组件的可能结构
• 运行和调试 Java 组件

• 注册组件文件
• 使注册对 OpenOffice.org 可用
• 测试注册
• 调试
• OpenOffice.org 中的 Java 环境
• 故障排除

• C++ 组件

• 使用 Helper 模板类定义类
• 实现您自己的接口
• 使用 Helper 的方法提供单个工厂
• 使用 Helper 的方法编写注册信息
• 提供实现环境
• 不使用 Helper 的方法实现
• 存储服务管理器已备后用
• 使用参数创建实例
• 一个动态链接库中的多个组件
• 建立并测试 C++ 组件

• 将组件集成到 OpenOffice.org

• 协议处理器

• 实现
• 配置
• 安装

• 作业

• 执行环境
• 实现
• 初始化
• 返回结果
• 配置
• 安装
• 使用 vnd.sun.star.jobs: URL 模式
• 支持的事件的列表

• 加载项

• 指导原则
• 配置

• 菜单
• 工具栏
• 用于工具栏和菜单的图像
• 帮助集成

• 安装

• 禁用命令
• 截取上下文菜单

• 文件命名约定
• 组件的部署选项

• 命令行注册表工具
• 手动安装组件
• 引导服务管理器
• 特殊服务管理器配置

• UNO 可执行文件

• 独立使用实例
• 服务器使用实例
• 使用 UNO 可执行文件

• 调用对话框

• 为组件方法指派控件事件
• 在组件中使用对话框

< 上一页

下一页 >

UNOIDL 与 C++、CORBA IDL 之间存在相似之处，特别是在语法和编译程序的常规使用方面。如果您熟悉 C++ 或 CORBA IDL，就能理解 UNOIDL 的大部分内容。

第一个示例是 com.sun.star.bridge.XUnoUrlResolver 接口的 IDL 规范。idl 文件通常以一些预处理程序指令开头，其后是模块说明和类型定义：

  #ifndef __com_sun_star_bridge_XUnoUrlResolver_idl__ 
  #define __com_sun_star_bridge_XUnoUrlResolver_idl__ 
 
  #include <com/sun/star/uno/XInterface.idl> 
  #include <com/sun/star/lang/IllegalArgumentException.idl> 
  #include <com/sun/star/connection/ConnectionSetupException.idl> 
  #include <com/sun/star/connection/NoConnectException.idl> 
 
 
  module com { module sun { module star { module bridge {
 
 
  /** service <type scope="com::sun::star::bridge">UnoUrlResolver</type> 
          implements this interface.
   */
  published interface XUnoUrlResolver: com::sun::star::uno::XInterface
  { 
      // method com::sun::star::bridge::XUnoUrlResolver::resolve
      /** resolves an object, on the UNO URL.
       */
      com::sun::star::uno::XInterface resolve( [in] string sUnoUrl ) 
          raises (com::sun::star::connection::NoConnectException, 
                  com::sun::star::connection::ConnectionSetupException, 
                  com::sun::star::lang::IllegalArgumentException); 
  }; 
 
  }; }; }; };
 
  #endif

下面我们将分步讨论这个idl 文件，并尽快写出我们自己的 UNOIDL 规范。指定 com.sun.star.bridge.XUnoUrlResolver 的文件位于您安装的 SDK 的 idl 文件夹中，即 <SDK>/idl/com/sun/star/bridge/XUnoUrlResolver.idl。

按照惯例，UNOIDL 定义文件名称的扩展名是 .idl。说明必须使用不包含特殊字符的 US ASCII 字符集，不能使用空白（即空格、制表符或换行）来分隔符号。

Content on this page is licensed under the Public Documentation License (PDL).