36 |
36 |
37 public interface IssueDao extends GenericDao<Issue> { |
37 public interface IssueDao extends GenericDao<Issue> { |
38 |
38 |
39 /** |
39 /** |
40 * Lists all issues for the specified project. |
40 * Lists all issues for the specified project. |
|
41 * This is not guaranteed to contain version information. |
|
42 * Use {@link #joinVersionInformation(Issue)} to obtain this information for a specific issue. |
41 * |
43 * |
42 * @param project the project |
44 * @param project the project |
43 * @return a list of issues |
45 * @return a list of issues |
44 * @throws SQLException on any kind of SQL error |
46 * @throws SQLException on any kind of SQL error |
45 */ |
47 */ |
46 List<Issue> list(Project project) throws SQLException; |
48 List<Issue> list(Project project) throws SQLException; |
|
49 |
|
50 /** |
|
51 * Saves an instances to the database. |
|
52 * Implementations of this DAO must guarantee that the generated ID is stored in the instance. |
|
53 * |
|
54 * @param instance the instance to insert |
|
55 * @throws SQLException on any kind of SQL error |
|
56 * @see Issue#setId(int) |
|
57 */ |
|
58 @Override |
|
59 void save(Issue instance) throws SQLException; |
|
60 |
|
61 /** |
|
62 * Retrieves the affected, scheduled and resolved versions for the specified issue. |
|
63 * |
|
64 * @param issue the issue to join the information for |
|
65 * @throws SQLException on any kind of SQL error |
|
66 */ |
|
67 void joinVersionInformation(Issue issue) throws SQLException; |
47 } |
68 } |