feat: add persistent cache service

Signed-off-by: BruceAko <chongzhi@hust.edu.cn>

Author: BruceAko

manager/handlers/job.go

@@ -38,6 +38,7 @@ import (
 // @Failure 400
 // @Failure 404
 // @Failure 500
+// @Router /api/v1/jobs [post]
 // @Router /oapi/v1/jobs [post]
 func (h *Handlers) CreateJob(ctx *gin.Context) {
 	var json types.CreateJobRequest

manager/handlers/persistent_cache.go

@@ -0,0 +1,55 @@
+/*
+ *     Copyright 2025 The Dragonfly Authors
+ *
+ * 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 handlers
+
+import (
+	"net/http"
+
+	"github.com/gin-gonic/gin"
+
+	"d7y.io/dragonfly/v2/manager/types"
+)
+
+// @Summary Get PersistentCaches
+// @Description Get PersistentCaches
+// @Tags PersistentCache
+// @Accept json
+// @Produce json
+// @Param page query int true "current page" default(0)
+// @Param per_page query int true "return max item count, default 10, max 50" default(10) minimum(2) maximum(50)
+// @Success 200 {object} []types.GetPersistentCachesResponse
+// @Failure 400
+// @Failure 404
+// @Failure 500
+// @Router /api/v1/persistent-caches [get]
+func (h *Handlers) GetPersistentCaches(ctx *gin.Context) {
+	var query types.GetPersistentCachesQuery
+	if err := ctx.ShouldBindQuery(&query); err != nil {
+		ctx.JSON(http.StatusUnprocessableEntity, gin.H{"errors": err.Error()})
+		return
+	}
+
+	h.setPaginationDefault(&query.Page, &query.PerPage)
+	persistentCaches, count, err := h.service.GetPersistentCaches(ctx.Request.Context(), query)
+	if err != nil {
+		ctx.Error(err) // nolint: errcheck
+		return
+	}
+
+	h.setPaginationLinkHeader(ctx, query.Page, query.PerPage, int(count))
+	ctx.JSON(http.StatusOK, persistentCaches)
+}

manager/router/router.go

@@ -233,6 +233,12 @@ func Init(cfg *config.Config, logDir string, service service.Service, database *
 	pat.GET(":id", h.GetPersonalAccessToken)
 	pat.GET("", h.GetPersonalAccessTokens)
 
+	// Persistent Cache.
+	pc := apiv1.Group("/persistent-caches", jwt.MiddlewareFunc(), rbac)
+	//pc.DELETE(":id", h.DestroyPersistentCache)
+	//pc.GET(":id", h.GetPersistentCache)
+	pc.GET("", h.GetPersistentCaches)
+
 	// Open API router.
 	oapiv1 := r.Group("/oapi/v1")