72. XPages的文档数据源.pdfVIP

SSttaarrrrooww的的专专栏栏 IInntteerreessttiinngg ssttuuffff aabboouutt LLoottuuss DDoommiinnoo,, XXPPaaggeess,, JJaavvaaSSccrriipptt,, WWeebb aanndd LLooggiicc 22.. XXPPaaggeess的的文文档档数数据据源源 分类： Lotus Notes杂谈 Xpages 2013-12-16 18:35 242人阅读 评论 (0) 收藏 举报 在经典的Lotus Notes应用程序开发中，表单与Notes文档密不可分，在位于表单的代码里获取当前文档几乎是后续 所有操作和运算的起点。在XPages里，页面和数据虽然在架构上是分开的，但是一个用作表单的XPage的数据源通常 还是一个Notes文档，只不过在SSJS里可以直接使用的document1等变量对应的是一个Java的 com.ibm.xsp.model.domino.wrapped.DominoDocument对象。如果只用SSJS编程，这些变量具有和LotusScript里 NotesDocument类似的方法可以读写字段。但如果要用Java开发，很多人已经习惯了使用lotus.domino包 【注1】里 的类，它们与LotusScript里的Notes类有几乎一一对应的属性和方法。那么怎样从一个设定了数据源为一个Domino 文档的XPage获取代表该文档的lotus.domino.Document类型的Java对象呢？笔者写了如下的工具方法，可以在 managedbean里调用： public static Document getCurrentDocument() throws Exception{ UIViewRootEx2 view (UIViewRootEx2) FacesContext.getCurrentInstance().getViewR for (DataSource ds : view.getData()){ if (ds instanceof DominoDocumentData){ DominoDocumentData ddd (DominoDocumentData) ds; DominoDocument dd (DominoDocument) ddd.getDataObject() return dd.getDocument(); } } throw new AppException(No document data source is found.); } UIViewRootEx2 view是代表整个XPage的视图对象，它的getData ()方法返回该页面添加的所有数据源，这些对象都 实现了com.ibm.xsp.model.DataSource接口。如果添加了一个Domino文档，就会产生一个类型为 com.ibm.xsp.model.domino.DominoDocumentData的对象，从这个数据源对象的getDataObject()方法可以返回一个 com.ibm.xsp.model.domino.wrapped.DominoDocument对象，从它的getDocument()方法才能最终得到我们想要的 lotus.domino.Document对象。如果当前XPage没有添加任何Domino文档数据源，则抛出一个自定义的异常 AppException （简单扩展Exception，统一标志自定义的异常）。 com.ibm.xsp.model.domino.wrapped.DominoDocument类 （以后简称DominoDocument）从名称就显示了它是一个包装 器 （wrapper），实际