【正文】 = ()。 (primary_host, )。參數(shù) docbase Repository名 identity 已經(jīng)設(shè)置了用戶證明的IDfLoginInfo對(duì)象返回示例 參考接口IDfClient 的getLocalClient方法getSession(String docbase)目的 獲得一個(gè)IDfSession對(duì)象語法 public IDfSession getSession(String docbase) throws DfIdentityException,DfAuthenticationException, DfPrincipalException, DfServiceException描述 取得處理具體應(yīng)用所需要的session信息，通過該方法可以多次恢復(fù)session。 if (s != null) { // Use the session to get the ID of an // object meeting the qualification return (qual)。 } }release(IDfSession session)目的 把session對(duì)象釋放掉語法 public void release(IDfSession session)描述 釋放session對(duì)象，如果你不再使用一個(gè)session對(duì)象的時(shí)候，應(yīng)盡快調(diào)用這個(gè)方法把它釋放掉。主要成員變量主要成員方法getObject(IDfId objectId)目的 返回一個(gè)Repository對(duì)象語法 public IDfPersistentObject getObject(IDfId objectId) throws DfException描述 通過對(duì)象ID來得到一個(gè)持久化對(duì)象。 IDfSysObject sysObj = (IDfSysObject) (myId)。 disconnect()目的 切斷一個(gè)DFC session連接語法 public void disconnect() throws DfException描述 切斷一個(gè)DFC session連接，如果結(jié)下來仍在使用這個(gè)session。 IDfClient client = ()。 (user)。 (null)。 //access the Docbase here //disconnect from the session ()。參數(shù) additionalAttributes 添加你想得到的其他dm_process對(duì)象的屬性返回 repository里所有已安裝的dm_process對(duì)象的object_name，r_object_id和用戶指定的屬性集合示例 下面的示例為打印指定repository的所有已安裝的workflow IDfCollection Workflows = ()。 e = ()。 ( () + = )。 if ( () ) AttrCount = ( () )。 for (int i=0。 i++) { // Get the next value! IDfValue NextAttrValue = ( (), i )。 ( , )。參數(shù) processed 你想追加到workflow builder對(duì)象上去的dm_process 對(duì)象ID返回 IDfWorkflowBuilder接口示例 參考IDfWorkflowBuilder接口的initWorkflow方法示例三．Type Related Interface 這一部分介紹的接口是類型相關(guān)的，這一部分接口是可以被繼承的，下圖描述了所有類型相關(guān)的接口的繼承關(guān)系。這里最重要的一個(gè)類型相關(guān)接口是IDfSysObject，它提供很多功能相關(guān)的方法。 在上面這個(gè)圖中。如果要執(zhí)行一個(gè)Workflow，還需要其他的接口，下面描述一下完整的執(zhí)行一個(gè)工作流模版的過程。主要成員變量主要成員方法getObjectId()目的 返回對(duì)象的object ID語法 public IDfId getObjectId() throws DfException描述 取得對(duì)象的object ID。主要成員變量主要成員方法destroy()目的 從Repository移除對(duì)象語法 public void destroy() throws DfException描述 使用該方法可以從Repository移除對(duì)象，但是該方法不能銷毀多版本的對(duì)象。 IDfPersistentObject perObj = (myId)。fetch()目的 從Repository取得一個(gè)對(duì)象，且不鎖定該對(duì)象語法 public boolean fetch(String internalType) throws DfException描述 使用該方法可以從Repository取得一個(gè)當(dāng)前版本的對(duì)象，你必須擁有browse permission來調(diào)用它，并且無法使用checkin方法更新源對(duì)象。該方法一般使用在創(chuàng)建一個(gè)新的對(duì)象。參數(shù)返回示例 下面的示例為在Repository創(chuàng)建一個(gè)對(duì)象IDfFolder folder = (IDfFolder) (dm_folder)。 (/Temp)。接口IDfSysObject 語法public abstract interface extends 描述IDfSysObject接口提供了與Repository里的dm_sysobject對(duì)象進(jìn)行交互所必需的功能，它擴(kuò)展了IDfPersistentObject對(duì)象。主要成員變量主要成員方法getObjectName()目的 返回對(duì)象的object_name屬性語法 public String getObjectName() throws DfException描述 返回對(duì)象的object_name屬性。參數(shù) internalType對(duì)象的object type，例如如果fetch的是document對(duì)象，輸入dm_document，這是一個(gè)可選參數(shù)，不使用就輸入null返回 true，如果在Server找到一個(gè)新版本的對(duì)象 false，如果在Serve沒有找到一個(gè)新版本的對(duì)象示例getContent()目的 取得一個(gè)對(duì)象的內(nèi)容語法 public ByteArrayInputStream getContent() throws DfException描述 從Content Server復(fù)制一個(gè)對(duì)象到ByteArrayInputStream對(duì)象。 IDfSysObject sysObj = (IDfSysObject)(myId)。 if (() 0) { String strTemp = (bais)。參數(shù)返回 返回一個(gè)對(duì)象的內(nèi)容文件格式示例 下面的示例為復(fù)制了一個(gè)rendition IDfId myId = (09...1)。 IDfFormat myFormat = (())。 String filePath = c:/temp/ + () + . + ext。setContentType(String contentType)目的 設(shè)置一個(gè)對(duì)象的內(nèi)容文件格式語法 public void setContentType(String contentType) throws DfException描述 設(shè)置一個(gè)對(duì)象的內(nèi)容文件格式，這個(gè)對(duì)象必須是Documentum Server能夠識(shí)別的。 (FILE_NAME)。// add content to this dm_document (c:/)。link(String folderSpec)目的 關(guān)聯(lián)對(duì)象到folder或者cabinet語法 public void link(String folderSpec) throws DfException描述 這個(gè)關(guān)聯(lián)操作只有在執(zhí)行save和checkin操作后才生效。 IDfSysObject sysObj = (IDfSysObject)(myId)。 (/DFCTargetCab)。unlink(String folderSpec)目的 移除對(duì)象到folder或者cabinet的關(guān)聯(lián)語法 public void unlink(String folderSpec) throws DfException描述 這個(gè)移除關(guān)聯(lián)操作只有在執(zhí)行save和checkin操作后才生效。參數(shù) fRetainLock True，給新創(chuàng)建的版本加鎖 False，不給新創(chuàng)建的版本加鎖 versionLabels給新版本創(chuàng)建一個(gè)新的字符標(biāo)簽，可以是一個(gè)或多個(gè)，如果不指定，則系統(tǒng)會(huì)默認(rèn)賦CURRENT給它返回 返回對(duì)象新版本的一個(gè)IDfId對(duì)象示例 下面的示例為checkin指定的對(duì)象 IDfId myId = (09...1)。 if (!()) { ()。 (APPROVED)。checkout()目的 給一個(gè)對(duì)象加鎖語法 public void checkout() throws DfException描述 執(zhí)行這個(gè)動(dòng)作的過程，實(shí)際上是對(duì)checkout的對(duì)象的r_lock_machine屬性進(jìn)行設(shè)值得過程。 if (!()) { ()。 }其它有用的操作如果想得到一個(gè)類型的所有子類，可以執(zhí)行下面的代碼 StringBuilder bldr = new StringBuilder(24)。)。 (39。 String strQuery = ()。 query = ()。 collection = (session, )。 }如果想得到所有Documentum Server支持的內(nèi)容對(duì)象類型，可以執(zhí)行下面的代碼 IDfClientX clientx = new DfClientX()。 String dql = select name from dm_format。 IDfCollection collection = (session, )。 } } finally { if (collection != null) { ()。接口IDfWorkflowBuilder 語法public abstract interface 描述IDfCollection接口提供了啟動(dòng)一個(gè)workflow需要的方法。參數(shù)返回 包括dm_workflow object ID的IDfId對(duì)象示例 下面的示例為創(chuàng)建一個(gè)workflow實(shí)例 IDfWorkflowBuilder workflowBuilder = session .newWorkflowBuilder(new DfId(4b0004578000084d))。 (Workflow initted! Id: + NewWorkflowId)。 (Workflow started! Id: + NewWorkflowId2)。四．Common Tools這一部分接口的作用是輔助DFC編程，使DFC開發(fā)變得更有效率。主要成員變量主要成員方法next()目的 得到collection的下一行記錄語法 public boolean next() throws DfException描述 該方法通常用在返回DQL查詢結(jié)果，每執(zhí)行一次這個(gè)方法，返回一行記錄。 int attributeCount = ()。 for ( int i = 0。 i++ ) attributes[i] = (i)。 i attributeCount。} } }getTypedObject()目的 返回一個(gè)IDfTypedObject對(duì)象作為下一行記錄語法 public IDfTypedObject getTypedObject() throws DfException描述 在調(diào)用IDfCollection接口的next方法以后，是不可以在得到前一個(gè)行的記錄，那么可以通過調(diào)用這個(gè)方法把記錄行緩存到內(nèi)存，方便以后使用。 while ( () ) { ( () )。 String name = ( r_object_name )。 // Do something with the values from the current row. }接口IDfId 語法public abstract interface 描述IDfId接口對(duì)象對(duì)r_o