Activiti工作流中注入的陷阱

3.查看任务
3.1.引入
当我们流程启动后，会产生对应私人任务或公有任务，只要对应的办理者或候选人，查看任务后，进行认领，办理等操作。整个流程才能走完。我们先来看查看任务。
3.2.分析
当用户登录系统后，要有个地方查询自己的任务，这时我们专门准备一个菜单来展示任务，当然任务又分私人任务和公有任务。需要区分对待。
1、提供一个“任务管理”的一级菜单，在该菜单下面有“待办任务（私人任务）”和“可接任务（公共任务）”
2、需要通过Controller跳转页面
3、每个二级菜单需要调整一个管理界面

3.3.实现
菜单：
菜单，Controller,页面
列表:
返回值List

注意：在CommonUtil中针对任务创建日期的创建日期做格式化。

3.3.1.跳转到代办任务首页

//跳转到待办任务的管理界面
	///workFlow/personalTask/index
	@RequestMapping("/personalTask/index")
	public String personalTask() 
	{
		return "workFlow/personalTask";
	}
3.3.2.查询代办任务列表
/**
	 * 当前登录用户的待办任务
	 * 参数:
	 *  当前登录用户,Session已经存放,不要传递
	 * 返回值:
	 *    原来返回值:List<Task>和原来流程定义一样要用Map
	 * @return
	 */
	@RequestMapping("/listPersonalTasks")
	@ResponseBody
	public List<Map<String,Object>> listPersonalTasks() {
		//把Session里面用户传入Service,降低Service与web层耦合
		String assignee = UserContext.getUser().getNickname();
		return workFlowService.listPersonalTasks(assignee);
	}


Service:
@Override
	public List<Map<String, Object>> listPersonalTasks(String assignee) {
		
		//创建查询对象
		TaskQuery query = taskService.createTaskQuery();
		//设置查询条件
		query.taskAssignee(assignee);
		query.orderByProcessDefinitionId().desc();//相同规则放到一起
		query.orderByTaskCreateTime().desc();//按时间倒序
		//做查询-List<Task>
		List<Task> list = query.list();
		   //声明要返回类型
			List<Map<String, Object>> result = new ArrayList<>();
		   //转换
			for (Task task : list) {
				//一个task就是一个map
				result.add(task2map(task));
			}
		   //返回
		return result;
	}

	private Map<String, Object> task2map(Task task) {
		// Map<String, Object> result = new HashMap<>();
		// result.put("id", task.getId());
		Map<String, Object> obj2map = CommUtil
				.obj2map(task, new String[] { "id", "name", "assignee", "createTime", "description" });
		//为了构造动态表单,需要将formKey businessObjType businessObjId这三个参数和task属性一起返回 
		obj2map.put("businessObjType", getBusinessObjType(task));
		obj2map.put("businessObjId", getBusinessObjId(task));
		obj2map.put("formKey", getFormKey(task));
		return obj2map;
	}


private String getFormKey(Task task) {
		//方式1:通过task直接获取-有兼容性问题,老版本中不能直接获取
		String formKey = task.getFormKey();
		//方式2:通过FormService的getTaskFormKey方法获取
		/*
		String processDefinitionId = task.getProcessDefinitionId();
		String taskDefinitionKey = task.getTaskDefinitionKey();
		formKey = formService.getTaskFormKey(processDefinitionId, taskDefinitionKey);*/
	     //方式3:通过FormService获取TaskFormData,在TaskFormData中获取formKey
	     //这一种方式不仅可以获取formKey还能获取表单属性
		/*
	     formKey = formService.getTaskFormData(task.getId()).getFormKey();
	     System.out.println(formKey);*/
		return formKey;
	}

	private Long getBusinessObjId(Task task) {
		return taskService.getVariable(task.getId(), "businessObjId", Long.class);
	}

	private String getBusinessObjType(Task task) {
		//Customer LeaveBill
		String businessObjType = taskService.getVariable(task.getId(), "businessObjType", String.class);
		businessObjType = businessObjType.substring(0, 1).toLowerCase()+businessObjType.substring(1);
		return businessObjType;
	}

工具类时间转换：
//获取到的值,其中就有Date
					Object value = readMethod.invoke(source, new Object[0]);
					if (value instanceof Date) {
						//日期类型
						Date dateValue = (Date) value;
						DateFormat df = new SimpleDateFormat(PATTERN);
						String dateStr = df.format(dateValue);
						map.put(p, dateStr);
					}else{
						map.put(p, value);

			}

4.办理任务-动态表单
4.1.办理任务方式分析

分析 ：
1、提供一个“查看任务”按钮，点击后打开任务详情对话框，查看后关闭，然后在提供一个“办理任务”按钮，点击后完成任务。

2、提供一个“办理任务”按钮，点击后弹出一个任务详情对话框，在对话框的最下面，提供一个完成任务按钮，点击后完成任务，并关闭对话框。(采纳)

4.2.为什么需要动态表单
分析：每个任务的详情对话框是不变的，还是可变的。
任务详情对话框放的是任务所对应的业务对象，如果是客户报备，里面放的就是客户的信息，如果是请假，里面放的是请假单。
1 不同流程定义所对应任务的任务详情，肯定是不一样的。
2 相同流程定义所对应任务的任务详情，一定是一样的吗？
有可能不一样
所以不同任务就要有不同任务详情对话框内容。任务是通过流程中节点生成的，而且同一个节点对话框是一样，要想确认每个任务不一样，在定义流程时，在流程节点上定义不同对话框表单。

4.3.实现动态表单方式；
4.3.1.FormProperties(表单属性)
通过表单属性的方式定义很多表单项（input）,并且既包含结构又包含值

