mirror of
				https://github.com/go-gitea/gitea.git
				synced 2025-11-03 21:16:26 +01:00 
			
		
		
		
	* [API] Add notification endpoints
 * add func GetNotifications(opts FindNotificationOptions)
 * add func (n *Notification) APIFormat()
 * add func (nl NotificationList) APIFormat()
 * add func (n *Notification) APIURL()
 * add func (nl NotificationList) APIFormat()
 * add LoadAttributes functions (loadRepo, loadIssue, loadComment, loadUser)
 * add func (c *Comment) APIURL()
 * add func (issue *Issue) GetLastComment()
 * add endpoint GET /notifications
 * add endpoint PUT /notifications
 * add endpoint GET /repos/{owner}/{repo}/notifications
 * add endpoint PUT /repos/{owner}/{repo}/notifications
 * add endpoint GET /notifications/threads/{id}
 * add endpoint PATCH /notifications/threads/{id}
* Add TEST
* code format
* code format
		
	
			
		
			
				
	
	
		
			152 lines
		
	
	
		
			3.9 KiB
		
	
	
	
		
			Go
		
	
	
	
	
	
			
		
		
	
	
			152 lines
		
	
	
		
			3.9 KiB
		
	
	
	
		
			Go
		
	
	
	
	
	
// Copyright 2020 The Gitea Authors. All rights reserved.
 | 
						|
// Use of this source code is governed by a MIT-style
 | 
						|
// license that can be found in the LICENSE file.
 | 
						|
 | 
						|
package notify
 | 
						|
 | 
						|
import (
 | 
						|
	"net/http"
 | 
						|
	"strings"
 | 
						|
	"time"
 | 
						|
 | 
						|
	"code.gitea.io/gitea/models"
 | 
						|
	"code.gitea.io/gitea/modules/context"
 | 
						|
	"code.gitea.io/gitea/routers/api/v1/utils"
 | 
						|
)
 | 
						|
 | 
						|
// ListRepoNotifications list users's notification threads on a specific repo
 | 
						|
func ListRepoNotifications(ctx *context.APIContext) {
 | 
						|
	// swagger:operation GET /repos/{owner}/{repo}/notifications notification notifyGetRepoList
 | 
						|
	// ---
 | 
						|
	// summary: List users's notification threads on a specific repo
 | 
						|
	// consumes:
 | 
						|
	// - application/json
 | 
						|
	// produces:
 | 
						|
	// - application/json
 | 
						|
	// parameters:
 | 
						|
	// - name: owner
 | 
						|
	//   in: path
 | 
						|
	//   description: owner of the repo
 | 
						|
	//   type: string
 | 
						|
	//   required: true
 | 
						|
	// - name: repo
 | 
						|
	//   in: path
 | 
						|
	//   description: name of the repo
 | 
						|
	//   type: string
 | 
						|
	//   required: true
 | 
						|
	// - name: all
 | 
						|
	//   in: query
 | 
						|
	//   description: If true, show notifications marked as read. Default value is false
 | 
						|
	//   type: string
 | 
						|
	//   required: false
 | 
						|
	// - name: since
 | 
						|
	//   in: query
 | 
						|
	//   description: Only show notifications updated after the given time. This is a timestamp in RFC 3339 format
 | 
						|
	//   type: string
 | 
						|
	//   format: date-time
 | 
						|
	//   required: false
 | 
						|
	// - name: before
 | 
						|
	//   in: query
 | 
						|
	//   description: Only show notifications updated before the given time. This is a timestamp in RFC 3339 format
 | 
						|
	//   type: string
 | 
						|
	//   format: date-time
 | 
						|
	//   required: false
 | 
						|
	// responses:
 | 
						|
	//   "200":
 | 
						|
	//     "$ref": "#/responses/NotificationThreadList"
 | 
						|
 | 
						|
	before, since, err := utils.GetQueryBeforeSince(ctx)
 | 
						|
	if err != nil {
 | 
						|
		ctx.InternalServerError(err)
 | 
						|
		return
 | 
						|
	}
 | 
						|
	opts := models.FindNotificationOptions{
 | 
						|
		UserID:            ctx.User.ID,
 | 
						|
		RepoID:            ctx.Repo.Repository.ID,
 | 
						|
		UpdatedBeforeUnix: before,
 | 
						|
		UpdatedAfterUnix:  since,
 | 
						|
	}
 | 
						|
	qAll := strings.Trim(ctx.Query("all"), " ")
 | 
						|
	if qAll != "true" {
 | 
						|
		opts.Status = models.NotificationStatusUnread
 | 
						|
	}
 | 
						|
	nl, err := models.GetNotifications(opts)
 | 
						|
	if err != nil {
 | 
						|
		ctx.InternalServerError(err)
 | 
						|
		return
 | 
						|
	}
 | 
						|
	err = nl.LoadAttributes()
 | 
						|
	if err != nil {
 | 
						|
		ctx.InternalServerError(err)
 | 
						|
		return
 | 
						|
	}
 | 
						|
 | 
						|
	ctx.JSON(http.StatusOK, nl.APIFormat())
 | 
						|
}
 | 
						|
 | 
						|
