01: /*
02: * Copyright 2005-2006 The Kuali Foundation.
03: *
04: * Licensed under the Educational Community License, Version 1.0 (the "License");
05: * you may not use this file except in compliance with the License.
06: * You may obtain a copy of the License at
07: *
08: * http://www.opensource.org/licenses/ecl1.php
09: *
10: * Unless required by applicable law or agreed to in writing, software
11: * distributed under the License is distributed on an "AS IS" BASIS,
12: * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13: * See the License for the specific language governing permissions and
14: * limitations under the License.
15: */
16: package org.kuali.module.gl.dao;
17:
18: import java.sql.Date;
19: import java.util.Collection;
20:
21: import org.kuali.module.gl.bo.UniversityDate;
22:
23: /**
24: * An DAO interface declaring methods needed by UniversityDates to interact with the database
25: */
26: public interface UniversityDateDao {
27: /**
28: * Returns a university date record based on a given java.sql.Date
29: *
30: * @param date a Date to find the corresponding University Date record
31: * @return a University Date record if found, null if not
32: */
33: public UniversityDate getByPrimaryKey(Date date);
34:
35: /**
36: * Returns a university date record based on java.util.Date
37: *
38: * @param date a java.util.Date to find the corresponding University Date record
39: * @return a University Date record if found, null if not
40: */
41: public UniversityDate getByPrimaryKey(java.util.Date date);
42:
43: /**
44: * Returns the last university date for a given fiscal year
45: *
46: * @param fiscalYear the fiscal year to find the last date for
47: * @return a UniversityDate record for the last day in the given fiscal year, or null if nothing can be found
48: */
49: public UniversityDate getLastFiscalYearDate(Integer fiscalYear);
50:
51: /**
52: * Returns the first university date for a given fiscal year
53: *
54: * @param fiscalYear the fiscal year to find the first date for
55: * @return a UniversityDate record for the first day of the given fiscal year, or null if nothing can be found
56: */
57: public UniversityDate getFirstFiscalYearDate(Integer fiscalYear);
58:
59: /**
60: * Returns all distinct accounting period codes from the table
61: *
62: * @return a Collection of all distinct accounting period codes represented by UniversityDate records in the database
63: */
64: public Collection getAccountingPeriodCode();
65: }
|