1 //----------------------------------------------------------------------
2 //
3 // PerfectJPattern: "Design patterns are good but components are better!"
4 // IPersonDao.java Copyright (c) 2009 Giovanni Azua Garcia
5 // bravegag@hotmail.com
6 //
7 // This program is free software; you can redistribute it and/or
8 // modify it under the terms of the GNU General Public License
9 // as published by the Free Software Foundation; either version 3
10 // of the License, or (at your option) any later version.
11 //
12 // This program is distributed in the hope that it will be useful,
13 // but WITHOUT ANY WARRANTY; without even the implied warranty of
14 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 // GNU General Public License for more details.
16 //
17 // You should have received a copy of the GNU General Public License
18 // along with this program; if not, see <http://www.gnu.org/licenses/>.
19 //
20 //----------------------------------------------------------------------
21 package org.perfectjpattern.jee.api.integration.dao;
22
23 import java.util.*;
24
25 import org.perfectjpattern.example.datamodel.*;
26
27 /**
28 * Abstract definition of the Person DAO
29 *
30 * @author <a href="mailto:bravegag@hotmail.com">Giovanni Azua</a>
31 * @version $ $Date: Nov 6, 2008 2:11:46 PM $
32 */
33 public
34 interface IPersonDao
35 extends IGenericDao<Long, Person>
36 {
37 //------------------------------------------------------------------------
38 // public
39 //------------------------------------------------------------------------
40 /**
41 * Returns the List of matching {@link Person} instances. Finds person
42 * instances by name
43 *
44 * @param aName the name of the person to search for
45 * @return List of matching {@link Person} instances
46 */
47 @QueryParameters(names = "Name")
48 public List<Person>
49 findByName(String aName);
50
51 //------------------------------------------------------------------------
52 /**
53 * Returns the List of matching {@link Person} instances. Finds person
54 * instances by age
55 *
56 * @param anAge the age of the person to search for
57 * @return List of matching {@link Person} instances
58 */
59 @QueryParameters(names = "Age")
60 public List<Person>
61 findByAge(int anAge);
62 }