【正文】 DFC接口手冊DFC接口手冊一．前言 Documentum Foundation Classes（DFC）是Content Application和Content Server進(jìn)行通信的主要接口。它提供了完整的訪問Documentum Object Model的基于對象的應(yīng)用程序接口。DFC能夠使程序員通過Highlevel的操作或者Lowlevel的對象方法調(diào)用來訪問內(nèi)容管理。圖1 DFC的層次結(jié)構(gòu)DFC是基于JAVA的，如果客戶端程序是由JAVA實(shí)現(xiàn)的話，就能夠直接通過接口訪問DFC。DFC還提供Documentum JavaCOM Brigde，使微軟組件對象模型（COM）能夠使用DFC的接口，這就說明其他能夠COM模型的語言都能夠運(yùn)用DFC的接口。DFC PIA還提供在dotNet環(huán)境下訪問DFC的能力。上面這一點(diǎn)講到外部應(yīng)用程序可以通過什么樣的途徑來訪問DFC。那么DFC本身是怎么訪問外部資源的呢？Java 軟件開發(fā)工具箱（Java Software Development Kit (SDK)）提供了Java 本機(jī)接口（Java Native Interface (JNI)）這么一個(gè)本機(jī)編程接口。JNI 允許 Java 代碼使用以其它語言（譬如 C 和 C++）編寫的代碼和代碼庫。因?yàn)镈FC是基于JAVA的，所有就有能力來訪問其他語言寫的代碼庫。DFC是有許多包組成的，每個(gè)包的類和接口都是具有一組特定的功能。包名 描述 包含通過OLE/COM訪問DFC的接口 包含管理SESSION和維護(hù)Documentum Repository 數(shù)據(jù)的類和接口 包含所有DFC對象都可能用到的有用的類和接口 包含通用client功能的接口，如checking in和 checking out 文檔的操作 包含在客戶端本地系統(tǒng)管理Documentum信息需要 用到的類和接口 包含查詢Documentum Repository返回XML結(jié)果 所需要用到的類和接口 通過這個(gè)手冊的描述，掌握Documentum Server 對象模型和DFC接口模型之間的關(guān)系是非常重要的。二．Clients and sessions Documentum采用的是client/server模型的架構(gòu)。DFC把所有client功能壓縮到一個(gè)叫IDfClient的接口，這個(gè)接口是所有DFC代碼的入口。從IDfClient對象可以獲得一個(gè)IDfSessionManager。 IDfSession對象是DFC的核心概念。一個(gè)DFC Session實(shí)現(xiàn)了Documentum server和它提供的服務(wù)之間的一個(gè)連接。一個(gè)session對象是一個(gè)IDfSession的實(shí)例，所有訪問repository的功能都需要一個(gè)repository session和DFC session。DFC clients可以通過session manager來得到一個(gè)session object。 Session Manager管理著一個(gè)或多個(gè)repository的session。Client應(yīng)用程序從Session manager獲得session，使用完后，把session釋放給Session manager。Session Manager也維護(hù)著一個(gè)repository session pool來提供DFC session。通常，DFC session應(yīng)該從Session manager獲得，而不是使用IDfClient對象得到。Session manager提供了很多方法，能夠讓我們處理：1． Manage Identities/access credentials2． Authenticate user access3． Acquire and release sessions4． Process Transactions5． Authenticate user access6． Obtain session statistics7． Catch checked and unchecked ExceptionsSession Manager提供repository session pool來有效的處理session。當(dāng)你釋放一個(gè)從Session Manager獲得的session時(shí)，Session Manager并不馬上切斷這個(gè)session的連接。如果你在Session Manager切斷剛才釋放的session連接前，再次申請一個(gè)針對同一個(gè)repository的session的話，Session Manager會(huì)把原來的返回給你。如果Session Manager已經(jīng)切斷了你所釋放的session連接，或者你明確要申請一個(gè)新session，或者你申請一個(gè)不同repository的session，那么Session Manager就提供一個(gè)新的session給你。 Session能夠支持Transaction來處理多個(gè)repository的相互作用。這里需要說明的是，Session管理Transactions不使用兩階段提交算法（twophase mit algorithm）。舉個(gè)例子，如果一個(gè)多repository 的Transaction，如果其中的一個(gè)repository已經(jīng)mit了transaction，那么這個(gè)事務(wù)操作就會(huì)失敗。還有Session Transaction和Session Manager Transaction是不同的。IDfSession接口通過beginTran來啟動(dòng)事務(wù)，IDfSessionManager接口通過beginTransaction方法來啟動(dòng)事務(wù)，但是beginTransaction方法啟動(dòng)的是一個(gè)受管制的事務(wù)，只有在beginTransaction方法調(diào)用之后獲得的session才能參與Transaction，否則就不行。 每一個(gè)DFC Client應(yīng)用的功能，和復(fù)雜度是隨著業(yè)務(wù)需求而變化的。但是DFC Client處理session的典型過程是固定的：1． 獲得一個(gè)DFC Client對象2． 取得一個(gè)Session Manager的實(shí)例3． 通過Session Manager注冊一個(gè)訪問repository的用戶帳號4． 取得操作repository的一個(gè)DFC session5． 對repository執(zhí)行業(yè)務(wù)功能6． 釋放session回Session Manager7． 銷毀Session Manager在WDK應(yīng)用中，()方法來得到一個(gè)Session Manager實(shí)例，但是如果我們在WDK應(yīng)用中需要得到一個(gè)IDfSession來處理業(yè)務(wù)，那么我們應(yīng)該使用WDK提供的ponent類的getDfSession方法，而不是從Session Manager里獲得。原因是我們不應(yīng)該讓SysObject存在于多個(gè)request/response周期，而從Component里得到的session所獲得的對象的生存周期只有一個(gè)request/response周期。接口IDfClientX 語法public interface 描述IDfClientX接口提供了一組工廠方法，這些方法列舉了其他對象，例如IDfClient，它使JAVA與COM程序通信成為了可能。我們可以通過new DfClientX()來創(chuàng)建一個(gè)IDfClientX對象。主要成員變量主要成員方法getLocalClient ()目的 IDfClient對象的工廠方法語法 public IDfClient getLocalClient() throws DfException描述 Server進(jìn)行通信。在程序中可以多次使用這個(gè)方法。參數(shù)返回 IDfClient對象示例 下面的示例為實(shí)例化一個(gè)IDfClient對象 IDfClientX clientx = new DfClientX()。 IDfClient client = ()。getQuery ()目的 IDfQuery對象的工廠方法語法 public IDfQuery getQuery()描述 構(gòu)造了一個(gè)IDfQuery對象來進(jìn)行對Documentum Server的DQL查詢。參數(shù)返回 IDfQuery對象示例 下面的示例為通過IDfQuery執(zhí)行DQL查詢 IDfCollection col = null。 //Collection for the result IDfClientX clientx = new DfClientX()。 IDfQuery q = ()。 //Create query object (queryString)。 //Give it the query col = (session, )。getLoginInfo ()目的 IDfLoginInfo對象的工廠方法語法 public IDfLoginInfo getLoginInfo()描述 構(gòu)造了一個(gè)IDfLoginInfo空對象，設(shè)置登錄到Documentum Server的連接信息。參數(shù)返回 IDfLoginInfo對象示例 參考接口IDfClient 的getLocalClient方法接口IDfClient 語法public interface 描述IDfClient接口提供session管理功能設(shè)定Principal Support mode，如果需要single login的話。查詢connection broker獲得DBOR管理對象主要成員變量主要成員方法newSessionManager()目的 IDfSessionManager對象的工廠方法語法 public IDfSessionManager newSessionManager ()描述 返回一個(gè)IDfSessionManager對象。參數(shù)返回 IDfSessionManager對象示例 下面的示例為獲得一個(gè)IDfSessionManager對象 IDfSessionManager createSessionManager(String repository, String user, String password) throws Exception { IDfClientX clientx = new DfClientX()。 IDfClient client = ()。 //IDfTypedObject config = ()。 // (primary_host, )。 IDfSessionManager sMgr = ()。 IDfLoginInfo loginInfo = ()。 (user)。 (password)。 (repository, loginInfo)。 return sMgr。 }getDocbaseMap()目的 從connection broker里獲得repository信息語法 public IDfDocbaseMap getDocbaseMap() throws DfException描述 這個(gè)方法返回一個(gè)擁有the repository IDs, repository names, and verbose repository descriptions的IDfDocbaseMap對象。參數(shù)返回 IDfDocbaseMap對象示例 下面的示例為獲得一個(gè)repository map void obtainDocbaseMap() throws Exception { IDfClientX clientx = new DfClientX()。 IDfClient client = ()。 IDfDocbaseMap myMap = ()。 (Repositories for connection broker: + ())。 (Total number of Repositories: + ())。 for(int i = 0。 i ()。 i++) { (Repository + (i + 1) + : + (i))。 }}getClientConfig()目的 返回DMCL library的信息語法 public IDfTypedObject getClientConfig() throws DfException描述 client配置信息存儲(chǔ)在DMCL API Config object里面，通過調(diào)用這個(gè)