FileNet Realm类的简单使用和常量类的简要说明及其引申的待谈话题

        FileNet的用户和组依靠的是LDAP，多少情况使用的是windows2003 的。在项目中获取账户和组信息可以编码访问LDAP，也可以使用FileNet的接口来访问用信息。没有特殊需要，直接使用FileNet接口接口即可。

        在com.filenet.api.security包中提供了关于认证、授权以及用户和组的接口。包括Realm、User、Group等。Realm可以用来查询User和Group。以获取用户信息为例代码如下所示。

Realm realm = Factory.Realm.fetchCurrent(this.osp().getObjectStore().getConnection(), null);

UserSet userSet = realm.findUsers(“shortName”,

                   PrincipalSearchType.SUFFIX_MATCH,

                   PrincipalSearchAttribute.SHORT_NAME,

                   PrincipalSearchSortType.ASCENDING,

                   0, 

                    null);

  for(Iterator<?> iter = userSet.iterator();iter.hasNext();){

         User user = (User)iter.next();

        String dispName = user.get_DisplayName();

        String email = user.get_Email();

}

 

 

        以上代码的核心在realm.findUsers上，其中使用了实体类PrincipalSearchType，PrincipalSearchAttribute和PrincipalSearchSortType，它们分别用于指定查找匹配模式、查找的条件字段和排序类型。这些类都在FileNet的com.filenet.api.constants包中。这样做便于管理，也防止了用户传参的无效性，提高了代码的质量。在项目中我们也经常定义一些这样的类来存储所需常量（包括方法参数常量、信息提示常量、配置信息常量等等），一个很好的应用是项目Exception统一管理中的异常代码。不过需要注意区别常量和可能变动的信息（往往使用配置文件xml、property等）。

        上面代码查询过程使用的是尾缀匹配方式，而且对查询结果进行了排序，其速度是相当慢的。但就查询某一个用户，我们可以直接进行精确查找，对结果无需排序，其查询速度大概能提高10倍以上。修改内容如下所示：

	UserSet userSet = realm.findUsers (“shortName”,			 PrincipalSearchType.EXACT,
			PrincipalSearchAttribute.SHORT_NAME,
			PrincipalSearchSortType.NONE,
		0, 
			null);

        在FileNet PE方面的接口中的VWSession有fetchUserInfo(java.lang.String theName)方法能够获取指定shortName下的VWUserInfo，通过这个类能够得到使用Realm方法获取的信息，但使用该方法查询用户信息可能会存在权限等问题致使无法完全获取自己需要的信息。

        对于FileNet的security包还有很多重要的功能，如授权和认证，是所有系统必不可少的基础模块。此外FileNet的组织信息牵涉到作为轻量级目录服务之一的LDAP协议的使用，同时此文对使用常量类和配置文件进行了简单说明，但在项目中值得重视。