card.java

国内很牛的软件公司花费两年半开发的用EJB3开发的代码,采用STRUTS和EJB3,目前系统进行第二版.所以拿出来共享

package com.ufmobile.business.account.bo;

import java.util.ArrayList;
import java.util.Date;
import java.util.List;

import javax.ejb.Local;
import javax.ejb.Remote;

import com.ufmobile.business.account.entity.CardEntity;
import com.ufmobile.business.exception.CardException;
import com.ufmobile.common.login.entity.UserInfo;
import com.ufmobile.platform.Exception.BusinessException;

/**
 * <p>
 * 
 * <p>
 * 创建日期：2006-12-13
 * 
 * @author Janet Feng
 * @since v3.0
 */
/**
 * <p>
 * <p>
 * 创建日期：2006-12-13
 * 
 * @author Janet Feng
 * @since v3.0
 */
@Remote
@Local
public interface Card {

	/**
	 * <p>
	 * 新建充值卡
	 * <p>
	 * 作者：Janet Feng <br>
	 * 日期：2006-12-13
	 * 
	 * @param card
	 */
	public void addCard(CardEntity card) throws CardException;

	/**
	 * <p>
	 * 更新充值卡
	 * <p>
	 * 作者：Janet Feng <br>
	 * 日期：2006-12-13
	 * 
	 * @param card
	 */
	public void updateCard(CardEntity card) throws CardException;

	/**
	 * <p>
	 * 删除充值卡
	 * <p>
	 * 作者：Janet Feng <br>
	 * 日期：2006-12-13
	 * 
	 * @param cardId
	 */
	public void deleteCard(Long cardId) throws CardException;

	/**
	 * <p>
	 * 根据id获得充值卡对象
	 * <p>
	 * 作者：Janet Feng <br>
	 * 日期：2006-12-13
	 * 
	 * @param cardId
	 * @return
	 */
	public CardEntity getCardEntity(Long cardId) throws CardException;

	/**
	 * <p>
	 * 所有的充值卡记录数

	 * <p>
	 * 作者：Janet Feng <br>
	 * 日期：Dec 20, 2006
	 * 
	 * @return
	 * @throws CardException
	 */
	public int getAllCardsTotal() throws CardException;

	/**
	 * <p>
	 * 所有的充值卡记录
	 * <p>
	 * 作者：Janet Feng <br>
	 * 日期：Dec 20, 2006
	 * 
	 * @param beginIndex
	 * @param maxNumber
	 * @return
	 * @throws CardException
	 */
	public List<CardEntity> getAllCardsByPage(int beginIndex, int maxNumber) throws CardException;

	/**
	 * <p>
	 * 根据代理商编号，查询充值卡，分页

	 * <p>
	 * 作者：Janet Feng <br>
	 * 日期：Dec 30, 2006
	 * 
	 * @param beginIndex
	 * @param maxNumber
	 * @param agentCode
	 * @return
	 */

	public List<CardEntity> findCardByAgentCode(int beginIndex, int maxNumber, String agentCode, int dr,int queryType) throws CardException;

	/**
	 * <p>
	 * *根据代理商编号，查询充值卡，总数
	 * <p>
	 * 作者：Janet Feng <br>
	 * 日期：Dec 30, 2006
	 * 
	 * @param agentCode
	 * @return
	 */
	public int findCardByAgentCodeTotal(String agentCode, int dr,int queryType) throws CardException;

	/**
	 * <p>
	 * 批量更改充值卡状态

	 * <p>
	 * 作者：Janet Feng <br>
	 * 日期：Dec 31, 2006
	 * 
	 * @param bFreeze
	 * @param cardId
	 * @throws CardException
	 */
	public void changeCardState(Boolean bFreeze, long... cardId) throws CardException;

	/**
	 * <p>
	 * <p>
	 * 作者：Janet Feng <br>
	 * 日期：Jan 4, 2007
	 * 
	 * @param beginIndex
	 * @param maxNumber
	 * @param agentCode
	 * @param cardCode
	 * @param isFreeze
	 * @param dr
	 * @param cardType
	 * @param accountName
	 * @return
	 * @throws CardException
	 */
	public List<CardEntity> queryCardsByPage(int beginIndex, 
											int maxNumber, 
											String agentCode,
											String cardCode,
											int isFreeze,
											int dr,
											int cardType,
											String accountName,
											String streetName,
											Date fillBeginDate,
											Date fillEndDate,
											Date saleBeginDate,
											Date saleEndDate,
											int queryType) throws CardException;

	/**
	 * <p>
	 * <p>
	 * 作者：Janet Feng <br>
	 * 日期，：Jan 4, 2007
	 * 
	 * @param agentCode
	 * @param cardCode
	 * @param isFreeze
	 * @param dr
	 * @param cardType
	 * @param accountName
	 * @return
	 * @throws CardException
	 */
	public int queryCardsTotal(String agentCode, 
								String cardCode, 
								int isFreeze, 
								int dr, 
								int cardType, 
								String accountName, 
								String streetName,
								Date fillBeginDate,
								Date fillEndDate,
								Date saleBeginDate,
								Date saleEndDate,
								int queryType) throws CardException;

