feat: post rest docs

CodeURJC-DAW-2022-23 · Mar 23, 2023 · 21433df · 21433df
1 parent 358a574
commit 21433df
Showing 1 changed file with 58 additions and 22 deletions.
diff --git a/back/src/main/java/net/daw/alist/controllers/rest/PostRestController.java b/back/src/main/java/net/daw/alist/controllers/rest/PostRestController.java
@@ -1,5 +1,12 @@
 package net.daw.alist.controllers.rest;
 
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.media.ArraySchema;
+import io.swagger.v3.oas.annotations.media.Content;
+import io.swagger.v3.oas.annotations.media.Schema;
+import io.swagger.v3.oas.annotations.responses.ApiResponse;
+import io.swagger.v3.oas.annotations.responses.ApiResponses;
+import net.daw.alist.models.Comment;
 import net.daw.alist.models.Post;
 import net.daw.alist.models.User;
 import net.daw.alist.services.PostService;
@@ -11,6 +18,7 @@
 import org.springframework.security.core.Authentication;
 import org.springframework.web.bind.annotation.*;
 
+import java.util.Objects;
 import java.util.Optional;
 
 @RestController
@@ -25,42 +33,72 @@ public class PostRestController {
 
   @Autowired
   private VotesService votesService;
+
+  @Operation(summary = "Create new post")
+  @ApiResponses(value = {
+    @ApiResponse(responseCode = "201", description = "Post created", content = {
+      @Content(mediaType = "application/json", array = @ArraySchema(schema = @Schema(implementation = Post.class)))
+    }),
+    @ApiResponse(responseCode = "403", description = "Can't create post if not registered", content = @Content)
+  })
   @PostMapping("/")
   @ResponseStatus(HttpStatus.CREATED)
-  public Post createPost(Post post) {
-    postService.save(post);
-    return post;
+  public Post createPost(Authentication auth, Post post) {
+    if (auth != null) {
+      postService.save(post);
+      return post;
+    }
+    return null;
   }
 
-  @GetMapping("/{id}")
-  public ResponseEntity<Post> getPost(@PathVariable long id) {
-    Optional<Post> optionalPost = postService.findByID(id);
+  @Operation(summary = "Get specific post")
+  @ApiResponses(value = {
+    @ApiResponse(responseCode = "200", description = "Post found", content = {
+      @Content(mediaType = "application/json", array = @ArraySchema(schema = @Schema(implementation = Post.class)))
+    }),
+    @ApiResponse(responseCode = "404", description = "Post not found", content = @Content)
+  })
+  @GetMapping("/{postId}")
+  public ResponseEntity<Post> getPost(@PathVariable long postId) {
+    Optional<Post> optionalPost = postService.findByID(postId);
     if (optionalPost.isPresent()) {
       Post post = optionalPost.get();
       return new ResponseEntity<>(post, HttpStatus.OK);
     }
     return new ResponseEntity<>(HttpStatus.NOT_FOUND);
   }
 
-  @DeleteMapping("/{id}")
-  public ResponseEntity<Post> deletePost(@PathVariable long id) {
-    Optional<Post> optionalPost = postService.findByID(id);
-    if (optionalPost.isPresent()) {
+  @Operation(summary = "Delete specific post")
+  @ApiResponses(value = {
+    @ApiResponse(responseCode = "200", description = "Post deleted", content = {
+      @Content(mediaType = "application/json", array = @ArraySchema(schema = @Schema(implementation = Post.class)))
+    }),
+    @ApiResponse(responseCode = "403", description = "Can't delete other one post", content = @Content),
+    @ApiResponse(responseCode = "404", description = "Post not found", content = @Content)
+  })
+  @DeleteMapping("/{postId}")
+  public ResponseEntity<Post> deletePost(Authentication auth, @PathVariable long postId) {
+    Optional<Post> optionalPost = postService.findByID(postId);
+    if (auth != null && optionalPost.isPresent()) {
+      User userSession = (User) userService.loadUserByUsername(((User) auth.getPrincipal()).getUsername());
       Post post = optionalPost.get();
-      postService.delete(post);
-      return new ResponseEntity<>(HttpStatus.OK);
+      if (Objects.equals(userSession.getId(), post.getAuthor().getId())) {
+        postService.delete(post);
+        return new ResponseEntity<>(HttpStatus.OK);
+      }
+      return new ResponseEntity<>(HttpStatus.FORBIDDEN);
     }
     return new ResponseEntity<>(HttpStatus.NOT_FOUND);
   }
 
-  @PutMapping("/{id}/upvote")
-  public ResponseEntity<Post> upvoteAction(Authentication authentication, @PathVariable long id) {
-    Optional<Post> optionalPost = postService.findByID(id);
+  @PutMapping("/{postId}/upvote")
+  public ResponseEntity<Post> upvoteAction(Authentication authentication, @PathVariable long postId) {
+    Optional<Post> optionalPost = postService.findByID(postId);
     if(!(authentication == null) && optionalPost.isPresent() ) {
       User userSession = (User) userService.loadUserByUsername(((User) authentication
               .getPrincipal())
               .getUsername());
-      votesService.actionUpVote(id, userSession);
+      votesService.actionUpVote(postId, userSession);
       return new ResponseEntity<>(HttpStatus.OK);
     }
     else if (authentication==null)
@@ -70,22 +108,20 @@ else if (authentication==null)
 
   }
 
-  @PutMapping("/{id}/downvote")
-  public ResponseEntity<Post> downvoteAction(Authentication authentication, @PathVariable long id) {
-    Optional<Post> optionalPost = postService.findByID(id);
+  @PutMapping("/{postId}/downvote")
+  public ResponseEntity<Post> downvoteAction(Authentication authentication, @PathVariable long postId) {
+    Optional<Post> optionalPost = postService.findByID(postId);
     if(!(authentication == null) && optionalPost.isPresent() ) {
       User userSession = (User) userService.loadUserByUsername(((User) authentication
               .getPrincipal())
               .getUsername());
-      votesService.actionDownVote(id, userSession);
+      votesService.actionDownVote(postId, userSession);
       return new ResponseEntity<>(HttpStatus.OK);
     }
     else if (authentication==null)
       return new ResponseEntity<>(HttpStatus.FORBIDDEN);
     else
       return new ResponseEntity<>(HttpStatus.NOT_FOUND);
-
   }
 
-
 }