costcenterservice.java

来自「一个关于tlms的一个小程序 看看能否帮助到别人」· Java 代码 · 共 126 行

/**
 * =============================================
 * Copyright 2006 szmx
 *
 * Change Revision
 * --------------------------------
 *   Date          Author      Remarks
 *   2006-4-6      Allen.Zeng    com.szmx.tlms.finance.service.CostCenterService
 * =============================================
 */

package com.szmx.tlms.finance.service;

import com.szmx.tlms.finance.model.CostCenter;
import com.szmx.tlms.TlmsServiceException;
import com.szmx.framework.base.service.BaseService;
import com.szmx.framework.base.model.Pagination;

import java.util.Collection;
import java.util.List;

/**
 *
 * @author Allen.Zeng
 * @since 2006-4-6
 */

public interface CostCenterService extends BaseService {

    /**
     * This method saves a single cost center object.
     *
     * @param companySysId  company physical id
     * @param costCenter  cost center object
     * @throws TlmsServiceException
     */
    void saveCostCenter(String companySysId, CostCenter costCenter) throws TlmsServiceException;

    /**
     * This method saves cost center objects in batches.
     *
     * @param companySysId  company physical id
     * @param costCenters  collection of cost center objects
     * @throws TlmsServiceException
     */
    void saveCostCenter(String companySysId, Collection costCenters) throws TlmsServiceException;

    /**
     * This method updates a single cost center object.
     *
     * @param costCenter  cost center object
     * @throws TlmsServiceException
     */
    void updateCostCenter(CostCenter costCenter) throws TlmsServiceException;

    /**
     * This method updates cost center objects in batches.
     *
     * @param costCenters  collection of cost center objects
     * @throws TlmsServiceException
     */
    void updateCostCenter(Collection costCenters) throws TlmsServiceException;

    /**
     * This method removes a single cost center object.
     *
     * @param costCenter  cost center object
     * @throws TlmsServiceException
     */
    void removeCostCenter(CostCenter costCenter) throws TlmsServiceException;

    /**
     * This method removes cost center objets in batches.
     *
     * @param costCenters  collection of cost center objects
     * @throws TlmsServiceException
     */
    void removeCostCenter(Collection costCenters) throws TlmsServiceException;

    /**
     * This method removes cost center objects in batches through their ids.
     *
     * @param idArr  array of cost centers' ids
     * @throws TlmsServiceException
     */
    void removeCostCenter(final String[] idArr) throws TlmsServiceException;

    /**
     * This method gets a single cost center object through its id.
     *
     * @param id  cost center object id
     * @return  cost center object
     * @throws TlmsServiceException
     */
    CostCenter getCostCenter(final String id) throws TlmsServiceException;

    /**
     *
     * @param companySysId  company physical id
     * @param costCenter  cost center object
     * @return  list of cost center objects
     * @throws TlmsServiceException
     */
    List searchCostCenter(String companySysId, CostCenter costCenter) throws TlmsServiceException;

    /**
     * This method completes user search function.
     *
     * @param companySysId  company physical id
     * @param costCenter  cost center object that includs query condtion value
     * @param pagination  pagination object for paging
     * @return  pagination object
     * @throws TlmsServiceException
     */
    Pagination searchCostCenter(String companySysId, CostCenter costCenter, Pagination pagination) throws TlmsServiceException;

    /**
     * This method translates sap account starting with 6 or 7 to local account via cost center.
     *
     * @param sapAccount  sap account number
     * @param costCenterCode  cost center number
     * @return  local account number
     */
    String generateLocalAccount(String companySysId, String costCenterCode, String sapAccount) throws TlmsServiceException;
}