实现步骤：
1、 点击办理任务时，获取表单属性
2、使用代码动态生成表单，和对应下面的表单项的值
动态生成表单，非常麻烦。
4.3.2.FormKey(表单键)
这种方式是提起动态表单键指向提前定义好的结构，并把它绑定到节点上。
1)FormKey定义结果

2)动态获取业务对象
在流程中，获取“业务对象”信息？？
从流程变量中，获取预先准备的业务信息：
businessObjType businessObjeId
可以发送Ajax请求到后台获取数据
/customer/getByID?id=1
/leaveBill/getByID?id=1

//统一格式
/businessObjType/loadFormData?businessObjId= businessObjeId

4.4.实现
实现步骤：
步骤：
分析，整体包表单分为表单结构和表单值，
1、表单的结构通过FormKey获取
2 、表单的值通过（businessObjType businessObjId流程变量）拼接一个url，发送一个Ajax请求获取数据
需要三个参数：FormKey，businessObjType ，businessObjId

当点击办理任务时，做以下步骤
1）获取三个参数FormKey，businessObjType ，businessObjid
1.1 点击办理任务，发送一个Ajax请求获取三个参数
1.2 查询任务时，每个任务携带上面的三个参数，可以直接获取。（采纳）
2）通过Formkey加载表单结构–表单键就是一个地址，通过该地址动态加载表单结构
3）通过businessObjType ，businessObjid发送Ajax请求获取数据
4)把表单结构和表单值融合在一起，形成完整的动态表单
4.4.1.前台

4.4.2.后台
1）三个参数收集

2）结构和业务对象获取

@Override
	public Map<String, String> loadFormData(Long businessObjId) {
		Customer customer = dao.get(businessObjId);
		//声明
		Map<String, String> result = new HashMap<>();
		//转换
		result.put("name", customer.getName());
		
		String genderStr = "未知";
		Integer gender = customer.getGender();
		if (gender == 0) {
			genderStr = "男";
		}else if (gender==1) {
			genderStr = "女";
		}
		result.put("gender", genderStr);
		SystemDictionaryItem job = customer.getJob();
		if (job!= null) {
			result.put("job", job.getTitle());
		}
		
		Employee seller = customer.getSeller();
		if (seller!= null) {
			result.put("seller", seller.getNickname());
		}
		Integer status = customer.getStatus();
		// 0初始录入，-1作废（放入资源池）1 报备中 2 报备完成
		String statusStr = "作废";
		if (status == 0) {
			statusStr = "初始录入";
		}else if (status==1) {
			statusStr = "报备中";
		}
		else if (status==2) {
			statusStr = "报备完成";
		}
		result.put("status", statusStr);
		//返回
		return result;
	}

4.5.小结
1、为什么需要动态表单
2、怎么实现动态表单
5.办理任务
5.1.引入
前面，我们已经完成每个任务的动态表单实现，能看到任务详情，接下来就要根据它是否符合条件进行任务办理。

5.2.审批报备办理者动态指定
1）写一个类继承TaskListener

2）把这个类绑定对应任务节点

3）在这个类中实现设置办理者的逻辑

//由于要注入Spring里面的Bean,所以本身也要交给Spring管理
//问题:不能注入employeeService
//分析:
	//ManagerSettingListener是给流程引擎创建"审批任务"是用来设置办理者,
	//而这时ManagerSettingListener的bean已经交个Spring管理,正常情况流程引擎直接从Spring中获取就ok.
	//但是流程引擎不知道要从Spring中去获取ManagerSettingListener
//解决方案:告诉流程引擎从Spring中获取监听器,而不要自己创建了.
@Component //还需要设置扫描路径
public class ManagerSettingListener implements TaskListener {

	@Autowired
	private IEmployeeService employeeService;
	@Override
	public void notify(DelegateTask delegateTask) {
		//获取审批人员  获取营销人员---部门----部门经理
		String sellerNickName = delegateTask.getVariable("seller", String.class);
		System.out.println(sellerNickName);
		System.out.println(employeeService);
		// Employee employee = employeeService.findBYNickName();
		// Department dept= employee.getDept();
		// Employee manager = dept.getManager();
		
		//写死"超级管理员"-超级管理员就可以获取审批任务
		delegateTask.setAssignee("超级管理员");
	}

}

注意：要配置spring对listener的注解扫描：

	<!-- listener的注解扫描 -->
	<context:component-scan base-package="cn.itsource.crm.listener"></context:component-scan>
	

5.3.流程办理完成状态修改
1)写一个类继承ExecutionListener

2)绑定到结束节点

3)实现逻辑

/**
 * 在流程结束的时候：
 * 		更新报备的状态
 * @author Administrator
 *
 */
@Component
public class EndListener implements ExecutionListener{

	@Autowired
	private ICustomerService customerService;
	@Override
	public void notify(DelegateExecution execution) throws Exception {
		//流程结束的时候修改status的状态值：
		//通过流程变量获取业务id
		Long businessObjId = execution.getVariable("businessObjId", Long.class);
		//查询业务对象
		Customer customer = customerService.get(businessObjId);
		//设置状态值
		customer.setStatus(2);
		//跟新数据库
		customerService.update(customer);
	}

}

特别注意：Spring注入问题
必须把监听器类交给Spring管理，不能自己直接new，否则无法注入，因为如果自己new的话Spring中没有该监听实例，所以在运行时会无法找到监听实例，而把监听器类交给Spring管理，Spring的IOC会存入该实例，因为SpringIOC容器会开辟许多空间，容纳@controller，@service，@repository，@Component …以供存放这些实例，当加上@Autowired这个注解时会通过索引去到响应的层去找对应的实例；