taskeventmgr.java

基于Sturts+Spring+Hibernate的一个高级销售管理系统。内容丰富

package com.yuanchung.sales.service.taskevent;

import java.util.List;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpSession;

import org.apache.struts.action.ActionForm;

import com.yuanchung.sales.dao.taskEvent.EventDAO;
import com.yuanchung.sales.dao.taskEvent.TaskDAO;
import com.yuanchung.sales.exception.ApplicationException;
import com.yuanchung.sales.model.businessOpportunity.BusinessOpportunity;
import com.yuanchung.sales.model.customer.Customer;
import com.yuanchung.sales.model.customer.CustomerContact;
import com.yuanchung.sales.model.taskEvent.ActivityTask;
import com.yuanchung.sales.model.taskEvent.Event;
import com.yuanchung.sales.model.user.User;
import com.yuanchung.sales.model.userDefined.UserDefined;
import com.yuanchung.sales.model.userDefined.UserField;
import com.yuanchung.sales.model.userDefined.UserFilter;
import com.yuanchung.sales.struts.taskevent.form.EventForm;
import com.yuanchung.sales.util.PageController;
import com.yuanchung.sales.vo.CustomerVo;
import com.yuanchung.sales.vo.busiOpport.BusinessOpportunityVo;
import com.yuanchung.sales.vo.contact.ContactVo;
import com.yuanchung.sales.vo.taskEvent.Activity;
import com.yuanchung.sales.vo.taskEvent.ActivityDefinedVo;
import com.yuanchung.sales.vo.taskEvent.ActivityTaskVo;
import com.yuanchung.sales.vo.user.UserVo;

/**
 * @author 陆文邦;
 * @function 处理活动任务和事件的组件接口;
 * 
 */
public interface TaskEventMgr {

	public TaskDAO getTaskDAO();

	public EventDAO getEventDAO();

	/**
	 * @author 陆文邦;
	 * @function 获取全部用户;
	 * @param flag根据任务活动状态来搜索;
	 * @return 返回全部用户的列表;
	 */
	public List<User> getAllUsers(String userIds) throws ApplicationException;

	/**
	 * @author 陆文邦;
	 * @function 用于获取搜索符合条件的用户;
	 * @param 用userName参数模糊搜索;
	 * @param flag
	 *            根据状态来搜索记录;
	 * @return 返回搜索的用户列表;
	 */
	public List<UserVo> getUsersByNameLike(String familyName)
			throws ApplicationException;

	/**
	 * @author 陆文邦;
	 * @function 用于获取搜索符合条件的业务机会;
	 * @param 用userName参数模糊搜索;
	 * @param flag
	 *            根据状态来搜索记录;
	 * @return 返回搜索的业务机会列表;
	 */
	public List<BusinessOpportunityVo> getOpportByNameLike(String name)
			throws ApplicationException;

	/**
	 * @author 陆文邦;
	 * @function 用于获取搜索符合条件的客户;
	 * @param 用userName参数模糊搜索;
	 * @param flag
	 *            根据状态来搜索记录;
	 * @return 返回搜索的客户列表;
	 */
	public List<CustomerVo> getCustomerByNameLike(String name)
			throws ApplicationException;

	/**
	 * @author 陆文邦;
	 * @function 用于获取搜索符合条件的联系人;
	 * @param name
	 * @return
	 * @throws ApplicationException
	 */
	public List<ContactVo> getCustomerContactByNameLike(String name)
			throws ApplicationException;

	/**
	 * @author 陆文邦;
	 * @function 搜索全部的联系人;
	 * @param flag;根据记录状态来搜索;
	 * @return 返回搜索的联系人;
	 */
	public List<CustomerContact> getAllCustomerContacts(Integer flag)
			throws ApplicationException;

	/**
	 * @author 陆文邦;
	 * @function 根据相关项类型搜索具体记录;
	 * @param id为相关项标识
	 * @return 返回相关项里的相关记录;
	 */
	public List getAllfunctionRecordCollection(Integer id)
			throws ApplicationException;

