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

使用XPagesExtensibilityAPI创建和部署自定义控件
HYPERLINK"http://www.ibm.com/developerworks/cn/lotus/ls-cn-domino-xpageapi/index.html?ca=drs-"\l"author1#author1"\o""林云志,高级软件工程师,IBM
林云志，目前从事LotusExpeditor的开发工作，对Eclipse插件开发和XPages开发有丰富的经验。
简介：XPages是目前Notes/Domino开发中非常热门的一项技术，也是Notes/Domino未来技术发展的重要方向。ExtensibilityAPI则是XPages新提供的一项强大功能。通过使用ExtensibilityAPI，开发人员可以对XPages进行扩展。本文就将向您介绍如何使用这套API进行开发。
HYPERLINK"http://www.ibm.com/developerworks/cn/lotus/ls-cn-domino-xpageapi/index.html?ca=drs-"\l"#"标记本文！
发布日期：2011年11月17日级别：初级访问情况：758次浏览评论：0(HYPERLINK"http://www.ibm.com/developerworks/cn/lotus/ls-cn-domino-xpageapi/index.html?ca=drs-"\l"icomments#icomments"查看|HYPERLINK"http://www.ibm.com/developerworks/cn/lotus/ls-cn-domino-xpageapi/index.html?ca=drs-"\l"#"添加评论-登录)
平均分(0个评分)HYPERLINK"http://www.ibm.com/developerworks/cn/lotus/ls-cn-domino-xpageapi/index.html?ca=drs-"\l"iratings#iratings"为本文评分

XPagesExtensibilityAPI简介
XPagesExtensibilityAPI是Notes/Domino8.5.2的一个新功能。它是一套Java的API。通过使用这一套API，开发人员可以访问XPages运行时的信息，并且可以对XPages的组件库进行扩展，创建自定义的组件。自定义的组件可以被打包成扩展组件库(ExtensionLibrary)，集中部署到Notes客户端或者Domino服务器上。ExtensibilityAPI是XPages开发的一个进阶知识，在开始使用ExtensibilityAPI之前，希望您对XPages的基本开发已经有一定的了解。
我们知道，XPages是基于JSF框架的。对JSF有一定了解的开发人员，可以很容易的从XPages的开发中看到很多JSF的概念，如Converter,Validator,Managedbean等等。JSF的相关概念在XPages中基本都是适用的，开发人员也可以在XPages的开发中，使用JSF的API。另一方面，JSF是一个开放的框架，它允许开发人员开发自定义的扩展。这里说的扩展不仅局限于UI控件，也包括非UI控件，如Converter等。在Notes/Domino8.5.2之前，这部分扩展API并没有公开给第三方的开发人员使用。为了满足XPages开发中的高级需求，8.5.2发布了ExtensibilityAPI，同时DominoDesigner对ExtensibilityAPI的开发也提供了良好的支持。IBM还基于ExtensibilityAPI,创建了一个XPagesExtensionLibrary。ExtensionLibrary提供了很多有用的UI控件，如对话框，菜单，工具条，还提供了REST服务相关的功能。我们可以从OpenNTF站点上下载ExtensionLibrary，它的源代码也可以通过OpenNTF获得。在使用ExtensibilityAPI进行开发的时候，ExtensionLibrary的源代码是一个非常好的参考。目前，我们可以自定义的组件包括：
UI控件
Converter
Validator
数据源
Languagebinding
SimpleActions
大家可能会问，XPages已经提供了CustomControl的方式定义自定义组件，为什么还要提供ExtensibilityAPI？这两种方式又有什么区别？就我的理解，它们的区别在于：
CustomControl主要是通过组合已有控件的方式进行扩展，大多数情况下，它主要是用来定义UI控件。而Exte