1.1 --- a/src/main/java/de/uapcore/lightpit/dao/IssueDao.java Fri Nov 06 10:50:32 2020 +0100
1.2 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000
1.3 @@ -1,111 +0,0 @@
1.4 -/*
1.5 - * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
1.6 - *
1.7 - * Copyright 2018 Mike Becker. All rights reserved.
1.8 - *
1.9 - * Redistribution and use in source and binary forms, with or without
1.10 - * modification, are permitted provided that the following conditions are met:
1.11 - *
1.12 - * 1. Redistributions of source code must retain the above copyright
1.13 - * notice, this list of conditions and the following disclaimer.
1.14 - *
1.15 - * 2. Redistributions in binary form must reproduce the above copyright
1.16 - * notice, this list of conditions and the following disclaimer in the
1.17 - * documentation and/or other materials provided with the distribution.
1.18 - *
1.19 - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
1.20 - * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
1.21 - * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
1.22 - * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
1.23 - * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
1.24 - * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
1.25 - * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
1.26 - * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
1.27 - * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
1.28 - * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
1.29 - * POSSIBILITY OF SUCH DAMAGE.
1.30 - *
1.31 - */
1.32 -package de.uapcore.lightpit.dao;
1.33 -
1.34 -import de.uapcore.lightpit.entities.*;
1.35 -
1.36 -import java.sql.SQLException;
1.37 -import java.util.List;
1.38 -
1.39 -public interface IssueDao extends ChildEntityDao<Issue, Project> {
1.40 -
1.41 - /**
1.42 - * Lists all issues that are related to the specified component and version.
1.43 - * If component or version is null, search for issues that are not assigned to any
1.44 - * component or version, respectively.
1.45 - *
1.46 - * @param project the project
1.47 - * @param component the component or null
1.48 - * @param version the version or null
1.49 - * @return a list of issues
1.50 - * @throws SQLException on any kind of SQL error
1.51 - */
1.52 - List<Issue> list(Project project, Component component, Version version) throws SQLException;
1.53 -
1.54 - /**
1.55 - * Lists all issues that are related to the specified version.
1.56 - * If the version is null, lists issues that are not assigned to any version.
1.57 - *
1.58 - * @param project the project (mandatory)
1.59 - * @param version the version or null
1.60 - * @return a list of issues
1.61 - * @throws SQLException on any kind of SQL error
1.62 - */
1.63 - List<Issue> list(Project project, Version version) throws SQLException;
1.64 -
1.65 - /**
1.66 - * Lists all issues that are related to the specified component.
1.67 - * If the component is null, lists issues that are not assigned to a component.
1.68 - *
1.69 - * @param project the project (mandatory)
1.70 - * @param component the component or null
1.71 - * @return a list of issues
1.72 - * @throws SQLException on any kind of SQL error
1.73 - */
1.74 - List<Issue> list(Project project, Component component) throws SQLException;
1.75 -
1.76 - /**
1.77 - * Lists all comments for a specific issue in chronological order.
1.78 - *
1.79 - * @param issue the issue
1.80 - * @return the list of comments
1.81 - * @throws SQLException on any kind of SQL error
1.82 - */
1.83 - List<IssueComment> listComments(Issue issue) throws SQLException;
1.84 -
1.85 - /**
1.86 - * Stores the specified comment in database.
1.87 - * This is an update-or-insert operation.
1.88 - *
1.89 - * @param issue the issue to save the comment for
1.90 - * @param comment the comment to save
1.91 - * @throws SQLException on any kind of SQL error
1.92 - */
1.93 - void saveComment(Issue issue, IssueComment comment) throws SQLException;
1.94 -
1.95 - /**
1.96 - * Saves an instances to the database.
1.97 - * Implementations of this DAO must guarantee that the generated ID is stored in the instance.
1.98 - *
1.99 - * @param instance the instance to insert
1.100 - * @param project the parent project
1.101 - * @throws SQLException on any kind of SQL error
1.102 - * @see Issue#setId(int)
1.103 - */
1.104 - @Override
1.105 - void save(Issue instance, Project project) throws SQLException;
1.106 -
1.107 - /**
1.108 - * Retrieves the affected, scheduled and resolved versions for the specified issue.
1.109 - *
1.110 - * @param issue the issue to join the information for
1.111 - * @throws SQLException on any kind of SQL error
1.112 - */
1.113 - void joinVersionInformation(Issue issue) throws SQLException;
1.114 -}
