EMC-- DFC --Sessions and Session Managers

本文链接：https://blog.csdn.net/oscar999/article/details/7936303

DFC - Documentum Foundation Classes

位于Content server和client 之间。用来做服务端业务逻辑和客制。

BOF- Business Object Framework.

模组。最重要的两个模组是

1. TBOs --type based objects

2. SBOs-- service based objects

3. Aspect -- similar to TBOs. enable you to attach properties and behavior on an instance-by-instace basic.

DFC的运行点

1. 运行content server的机器。 as call from a mthod.

2. 中间层系统。 as an application server

DFC除了DfClientC和异常类及其子类(DfException),大部分类都是通过工厂方法实例化。

如何得到一个session

1. 通过 IDfClient.newSessionMangager的方式创建一个IDfSessionManger

2. 从session manager中得到一个session. IDfSessionManger.newSession

3. session使用完成之后需要释放

4. IDfSessionManger.getSession 得到的是公用的session

clientx.getLocalClient() 这个方法会去找dfc的配置文件

IDfSessionManager.ALL_DOCBASES . 对于所有的docbases, 设置单一的身份

如果session manager有多重身份，可以懒加载。但是需要确认是否以及有此身份，如果有需先清空之前的身份信息，才能setIdentity否则会报错误。

package com.dev.guide.ch2;

import com.documentum.com.DfClientX;
import com.documentum.com.IDfClientX;
import com.documentum.fc.client.DfServiceException;
import com.documentum.fc.client.IDfClient;
import com.documentum.fc.client.IDfSessionManager;
import com.documentum.fc.common.DfException;
import com.documentum.fc.common.IDfLoginInfo;

public class TestSession {

	private IDfSessionManager sessionManager;

	IDfClientX clientx;

	public IDfSessionManager getSessionManager() {
		sessionManager = null;
		try {
			clientx = new DfClientX();
			IDfClient client = clientx.getLocalClient();
			sessionManager = client.newSessionManager();
		} catch (DfException e) {
			e.printStackTrace();
		}
		return sessionManager;
	}

	public IDfSessionManager getSessionManager(String userName, String password) {
		sessionManager = null;
		try {
			clientx = new DfClientX();
			IDfClient client = clientx.getLocalClient();
			sessionManager = client.newSessionManager();
			IDfLoginInfo loginInfo = clientx.getLoginInfo();
			loginInfo.setUser(userName);
			loginInfo.setPassword(password);
			sessionManager.setIdentity(IDfSessionManager.ALL_DOCBASES, loginInfo);
		} catch (DfException e) {
			e.printStackTrace();
		}
		return sessionManager;
	}

	public void addIdentity(String repository, String userName, String password) {
		try {
			IDfLoginInfo loginInfo = clientx.getLoginInfo();
			loginInfo.setUser(userName);
			loginInfo.setPassword(password);
			if (sessionManager.hasIdentity(repository)) {
				sessionManager.clearIdentity(repository);
			}
			sessionManager.setIdentity(repository, loginInfo);
		} catch (DfServiceException e) {
			e.printStackTrace();
		}
	}

	public static void main(String[] args) {
		// TODO Auto-generated method stub
		TestSession testSession = new TestSession();
		testSession.getSessionManager("dm_bof_registry", "dctmecmq");
		testSession.addIdentity("ecmq", "dm_bof_registry", "dctmecmq");

	}

}

setIdentity不会验证登录信息的正确与否，而是到getSession或是newSession的时候验证。但是你可以调用IDfSessionManger.authenticate的方法来验证。

getSession -- 得到共享session

newSession --得到私有的session

session需及时释放，尽量不要保存使用。释放时放在 finally的程序段里。

一些遗留的程序直接从IDfClient获取sessions, 在这种状况下，使用IDfSession.disconnet的方式释放。

当引用一个存在的session , 像session作为type object的数据成员的时候，不能够释放session.

比如通过这种方式获取的： IDfTypedObject.getSession

同一个session不能被释放两次，否则会抛出异常。

session释放之后也不能再使用了。

根据现有的session,得到另外一个repository有两种方式

1. 通过session得到sessionmanger, 使用sessionmanager传入repository，获取session. 两个session都需要释放。

2. 使用relateSession的方式。session.getRelatedSession. 这种session不需要显示释放。