Rational Team Conert Java API

说明：这篇日志一半是个人的总结，一半是借鉴别人的资料所成，所以不知道算不算原创，因为跟work相关吧，所以有些东西不能全部拿出。

关于RationalTeam Concert Java API

RTC API包含两种：Java 和REST。利用JavaAPI 就能够完成对Work item 的管理工作。但是JavaAPI在不同的RTC版本之间不够稳定，RTC版本变更，JavaAPI需要进行对应的迁移。

RTC的扩展架构如下：

如果要查询WI，基本流程如下：

第一步：登陆到rtc

自定义一个LoginHandler 类实现ILoginHandler, ILoginInfo 接口，并通过TeamPlatform获得 RTCrepository 连接后注册用户，并进行登陆。

privatestaticclassLoginHandler implementsILoginHandler, ILoginInfo {

privateString fUserId;

privateString fPassword;

privateLoginHandler(String userId, String password) {

fUserId =userId;

fPassword= password;

}

publicString getUserId() {

returnfUserId;

}

publicString getPassword() {

returnfPassword;

}

publicILoginInfo challenge(ITeamRepository repository) {

returnthis;

}

}

privatestaticITeamRepository login(String repositoryURI, String userId,Stringpassword) throwsTeamRepositoryException{

ITeamRepository repository= TeamPlatform

.getTeamRepositoryService().getTeamRepository(repositoryURI);

repository.registerLoginHandler(newLoginHandler(userId, password));

repository.login(null);

returnrepository;

}

第二步：获取IProcessItemService和IProcessClientService过程服务

IProcessClientServiceprocessClient =(IProcessClientService)repository.getClientLibrary(IProcessClientService.class);

IProcessItemServiceservice=(IProcessItemService)repository.getClientLibrary(IProcessItemService.class);

第三步：通过使用IProcessClientService.findProcessArea()以ProcessArea 的URI作为参数得到ProcessArea 的引用。

URIuri = URI.create(project_name.replace("", "%20"));

IProjectAreaprojectArea =(IprojectArea)processClient.findProcessArea(uri,null,null);

第四步：得到ProjectArea 的查询属性对象

IAuditableClientauditableClient =(IAuditableClient)repository.getClientLibrary(IAuditableClient.class);

IQueryClientqueryClient =(IQueryClient)repository.getClientLibrary(IQueryClient.class);

IQueryableAttributeFactoryfactory = QueryableAttributes.getFactory(IWorkItem.ITEM_TYPE);

IQueryableAttributequeryableAttribute1 = factory.findAttribute(projectArea,IworkItem.PROJECT_AREA_PROPERTY,auditableClient,null);

进行查询表达式的构建的时候，我们需要取出查询条件的查询属性对象，然后用查询属性对象，属性操作符，和属性的取值来构建这个查询表达式。

第五步：构建查询条件表达式AttributeExpression。其中，AttributeOperation可以设置为EQUALS等各种条件。

AttributeExpressionprojectAreaExpression =

newAttributeExpression(projectAreaAttribute, AttributeOperation.EQUALS,projectArea);

如果需要增加多个条件，需要新建Term对象来包含两个条件表达式。并将所有条件的连接方式设为AND，即和，我们同样可以根据需求设置为OR或者其他。

Termterm=null;

term=new Term(Operator.AND);

term.add(projectAreaExpression1);

ownerExpression=new AttributeExpression(ownerAttribute,

AttributeOperation.EQUALS,ownerHandle);

//加入Owner查询条件

term.add(ownerExpression);

第六步：获取查询查询结果。IWorkItem.FULL_PROFILE将查询出一个IWorkItem类中全部的属性。

privateIQueryResult<IResolvedResult<IWorkItem>> result;

result=queryClient.getResolvedExpressionResults(projectArea,projectAreaExpression,

IworkItem.FULL_PROFILE);

第七步：遍历结果集中的WorkItem，并得到此WorkItem 的属性

while(result.hasNext(monitor)) {

IWorkItem wi=newIWorkItem(result.next(monitor).getItem());

Long estimatethis.estimate=wi.getDuration()/3600000;

IWorkItemClientwiCommon =(IWorkItemClient)repository.getClientLibrary

(IWorkItemClient.class);

IProjectAreaHandleprjAreaHandle=(IProjectAreaHandle)projectArea.getItemHandle();

ICombinedWorkflowInfoswfInfo =

wiCommon.findCombinedWorkflowInfos(prjAreaHandle,null);

Stringstate=wfInfo.getStateName(wi.getState2());

String type=wi.getWorkItemType();

}