1 package org.kuali.coeus.propdev.api.questionnaire;
2
3
4 import org.kuali.coeus.common.questionnaire.api.answer.AnswerContract;
5 import org.kuali.coeus.common.questionnaire.api.answer.AnswerHeaderContract;
6
7 import java.util.List;
8
9 public interface PropDevQuestionAnswerService {
10
11 /**
12 * Gets a list of Answers from a proposal number, namespace, and form name. If none are found then an empty list is
13 * returned. The proposal number, namespace, and form name cannot be blank.
14 *
15 * @param proposalNumber the proposal number. cannot be blank.
16 * @param namespace the namespace. cannot be blank.
17 * @param formName the form name. cannot be blank.
18 * @return a list of answers or an empty list
19 * @throws java.lang.IllegalArgumentException proposal number, namespace, or form name is blank
20 */
21 List<? extends AnswerContract> getQuestionnaireAnswers(String proposalNumber, String namespace, String formName);
22
23 /**
24 * Gets a list of Answer Headers from a proposal number, namespace, and form name. If none are found then an empty list is
25 * returned. The proposal number, namespace, and form name cannot be blank.
26 *
27 * @param proposalNumber the proposal number. cannot be blank.
28 * @param namespace the namespace. cannot be blank.
29 * @param formName the form name. cannot be blank.
30 * @return a list of answer headers or an empty list
31 * @throws java.lang.IllegalArgumentException proposal number, namespace, or form name is blank
32 */
33 List<? extends AnswerHeaderContract> getQuestionnaireAnswerHeaders(String proposalNumber, String namespace, String formName);
34
35 /**
36 * Gets a list of Answer Headers from a proposal number. If none are found then an empty list is
37 * returned. The proposal number cannot be blank.
38 *
39 * @param proposalNumber the proposal number. cannot be blank.
40 * @return a list of answer headers or an empty list
41 * @throws java.lang.IllegalArgumentException proposal number is blank
42 */
43 List<? extends AnswerHeaderContract> getQuestionnaireAnswerHeaders(String proposalNumber);
44 }