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 |