// ReadRepoNotifications mark notification threads as read on a specific repo
 | 
						|
func ReadRepoNotifications(ctx *context.APIContext) {
 | 
						|
	// swagger:operation PUT /repos/{owner}/{repo}/notifications notification notifyReadRepoList
 | 
						|
	// ---
 | 
						|
	// summary: Mark notification threads as read on a specific repo
 | 
						|
	// consumes:
 | 
						|
	// - application/json
 | 
						|
	// produces:
 | 
						|
	// - application/json
 | 
						|
	// parameters:
 | 
						|
	// - name: owner
 | 
						|
	//   in: path
 | 
						|
	//   description: owner of the repo
 | 
						|
	//   type: string
 | 
						|
	//   required: true
 | 
						|
	// - name: repo
 | 
						|
	//   in: path
 | 
						|
	//   description: name of the repo
 | 
						|
	//   type: string
 | 
						|
	//   required: true
 | 
						|
	// - name: last_read_at
 | 
						|
	//   in: query
 | 
						|
	//   description: Describes the last point that notifications were checked. Anything updated since this time will not be updated.
 | 
						|
	//   type: string
 | 
						|
	//   format: date-time
 | 
						|
	//   required: false
 | 
						|
	// responses:
 | 
						|
	//   "205":
 | 
						|
	//     "$ref": "#/responses/empty"
 | 
						|
 | 
						|
	lastRead := int64(0)
 | 
						|
	qLastRead := strings.Trim(ctx.Query("last_read_at"), " ")
 | 
						|
	if len(qLastRead) > 0 {
 | 
						|
		tmpLastRead, err := time.Parse(time.RFC3339, qLastRead)
 | 
						|
		if err != nil {
 | 
						|
			ctx.InternalServerError(err)
 | 
						|
			return
 | 
						|
		}
 | 
						|
		if !tmpLastRead.IsZero() {
 | 
						|
			lastRead = tmpLastRead.Unix()
 | 
						|
		}
 | 
						|
	}
 | 
						|
	opts := models.FindNotificationOptions{
 | 
						|
		UserID:            ctx.User.ID,
 | 
						|
		RepoID:            ctx.Repo.Repository.ID,
 | 
						|
		UpdatedBeforeUnix: lastRead,
 | 
						|
		Status:            models.NotificationStatusUnread,
 | 
						|
	}
 | 
						|
	nl, err := models.GetNotifications(opts)
 | 
						|
	if err != nil {
 | 
						|
		ctx.InternalServerError(err)
 | 
						|
		return
 | 
						|
	}
 | 
						|
 | 
						|
	for _, n := range nl {
 | 
						|
		err := models.SetNotificationStatus(n.ID, ctx.User, models.NotificationStatusRead)
 | 
						|
		if err != nil {
 | 
						|
			ctx.InternalServerError(err)
 | 
						|
			return
 | 
						|
		}
 | 
						|
		ctx.Status(http.StatusResetContent)
 | 
						|
	}
 | 
						|
 | 
						|
	ctx.Status(http.StatusResetContent)
 | 
						|
}
 |