Ness被Documentum选中来开发这个新特性，是因为Ness具备利用新兴技术的能力，同时Ness与Documentum和BEA的开发团队都有很密切的合作关系。Ness建立了完整的软件包，包括控件、向导、示例和集成的帮助。

　　本文是介绍DBOC及其使用的系列文章的第一篇。在这里，我们要介绍有关环境，概述DBOC的功能。在后面的文章里，我们会介绍底层技术以及如何使用控件提供安全方法。

　　Documentum业务对象
　　Documentum 5使开发人员可以利用一个强大的新框架将业务逻辑封装在多个独立的组件里。BOF里包含业务逻辑，业务逻辑是可以重用的功能单元，开发人员可以把业务逻辑和Docbase类型或独立的服务关联起来。

　　BOF位于Documentum基本类库(DFC) 之中，它提供了开发可插入控件的功能，每个组件实现了一个或多个中间层业务规则。由于框架是核心DFC层的一部分，所以用户界面方面的行为是一致的；业务逻辑层与表示层相互分离。

　　业务对象框架支持两类业务对象：
　　基于服务的对象(SBO)

　　基于类型的对象(TBO)

　　但是，DBOC集成只把SBO明确地公开给WebLogic Workshop环境。

　　背后的原因是，SBO公开了对所有对象类型（例如工作流、收件箱）都可用的功能，而TBO只实现了针对特定对象类型的分散的功能片断。

　　此外，SBO也接受利用任何TBO实现的自定义行为，所以，对于使用WebLogic Workshop的应用程序开发人员来说，没有必要了解使用TBO进行自定义的相关知识。

　　将Documentum的SBO作为基于BEA平台的内容管理应用程序的构建模块，可以使您利用预定义的服务或定制开发的服务。利用现有的SBO开发应用程序，可以在Documentum/BEA环境中实现快速的应用程序开发。最后，这一集成还能够迅速识别任何定制开发SBO，并把它们作为控件插入，供所有开发人员使用。

