// Copyright 2020 Vikunja and contriubtors. All rights reserved. // // This file is part of Vikunja. // // Vikunja is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Vikunja is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Vikunja. If not, see . package models import ( "code.vikunja.io/api/pkg/timeutil" "code.vikunja.io/api/pkg/user" "code.vikunja.io/web" ) // TaskComment represents a task comment type TaskComment struct { ID int64 `xorm:"autoincr pk unique not null" json:"id" param:"commentid"` Comment string `xorm:"text not null" json:"comment"` AuthorID int64 `xorm:"not null" json:"-"` Author *user.User `xorm:"-" json:"author"` TaskID int64 `xorm:"not null" json:"-" param:"task"` Created timeutil.TimeStamp `xorm:"created" json:"created"` Updated timeutil.TimeStamp `xorm:"updated" json:"updated"` web.CRUDable `xorm:"-" json:"-"` web.Rights `xorm:"-" json:"-"` } // TableName holds the table name for the task comments table func (tc *TaskComment) TableName() string { return "task_comments" } // Create creates a new task comment // @Summary Create a new task comment // @Description Create a new task comment. The user doing this need to have at least write access to the task this comment should belong to. // @tags task // @Accept json // @Produce json // @Security JWTKeyAuth // @Param relation body models.TaskComment true "The task comment object" // @Param taskID path int true "Task ID" // @Success 200 {object} models.TaskComment "The created task comment object." // @Failure 400 {object} code.vikunja.io/web.HTTPError "Invalid task comment object provided." // @Failure 500 {object} models.Message "Internal error" // @Router /tasks/{taskID}/comments [put] func (tc *TaskComment) Create(a web.Auth) (err error) { // Check if the task exists _, err = GetTaskSimple(&Task{ID: tc.TaskID}) if err != nil { return err } tc.AuthorID = a.GetID() _, err = x.Insert(tc) return } // Delete removes a task comment // @Summary Remove a task comment // @Description Remove a task comment. The user doing this need to have at least write access to the task this comment belongs to. // @tags task // @Accept json // @Produce json // @Security JWTKeyAuth // @Param taskID path int true "Task ID" // @Param commentID path int true "Comment ID" // @Success 200 {object} models.Message "The task comment was successfully deleted." // @Failure 400 {object} code.vikunja.io/web.HTTPError "Invalid task comment object provided." // @Failure 404 {object} code.vikunja.io/web.HTTPError "The task comment was not found." // @Failure 500 {object} models.Message "Internal error" // @Router /tasks/{taskID}/comments/{commentID} [delete] func (tc *TaskComment) Delete() error { deleted, err := x.ID(tc.ID).NoAutoCondition().Delete(tc) if deleted == 0 { return ErrTaskCommentDoesNotExist{ID: tc.ID} } return err } // Update updates a task text by its ID // @Summary Update an existing task comment // @Description Update an existing task comment. The user doing this need to have at least write access to the task this comment belongs to. // @tags task // @Accept json // @Produce json // @Security JWTKeyAuth // @Param taskID path int true "Task ID" // @Param commentID path int true "Comment ID" // @Success 200 {object} models.TaskComment "The updated task comment object." // @Failure 400 {object} code.vikunja.io/web.HTTPError "Invalid task comment object provided." // @Failure 404 {object} code.vikunja.io/web.HTTPError "The task comment was not found." // @Failure 500 {object} models.Message "Internal error" // @Router /tasks/{taskID}/comments/{commentID} [post] func (tc *TaskComment) Update() error { updated, err := x.ID(tc.ID).Cols("comment").Update(tc) if updated == 0 { return ErrTaskCommentDoesNotExist{ID: tc.ID} } return err } // ReadOne handles getting a single comment // @Summary Remove a task comment // @Description Remove a task comment. The user doing this need to have at least read access to the task this comment belongs to. // @tags task // @Accept json // @Produce json // @Security JWTKeyAuth // @Param taskID path int true "Task ID" // @Param commentID path int true "Comment ID" // @Success 200 {object} models.TaskComment "The task comment object." // @Failure 400 {object} code.vikunja.io/web.HTTPError "Invalid task comment object provided." // @Failure 404 {object} code.vikunja.io/web.HTTPError "The task comment was not found." // @Failure 500 {object} models.Message "Internal error" // @Router /tasks/{taskID}/comments/{commentID} [get] func (tc *TaskComment) ReadOne() (err error) { exists, err := x.Get(tc) if err != nil { return } if !exists { return ErrTaskCommentDoesNotExist{ ID: tc.ID, TaskID: tc.TaskID, } } // Get the author author := &user.User{} _, err = x. Where("id = ?", tc.AuthorID). Get(author) tc.Author = author return } // ReadAll returns all comments for a task // @Summary Get all task comments // @Description Get all task comments. The user doing this need to have at least read access to the task. // @tags task // @Accept json // @Produce json // @Security JWTKeyAuth // @Param taskID path int true "Task ID" // @Success 200 {array} models.TaskComment "The array with all task comments" // @Failure 500 {object} models.Message "Internal error" // @Router /tasks/{taskID}/comments [get] func (tc *TaskComment) ReadAll(auth web.Auth, search string, page int, perPage int) (result interface{}, resultCount int, numberOfTotalItems int64, err error) { // Check if the user has access to the task canRead, err := tc.CanRead(auth) if err != nil { return nil, 0, 0, err } if !canRead { return nil, 0, 0, ErrGenericForbidden{} } // Because we can't extend the type in general, we need to do this here. // Not a good solution, but saves performance. type TaskCommentWithAuthor struct { TaskComment AuthorFromDB *user.User `xorm:"extends" json:"-"` } comments := []*TaskComment{} err = x. Where("task_id = ? AND comment like ?", tc.TaskID, "%"+search+"%"). Join("LEFT", "users", "users.id = task_comments.author_id"). Limit(getLimitFromPageIndex(page, perPage)). Find(&comments) if err != nil { return } // Get all authors authors := make(map[int64]*user.User) err = x. Select("users.*"). Table("task_comments"). Where("task_id = ? AND comment like ?", tc.TaskID, "%"+search+"%"). Join("INNER", "users", "users.id = task_comments.author_id"). Find(&authors) if err != nil { return } for _, comment := range comments { comment.Author = authors[comment.AuthorID] } numberOfTotalItems, err = x. Where("task_id = ? AND comment like ?", tc.TaskID, "%"+search+"%"). Count(&TaskCommentWithAuthor{}) return comments, len(comments), numberOfTotalItems, err }