JBPM4.4总结-嵌入自己的用户体系(集成自定义用户表)

 

      很多时候,JBPM自己提供的用户系统是不够用的,这时候就要求我们自己去扩展自己的用户体系。JBPM允许外挂一个用户体系。

      如果想嵌入自己的用户体系,只需如下五步:

 

一:创建MesUser,MesGroup,MesMembership三个类,分别实现接口User,Group。由于类MesMembership是独立的,因此没有必要继承或实现其他接口。

 

Jbpm4提供了实现接口

interface User 

interface Group

interface GroupMember

interface IdentitySession

想要集成自己的表,首先需要实现jbpm提供的接口,然后再进行配置。 

MesUser.java 用户表  

package com.amnet.jbpm.identify;

import java.io.Serializable;
import java.sql.Blob;
import org.jbpm.api.identity.User;

public class MesUser implements Serializable, User {

	private static final long serialVersionUID = 1L;

	protected long dbid; // 数据库内部自生成的ID

	private String id;

	private String userNo;// 员工工号

	private String userName;// 员工姓名

	private String userSex;// 性别

	private String userPassword;// 密码

	private String userType;// 类型

	private String userMail;// 电子邮件

	private String isValid;// 是否有效Y/N

	private Blob signaturePic;// 电子签名

	private String remarks;// 备注

	protected int dbversion;

	public int getDbversion() {

		return dbversion;

	}

	public MesUser() {

	}

	public MesUser(String id, String userName, String userMail) {

		this.id = id;

		this.userName = userName;

		this.userMail = userMail;

	}

	public void setDbversion(int dbversion) {

		this.dbversion = dbversion;

	}

	public long getDbid() {

		return dbid;

	}

	public void setDbid(long dbid) {

		this.dbid = dbid;

	}

	public void setId(String id) {

		this.id = id;

	}

	public String getUserNo() {

		return userNo;

	}

	public void setUserNo(String userNo) {

		this.userNo = userNo;

	}

	public String getUserName() {

		return userName;

	}

	public void setUserName(String userName) {

		this.userName = userName;

	}

	public String getUserSex() {

		return userSex;

	}

	public void setUserSex(String userSex) {

		this.userSex = userSex;

	}

	public String getUserPassword() {

		return userPassword;

	}

	public void setUserPassword(String userPassword) {

		this.userPassword = userPassword;

	}

	public String getUserType() {

		return userType;

	}

	public void setUserType(String userType) {

		this.userType = userType;

	}

	public String getUserMail() {

		return userMail;

	}

	public void setUserMail(String userMail) {

		this.userMail = userMail;

	}

	public String getIsValid() {

		return isValid;

	}

	public void setIsValid(String isValid) {

		this.isValid = isValid;

	}

	public Blob getSignaturePic() {

		return signaturePic;

	}

	public void setSignaturePic(Blob signaturePic) {

		this.signaturePic = signaturePic;

	}

	public String getRemarks() {

		return remarks;

	}

	public void setRemarks(String remarks) {

		this.remarks = remarks;

	}

	public String getDisplayName() {

		return userName + "(" + id + ")";

	}

	// 实现User接口所必须实现的几个方法

	public String getId() {

		return this.id;

	}

	public String getGivenName() {

		return null;

	}

	public String getFamilyName() {

		return null;

	}

	public String getBusinessEmail() {

		return this.userMail;

	}

}

MesGroup.java  部门表 

package com.amnet.jbpm.identify;

import java.io.Serializable;

import org.jbpm.api.identity.Group;

public class MesGroup implements Serializable, Group {

	private static final long serialVersionUID = 1L;

	private String id;

	private String groupName;// 组织名称

	private String groupType;// 组织类型

	private MesGroup parentGroup;// 父组织

	private String remarks;// 备注

	protected long dbid;

	protected int dbversion;

	public int getDbversion() {

		return dbversion;

	}

	public void setDbversion(int dbversion) {

		this.dbversion = dbversion;

	}

	public long getDbid() {

		return dbid;

	}

	public void setDbid(long dbid) {

		this.dbid = dbid;

	}

