/**
    * Copyright 2004-2013 The Kuali Foundation
    *
    * Licensed under the Educational Community License, Version 2.0 (the "License");
    * you may not use this file except in compliance with the License.
    * You may obtain a copy of the License at
    *
    * http://www.opensource.org/licenses/ecl2.php
    *
   * Unless required by applicable law or agreed to in writing, software
   * distributed under the License is distributed on an "AS IS" BASIS,
   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   * See the License for the specific language governing permissions and
   * limitations under the License.
   */
  package org.kuali.hr.time.principal.service;
  
  import java.util.Date;
  import java.util.List;
  import org.kuali.hr.time.principal.PrincipalHRAttributes;
  import org.springframework.cache.annotation.Cacheable;
  
  public interface PrincipalHRAttributesService {
  	/**
  	 * Fetch PrincipalCalendar object at a particular date
  	 * @param principalId
  	 * @param asOfDate
  	 * @return
  	 */
      @Cacheable(value= PrincipalHRAttributes.CACHE_NAME, key="'principalId=' + #p0 + '|' + 'asOfDate=' + #p1")
  	public PrincipalHRAttributes getPrincipalCalendar(String principalId, Date asOfDate);
  	
  	/**
  	 * Get a list of active employees based on pay calendar and as of a particular date 
  	 * @param payCalendarName
  	 * @param asOfDate
  	 * @return
  	 */
      @Cacheable(value= PrincipalHRAttributes.CACHE_NAME, key="'payCalendarName=' + #p0 + '|' + 'asOfDate=' + #p1")
      public List<PrincipalHRAttributes> getActiveEmployeesForPayCalendar(String payCalendarName, Date asOfDate);
      
  	/**
  	 * Get a list of active employees based on leave calendar and as of a particular date 
  	 * @param leaveCalendarName
  	 * @param asOfDate
  	 * @return
  	 */
      @Cacheable(value= PrincipalHRAttributes.CACHE_NAME, key="'leaveCalendarName=' + #p0 + '|' + 'asOfDate=' + #p1")
      public List<PrincipalHRAttributes> getActiveEmployeesForLeaveCalendar(String leaveCalendarName, Date asOfDate);
      
      /**
       * Get a list of unique principal ids that match given criteria, used by leave approval and leave request approval pages
       * @param leaveCalendarName
       * @param pidList
       * @param asOfDate
       * @return
       */
      @Cacheable(value= PrincipalHRAttributes.CACHE_NAME, key="'leaveCalendarName=' + #p0 + '|' + 'asOfDate=' + #p1")
      public List<String> getActiveEmployeesIdForLeaveCalendarAndIdList(String leaveCalendarName, List<String> pidList, Date asOfDate);
  	
      /**
       * Get a list of unique principal ids that match given criteria, used by Time approval pages
       * @param timeCalendarName
       * @param pidList
       * @param asOfDate
       * @return
       */
      @Cacheable(value= PrincipalHRAttributes.CACHE_NAME, key="'timeCalendarName=' + #p0 + '|' + 'asOfDate=' + #p1")
      public List<String> getActiveEmployeesIdForTimeCalendarAndIdList(String timeCalendarName, List<String> pidList, Date asOfDate);
      
      /**
  	 * KPME-1250 Kagata
  	 * Get a list of active employees based on leave plan and as of a particular date 
  	 * @param leavePlan
  	 * @param asOfDate
  	 * @return
  	 */
      @Cacheable(value= PrincipalHRAttributes.CACHE_NAME, key="'leavePlan=' + #p0 + '|' + 'asOfDate=' + #p1")
      public List<PrincipalHRAttributes> getActiveEmployeesForLeavePlan(String leavePlan, Date asOfDate);
      
  	/**
  	 * Fetch inactive PrincipalHRAttributes object at a particular date
  	 * @param principalId
  	 * @param asOfDate
  	 * @return
  	 */
      public PrincipalHRAttributes getInactivePrincipalHRAttributes(String principalId, Date asOfDate);
  	/**
  	 * Fetch PrincipalHRAttributes object with given id
  	 * @param hrPrincipalAttributeId
  	 * @return
  	 */
      public PrincipalHRAttributes getPrincipalHRAttributes(String hrPrincipalAttributeId);
      
      public List<PrincipalHRAttributes> getAllActivePrincipalHrAttributesForPrincipalId(String principalId, Date asOfDate);
      
      public List<PrincipalHRAttributes> getAllInActivePrincipalHrAttributesForPrincipalId(String principalId, Date asOfDate);
      
      public PrincipalHRAttributes getMaxTimeStampPrincipalHRAttributes(String principalId);
     
     /*
      * Fetch list of PrincipalHRAttributes that become active for given principalId and date range
      */
     public List<PrincipalHRAttributes> getActivePrincipalHrAttributesForRange(String principalId, Date startDate, Date endDate);
     /*
      * Fetch list of PrincipalHRAttributes that become inactive for given principalId and date range
      */
     public List<PrincipalHRAttributes> getInactivePrincipalHRAttributesForRange(String principalId, Date startDate, Date endDate);
     /**
      * Fetch list of PrincipalHRAttributes using given parameters
      *
      * @param principalId
      * @param leavePlan
      *@param fromEffdt
      * @param toEffdt
      * @param active
      * @param showHistory     @return
      */
     public List<PrincipalHRAttributes> getPrincipalHrAtributes(String principalId, String leavePlan, java.sql.Date fromEffdt, java.sql.Date toEffdt, String active, String showHistory);
     /**
      * Get List of all active pay calendars
      * @return
      */
     public List<String> getUniqueTimePayGroups();
 }