mirror of
https://github.com/raseels-repos/golang-saas-starter-kit.git
synced 2025-06-06 23:46:29 +02:00
362 lines
11 KiB
Go
362 lines
11 KiB
Go
package handlers
|
|
|
|
import (
|
|
"context"
|
|
"net/http"
|
|
"strconv"
|
|
"strings"
|
|
|
|
"geeks-accelerator/oss/saas-starter-kit/internal/platform/auth"
|
|
"geeks-accelerator/oss/saas-starter-kit/internal/platform/web"
|
|
"geeks-accelerator/oss/saas-starter-kit/internal/platform/web/webcontext"
|
|
"geeks-accelerator/oss/saas-starter-kit/internal/platform/web/weberror"
|
|
"geeks-accelerator/oss/saas-starter-kit/internal/project"
|
|
"github.com/jmoiron/sqlx"
|
|
"github.com/pkg/errors"
|
|
"gopkg.in/go-playground/validator.v9"
|
|
)
|
|
|
|
// Project represents the Project API method handler set.
|
|
type Project struct {
|
|
MasterDB *sqlx.DB
|
|
|
|
// ADD OTHER STATE LIKE THE LOGGER IF NEEDED.
|
|
}
|
|
|
|
// Find godoc
|
|
// TODO: Need to implement unittests on projects/find endpoint. There are none.
|
|
// @Summary List projects
|
|
// @Description Find returns the existing projects in the system.
|
|
// @Tags project
|
|
// @Accept json
|
|
// @Produce json
|
|
// @Security OAuth2Password
|
|
// @Param where query string false "Filter string, example: name = 'Moon Launch'"
|
|
// @Param order query string false "Order columns separated by comma, example: created_at desc"
|
|
// @Param limit query integer false "Limit, example: 10"
|
|
// @Param offset query integer false "Offset, example: 20"
|
|
// @Param include-archived query boolean false "Included Archived, example: false"
|
|
// @Success 200 {array} project.ProjectResponse
|
|
// @Failure 400 {object} weberror.ErrorResponse
|
|
// @Failure 403 {object} weberror.ErrorResponse
|
|
// @Failure 500 {object} weberror.ErrorResponse
|
|
// @Router /project [get]
|
|
func (p *Project) Find(ctx context.Context, w http.ResponseWriter, r *http.Request, params map[string]string) error {
|
|
claims, ok := ctx.Value(auth.Key).(auth.Claims)
|
|
if !ok {
|
|
return errors.New("claims missing from context")
|
|
}
|
|
|
|
var req project.ProjectFindRequest
|
|
|
|
// Handle where query value if set.
|
|
if v := r.URL.Query().Get("where"); v != "" {
|
|
where, args, err := web.ExtractWhereArgs(v)
|
|
if err != nil {
|
|
return web.RespondJsonError(ctx, w, weberror.NewError(ctx, err, http.StatusBadRequest))
|
|
}
|
|
req.Where = where
|
|
req.Args = args
|
|
}
|
|
|
|
// Handle order query value if set.
|
|
if v := r.URL.Query().Get("order"); v != "" {
|
|
for _, o := range strings.Split(v, ",") {
|
|
o = strings.TrimSpace(o)
|
|
if o != "" {
|
|
req.Order = append(req.Order, o)
|
|
}
|
|
}
|
|
}
|
|
|
|
// Handle limit query value if set.
|
|
if v := r.URL.Query().Get("limit"); v != "" {
|
|
l, err := strconv.Atoi(v)
|
|
if err != nil {
|
|
err = errors.WithMessagef(err, "unable to parse %s as int for limit param", v)
|
|
return web.RespondJsonError(ctx, w, weberror.NewError(ctx, err, http.StatusBadRequest))
|
|
}
|
|
ul := uint(l)
|
|
req.Limit = &ul
|
|
}
|
|
|
|
// Handle offset query value if set.
|
|
if v := r.URL.Query().Get("offset"); v != "" {
|
|
l, err := strconv.Atoi(v)
|
|
if err != nil {
|
|
err = errors.WithMessagef(err, "unable to parse %s as int for offset param", v)
|
|
return web.RespondJsonError(ctx, w, weberror.NewError(ctx, err, http.StatusBadRequest))
|
|
}
|
|
ul := uint(l)
|
|
req.Limit = &ul
|
|
}
|
|
|
|
// Handle include-archive query value if set.
|
|
if v := r.URL.Query().Get("include-archived"); v != "" {
|
|
b, err := strconv.ParseBool(v)
|
|
if err != nil {
|
|
err = errors.WithMessagef(err, "unable to parse %s as boolean for include-archived param", v)
|
|
return web.RespondJsonError(ctx, w, weberror.NewError(ctx, err, http.StatusBadRequest))
|
|
}
|
|
req.IncludeArchived = b
|
|
}
|
|
|
|
//if err := web.Decode(r, &req); err != nil {
|
|
// if _, ok := errors.Cause(err).(*web.Error); !ok {
|
|
// err = weberror.NewError(ctx, err, http.StatusBadRequest)
|
|
// }
|
|
// return web.RespondJsonError(ctx, w, err)
|
|
//}
|
|
|
|
res, err := project.Find(ctx, claims, p.MasterDB, req)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
var resp []*project.ProjectResponse
|
|
for _, m := range res {
|
|
resp = append(resp, m.Response(ctx))
|
|
}
|
|
|
|
return web.RespondJson(ctx, w, resp, http.StatusOK)
|
|
}
|
|
|
|
// Read godoc
|
|
// @Summary Get project by ID.
|
|
// @Description Read returns the specified project from the system.
|
|
// @Tags project
|
|
// @Accept json
|
|
// @Produce json
|
|
// @Security OAuth2Password
|
|
// @Param id path string true "Project ID"
|
|
// @Success 200 {object} project.ProjectResponse
|
|
// @Failure 400 {object} weberror.ErrorResponse
|
|
// @Failure 404 {object} weberror.ErrorResponse
|
|
// @Failure 500 {object} weberror.ErrorResponse
|
|
// @Router /projects/{id} [get]
|
|
func (p *Project) Read(ctx context.Context, w http.ResponseWriter, r *http.Request, params map[string]string) error {
|
|
claims, ok := ctx.Value(auth.Key).(auth.Claims)
|
|
if !ok {
|
|
return errors.New("claims missing from context")
|
|
}
|
|
|
|
// Handle include-archived query value if set.
|
|
var includeArchived bool
|
|
if v := r.URL.Query().Get("include-archived"); v != "" {
|
|
b, err := strconv.ParseBool(v)
|
|
if err != nil {
|
|
err = errors.WithMessagef(err, "unable to parse %s as boolean for include-archived param", v)
|
|
return web.RespondJsonError(ctx, w, weberror.NewError(ctx, err, http.StatusBadRequest))
|
|
}
|
|
includeArchived = b
|
|
}
|
|
|
|
res, err := project.Read(ctx, claims, p.MasterDB, project.ProjectReadRequest{
|
|
ID: params["id"],
|
|
IncludeArchived: includeArchived,
|
|
})
|
|
if err != nil {
|
|
cause := errors.Cause(err)
|
|
switch cause {
|
|
case project.ErrNotFound:
|
|
return web.RespondJsonError(ctx, w, weberror.NewError(ctx, err, http.StatusNotFound))
|
|
default:
|
|
return errors.Wrapf(err, "ID: %s", params["id"])
|
|
}
|
|
}
|
|
|
|
return web.RespondJson(ctx, w, res.Response(ctx), http.StatusOK)
|
|
}
|
|
|
|
// Create godoc
|
|
// @Summary Create new project.
|
|
// @Description Create inserts a new project into the system.
|
|
// @Tags project
|
|
// @Accept json
|
|
// @Produce json
|
|
// @Security OAuth2Password
|
|
// @Param data body project.ProjectCreateRequest true "Project details"
|
|
// @Success 201 {object} project.ProjectResponse
|
|
// @Failure 400 {object} weberror.ErrorResponse
|
|
// @Failure 403 {object} weberror.ErrorResponse
|
|
// @Failure 404 {object} weberror.ErrorResponse
|
|
// @Failure 500 {object} weberror.ErrorResponse
|
|
// @Router /projects [post]
|
|
func (p *Project) Create(ctx context.Context, w http.ResponseWriter, r *http.Request, params map[string]string) error {
|
|
v, err := webcontext.ContextValues(ctx)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
claims, err := auth.ClaimsFromContext(ctx)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
var req project.ProjectCreateRequest
|
|
if err := web.Decode(ctx, r, &req); err != nil {
|
|
if _, ok := errors.Cause(err).(*weberror.Error); !ok {
|
|
err = weberror.NewError(ctx, err, http.StatusBadRequest)
|
|
}
|
|
return web.RespondJsonError(ctx, w, err)
|
|
}
|
|
|
|
res, err := project.Create(ctx, claims, p.MasterDB, req, v.Now)
|
|
if err != nil {
|
|
cause := errors.Cause(err)
|
|
switch cause {
|
|
case project.ErrForbidden:
|
|
return web.RespondJsonError(ctx, w, weberror.NewError(ctx, err, http.StatusForbidden))
|
|
default:
|
|
_, ok := cause.(validator.ValidationErrors)
|
|
if ok {
|
|
return web.RespondJsonError(ctx, w, weberror.NewError(ctx, err, http.StatusBadRequest))
|
|
}
|
|
return errors.Wrapf(err, "Project: %+v", &req)
|
|
}
|
|
}
|
|
|
|
return web.RespondJson(ctx, w, res.Response(ctx), http.StatusCreated)
|
|
}
|
|
|
|
// Read godoc
|
|
// @Summary Update project by ID
|
|
// @Description Update updates the specified project in the system.
|
|
// @Tags project
|
|
// @Accept json
|
|
// @Produce json
|
|
// @Security OAuth2Password
|
|
// @Param data body project.ProjectUpdateRequest true "Update fields"
|
|
// @Success 204
|
|
// @Failure 400 {object} weberror.ErrorResponse
|
|
// @Failure 403 {object} weberror.ErrorResponse
|
|
// @Failure 500 {object} weberror.ErrorResponse
|
|
// @Router /projects [patch]
|
|
func (p *Project) Update(ctx context.Context, w http.ResponseWriter, r *http.Request, params map[string]string) error {
|
|
v, err := webcontext.ContextValues(ctx)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
claims, err := auth.ClaimsFromContext(ctx)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
var req project.ProjectUpdateRequest
|
|
if err := web.Decode(ctx, r, &req); err != nil {
|
|
if _, ok := errors.Cause(err).(*weberror.Error); !ok {
|
|
err = weberror.NewError(ctx, err, http.StatusBadRequest)
|
|
}
|
|
return web.RespondJsonError(ctx, w, err)
|
|
}
|
|
|
|
err = project.Update(ctx, claims, p.MasterDB, req, v.Now)
|
|
if err != nil {
|
|
cause := errors.Cause(err)
|
|
switch cause {
|
|
case project.ErrForbidden:
|
|
return web.RespondJsonError(ctx, w, weberror.NewError(ctx, err, http.StatusForbidden))
|
|
default:
|
|
_, ok := cause.(validator.ValidationErrors)
|
|
if ok {
|
|
return web.RespondJsonError(ctx, w, weberror.NewError(ctx, err, http.StatusBadRequest))
|
|
}
|
|
|
|
return errors.Wrapf(err, "ID: %s Update: %+v", req.ID, req)
|
|
}
|
|
}
|
|
|
|
return web.RespondJson(ctx, w, nil, http.StatusNoContent)
|
|
}
|
|
|
|
// Read godoc
|
|
// @Summary Archive project by ID
|
|
// @Description Archive soft-deletes the specified project from the system.
|
|
// @Tags project
|
|
// @Accept json
|
|
// @Produce json
|
|
// @Security OAuth2Password
|
|
// @Param data body project.ProjectArchiveRequest true "Update fields"
|
|
// @Success 204
|
|
// @Failure 400 {object} weberror.ErrorResponse
|
|
// @Failure 403 {object} weberror.ErrorResponse
|
|
// @Failure 500 {object} weberror.ErrorResponse
|
|
// @Router /projects/archive [patch]
|
|
func (p *Project) Archive(ctx context.Context, w http.ResponseWriter, r *http.Request, params map[string]string) error {
|
|
v, err := webcontext.ContextValues(ctx)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
claims, err := auth.ClaimsFromContext(ctx)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
var req project.ProjectArchiveRequest
|
|
if err := web.Decode(ctx, r, &req); err != nil {
|
|
if _, ok := errors.Cause(err).(*weberror.Error); !ok {
|
|
err = weberror.NewError(ctx, err, http.StatusBadRequest)
|
|
}
|
|
return web.RespondJsonError(ctx, w, err)
|
|
}
|
|
|
|
err = project.Archive(ctx, claims, p.MasterDB, req, v.Now)
|
|
if err != nil {
|
|
cause := errors.Cause(err)
|
|
switch cause {
|
|
case project.ErrForbidden:
|
|
return web.RespondJsonError(ctx, w, weberror.NewError(ctx, err, http.StatusForbidden))
|
|
default:
|
|
_, ok := cause.(validator.ValidationErrors)
|
|
if ok {
|
|
return web.RespondJsonError(ctx, w, weberror.NewError(ctx, err, http.StatusBadRequest))
|
|
}
|
|
|
|
return errors.Wrapf(err, "Id: %s", req.ID)
|
|
}
|
|
}
|
|
|
|
return web.RespondJson(ctx, w, nil, http.StatusNoContent)
|
|
}
|
|
|
|
// Delete godoc
|
|
// @Summary Delete project by ID
|
|
// @Description Delete removes the specified project from the system.
|
|
// @Tags project
|
|
// @Accept json
|
|
// @Produce json
|
|
// @Security OAuth2Password
|
|
// @Param id path string true "Project ID"
|
|
// @Success 204
|
|
// @Failure 400 {object} weberror.ErrorResponse
|
|
// @Failure 403 {object} weberror.ErrorResponse
|
|
// @Failure 500 {object} weberror.ErrorResponse
|
|
// @Router /projects/{id} [delete]
|
|
func (p *Project) Delete(ctx context.Context, w http.ResponseWriter, r *http.Request, params map[string]string) error {
|
|
claims, err := auth.ClaimsFromContext(ctx)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
err = project.Delete(ctx, claims, p.MasterDB,
|
|
project.ProjectDeleteRequest{ID: params["id"]})
|
|
if err != nil {
|
|
cause := errors.Cause(err)
|
|
switch cause {
|
|
case project.ErrForbidden:
|
|
return web.RespondJsonError(ctx, w, weberror.NewError(ctx, err, http.StatusForbidden))
|
|
default:
|
|
_, ok := cause.(validator.ValidationErrors)
|
|
if ok {
|
|
return web.RespondJsonError(ctx, w, weberror.NewError(ctx, err, http.StatusBadRequest))
|
|
}
|
|
|
|
return errors.Wrapf(err, "Id: %s", params["id"])
|
|
}
|
|
}
|
|
|
|
return web.RespondJson(ctx, w, nil, http.StatusNoContent)
|
|
}
|