	/**
	 * @author 陆文邦;
	 * @function 添加任务活动;
	 * @param 保存raskPojo参数的实例
	 * @return 返回是否保存成功;
	 */
	public boolean addTask(ActivityTask raskPojo, String userStr, String path,
			User user) throws ApplicationException;

	/**
	 * @author 陆文邦;
	 * @function 添加日历事件;
	 * @param 保存eventPojo参数的实例
	 * @return 返回是否保存成功;
	 */
	// public boolean addEvent(Event eventPojo) throws ApplicationException;
	/**
	 * @author 陆文邦;
	 * @function 搜索具体某个用户;
	 * @param id
	 *            根据用户id的主键来搜索用户
	 * @return 返回该id号的用户;
	 */
	public User getUserById(Integer id) throws ApplicationException;

	/**
	 * @author 陆文邦;
	 * @function 搜索全部任务活动;
	 * @param flag
	 *            根据flag状态搜索记录;
	 * @param type
	 *            搜索任务活动的类型;
	 * @return 返回全部的任务活动;
	 */
	public List<ActivityTaskVo> getAllTasks(Integer flag, User user,
			Integer type) throws ApplicationException;

	/**
	 * @author 陆文邦;
	 * @function 搜索id号的任务活动;
	 * @param id
	 *            根据该id参数来搜索;
	 * @return 返回该任务活动;
	 */
	public ActivityTask getTsakById(Integer id) throws ApplicationException;

	/**
	 * @author 陆文邦;
	 * @function 搜索该id号的联系人;
	 * @param id
	 *            根据该id参数来搜索;
	 * @return 返回该具体联系人;
	 */
	public CustomerContact getCustomerContactById(Integer id)
			throws ApplicationException;

	/**
	 * @author 陆文邦;
	 * @function 搜索该rid号的客户;
	 * @param id
	 *            根据该rid参数来搜索;
	 * @return 返回该具体客户;
	 */
	public Customer getCustomerByRid(Integer rid) throws ApplicationException;

	/**
	 * @author 陆文邦;
	 * @function 搜索该rid号的业务机会;
	 * @param id
	 *            根据该rid参数来搜索;
	 * @return 返回该具体业务机会;
	 */
	public BusinessOpportunity getOpportByRid(Integer rid)
			throws ApplicationException;

	/**
	 * @author 陆文邦;
	 * @function 修改该任务活动对象;
	 * @param id
	 *            修改raskPojo对象的参数;
	 * @return 返回是否修改成功;
	 */
	public boolean modifyTask(ActivityTask raskPojo)
			throws ApplicationException;

	/**
	 * @author 陆文邦;
	 * @function 添加事件;
	 * @param form
	 *            action中的form;
	 * @param request
	 *            action中的request;
	 * @return 返回是否修改成功;
	 */
	public boolean addEvent(ActionForm form, HttpServletRequest request)
			throws ApplicationException;

	/**
	 * @author 陆文邦;
	 * @function 根据某天搜索事件;
	 * @param DayOfMonth
	 *            日期;
	 * @return 返回事件列表;
	 */
	public List getEventByDay(String dayOfMonth, int flag, User user)
			throws ApplicationException;

	/**
	 * @author 陆文邦;
	 * @function 根据某年某月搜索事件;
	 * @param date
	 *            日期;
	 * @param flag
	 *            是否激活状态;
	 * @return 返回事件列表;
	 */
	public List getEventsByMonth(int flag, int year, int month, User user)
			throws ApplicationException;

	/**
	 * @author 陆文邦;
	 * @function 根据某年某周搜索事件;
	 * @param date
	 *            日期;
	 * @param flag
	 *            是否激活状态;
	 * @return 返回事件列表;
	 */
	public List getEventsByWeek(int weekOfYearInt, int year, int flag, User user)
			throws ApplicationException;

