account.java

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

package com.ufmobile.business.account.bo;

import java.math.BigDecimal;
import java.util.Date;
import java.util.List;

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

import com.ufmobile.business.account.entity.AccountEntity;
import com.ufmobile.business.exception.AccountException;
import com.ufmobile.business.exception.CardException;
import com.ufmobile.common.login.entity.UserInfo;
import com.ufmobile.platform.Exception.BusinessException;
/*
 * @authu毛士福
 * @date 2006/12/7
 * @function 账户管理
 */
@Remote
@Local
public interface Account {
	public  enum AccountType {Flow,Service};//Flow 流量,Service 服务
	public  enum AccountState{star,stop};//start 启用 stop 停用
    public  enum BussinessType {fill,back,debuct,start,stop,add,subtract};//业务类型 fill 充值,back 返款,debuct 扣费,star 启用,stop 停用,add 增加余额 subtract 减少余额
	
    /**
	 * <p>
	 * 新增账户
	 * <p>
	 * 作者：msf <br>
	 * 日期：Dec 15, 2006
	 * @param account 要创建账户值
	 * @return
	 * @throws AccountException
	 */
	public AccountEntity add(AccountEntity account) throws AccountException;
	
	/**
	 * <p>
	 * 修改账户
	 * <p>
	 * 作者：msf <br>
	 * 日期：Dec 15, 2006
	 * @param account 要修改账户值
	 * @throws AccountException
	 */
	public void modify(AccountEntity account) throws AccountException;
	 
	/**
	 * <p>
	 * 删除账户
	 * <p>
	 * 作者：msf <br>
	 * 日期：Dec 15, 2006
	 * @param accountid 账户id
	 * @throws AccountException
	 */
	public void delete(String accountid) throws AccountException;

	/**
	 * <p>
	 * 启用账户
	 * <p>
	 * 作者：msf <br>
	 * 日期：Dec 15, 2006
	 * @param accountid
	 * @param usrid
	 * @param reson
	 * @throws AccountException
	 */
	public void start(String accountid,String usrname,String reson) throws AccountException;

	/**
	 * <p>
	 * 停用账户
	 * <p>
	 * 作者：msf <br>
	 * 日期：Dec 15, 2006
	 * @param accountid
	 * @param usrname
	 * @param reson
	 * @throws AccountException
	 */
	public void stop(String accountid,String usrname,String reson) throws AccountException;

	/**
	 * <p>
	 * 充值
	 * <p>
	 * 作者：msf <br>
	 * 日期：Dec 15, 2006
	 * @param accountid 充值账户id
	 * @param accountid 充值账户类型
	 * @param usrname 充值人
	 * @param sCardcode 充值卡编号
	 * @param password 充值卡密码
	 * @throws AccountException
	 */
	public void fillMoney(String accountid, AccountType Type,String usrname,String sCardcode,String password ) throws BusinessException;

	/**
	 * <p>
	 * 扣费
	 * <p>
	 * 作者：msf <br>
	 * 日期：Dec 15, 2006
	 * @param accountid 账户id
	 * @param accountid 充值账户类型
	 * @param quantity 流量数量
	 * @param category 流量类别
	 * @param usrname 操作员
	 * @param reson 原因
	 * @throws AccountException
	 */
	@Deprecated
	public void deduct(String accountid, AccountType Type,BigDecimal quantity,String category,String usrname,String reson) throws AccountException;

	/**
	 * <p>
	 *  扣费
	 * <p>
	 * 作者：msf <br>
	 * 日期：Feb 5, 2007
	 * @param accountid 账户id
	 * @param Type 充值账户类型  0 流量, 1 服务
	 * @param divNum 拆分的条数
	 * @param sendCount 发送列表
	 * @param category 发送类别 00001  主动下行（含群发和下行点播） 00002 上行回复（点播下行） 00100 wappush
	 * @param usrname 发送人
	 * @param reson 原因
	 * @throws AccountException
	 */
	public void deduct(String accountid, AccountType Type,Integer divNum,Long sendCount,String category,String usrname,String reson) throws AccountException;
	/**
	 * <p>
	 * 扣费
	 * <p>
	 * 作者：msf <br>
	 * 日期：Dec 15, 2006
	 * @param accountid 账户id
	 * @param accountid 充值账户类型
	 * @param money  扣费金额
	 * @param usrname 操作员
	 * @param reson 原因
	 * @throws AccountException
	 */
	public void deduct(String accountid, AccountType Type,BigDecimal money,String usrname,String reson) throws AccountException;
	/**
	 * <p>
	 * 返款
	 * <p>
	 * 作者：msf <br>
	 * 日期：Dec 15, 2006
	 * @param accountid 账户id
	 * @param iType 账户类型
	 * @param money 返款金额
	 * @param usrname 操作员
	 * @param reson 原因
	 * @throws AccountException
	 */
	public void back(String accountid,AccountType Type ,BigDecimal money,String usrname,String reson) throws AccountException;

