mirror of
https://github.com/grafana/grafana.git
synced 2025-02-25 18:55:37 -06:00
48 lines
2.1 KiB
Go
48 lines
2.1 KiB
Go
package folder
|
|
|
|
import (
|
|
"context"
|
|
)
|
|
|
|
type Service interface {
|
|
// GetChildren returns an array containing all child folders.
|
|
GetChildren(ctx context.Context, cmd *GetChildrenQuery) ([]*Folder, error)
|
|
Create(ctx context.Context, cmd *CreateFolderCommand) (*Folder, error)
|
|
|
|
// GetFolder takes a GetFolderCommand and returns a folder matching the
|
|
// request. One of ID, UID, or Title must be included. If multiple values
|
|
// are included in the request, Grafana will select one in order of
|
|
// specificity (ID, UID, Title).
|
|
Get(ctx context.Context, cmd *GetFolderQuery) (*Folder, error)
|
|
|
|
// Update is used to update a folder's UID, Title and Description. To change
|
|
// a folder's parent folder, use Move.
|
|
Update(ctx context.Context, cmd *UpdateFolderCommand) (*Folder, error)
|
|
DeleteFolder(ctx context.Context, cmd *DeleteFolderCommand) error
|
|
MakeUserAdmin(ctx context.Context, orgID int64, userID, folderID int64, setViewAndEditPermissions bool) error
|
|
// Move changes a folder's parent folder to the requested new parent.
|
|
Move(ctx context.Context, cmd *MoveFolderCommand) (*Folder, error)
|
|
}
|
|
|
|
// NestedFolderService is the temporary interface definition for the folder
|
|
// Service which includes any new or alternate methods. These will be collapsed
|
|
// into a single service when the nested folder implementation is rolled out.
|
|
// Note that the commands in this service use models from this package, while
|
|
// the legacy FolderService uses models from the models package.
|
|
type NestedFolderService interface {
|
|
// Create creates a new folder.
|
|
Create(ctx context.Context, cmd *CreateFolderCommand) (*Folder, error)
|
|
|
|
// Delete deletes a folder. This will return an error if there are any
|
|
// dashboards in the folder.
|
|
Delete(ctx context.Context, cmd *DeleteFolderCommand) (*Folder, error)
|
|
|
|
// GetParents returns an ordered list of parent folders for the given
|
|
// folder, starting with the root node and ending with the requested child
|
|
// node.
|
|
GetParents(ctx context.Context, cmd *GetParentsQuery) ([]*Folder, error)
|
|
|
|
// GetChildren returns an array containing all child folders.
|
|
GetChildren(ctx context.Context, cmd *GetChildrenQuery) ([]*Folder, error)
|
|
}
|