	/**
	 * <p>
	 * 根据卡号查询冲值卡
	 * <p>
	 * 作者：Jan <br>
	 * 日期：Jan 23, 2007
	 * 
	 * @param cardCode
	 * @return
	 * @throws CardException
	 */
	public CardEntity findCardByCode(String cardCode) throws CardException;

	/**
	 * <p>
	 * 冲值

	 * <p>
	 * 作者：msf <br>
	 * 日期：2007-3-19
	 * 
	 * @param card 卡

	 * @param userName 用户名

	 * @throws CardException
	 */
	public void fillMoney(CardEntity card, String userName) throws CardException;

	/**
	 * <p>
	 * <p>
	 * 作者：msf <br>
	 * 日期：2007-3-28
	 * 
	 * @return
	 * @throws CardException
	 */
	public List<String> QueryAllCardCode(String codes) throws CardException;

	/**
	 * <p>
	 * 批量倒入
	 * <p>
	 * 作者：msf <br>
	 * 日期：2007-3-28
	 * 
	 * @param cards
	 * @throws CardException
	 */
	public void importCard(List<CardEntity> cards) throws CardException;
	
	
	/**
	 * <p>
	 * 充值卡导入数据有效性检查
	 * <p>
	 * 作者：daixh <br>
	 * 日期：Aug 30, 2007
	 * @return
	 * @throws CardException
	 */
	public  String checkImportedCard(int formIndex,UserInfo user,List<String[]> source) throws CardException;
	
	public List<String[]>prepareCardData(int beginIndex, 
											int maxNumber, 
											String agentCode,
											String cardCode,
											int isFreeze,
											int dr,
											int cardType,
											String accountName,
											String streetName,
											Date fillBeginDate,
											Date fillEndDate,
											Date saleBeginDate,
											Date saleEndDate,
											UserInfo userinfo) throws CardException;
	
	public void modifyCardAgent(String oldAgentCode,String newAgentCode)throws BusinessException;
    
	/**
	 * @author chengjy
	 * @param  staArea,
	 * @param  agentCode
	 * @param  cardType
	 * @param  beginDate
	 * @param  endDate
	 * @exception BusinessException
	 * @since 1.1
	 * 2007-09-06
	 * 
	 * */
	public Integer staCostCardNum(Integer staArea,
			                        String agentCode,
			                        Integer cardType,
			                        Date beginDate,
			                        Date endDate) throws BusinessException;
	
	
	/**
	 * @author chengjy
	 * @param  staArea,
	 * @param  agentCode
	 * @param  cardType
	 * @param  beginDate
	 * @param  endDate
	 * @param  beginIndex
	 * @param  maxNumber
	 * @exception BusinessException
	 * @since 1.1
	 * 2007-09-06
	 * 
	 * */
	public List<CostCardStatiDetail> staCostCard(Integer staArea,
			                        String agentCode,
			                        Integer cardType,
			                        Date beginDate,
			                        Date endDate,
			                        int beginIndex, 
									int maxNumber) throws BusinessException;
	
	
	/**
	 * <p>
	 * 查询充值卡历史数据
	 * <p>
	 * 作者：daixh <br>
	 * 日期：Oct 24, 2007
	 * @return
	 * @throws CardException
	 */
	//public List<CardEntity> queryHisCard() throws CardException;  
	
	
	/**
	 * <p>
	 * 对充值卡历史数据密码加密并保存
	 * <p>
	 * 作者：daixh <br>
	 * 日期：Oct 24, 2007
	 * @param list
	 * @return
	 * @throws CardException
	 */
	public boolean encryHisCard() throws CardException; 
	
	/**
	 * <p>
	 * 计算服务费订单支出所对应的积分额(用于升级历史数据)
	 * <p>
	 * 作者：yulimin <br>
	 * 日期：2007-10-29
	 * 
	 * @param 
	 * @return 
	 * @throws 
	 */
	public boolean calculateBootHistoryScore(long ruleid);
	
	
	/**
	 * <p>
	 * 获得需要升级积分的帐户和帐户对应需要增加的积分组合
	 * <p>
	 * 作者：yulimin <br>
	 * 日期：2007-10-29
	 * 
	 * @param 
	 * @return 
	 * @throws 
	 */
	public List getAllAcountScore(long ruleid);
	
	/**
	 * <p>
	 * 升级商铺历史积分
	 * <p>
	 * 作者：yulimin <br>
	 * 日期：2007-10-29
	 * 
	 * @param 
	 * @return 
	 * @throws 
	 */
	public boolean updateScore(Long sysID);
	
	/**
	 * <p>
	 * 判断是否已经更新积分
	 * <p>
	 * 作者：yulimin <br>
	 * 日期：2007-10-29
	 * 
	 * @param 
	 * @return 
	 * @throws 
	 */
	public boolean ifupdate();
}