Project

General

Profile

Download (3.76 KB) Statistics
| Branch: | Tag: | Revision:
1
/**
2
* Copyright (C) 2017 EDIT
3
* European Distributed Institute of Taxonomy
4
* http://www.e-taxonomy.eu
5
*
6
* The contents of this file are subject to the Mozilla Public License Version 1.1
7
* See LICENSE.TXT at the top of this package for the full license terms.
8
*/
9
package eu.etaxonomy.cdm.persistence.dao.name;
10

    
11
import java.util.Collection;
12
import java.util.List;
13
import java.util.Optional;
14
import java.util.UUID;
15

    
16
import eu.etaxonomy.cdm.model.name.Registration;
17
import eu.etaxonomy.cdm.model.name.RegistrationStatus;
18
import eu.etaxonomy.cdm.model.reference.Reference;
19
import eu.etaxonomy.cdm.persistence.dao.common.IAnnotatableDao;
20
import eu.etaxonomy.cdm.persistence.query.OrderHint;
21

    
22
/**
23
 * @author a.kohlbecker
24
 * @since May 2, 2017
25
 *
26
 */
27
public interface IRegistrationDao
28
            extends IAnnotatableDao<Registration> {
29

    
30

    
31
    /**
32
     * Returns a sublist of Registration instances stored in the database. A maximum
33
     * of 'limit' objects are returned, starting at object with index 'start'.
34
     * The bean properties specified by the parameter <code>propertyPaths</code>
35
     * and recursively initialized for each of the entities in the resultset
36
     *
37
     * For detailed description and examples regarding
38
     * <code>propertyPaths</code> <b>please refer to:</b>
39
     * {@link IBeanInitializer#initialize(Object, List)}
40
     *
41
     * @param reference
42
     *            filters the Registration by the reference of the nomenclatural act
43
     *            for which the Registration has been created.
44
     *            The name and all type designations associated with the Registration
45
     *            are sharing the same  reference.
46
     *            If <code>null</code> all registrations with a name or type designation
47
     *            that has no reference are returned. Also those registrations
48
     *            having no name and type designation at all.
49
     * @param includedStatus
50
     * @param limit
51
     *            the maximum number of entities returned (can be <code>null</code>
52
     *            to return all entities)
53
     * @param start
54
     * @param propertyPaths
55
     * @return
56
     * @throws DataAccessException
57
     */
58
    public List<Registration> list(Optional<Reference> reference, Collection<RegistrationStatus> includedStatus,
59
            Integer limit, Integer start, List<String> propertyPaths);
60

    
61
    /**
62
     * Counts the Registration instances stored in the database.
63
     *
64
     * For detailed description see the according list method
65
     * {@link #list(Optional, Collection, Integer, Integer, List)}}
66
     *
67
     * @return
68
     */
69
    public Long count(Optional<Reference> reference, Collection<RegistrationStatus> includedStatus);
70

    
71
    /**
72
     * @param submitterUuid
73
     * @param includedStatus
74
     * @param identifierFilterPattern
75
     * @param taxonNameFilterPattern
76
     * @param typeDesignationStatusUuids
77
     * @return
78
     */
79
    public long count(UUID submitterUuid, Collection<RegistrationStatus> includedStatus, String identifierFilterPattern,
80
            String taxonNameFilterPattern, String referenceFilterPattern, Collection<UUID> typeDesignationStatusUuids);
81

    
82

    
83
    public List<Registration> list(UUID submitterUuid, Collection<RegistrationStatus> includedStatus, String identifierFilterPattern,
84
            String taxonNameFilterPattern, String referenceFilterPattern, Collection<UUID> typeDesignationStatusUuids,
85
            Integer limit, Integer start, List<OrderHint> orderHints, List<String> propertyPaths);
86

    
87

    
88
    public List<Registration> list(UUID submitterUuid, Collection<RegistrationStatus> includedStatus, Collection<UUID> taxonNameUUIDs,
89
            Integer limit, Integer start, List<OrderHint> orderHints, List<String> propertyPaths);
90

    
91
    public long count(UUID submitterUuid, Collection<RegistrationStatus> includedStatus, Collection<UUID> taxonNameUUIDs);
92

    
93
}
(3-3/5)