Files
ai/controllers/article.go

131 lines
3.9 KiB
Go

// Copyright 2023-2025 Hanzo AI Inc. All Rights Reserved.
// Portions Copyright 2024 The OpenAgent Authors. All Rights Reserved.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
package controllers
import (
"github.com/hanzoai/ai/object"
"github.com/hanzoai/ai/util"
)
// GetGlobalArticles
// @Title GetGlobalArticles
// @Tag Article API
// @Description get global articles
// @Success 200 {array} object.Article The Response object
// @router /get-global-articles [get]
func (c *ApiController) GetGlobalArticles() {
articles, ok := within(c, object.GetGlobalArticles, object.GetArticles)
if !ok {
return
}
c.ResponseOk(object.GetMaskedArticles(articles, true))
}
// GetArticles
// @Title GetArticles
// @Tag Article API
// @Description get articles
// @Param owner query string true "The owner of article"
// @Success 200 {array} object.Article The Response object
// @router /get-articles [get]
func (c *ApiController) GetArticles() {
owner, allowed := c.GetScopedOwner()
if !allowed {
return
}
limit := c.Input().Get("pageSize")
page := c.Input().Get("p")
field := c.Input().Get("field")
value := c.Input().Get("value")
sortField := c.Input().Get("sortField")
sortOrder := c.Input().Get("sortOrder")
if limit == "" || page == "" {
articles, err := object.GetArticles(owner)
if err != nil {
c.ResponseError(err.Error())
return
}
c.ResponseOk(object.GetMaskedArticles(articles, true))
} else {
limit := util.ParseInt(limit)
count, err := object.GetArticleCount(owner, field, value)
if err != nil {
c.ResponseError(err.Error())
return
}
paginator := util.NewPaginator(c.PageAsked(), limit, count)
articles, err := object.GetPaginationArticles(owner, paginator.Offset(), limit, field, value, sortField, sortOrder)
if err != nil {
c.ResponseError(err.Error())
return
}
c.ResponseOk(articles, paginator.Nums())
}
}
// GetArticle
// @Title GetArticle
// @Tag Article API
// @Description get article
// @Param id query string true "The id (owner/name) of article"
// @Success 200 {object} object.Article The Response object
// @router /get-article [get]
func (c *ApiController) GetArticle() {
id := c.Input().Get("id")
article, err := object.GetArticle(id)
if err != nil {
c.ResponseError(err.Error())
return
}
if article != nil && !reachable(c, article.Owner) {
return
}
c.ResponseOk(object.GetMaskedArticle(article, true))
}
// UpdateArticle
// @Title UpdateArticle
// @Tag Article API
// @Description update article
// @Param id query string true "The id (owner/name) of the article"
// @Param body body object.Article true "The details of the article"
// @Success 200 {object} controllers.Response The Response object
// @router /update-article [post]
func (c *ApiController) UpdateArticle() { replaced(c, c.GetScopedOwner, object.UpdateArticle) }
// AddArticle
// @Title AddArticle
// @Tag Article API
// @Description add article
// @Param body body object.Article true "The details of the article"
// @Success 200 {object} controllers.Response The Response object
// @router /add-article [post]
func (c *ApiController) AddArticle() { stored(c, c.GetScopedOwner, object.AddArticle) }
// DeleteArticle
// @Title DeleteArticle
// @Tag Article API
// @Description delete article
// @Param body body object.Article true "The details of the article"
// @Success 200 {object} controllers.Response The Response object
// @router /delete-article [post]
func (c *ApiController) DeleteArticle() { stored(c, c.GetScopedOwner, object.DeleteArticle) }