　　虽然随Documentum 5安装直接提供的SBO数量有限，但是可用的SBO清单不断增长，这些SBO可以从Documentum 开发人员项目的组件交换中心 (http://developer.documentum.com)得到，也可以自行设计。

　　对于任何需要与Documentum资源交互的应用程序来说，SBO会成为程序的重要部分。BOF是Documentum中的策略架构。

　　DBOC只是Documentum/BEA的多项集成目标中的一个。例如，Documentum还有供WebLogic Portal使用的portlet和内容管理器服务提供者接口 (CMSPI)。

　　WLW环境
　　Weblogic Workshop是一个J2EE的集成开发环境（IDE），它为不同的应用程序组件提供了单一的IDE视图，从而简化了开发任务。

　　开发人员可以在一个地方建立Java代码、JSP、门户、集成过程、Web服务以及其他项目。

　　底层框架提供了大量详细的J2EE管道，但它把声明性接口提供给开发人员，从而极大地降低了需要编写的代码量。这样，开发Web服务这样的项目，就变得非常容易，否则开发这些项目会很耗时，对技术也有很强的要求。WebLogic Workshop使您可以专注于应用程序和客户的需求，而由WLW平台来完成复杂的应用程序所必需的多数繁杂的基本工作。

　有关WebLogic Workshop的更多信息，请参阅：http://dev2dev.bea.com/products/wlworkshop81/index.jsp

　　如果以前还没试用过WLW，可以从http://www.bea.com这个站点下载完整的包括免费许可的WebLogic Platform 8.1.2。

　　Java 控件
　　WebLogic Workshop引入了Java控件，把它作为一种封装业务逻辑、方便地访问企业资源的方法。可以把控件拖到IDE的设计界面上，并与控件“对话”，实际控件再与后端资源对话。

　　WebLogic Workshop提供了连接数据库、EJB、消息队列等的内置平台（Platform）控件。门户(Portal)控件则用来在多页portlet中对外公开跟踪和个性化功能。

　　应用程序开发人员可以建立自定义控件，来表示特定于应用程序的逻辑，并为开发团队提供一套一致的工具。

　　什么是DBOC？
　　DBOC是自定义控件的实例。DBOC使得访问Documentum SBO更加容易，并减少了需要编写的代码量。没有必要声明（或者根本不需要了解或考虑）home 和remote接口，只需要在向导中回答一些问题，就万事俱备了。

　　DBOC是SBO之外的包装器。控件也扩展了SBO，以便加入所有SBO都需要的额外实用工具工具特性。

　　开发人员可以从Documentum 业务对象注册表（DBOR）中列出的SBO中选择一个，并把它和自己项目中的成员变量绑定。WebLogic Workshop把SBO提供的所有方法都公开出来，还有处理DFC会话所增加的实用工具方法。开发人员的代码只与代表SBO的控件变量交互。

　　因为DBOC是一个可编程构造，所以它没有自己的用户界面。DBOC是一个到SBO的连接，可以用JSP和其他可视组件来将通过控件得到的数据公开出来。

　　开始
　　开始使用DBOC的最容易方法是用WebLogic Workshop建立一个新应用程序和Web服务。如果您是初次使用 WebLogic Workshop，请按以下步骤进行：
　　从BEA的Web站点下载WebLogic Platform
　　安装到您的计算机
　　建立新应用程序：
　　File | New | Application
　　给应用程序命名（例如DemoApp），检查路径是否正确，单击Create，新应用程序就会在IDE中打开。
　　会自动创建一个DemoAppWeb项目。在应用程序树选择中，在项目上单击右键
　　New | Web Service
　　给Web服务命名（例如DemoWS.jws）然后单击Create

　　现在的屏幕看起来应当像这样：

　　在IDE中有了服务之后，在Web服务的中心单击右键，然后选择Add Control。如果以前没有用过控件，控件会自动下载并安装到应用程序。帮助文件和示例应用程序也会被安装到Workshop文件夹。

　　如果恰好是DBOC第一次被调用，那么就会有一个“先有蛋还是先有鸡”的问题。在某个服务器启动参数和WLW属性设置完成之前，DBOC不能工作，所以还不能连接到SBO。控件向导会检查这种情况，并给出有关配置不完整的信息。

　　这时，您应当打开WebLogic Workshop的帮助屏幕，并切换到Extensions主题，然后依次进入Documentum业务对象控件子主题。在这里，您可以找到与配置环境有关的说明，包括在服务器的类路径（Classpath）中加入DFC的位置等。而且还要记住，如果您已经提供了自己的自定义SBO（除了Documentum已经提供的那些之外），那么还必须把它们也加入到类路径（Classpath）。

　　当配置完成并重启服务器之后，就可以开始在新的Web服务中使用控件了。

　　不过，现在应当是查看示例应用程序的好时候，以便学习如何用控件来访问收件箱SBO。为了达到这个目的，应当关闭当前应用程序，并选择 File | Open ，装入DBOC示例应用文件，它通常位于：
BEA_HOME\weblogic81\samples\partners\Documentum\DBOSampleApp\BEADocumentumControlSamplesApp.work

　　使用DBOC
　　在加入DBOC时，插入控件向导会出现，搜集有关SBO和用户凭证的信息。这个窗口让您将这个控件实例化到具体的SBO，并给它命名。

　　这里有重要的一点需要牢记，就是必须为应用程序里将使用的每个SBO都执行这个控件入和绑定过程。在这一点上，它与EJB控件很像，使用EJB控件时，也需要为每个将在应用程序中引用的独立EJB执行插入和绑定。

　　下图显示了用插入控件向导定义访问Documentum Innbox SBO的示例程序。

　　步骤如下：
　　建立一个名为inbox的控件变量。

　　为控件建立新的控件JCX文件，在这个例子里名为inbox.jcx。

　　从可用的Documentum SBO列表中选择Inbox这个SBO。

　　为连接分配安全类型和安全凭证。

　　 注意：我们现在让控件为我们在运行时生成SessionManager对象，所有的SBO访问都要求有一个SessionManager (根据DFC文档中的描述)，所以DBOC为您提供了这项功能。使用其他的SessionManager选项（例如，Principal Identity支持），将在本系列后面的文章介绍。

　　在成功地完成了向导之后，就会发现，控件已经被插入项目，而且在应用程序视图里应当可以看到以下项目（下图显示了插入样本应用程序的一个控件）：

　　在向导中输入的控件属性，现在可以在属性编辑器中处理，可以进行必要的修改。

　　最后，控件被加入项目的设计视图，还可以看到SBO所有可用的方法。可以使用的DBOC助手方法被显示出来，有助于更方便地使用SBO。有关这方面的更详细信息，请参阅帮助系统中标题为“DBOC实用工具方法文档”的一节。

　　自动构建了Java控件文件 (.jcx)，并自动加入当前项目（在这个例子里，示例web 服务包含在控件的安装里）。通过为Documentum的SessionManager对象增加实用工具方法，控件扩展了选中的SBO的功能，从而简化 (或者消除)了连接业务对象框架所必需的代码。

　　示例应用程序
　　在控件首次安装时，会自动在WebLogic Workshop环境中安装并集成到一个演示在Web服务和Java页面流中使用DBOC的示例应用程序。

　　在DBOC帮助文档中，包含了详细步骤的指示，有助于了解示例。

　　下面的图片显示了我们使用的二个示例。我们会在后面的文章里更详细地介绍示例和底层代码。

　　这两个示例都处理Documentum InboxSBO，因为Inbox这个SBO安装，具备 Documentum 5所有的配置，所以比较全面。

　　Web服务示例
　　Web服务示例计算Documentum User Inbox的数量。WLW提供了一个测试浏览器，可以用向导中指定的属性调用这个Web服务。

　　DBOC建立SessionManager，并连接到inbox SBO。只有少量示例代码在Inbox项目中循环，进行计数(在这个例子里，有3个项目)。Web服务会把整个调用堆栈返回到测试浏览器，服务的响应中包含计数值（在下一张图的最后一行中）：

　　页面流示例
　　Web服务没有用户界面，它们通常被用来进行流程到流程的通信。

　　Java页面流示例显示用户收件箱的内容，并演示了多个Documentum安全选项。

　　用户输入凭证，并选择安全方法，在这个例子里，使用的是Registered Identity。

　　按下提交按钮，就会在结果屏幕中显示Inbox的每项内容：

　　下一步做什么？
　　DBOC允许您方便地把Documentum SBO集成到WebLogic Workshop环境。学习这个集成，只需下载并安装WebLogic Platform，插入DBOC，修改一些WebLogic服务器的配置，并按照示例教程的指导即可。

　　这份文档，是对最新的Documentum Business Objects Control for BEA WebLogic Workshop的介绍。后续的文章，将深入各个示例，更深入地讨论业务对象框架，学习DBOC提供的各种不同安全选项。

　　作者注：特别感谢Documentum的Kevin O'Connor，感谢他创建DBOC项目，支持Java控件工作，以及对本系列文章所做的贡献。

　　如果对本文有疑问，，请联系作者： Alan Zenreich ，电话：201-488-7222 转160.

　　欢迎继续阅读本系列的 第2部分 第3部分

　　原文出处：http://dev2dev.bea.com/products/wlworkshop81/articles/DCMT1.jsp