doc: Création du Readme

README.md

@@ -0,0 +1,7 @@
+# My API
+
+Une API personnelle généraliste permettant d'interroger une BDD self-hosted. Elle sera utilisée à terme par plusieurs applications différentes, dont Do It Earlier, une application de calendrier ou un tracker de films/séries/... .
+
+# Stack
+
+API réalisée en Sprinboot 4.1.1 interrogeant une base de données PostgreSQL.

src/main/java/myapi/api/Controller/ProjectController.java

@@ -0,0 +1,65 @@
+package myapi.api.Controller;
+
+import java.util.List;
+import myapi.api.Model.Project;
+import myapi.api.Service.Interfaces.ProjectService;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.web.bind.annotation.CrossOrigin;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+/**
+ * Classe servant de point d'entrée pour les objets {@link Project}
+ */
+@RestController
+@RequestMapping("/project")
+@CrossOrigin
+public class ProjectController {
+
+    @Autowired
+    private ProjectService projectService;
+
+    /**
+     * Récupère tous les projets de la bdd
+     * @return Une liste de Project
+     */
+    @GetMapping
+    public List<Project> getAllProjects() {
+        return projectService.getAllProjects();
+    }
+
+    /**
+     * Ajoute un projet à la bdd
+     * @param project Le projet à ajouter
+     * @return Le projet ajouté
+     */
+    @PostMapping("/add")
+    public Project addProject(@RequestBody Project project) {
+        return projectService.addProject(project);
+    }
+
+    /**
+     * Modifie un projet de la bdd
+     * @param project Le projet que l'on veut modifier. Il faut que son id soit déjà présent
+     * @return Le projet créé
+     */
+    @PutMapping("/update")
+    public Project updateProject(@RequestBody Project project) {
+        return projectService.updateProject(project);
+    }
+
+    /**
+     *  Supprime un projet de la bdd à partir de son identifiant
+     * @param idProject L'identifiant du projet à supprimer
+     */
+    @DeleteMapping("/delete")
+    public void deleteProject(@RequestParam("id") int idProject) {
+        projectService.deleteProject(idProject);
+    }
+}

src/main/java/myapi/api/Controller/TaskController.java

@@ -5,9 +5,9 @@ import myapi.api.Model.Task;
 import myapi.api.Service.Interfaces.TaskService;
 
 import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.web.bind.annotation.CrossOrigin;
 import org.springframework.web.bind.annotation.DeleteMapping;
 import org.springframework.web.bind.annotation.GetMapping;
-import org.springframework.web.bind.annotation.PathVariable;
 import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.PutMapping;
 import org.springframework.web.bind.annotation.RequestBody;
@@ -20,6 +20,7 @@ import org.springframework.web.bind.annotation.RestController;
  */
 @RestController
 @RequestMapping("/task")
