webservice.java

本系统可初步满足超市的收支管理

package org.yeeku.service;
import java.util.*;
import org.yeeku.exception.*;

/**
 * @author  yeeku.H.lee [e-mail]
 * @version  1.0
 * <br>Copyright (C), 2005-2008, yeeku.H.Lee
 * <br>This program is protected by copyright laws.
 * <br>Program Name:
 * <br>Date: 
 */
public interface WebService 
{
	/**
	 * 新增一个供货商
	 * @param vendorName 供货商名字
	 * @param vendorAddress 供货商地址
	 * @param vendorPhone 供货商电话
	 * @param vendorFax 供货商传真
	 * @param vendorContentPerson 供货商联系人
	 * @return 创建是否成功
	 */
	boolean createVendor(String vendorName , String vendorAddress , String vendorPhone , String vendorFax ,
		String vendorContactPerson)throws WEBException;

	/**
	 * 根据分页列出所有供货商
	 * @param page 页码
	 * @return 指定页的所有供货商
	 */
	Collection showVendor(int page)throws WEBException;

	/**
	 * 修改供货商
	 * @param vendorId 供货商id
	 * @param vendorName 供货商名字
	 * @param vendorAddress 供货商地址
	 * @param vendorPhone 供货商电话
	 * @param vendorFax 供货商传真
	 * @param vendorContentPerson 供货商联系人
	 * @return 修改是否成功
	 */
	boolean updateVendor(Integer vendorId , String vendorName , String vendorAddress , String vendorPhone , String vendorFax ,
		String vendorContactPerson)throws WEBException;

	/**
	 * 根据ID查询供货商
	 * @param id 供货商id
	 * @return 该id对应的供货商组成的集合
	 */
	Collection showVendorId(Integer id)throws WEBException;

	/**
	 * 获取所有供货商
	 * @return 返回系统的全部供货商
	 */
	Collection showVendor()throws WEBException;

	/**
	 * 新增一个部门
	 * @param deptName 部门名
	 * @param description 部门描述
	 * @return 创建部门是否成功
	 */
	boolean createDept(String deptName , String description)throws WEBException;

	/**
	 * 根据分页列出所有部门
	 * @param page 页码
	 * @return 指定页的所有部门
	 */
	Collection showDept(int page)throws WEBException;

	/**
	 * 修改部门
	 * @param deptId 部门id
	 * @param deptName 部门名
	 * @param description 部门描述
	 * @return 修改部门是否成功
	 */
	boolean updateDept(Integer deptId , String deptName , String description)throws WEBException;

	/**
	 * 根据ID查询部门
	 * @param id 部门id
	 * @return 指定ID对应部门组成的集合
	 */
	Collection showDeptId(Integer id)throws WEBException;

	/**
	 * 显示所有部门
	 * @return 系统中的所有部门
	 */
	Collection showDept()throws WEBException;

	/**
	 * 增加一笔收入
	 * @param daily 收入数量
	 * @param businessDate 业务日期
	 * @param lstModTimestamp 最后修改时间
	 * @param deptName 部门名
	 * @return 增加收入是否成功
	 */
	boolean createIncome(Integer daily , String businessDate , String lstModTimestamp , String deptName)throws WEBException;

	/**
	 * 根据分页列出所有收入
	 * @param page 页码
	 * @return 指定页的所有收入
	 */
	Collection showIncome(int page)throws WEBException;

	/**
	 * 修改收入
	 * @param incomeId 收入id
	 * @param daily 收入数量
	 * @param lstModTimestamp 最后修改时间
	 * @return 修改收入是否成功
	 */
	boolean updateIncome(Integer incomeId , Integer daily ,String lstModTimestamp )throws WEBException;

	/**
	 * 根据ID查询收入
	 * @param id 收入id
	 * @return 指定ID对应收入组成的集合
	 */
	Collection showIncomeId(Integer id)throws WEBException;

	/**
	 * 登录系统
	 * @param username 登录系统所用的用户名
	 * @param password 登录系统所用的密码
	 * @return 登录是否成功
	 */
	boolean login(String username , String password)throws WEBException;

	/**
	 * 增加一个帐单
	 * @param billDate 帐单日期
	 * @param billDueDate 帐单到期日期
	 * @param vendor 帐单对应的供货商
	 * @return 增加帐单是否成功
	 */
	boolean createBill(String billDate , String billDueDate , String vendor)throws WEBException;

	/**
	 * 根据供货商查询帐单
	 * @param vendor 供货商
	 * @return 该供货商对应的帐单
	 */
	Collection showBillPayment(int page , String vendor)throws WEBException;

	/**
	 * 修改一个帐单
	 * @param id 帐单ID
	 * @return 修改帐单是否成功
	 */
	boolean billUpdate(Integer id)throws WEBException;

	Collection showBillAddDepItem()throws WEBException;

}