	public String getParentGroupID() {

		return parentGroup != null ? parentGroup.getId() : null;

	}

	public String getParentGroupName() {

		return parentGroup == null ? "xxx" : parentGroup.getGroupName();

	}

	public void setId(String id) {

		this.id = id;

	}

	public String getGroupName() {

		return groupName;

	}

	public void setGroupName(String groupName) {

		this.groupName = groupName;

	}

	public String getGroupType() {

		return groupType;

	}

	public void setGroupType(String groupType) {

		this.groupType = groupType;

	}

	public MesGroup getParentGroup() {

		return parentGroup;

	}

	public void setParentGroup(MesGroup parentGroup) {

		this.parentGroup = parentGroup;

	}

	public String getRemarks() {

		return remarks;

	}

	public void setRemarks(String remarks) {

		this.remarks = remarks;

	}

	// 实现Group接口必须的几个方法

	public String getName() {

		return this.groupName;

	}

	public String getType() {

		return this.groupType;

	}

	public String getId() {

		return id;

	}

}

MesGroupMembership.java 用户部门关系表 

package com.amnet.jbpm.identify;

import java.io.Serializable;

public class MesGroupMembership implements Serializable {

	private static final long serialVersionUID = 1L;

	protected long dbid;

	protected int dbversion;

	private MesUser user;

	private MesGroup group;

	protected String role;

	public int getDbversion() {

		return dbversion;

	}

	public void setDbversion(int dbversion) {

		this.dbversion = dbversion;

	}

	public long getDbid() {

		return dbid;

	}

	public String getRole() {

		return role;

	}

	public void setRole(String role) {

		this.role = role;

	}

	public void setDbid(long dbid) {

		this.dbid = dbid;

	}

	public MesGroup getGroup() {

		return group;

	}

	public void setGroup(MesGroup group) {

		this.group = group;

	}

	public String getUserNo() {

		return user.getUserNo();

	}

	public String getUserID() {

		return user.getId();

	}

	public String getUserName() {

		return user.getUserName();

	}

	public MesUser getUser() {

		return user;

	}

	public void setUser(MesUser user) {

		this.user = user;

	}

}

 

二:第一步完成了,那么就开始第二步。第二步的主要任务就是将这些类映射到数据库里。由于JBPM的持久层的操作采用的是Hibernate进行的。所以我们必须编写一个Hibernate的映射文件将实体类映射到数据库。

jbpm.customize.identify.hbm.xml






	
	

		
			
		

		

		 

		 

		 

		 

		 

		 

		 

		 

		 

	
	
	
	

		
			
		

		

		

		

		

	

	
	

		
			
		

		

		

		

		

		

		

		
	

上面的代码是仿照JBPM默认的映射文件jbpm.identity.hbm.xml写的。这个文件可以在JBPM的源代码里面找到,导入jar包时,它被封装在jbpm.jar里面。映射文件配置好了之后,在applicationContext.xml注入自己的mappingResources:

		
			
				com/amnet/jbpm/identify/jbpm.customize.identify.hbm.xml
			
		

 

三:通过以上两步,就完成了由实体类到数据库的映射,也就是说,当你启动tomcat运行JBPM的时候,数据库里就会多出三张表:JBPM4_CUSTOMIZE_USER,JBPM4_CUSTOMIZE_GROUP,JBPM4_CUSTOMIZE_MEMBERSHIP。虽然如此,但是这只是利用了hibernate的自动生成数据表的功能产生了三个表而已,JBPM凭什么知道我需要使用的是我新创建的这三张表,而不会去调用原来的那三张表呢?答案是,他不知道。所以我们要继续进行配置。找到jbpm的一个配置文件叫:spring-jbpm4.xml。在这个文件里面原来有一句话:

import resource="jbpm.identity.cfg.xml"。我们可以去查看spring-jbpm4.xml的实际内容,结果里面就一句话:  。有了这句话,就相当于告诉了JBPM,它将会去调用JBPM自带的关于用户体系操作的一个接口IdentitySession。这个类的实现IdentitySessionImpl里就会默认去调用JBPM自带的用户关系管理的数据表。所以为了改变JBPM的这种习惯,我们就必须自己创建一个类MesIdentitySessionImpl.java,并实现接口IdentitySession。这样JBPM就会去调用我们自己的实现,而不会再去调用它自己的东东。要实现这个只需要把他的配置文件spring-jbpm4.xml 的import resource="jbpm.identity.cfg.xml“注释掉,然后加上一句:





