使用 XPages Extensibility API 创建和部署自定义控件.docVIP

使用 XPages Extensibility API 创建和部署自定义控件 林 云志, 高级软件工程师, IBM 林云志，目前从事 Lotus Expeditor 的开发工作，对 Eclipse 插件开发和 XPages 开发有丰富的经验。 简介：?XPages 是目前 Notes/Domino 开发中非常热门的一项技术，也是 Notes/Domino 未来技术发展的重要方向。Extensibility API 则是 XPages 新提供的一项强大功能。通过使用 Extensibility API，开发人员可以对 XPages 进行扩展。本文就将向您介绍如何使用这套 API 进行开发。 标记本文！ 发布日期：?2011 年 11 月 17 日 级别：?初级 访问情况 ：?758 次浏览 评论：?0?(查看?|?添加评论 - 登录) 平均分 (0个评分)为本文评分 XPages Extensibility API 简介 XPages Extensibility API 是 Notes/Domino 8.5.2 的一个新功能。它是一套 Java 的 API。通过使用这一套 API，开发人员可以访问 XPages 运行时的信息，并且可以对 XPages 的组件库进行扩展，创建自定义的组件。自定义的组件可以被打包成扩展组件库 (Extension Library)，集中部署到 Notes 客户端或者 Domino 服务器上。Extensibility API 是 XPages 开发的一个进阶知识，在开始使用 Extensibility API 之前，希望您对 XPages 的基本开发已经有一定的了解。 我们知道，XPages 是基于 JSF 框架的。对 JSF 有一定了解的开发人员，可以很容易的从 XPages 的开发中看到很多 JSF 的概念，如 Converter, Validator, Managed bean 等等。JSF 的相关概念在 XPages 中基本都是适用的， 开发人员也可以在 XPages 的开发中，使用 JSF 的 API。另一方面，JSF 是一个开放的框架，它允许开发人员开发自定义的扩展。这里说的扩展不仅局限于 UI 控件，也包括非 UI 控件，如 Converter 等。 在 Notes/Domino 8.5.2 之前， 这部分扩展 API 并没有公开给第三方的开发人员使用。为了满足 XPages 开发中的高级需求，8.5.2 发布了 Extensibility API，同时 Domino Designer 对 Extensibility API 的开发也提供了良好的支持。IBM 还基于 Extensibility API, 创建了一个 XPages Extension Library。Extension Library 提供了很多有用的 UI 控件，如对话框，菜单，工具条，还提供了 REST 服务相关的功能。我们可以从 OpenNTF 站点上下载 Extension Library，它的源代码也可以通过 OpenNTF 获得。在使用 Extensibility API 进行开发的时候，Extension Library 的源代码是一个非常好的参考。目前，我们可以自定义的组件包括： UI 控件 Converter Validator 数据源 Language binding Simple Actions 大家可能会问，XPages 已经提供了 Custom Control 的方式定义自定义组件，为什么还要提供 Extensibility API ？这两种方式又有什么区别？就我的理解，它们的区别在于： Custom Control 主要是通过组合已有控件的方式进行扩展，大多数情况下，它主要是用来定义 UI 控件。而 Extensibility API 不仅仅可以扩展 UI 控件，还可以扩展非 UI 控件。此外，Extensibility API 不局限于对已有的控件进行组合，开发人员可以定义全新的控件。 Extensibility API 提供了丰富的 API 让开发人员可以访问 XPages 运行时的信息，在 Extensibility API 发布之前，Custom Control 中能访问的信息相对较少。。 Custom Control 的门槛较低，比较容易上手和使用。而 Extensibility API 较为复杂，需要对 XPages 有更深入的了解。如果在使用 Custom Control 就可以满足使用需求的情况下，没有必要一定要使用 Extensibility API。 在组件重用方面，Custom Control 的代码是包括在 nsf 中的，重用的时候需要在 nsf 中进行拷贝；