Package su.onno.ui.comments

Class CommentController

java.lang.Object

su.onno.ui.comments.CommentController

@RestController
@RequestMapping("/api/comments")
public class CommentController
extends Object

The discussion-thread endpoint. A thread hangs off any catalog or document detail page and is addressed by the same {kind}/{name}/{id} triple the UI routes use. Reading and posting are gated on read access to the target entity — if you can open the record you can comment on it (see UiAccessService); deleting is limited to the author or an ADMIN. Authorship is stamped from the authenticated principal via CurrentUserResolver, so the client never asserts who it is.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	CommentController.CommentRequest	The request body for posting a comment.
static final record	CommentController.ReactionRequest	The request body for toggling a reaction.

Constructor Summary

Constructors

Constructor	Description
CommentController(CommentService comments, UiAccessService access, CurrentUserResolver currentUser, CommentAuthorAvatars authorAvatars, CommentProperties properties, UiViewResolver viewResolver, CatalogQueryService catalogQuery, DocumentQueryService documentQuery, MentionResolver mentions, org.springframework.context.ApplicationEventPublisher events)

Method Summary

Modifier and Type	Method	Description
Map<String,Object>	add(String kind, String name, UUID id, CommentController.CommentRequest request, Principal principal)
org.springframework.http.ResponseEntity<Void>	delete(UUID commentId, Principal principal)
List<Map<String,Object>>	list(String kind, String name, UUID id, Principal principal)
List<Map<String,Object>>	toggleReaction(UUID commentId, CommentController.ReactionRequest request, Principal principal)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

CommentController

public CommentController(CommentService comments,
 UiAccessService access,
 CurrentUserResolver currentUser,
 CommentAuthorAvatars authorAvatars,
 CommentProperties properties,
 UiViewResolver viewResolver,
 CatalogQueryService catalogQuery,
 DocumentQueryService documentQuery,
 MentionResolver mentions,
 org.springframework.context.ApplicationEventPublisher events)

Method Details

list

@GetMapping("/{kind}/{name}/{id}")
public List<Map<String,Object>> list(@PathVariable
 String kind,
 @PathVariable
 String name,
 @PathVariable
 UUID id,
 Principal principal)

add

@PostMapping("/{kind}/{name}/{id}")
public Map<String,Object> add(@PathVariable
 String kind,
 @PathVariable
 String name,
 @PathVariable
 UUID id,
 @RequestBody
 CommentController.CommentRequest request,
 Principal principal)

toggleReaction

@PostMapping("/{commentId}/reactions")
public List<Map<String,Object>> toggleReaction(@PathVariable
 UUID commentId,
 @RequestBody
 CommentController.ReactionRequest request,
 Principal principal)

delete

@DeleteMapping("/{commentId}")
public org.springframework.http.ResponseEntity<Void> delete(@PathVariable
 UUID commentId,
 Principal principal)