在spring-jbpm4.xml注释掉jbpm4自己的cfg.xml文件

  spring-jbpm4.xml 



	
		
	
	
	
	
	
	
	

	
	

	
		
		
		
	

这样就OK了。下面的任务就是去实现MesIdentitySessionImpl中的方法了。

 

四:实现MesIdentitySessionImpl中的方法

 

MesIdentitySessionImpl.java 实现类 

package com.amnet.jbpm.identify;

import java.util.Arrays;
import java.util.List;
import org.hibernate.Session;
import org.hibernate.criterion.Projections;
import org.hibernate.criterion.Restrictions;
import org.jbpm.api.JbpmException;
import org.jbpm.api.identity.Group;
import org.jbpm.api.identity.User;
import org.jbpm.pvm.internal.env.BasicEnvironment;
import org.jbpm.pvm.internal.env.EnvironmentImpl;
import org.jbpm.pvm.internal.id.DbidGenerator;
import org.jbpm.pvm.internal.identity.spi.IdentitySession;

@SuppressWarnings("unchecked")
public class MesIdentitySessionImpl implements IdentitySession {

	protected Session session;

	public MesIdentitySessionImpl() {

		this.session = BasicEnvironment.getFromCurrent(Session.class);

	}

//	public String createH() {
//
//		Test t = new Test();
//
//		long dbid = EnvironmentImpl.getFromCurrent(DbidGenerator.class)
//
//		.getNextId();
//
//		t.setDbid(dbid);
//
//		t.setId("abc");
//
//		return null;
//
//	}

	public String createUser(String id, String userName,

	String businessEmail, String familName) {

		MesUser user = new MesUser(id, userName, businessEmail);

		long dbid = EnvironmentImpl.getFromCurrent(DbidGenerator.class)

		.getNextId();

		user.setDbid(dbid);

		session.save(user);

		return user.getId();

	}

	public MesUser findUserById(String userId) {

		return (MesUser) session.createCriteria(MesUser.class).add(

		Restrictions.eq("id", userId)).uniqueResult();

	}

	public List findUsersById(String... userIds) {

		List users = session.createCriteria(MesUser.class).add(

		Restrictions.in("id", userIds)).list();

		if (userIds.length != users.size()) {

			throw new JbpmException("not all users were found: "

			+ Arrays.toString(userIds));

		}

		return users;

	}

	public List findUsers() {

		return session.createCriteria(MesUser.class).list();

	}

	public void deleteUser(String userId) {

		// lookup the user

		MesUser user = findUserById(userId);

		// cascade the deletion to the memberships

		List memberships = session.createCriteria(

		MesGroupMembership.class).add(Restrictions.eq("user", user)).list();

		// delete the related memberships

		for (MesGroupMembership membership : memberships) {

			session.delete(membership);

		}

		// delete the user

		session.delete(user);

	}

	public String createGroup(String groupName, String groupType,

	String parentGroupId) {

		MesGroup group = new MesGroup();

		String groupId = groupType != null ? groupType + "." + groupName

		: groupName;

		group.setId(groupId);

		long dbid = EnvironmentImpl.getFromCurrent(DbidGenerator.class)

		.getNextId();

		group.setDbid(dbid);

		group.setGroupName(groupName);

		group.setGroupType(groupType);

		if (parentGroupId != null) {

			MesGroup parentGroup = findGroupById(parentGroupId);

			group.setParentGroup(parentGroup);

		}

		session.save(group);

		return group.getId();

	}

	public List findUsersByGroup(String groupId) {

		return session.createCriteria(MesGroupMembership.class).createAlias(

		"group", "g").add(Restrictions.eq("g.id", groupId))

		.setProjection(Projections.property("user")).list();

	}

