001    /**
002     * Copyright 2004-2012 The Kuali Foundation
003     *
004     * Licensed under the Educational Community License, Version 2.0 (the "License");
005     * you may not use this file except in compliance with the License.
006     * You may obtain a copy of the License at
007     *
008     * http://www.opensource.org/licenses/ecl2.php
009     *
010     * Unless required by applicable law or agreed to in writing, software
011     * distributed under the License is distributed on an "AS IS" BASIS,
012     * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
013     * See the License for the specific language governing permissions and
014     * limitations under the License.
015     */
016    package org.kuali.hr.time.clock.location.dao;
017    
018    import java.sql.Date;
019    import java.util.List;
020    
021    import org.kuali.hr.time.clock.location.ClockLocationRule;
022    
023    public interface ClockLocationDao {
024            /**
025             * Get Clock location rule based on passed in criteria
026             * @param dept
027             * @param workArea
028             * @param principalId
029             * @param jobNumber
030             * @param asOfDate
031             * @return
032             */
033            public List<ClockLocationRule> getClockLocationRule(String dept, Long workArea, String principalId, 
034                                                                                                            Long jobNumber, Date asOfDate);
035            /**
036             * Get list of clock location rules based on criteria
037             * @param dept
038             * @param workArea
039             * @param principalId
040             * @param jobNumber
041             * @param asOfDate
042             * @return
043             */
044            public List<ClockLocationRule> getNewerVersionClockLocationRule(String dept, Long workArea, String principalId, 
045                            Long jobNumber, Date asOfDate);
046            /**
047             * Get Clock Location Rule based on id
048             * @param tkClockLocationRuleId
049             * @return
050             */
051            public ClockLocationRule getClockLocationRule(String tkClockLocationRuleId);
052            /**
053             * populate ip addresses for given ClockLocationRule
054             * @param ClockLocationRule
055             * @return
056             */
057            public void populateIPAddressesForCLR(ClockLocationRule clr);
058    }