	/**
	 * @author 陆文邦;
	 * @function 根据某年某日搜索事件;
	 * @param date
	 *            日期;
	 * @param flag
	 *            是否激活状态;
	 * @return 返回事件列表;
	 * @time:2008-12-12
	 */
	public List getEventsByDate(int year, int dayOfYear, int flag, User user)
			throws ApplicationException;

	/**
	 * @author 陆文邦;
	 * @function 根据id号搜索事件;
	 * @param id
	 * @return 该id号的事件;
	 * @throws ApplicationException
	 */
	public Event getEventById(Integer id) throws ApplicationException;

	/**
	 * @author 陆文邦
	 * @date 2008-12-18
	 * @function 查找相关的数据;
	 * @param user
	 * @param flag
	 * @return
	 * @throws ApplicationException
	 */
	public List getTaskEventList(User user, int flag)
			throws ApplicationException;

	/**
	 * 函数功能 修改事件; 创建时间 2008-12-23; 程序员 陆文邦;
	 * 
	 * @param event
	 * @throws ApplicationException
	 */
	public void modifyEvent(HttpServletRequest request, EventForm eForm)
			throws ApplicationException;

	/**
	 * 函数功能: 删除事件，不是物理删除; 参数说明: id 事件id,针对该id的事件修改; flag 旗标，标识该事件是否可用; 程序作者:
	 * 陆文邦; 创建时间: 2008-12-24
	 * 
	 * @throws ApplicationException
	 */
	public void mergeEventFlag(Integer id, int flag)
			throws ApplicationException;

	/**
	 * 函数功能 修改序列事件; 创建时间 2008-12-26; 程序员 陆文邦;
	 * 
	 * @param event
	 * @throws ApplicationException
	 */
	public Integer modifySystemEvent(HttpServletRequest request, EventForm eForm)
			throws ApplicationException;

	/**
	 * 函数功能:修改该序列事件的可用状态; 参数说明:@param seq 该事件的序列号;@param flag 是否可用的标识;
	 * 创建时间:2008-12-30; 程序作者:陆文邦; 异常处理: ApplicationException
	 */
	public void mergeEventsFlagBySeq(String seq, int flag)
			throws ApplicationException;

	/**
	 * 函数功能 获取当前时间是否有任务要提醒; 参数说明@param flag 可用状态
	 * 
	 * @param user
	 *            用户
	 * @param dateStr
	 *            日期
	 * @param wakeUpTime
	 *            提醒时间 创建时间:2009-1-17; 程序作者:陆文邦;
	 * @return int 任务的数量;
	 * @throws ApplicationException
	 */
	public int getTasksByNow(int id) throws ApplicationException;

	/**
	 * 程序作者:陆文邦; 创建时间:2009-01-19; 函数功能:获取需要提醒的数据; 参数说明:@param user 根据该用户相关的数据
	 * 
	 * @param flag
	 *            可用状态的数据;
	 * @return list 数据列表;
	 * @throws ApplicationException
	 */
	public List getAllTaskByAlert(int id, int flag) throws ApplicationException;

	/**
	 * 程序作者:陆文邦; 创建时间:2009-02-03; 函数功能:根据id获取数据对象; 参数说明: id 数据的序列号;
	 * 
	 * @throws ApplicationException;
	 */
	public List getActivityById(Integer id) throws ApplicationException;

	/**
	 * @author LuWenBang
	 * @date 2009_02_17 @
	 * @param user
	 * @param type
	 * @return
	 * @throws ApplicationException
	 */
	public List getOptionsByUserAndType(User user, int type)
			throws ApplicationException;

	/**
	 * @author LuWenBang
	 * @date 2009_02_18
	 * @param userDefined
	 * @throws ApplicationException
	 */
	public void addUserDefined(UserDefined userDefined)
			throws ApplicationException;

