From 3d8be17bd9463cfc008e6680271a5ce85833836e Mon Sep 17 00:00:00 2001 From: panuozzo77 Date: Tue, 9 Jan 2024 18:30:51 +0100 Subject: [PATCH] provided javadoc for ConditionManager and ExerciseManager --- .../service/condition/ConditionInterface.java | 31 +++++++++ .../service/condition/ConditionManager.java | 5 -- .../exercise/ExerciseManagerInterface.java | 66 ++++++++++++++----- 3 files changed, 80 insertions(+), 22 deletions(-) diff --git a/src/main/java/model/service/condition/ConditionInterface.java b/src/main/java/model/service/condition/ConditionInterface.java index 3c516e3..f280edf 100644 --- a/src/main/java/model/service/condition/ConditionInterface.java +++ b/src/main/java/model/service/condition/ConditionInterface.java @@ -5,8 +5,39 @@ import java.util.ArrayList; public interface ConditionInterface { + + /** + * Restituisce le condizioni che sono state associate al paziente. + * + * @param id_patient l'ID del paziente + * @return un ArrayList of Condition + */ ArrayList getConditionsOfPatient(int id_patient); + + /** + * Restituisce le condizioni che non sono state associate al paziente. + * + * @param id_patient l'ID del paziente + * @return un ArrayList di Condition objects + */ ArrayList getConditionsNOTOfPatient(int id_patient); + + /** + * Rimuove una condizione dal paziente selezionato. + * + * @param ID_condition l'ID della condizione del paziente da aggiungere + * @param ID_patient l'ID del paziente + * @param Severity il livello di gravità della condizione + * @return true if se è correttamente aggiunta, false altrimenti + */ boolean AddConditionPatient(int ID_condition, int ID_patient, int Severity); + + /** + * Rimuove una condizione dal paziente selezionato. + * + * @param ID_condition l'ID della condizione del paziente da rimuoverere + * @param ID_patient l'ID del paziente dal quale rimuoverla + * @return true se è correttamente rimossa, false altrimenti + */ boolean RemoveConditionPatient(int ID_condition, int ID_patient); } diff --git a/src/main/java/model/service/condition/ConditionManager.java b/src/main/java/model/service/condition/ConditionManager.java index aeaf5ca..82588ab 100644 --- a/src/main/java/model/service/condition/ConditionManager.java +++ b/src/main/java/model/service/condition/ConditionManager.java @@ -5,14 +5,9 @@ import java.util.ArrayList; public class ConditionManager implements ConditionInterface { - DAOCondition c=new DAOCondition(); - public ArrayList getConditionsOfPatient(int id_patient) { return c.getConditionsOfPatient(id_patient);} - public ArrayList getConditionsNOTOfPatient(int id_patient) { return c.getConditionsNOTOfPatient(id_patient);} - public boolean AddConditionPatient(int ID_condition, int ID_patient, int Severity) {return c.AddConditionPatient(ID_condition, ID_patient,Severity);} - public boolean RemoveConditionPatient(int ID_condition, int ID_patient) {return c.RemoveConditionPatient(ID_condition,ID_patient);} } diff --git a/src/main/java/model/service/exercise/ExerciseManagerInterface.java b/src/main/java/model/service/exercise/ExerciseManagerInterface.java index 243030e..6d3ad23 100644 --- a/src/main/java/model/service/exercise/ExerciseManagerInterface.java +++ b/src/main/java/model/service/exercise/ExerciseManagerInterface.java @@ -1,36 +1,68 @@ package model.service.exercise; +import model.entity.Exercise; import model.entity.ExerciseGlossary; +import model.entity.SlimmerExercise; import java.sql.Blob; import java.sql.Date; +import java.util.List; public interface ExerciseManagerInterface { /** - * Preleva un esercizio dal Database - * @param exerciseID l'id dell'esercizio - * @return l'oggetto esercizio + * Recupera i dettagli dell'esecuzione per un esercizio specifico, un utente e una data di inserimento. + * + * @param exerciseID L'ID dell'esercizio. + * @param userID L'ID dell'utente. + * @param insertionDate La data di inserimento. + * @return Un Blob che rappresenta l'esecuzione dell'esercizio, o null se non trovato. + */ + public Blob getExecution(int exerciseID, int userID, Date insertionDate); + + /** + * Salva i dettagli dell'esecuzione per un utente specifico, un esercizio e una data di inserimento. + * + * @param userID L'ID dell'utente. + * @param exerciseId L'ID dell'esercizio. + * @param insertDate La data di inserimento. + * @param execution Il Blob che rappresenta l'esecuzione dell'esercizio. + * @return true se l'esecuzione viene salvata con successo, false altrimenti. + */ + public boolean saveExecution(int userID, int exerciseId, Date insertDate, Blob execution); + + /** + * Salva i dettagli della valutazione per un utente specifico, un esercizio e una data di inserimento. + * + * @param userID L'ID dell'utente. + * @param exerciseId L'ID dell'esercizio. + * @param insertDate La data di inserimento. + * @param evaluation Il punteggio della valutazione. + * @return true se la valutazione viene salvata con successo, false altrimenti. */ - ExerciseGlossary getExercise(int exerciseID); + public boolean saveEvaluation(int userID, int exerciseId, Date insertDate, int evaluation); /** - * Preleva un'esecuzione di un esercizio - * @param exerciseID l'id dell'esercizio - * @param userID l'id dell'utente che ha svolto l'esercizio - * @param insertionDate la data in cui l'esercizio è stata assegnata all'utente - * @return un BLOB contenente l'esecuzione dell'esercizio + * Recupera una lista di tutti gli esercizi fatti da un paziente specifico. + * + * @param userID L'ID del paziente. + * @return Una lista di oggetti Exercise che rappresentano gli esercizi fatti dal paziente. + */ + public List retrieveAllPatientExerciseDone(int userID); + + /** + * Recupera una lista di esercizi che un paziente ha già fatto. + * + * @param patientId L'ID del paziente. + * @return Una lista di oggetti SlimmerExercise che rappresentano gli esercizi fatti dal paziente. */ - Blob getExecution(int exerciseID, int userID, Date insertionDate); + public List retrieveDoneExercises(int patientId); /** - * Salva l'esecuzione di un esercizio + * Recupera una lista di esercizi che un paziente non ha ancora fatto. * - * @param userID l'id dell'utente che ha eseguito l'esercizio - * @param exerciseId l'id dell'esercizio eseguito - * @param insertDate la data in cui l'esercizio è stato assegnato all'utente - * @param execution l'esecuzione dell'esercizio - * @return True se riesce a salvarla, false altrimenti + * @param patientId L'ID del paziente. + * @return Una lista di oggetti SlimmerExercise che rappresentano gli esercizi non fatti dal paziente. */ - boolean saveExecution(int userID, int exerciseId, Date insertDate, Blob execution); + public List retrieveNotDoneExercises(int patientId); }