115 lines
2.8 KiB
Go
115 lines
2.8 KiB
Go
|
package client
|
||
|
|
|
||
|
|
import (
|
||
|
|
"context"
|
||
|
|
"errors"
|
||
|
|
"fmt"
|
||
|
|
|
||
|
|
v2container "git.frostfs.info/TrueCloudLab/frostfs-api-go/v2/container"
|
||
|
|
"git.frostfs.info/TrueCloudLab/frostfs-api-go/v2/refs"
|
||
|
|
rpcapi "git.frostfs.info/TrueCloudLab/frostfs-api-go/v2/rpc"
|
||
|
|
"git.frostfs.info/TrueCloudLab/frostfs-api-go/v2/rpc/client"
|
||
|
|
"git.frostfs.info/TrueCloudLab/frostfs-sdk-go/container"
|
||
|
|
cid "git.frostfs.info/TrueCloudLab/frostfs-sdk-go/container/id"
|
||
|
|
)
|
||
|
|
|
||
|
|
// PrmContainerGet groups parameters of ContainerGet operation.
|
||
|
|
type PrmContainerGet struct {
|
||
|
|
prmCommonMeta
|
||
|
|
|
||
|
|
idSet bool
|
||
|
|
id cid.ID
|
||
|
|
}
|
||
|
|
|
||
|
|
// SetContainer sets identifier of the container to be read.
|
||
|
|
// Required parameter.
|
||
|
|
func (x *PrmContainerGet) SetContainer(id cid.ID) {
|
||
|
|
x.id = id
|
||
|
|
x.idSet = true
|
||
|
|
}
|
||
|
|
|
||
|
|
// ResContainerGet groups resulting values of ContainerGet operation.
|
||
|
|
type ResContainerGet struct {
|
||
|
|
statusRes
|
||
|
|
|
||
|
|
cnr container.Container
|
||
|
|
}
|
||
|
|
|
||
|
|
// Container returns structured information about the requested container.
|
||
|
|
//
|
||
|
|
// Client doesn't retain value so modification is safe.
|
||
|
|
func (x ResContainerGet) Container() container.Container {
|
||
|
|
return x.cnr
|
||
|
|
}
|
||
|
|
|
||
|
|
// ContainerGet reads FrostFS container by ID.
|
||
|
|
//
|
||
|
|
// Exactly one return value is non-nil. By default, server status is returned in res structure.
|
||
|
|
// Any client's internal or transport errors are returned as `error`.
|
||
|
|
// If PrmInit.ResolveFrostFSFailures has been called, unsuccessful
|
||
|
|
// FrostFS status codes are returned as `error`, otherwise, are included
|
||
|
|
// in the returned result structure.
|
||
|
|
//
|
||
|
|
// Returns an error if parameters are set incorrectly (see PrmContainerGet docs).
|
||
|
|
// Context is required and must not be nil. It is used for network communication.
|
||
|
|
//
|
||
|
|
// Return statuses:
|
||
|
|
// - global (see Client docs);
|
||
|
|
// - *apistatus.ContainerNotFound.
|
||
|
|
func (c *Client) ContainerGet(ctx context.Context, prm PrmContainerGet) (*ResContainerGet, error) {
|
||
|
|
switch {
|
||
|
|
case ctx == nil:
|
||
|
|
return nil, errorMissingContext
|
||
|
|
case !prm.idSet:
|
||
|
|
return nil, errorMissingContainer
|
||
|
|
}
|
||
|
|
|
||
|
|
var cidV2 refs.ContainerID
|
||
|
|
prm.id.WriteToV2(&cidV2)
|
||
|
|
|
||
|
|
// form request body
|
||
|
|
reqBody := new(v2container.GetRequestBody)
|
||
|
|
reqBody.SetContainerID(&cidV2)
|
||
|
|
|
||
|
|
// form request
|
||
|
|
var req v2container.GetRequest
|
||
|
|
|
||
|
|
req.SetBody(reqBody)
|
||
|
|
|
||
|
|
// init call context
|
||
|
|
|
||
|
|
var (
|
||
|
|
cc contextCall
|
||
|
|
res ResContainerGet
|
||
|
|
)
|
||
|
|
|
||
|
|
c.initCallContext(&cc)
|
||
|
|
cc.meta = prm.prmCommonMeta
|
||
|
|
cc.req = &req
|
||
|
|
cc.statusRes = &res
|
||
|
|
cc.call = func() (responseV2, error) {
|
||
|
|
return rpcapi.GetContainer(&c.c, &req, client.WithContext(ctx))
|
||
|
|
}
|
||
|
|
cc.result = func(r responseV2) {
|
||
|
|
resp := r.(*v2container.GetResponse)
|
||
|
|
|
||
|
|
cnrV2 := resp.GetBody().GetContainer()
|
||
|
|
if cnrV2 == nil {
|
||
|
|
cc.err = errors.New("missing container in response")
|
||
|
|
return
|
||
|
|
}
|
||
|
|
|
||
|
|
cc.err = res.cnr.ReadFromV2(*cnrV2)
|
||
|
|
if cc.err != nil {
|
||
|
|
cc.err = fmt.Errorf("invalid container in response: %w", cc.err)
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
// process call
|
||
|
|
if !cc.processCall() {
|
||
|
|
return nil, cc.err
|
||
|
|
}
|
||
|
|
|
||
|
|
return &res, nil
|
||
|
|
}
|