	public MesGroup findGroupById(String groupId) {

		return (MesGroup) session.createCriteria(MesGroup.class).add(

		Restrictions.eq("id", groupId)).uniqueResult();

	}

	public List findGroupsByUserAndGroupType(String userId,

	String groupType) {

		return session.createQuery(

		"select distinct m.group" + " from "

		+ MesGroupMembership.class.getName()

		+ " as m where m.user.id = :userId"

		+ " and m.group.type = :groupType").setString("userId",

		userId).setString("groupType", groupType).list();

	}

	public List findGroupsByUser(String userId) {

		List gList = session.createQuery(

		"select distinct m.group" + " from "

		+ MesGroupMembership.class.getName()

		+ " as m where m.user.id = :userId").setString(

		"userId", userId).list();

		return gList;

	}

	public List findGroups() {

		return session.createCriteria(MesGroup.class).list();

	}

	public void deleteGroup(String groupId) {

		// look up the group

		MesGroup group = findGroupById(groupId);

		// cascade the deletion to the memberships

		List memberships = session.createCriteria(

		MesGroupMembership.class).add(Restrictions.eq("group", group))

		.list();

		// delete the related memberships

		for (MesGroupMembership membership : memberships) {

			session.delete(membership);

		}

		// delete the group

		session.delete(group);

	}

	public void createMembership(String userId, String groupId, String role) {

		MesUser user = findUserById(userId);

		if (user == null) {

			throw new JbpmException("user " + userId + " doesn't exist");

		}

		MesGroup group = findGroupById(groupId);

		if (group == null) {

			throw new JbpmException("group " + groupId + " doesn't exist");

		}

		MesGroupMembership membership = new MesGroupMembership();

		membership.setUser(user);

		membership.setGroup(group);

		membership.setRole(role);

		long dbid = EnvironmentImpl.getFromCurrent(DbidGenerator.class)

		.getNextId();

		membership.setDbid(dbid);

		session.save(membership);

	}

	public void deleteMembership(String userId, String groupId, String role) {

		MesGroupMembership membership = (MesGroupMembership) session
				.createCriteria(

				MesGroupMembership.class).createAlias("user", "u").createAlias(

				"group", "g").add(Restrictions.eq("u.id", userId)).add(

				Restrictions.eq("g.id", groupId)).uniqueResult();

		session.delete(membership);

	}

}

 

五:测试类 

集成自己的表就完成了。当你调用 identityService.createUser()方法时,就往你自定义的user表里插入了一条记录。

TestMesIdentitySession.java 新建用户和组

package com.amnet.action;

import org.jbpm.api.IdentityService;
import org.jbpm.api.ProcessEngine;
import org.springframework.context.support.ClassPathXmlApplicationContext;

public class TestMesIdentitySession {

	/**
	 * @param args
	 */
	public static void main(String[] args) {
		ClassPathXmlApplicationContext applicationContext = new ClassPathXmlApplicationContext(
				"applicationContext.xml");
		applicationContext.start();
		ProcessEngine processEngine = (ProcessEngine) applicationContext
				.getBean("processEngine");

//		ExecutionService executionService = processEngine.getExecutionService();
//
//		TaskService taskService = processEngine.getTaskService();

		IdentityService identityService = processEngine.getIdentityService();

		identityService.createGroup("user_dept"); // 部门

		identityService.createUser("user1", "test1", "test1"); // 新建用户1

		identityService.createUser("user2", "test2", "test2"); // 新建用户2

		identityService.createMembership("user1", "user_dept"); // 绑定用户和部门的关系

		identityService.createMembership("user2", "user_dept");
	}
}

发布流程

ProcessEngine processEngine = Configuration.getProcessEngine();

RepositoryService repositoryService = processEngine

.getRepositoryService();

String deployId = repositoryService.createDeployment().addResourceFromClasspath("com/contract/contract.jpdl.xml").deploy();

删除流程

repositoryService.deleteDeploymentCascade(deployId));

开始流程实例

executionService.startProcessInstanceById(request.getParameter("id"));

 

 

 

 

你可能感兴趣的:(Jbpm,JavaEE)