src/main/java/de/uapcore/lightpit/dao/IssueDao.java

changeset 134
f47e82cd6077
parent 128
947d0f6a6a83
child 150
822b7e3d064d
equal deleted inserted replaced
133:ef075cd7ce55 134:f47e82cd6077
26 * POSSIBILITY OF SUCH DAMAGE. 26 * POSSIBILITY OF SUCH DAMAGE.
27 * 27 *
28 */ 28 */
29 package de.uapcore.lightpit.dao; 29 package de.uapcore.lightpit.dao;
30 30
31 import de.uapcore.lightpit.entities.Issue; 31 import de.uapcore.lightpit.entities.*;
32 import de.uapcore.lightpit.entities.IssueComment;
33 import de.uapcore.lightpit.entities.Project;
34 import de.uapcore.lightpit.entities.Version;
35 32
36 import java.sql.SQLException; 33 import java.sql.SQLException;
37 import java.util.List; 34 import java.util.List;
38 35
39 public interface IssueDao extends ChildEntityDao<Issue, Project> { 36 public interface IssueDao extends ChildEntityDao<Issue, Project> {
40 37
41 /** 38 /**
42 * Lists all issues that are somehow related to the specified version. 39 * Lists all issues that are related to the specified component and version.
43 * If version is null, search for issues that are not related to any version. 40 * If component or version is null, search for issues that are not assigned to any
41 * component or version, respectively.
44 * 42 *
43 * @param project the project
44 * @param component the component or null
45 * @param version the version or null 45 * @param version the version or null
46 * @return a list of issues 46 * @return a list of issues
47 * @throws SQLException on any kind of SQL error 47 * @throws SQLException on any kind of SQL error
48 */ 48 */
49 List<Issue> list(Version version) throws SQLException; 49 List<Issue> list(Project project, Component component, Version version) throws SQLException;
50
51 /**
52 * Lists all issues that are related to the specified version.
53 * If the version is null, lists issues that are not assigned to any version.
54 *
55 * @param project the project (mandatory)
56 * @param version the version or null
57 * @return a list of issues
58 * @throws SQLException on any kind of SQL error
59 */
60 List<Issue> list(Project project, Version version) throws SQLException;
61
62 /**
63 * Lists all issues that are related to the specified component.
64 * If the component is null, lists issues that are not assigned to a component.
65 *
66 * @param project the project (mandatory)
67 * @param component the component or null
68 * @return a list of issues
69 * @throws SQLException on any kind of SQL error
70 */
71 List<Issue> list(Project project, Component component) throws SQLException;
50 72
51 /** 73 /**
52 * Lists all comments for a specific issue in chronological order. 74 * Lists all comments for a specific issue in chronological order.
53 * 75 *
54 * @param issue the issue 76 * @param issue the issue

mercurial