	/**
	 * <p>
	 * 按代理商查询
	 * <p>
	 * 作者：msf <br>
	 * 日期：Dec 15, 2006
	 * @param agentcode 代理商编号
	 * @param type 账户类型
	 * @return  
	 * @throws AccountException
	 */
	public List querybyAgent(String agentcode,AccountType type) throws AccountException;

	/**
	 * <p>
	 * 查询明细
	 * <p>
	 * 作者：msf <br>
	 * 日期：Dec 15, 2006
	 * @param accountid 账户id
	 * @param type 账户类型
	 * @param start 开始时间
	 * @param end 结束时间
	 * @return
	 * @throws AccountException
	 */
	public List ListMeno(String accountid ,AccountType type,Date start,Date end) throws AccountException;
    
	/**
	 * <p>
	 * 账户调拨
	 * <p>
	 * 作者：msf <br>
	 * 日期：Dec 15, 2006
	 * @param fromAccountid
	 * @param toAccountid
	 * @param money
	 * @throws AccountException
	 */
	public void deploy(String fromAccountid,AccountType  fromType ,String toAccountid,AccountType toType,BigDecimal money,String usrname) throws AccountException;
	

	/**
	 * <p>
	 * 按id查询
	 * <p>
	 * 作者：msf <br>
	 * 日期：Dec 15, 2006
	 * @param sID
	 * @return
	 */
	public AccountEntity querybyAccountID(String sID);
	
	/**
	 * <p>
	 *  按id查询和账户类型查询
	 * <p>
	 * 作者：msf <br>
	 * 日期：Dec 18, 2006
	 * @param sID
	 * @param type
	 * @return
	 */
	public AccountEntity querybyAccountID(String sID, AccountType type);
	
	/**
	 * <p>
	 *查询账户总记录数
	 * <p>
	 * 作者：Janet Feng <br>
	 * 日期：Dec 21, 2006
	 * @param accountCode 账户编码
	 * @param accountName 账户名称
	 * @param from 账户创建时间，开始
	 * @param to 账户创建时间，结束
	 * @return
	 */
	public int queryAccountTotal(String accountCode, String accountName , Date from ,Date to , int isStarted )throws AccountException;
	/**
	 * <p>
	 *分页查询账户
	 * <p>
	 * 作者：Janet Feng <br>
	 * 日期：Dec 21, 2006
	 * @param beginIndex 记录开始索引值
	 * @param maxNumber 查询的记录总数
	 * @param accountCode 账户编码
	 * @param accountName 账户名称
	 * @param from 账户创建时间，开始
	 * @param to 账户创建时间，结束
	 * @return
	 * @throws AccountException
	 */
	public List<AccountEntity> queryAccountByPage( int beginIndex, int maxNumber ,String accountCode, String accountName , Date from ,Date to , int isStarted )throws AccountException;
	/**
	 * <p>
	 *改变账户状态
	 * <p>
	 * 作者：Janet Feng <br>
	 * 日期：Jan 6, 2007
	 * @param isStarted 是否启用
	 * @param accountIds 账户id
	 */
	public void changeAccountState ( Boolean isStarted , String...accountIds );
	/**
	 * <p>
	 * 批量删除账户
	 * <p>
	 * 作者：Janet Feng <br>
	 * 日期：Jan 6, 2007
	 * @param accountIds 账户Id
	 */
	public void batchDelete ( String...accountIds );
	
	/**
	 * <p>
	 *  修改账户代理商
	 * <p>
	 * 作者：msf <br>
	 * 日期：Feb 28, 2007
	 * @param agentCode 代理商编号
	 * @param accountID 账户id
	 */
	public void changeAgent(String agentCode,String accountID);
	/**
	 * <p>
	 *更新帐户名称
	 * <p>
	 * 作者：Jan <br>
	 * 日期：Mar 6, 2007
	 * @param accountName
	 */
	public void updateAccountName( String accountId ,String accountName );
	
	/**
	 * <p>
	 * 增加余额/减少余额
	 * <p>
	 * 作者：Chengjy <br>
	 * 日期：Oct 26, 2007
	 * @param boothid
	 * @param adjustType
	 * @param accountType
	 * @param sysid
	 * @param comment
	 * @param money
	 * @param user
	 */
	public void adjustAccount(Long boothid, int adjustType,int accountType, int sysid,String comment,BigDecimal money,UserInfo user) throws Exception;
	
	
}