+@CrossOrigin 
 public class TaskController {
 
     @Autowired

src/main/java/myapi/api/Controller/TaskGroupController.java

@@ -4,6 +4,7 @@ import java.util.List;
 import myapi.api.Model.TaskGroup;
 import myapi.api.Service.Interfaces.TaskGroupService;
 import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.web.bind.annotation.CrossOrigin;
 import org.springframework.web.bind.annotation.DeleteMapping;
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.PostMapping;
@@ -18,6 +19,7 @@ import org.springframework.web.bind.annotation.RestController;
  */
 @RestController
 @RequestMapping("/group")
+@CrossOrigin
 public class TaskGroupController {
 
     @Autowired

src/main/java/myapi/api/Model/Project.java

@@ -0,0 +1,40 @@
+package myapi.api.Model;
+
+import jakarta.persistence.Entity;
+import jakarta.persistence.GeneratedValue;
+import jakarta.persistence.GenerationType;
+import jakarta.persistence.Id;
+import org.hibernate.annotations.Audited.Table;
+
+/**
+ * Classe mappée à la table project de la bdd
+ * Project
+ */
+@Entity
+@Table(name = "project")
+public class Project {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private int id_project;
+
+    private String name_project;
+
+    /* --- GETTERS ET SETTERS --- */
+
+    public int getId_project() {
+        return id_project;
+    }
+
+    public void setId_project(int id_project) {
+        this.id_project = id_project;
+    }
+
+    public String getName_project() {
+        return name_project;
+    }
+
+    public void setName_project(String name_project) {
+        this.name_project = name_project;
+    }
+}

src/main/java/myapi/api/Repository/ProjectRepository.java

@@ -0,0 +1,12 @@
+package myapi.api.Repository;
+
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+
+import myapi.api.Model.Project;
+
+/**
+ * Repository Jpa permettant la persistance
+ */
+@Repository
+public interface ProjectRepository extends JpaRepository<Project, Integer> {}

src/main/java/myapi/api/Service/Implementations/ProjectServiceImpl.java

@@ -0,0 +1,53 @@
+package myapi.api.Service.Implementations;
+
+import java.util.List;
+import myapi.api.Model.Project;
+import myapi.api.Repository.ProjectRepository;
+import myapi.api.Service.Interfaces.ProjectService;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.stereotype.Service;
+
+@Service 
+public class ProjectServiceImpl implements ProjectService {
+
+    @Autowired
+    private ProjectRepository projectRepository;
+
+    /**    (non-Javadoc)
+     * @see myapi.api.Service.Interfaces.ProjectService#getAllProjects()
+     */
+    @Override
+    public List<Project> getAllProjects() {
+        return projectRepository.findAll();
+    }
+
+    /**    (non-Javadoc)
+     *
+     * @see myapi.api.Service.Interfaces.ProjectService#addProject(myapi.api.Model.Project)
+     */
+    @Override
+    public Project addProject(Project project) {
+        return projectRepository.save(project);
+    }
+
+    /**(non-Javadoc)
+     *
+     * @see myapi.api.Service.Interfaces.ProjectService#updateProject(myapi.api.Model.Project)
+     */
+    @Override
+    public Project updateProject(Project project) {
+        Project dbProject = projectRepository.findById(project.getId_project()).get();
+        dbProject.setId_project(project.getId_project());
+        dbProject.setName_project(project.getName_project());
+        return projectRepository.save(dbProject);
+    }
+
+    /**(non-Javadoc)
+     *
+     * @see myapi.api.Service.Interfaces.ProjectService#deleteProject(int)
+     */
+    @Override
+    public void deleteProject(int idProject) {
+        projectRepository.deleteById(idProject);
+    }
+}

src/main/java/myapi/api/Service/Interfaces/ProjectService.java

@@ -0,0 +1,36 @@
+package myapi.api.Service.Interfaces;
+
+import java.util.List;
+import myapi.api.Model.Project;
+
+/**
+ * Interface pour les services de project
+ * ProjectService
+ */
+public interface ProjectService {
+    /**
+     * Récupère tous les projets de la database
+     * @return Une liste de projets
+     */
+    List<Project> getAllProjects();
+
+    /**
+     * Ajoute un nouveau projet
+     * @param project Le nouveau projet
+     * @return Le projet nouvellement créé
+     */
+    Project addProject(Project project);
+
+    /**
+     * Modifie un projet déjà existant
+     * @param project Le projet à modifier. Il faut que son id existe déjà dans la database
+     * @return Le projet modifié
+     */
+    Project updateProject(Project project);
+
+    /**
+     * Supprime un projet à partir de son identifiant
+     * @param idProject L'identifiant du projet
+     */
+    void deleteProject(int idProject);
+}

src/main/java/myapi/api/Service/Interfaces/TaskService.java

@@ -1,8 +1,6 @@
 package myapi.api.Service.Interfaces;
 
 import java.util.List;
-
-
 import myapi.api.Model.Task;
 
 /**
@@ -31,7 +29,7 @@ public interface TaskService {
 
     /**
      * Supprime une tâche existante à partir de son identifiant
-     * @param taskId L'id de la tâche à supprimer
+     * @param idTask L'id de la tâche à supprimer
      */
-    void deleteTask(int taskId);
+    void deleteTask(int idTask);
 }