	/**
	 * @author LuWenBang
	 * @date 2009_02_18
	 * @param userFilter
	 * @throws ApplicationException
	 */
	public void addUserFilter(UserFilter userFilter)
			throws ApplicationException;

	/**
	 * @author LuWenBang
	 * @date 2009_02_18
	 * @param userField
	 * @throws ApplicationException
	 */
	public void addUserField(UserField userField) throws ApplicationException;

	/**
	 * @author LuWenBang
	 * @date 2009_02_20
	 * @function 根据参数搜索任务和事件两张表;
	 * @param usersId
	 * @param flag
	 * @return
	 * @throws ApplicationException
	 */
	public List getTaskEvents(String usersId, int flag)
			throws ApplicationException;

	/**
	 * @author LuWenBang
	 * @date 2009_02_20
	 * @function 根据id搜索该用户对象;
	 * @param optionId
	 * @return
	 * @throws ApplicationException
	 */
	public UserDefined getUserDefinedById(int optionId)
			throws ApplicationException;

	/**
	 * @author LuWenBang
	 * @date 2009_02_20
	 * @function 根据UserDefined封装ActivityDefinedVo对象;
	 * @throws ApplicationException;
	 */
	public ActivityDefinedVo transaformActivityDefinedPoToVo(
			UserDefined userDefined) throws ApplicationException;

	/**
	 * @author LuWenBang
	 * @date 2009_02_24
	 * @function 修改用户自定义选项;
	 * @param userDefined
	 * @return
	 * @throws ApplicationException
	 */
	public boolean updateOption(UserDefined userDefined)
			throws ApplicationException;

	/**
	 * @author LuWenBang
	 * @date 2009_02_24
	 * @function 获取用户过滤字段;
	 * @param filterId
	 * @return
	 * @throws ApplicationException
	 */
	public UserFilter getUserFilterById(String filterId)
			throws ApplicationException;

	/**
	 * @author LuWenBang
	 * @date 2009_02_24
	 * @function 删除用户过滤字段;
	 * @param userFilter
	 * @return
	 * @throws ApplicationException
	 */
	public boolean deleteFilter(UserFilter userFilter)
			throws ApplicationException;

	/**
	 * @author LuWenBang
	 * @date 2009_02_24
	 * @function 更新用户过滤字段;
	 * @param userFilter
	 * @return
	 * @throws ApplicationException
	 */
	public boolean updateUserFilter(UserFilter userFilter)
			throws ApplicationException;

	/**
	 * @author LuWenBang
	 * @date 2009_02_24
	 * @function 获取用户自定义通过选项;
	 * @param userDefined
	 * @return
	 * @throws ApplicationException
	 */
	public UserField getUserFieldByOption(UserDefined userDefined)
			throws ApplicationException;

	/**
	 * @author LuWenBang;
	 * @date 2009_02_24;
	 * @function 更新用户字段;
	 * @param userField
	 * @return
	 * @throws ApplicationException
	 */
	public boolean updateUserField(UserField userField)
			throws ApplicationException;

	/**
	 * @author LuWenBang;
	 * @date 2009-02-27;
	 * @function dwr搜索activity列表;
	 * @param optionId
	 * @param currentPage
	 * @param session
	 * @return
	 * @throws ApplicationException
	 */
	public List<Activity> getActivityByOption(String optionId, int currentPage,
			HttpSession session) throws ApplicationException;
	/**
	 * @author LuWenBang;
	 * @date 2009-03-02;
	 * @function dwr搜索字段列表;
	 * @param optionId
	 * @param request
	 * @return
	 * @throws ApplicationException
	 */
	public List<String> getDefinedField(String optionId,
			HttpServletRequest request) throws ApplicationException;
	/**
	 * @author LuWenBang;
	 * @date 2009-02-28
	 * @function 获取页面对象;
	 * @param currentPage
	 * @param session
	 * @return
	 * @throws ApplicationException
	 */
	public PageController getPageController(int currentPage, HttpSession session)
			throws ApplicationException;
}